Hướng dẫn này giúp bạn kết nối Microsoft Dynamics 365 Finance and Operations với HexaSync Automation Engine bằng Microsoft Entra App do doanh nghiệp quản lý. Sau khi hoàn tất, bạn sẽ tạo Dynamics 365 F&O Connector App trên HexaSync cho một legal entity và có thể dùng các tác vụ được tạo sẵn để đọc dữ liệu từ F&O.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để đăng nhập HexaSync. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Microsoft Entra App đã được chuẩn bị và liên kết với user trong D365 F&O.
- Client ID, Client Secret Value và Tenant ID của Entra App.
- F&O Environment, là địa chỉ bạn dùng để mở F&O, ví dụ:
https://contoso.operations.dynamics.com- Data Area ID của legal entity cần đọc dữ liệu, ví dụ usmf.
Chưa có Entra App? Nếu chưa có Entra App hoặc chưa liên kết ứng dụng với D365 F&O, hãy làm theo hướng dẫn tạo Microsoft Entra App cho Dynamics 365 trước khi tiếp tục.
Phần 1: Kết nối Dynamics 365 Finance and Operations trên HexaSync
Bước 1: Đăng nhập HexaSync
- Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa của bạn.
Bước 2: Bắt đầu kết nối Dynamics 365 Finance and Operations
- Mở Xác thực Microsoft Dynamics 365 F&O trên HexaSync.
- Trên màn hình Check connection details, tìm MS Dynamics 365 F&O và chọn Connect.
Bước 3: Nhập thông tin kết nối
- Trên màn hình Choose an app to connect to MS Dynamics 365 F&O, chọn Another App.
- Trên màn hình Connect HexaSync to your Entra App and F&O environment, nhập bốn thông tin sau:
| Trường | Giá trị |
|---|---|
| Client ID | Application (client) ID của Entra App. |
| Client Secret | Client Secret Value của Entra App. |
| Tenant ID | Directory (tenant) ID của Entra App. |
| F&O Environment | Địa chỉ F&O mà ứng dụng được phép truy cập, ví dụ https://contoso.operations.dynamics.com. |
- Chọn Continue.
Bước 4: Xác nhận kết nối và tạo Connector App
- Khi màn hình hiển thị MS Dynamics 365 F&O với trạng thái Connected, chọn Create [Beehexa] MS Dynamics 365 F&O Connector.
Bước 5: Hoàn tất thông tin Connector App
- Kiểm tra tên được đề xuất và thay đổi nếu cần.
- Nhập Data Area ID (legal entity), ví dụ usmf.
- Chọn Continue.
Lưu ý:
- Mỗi Connector App trong quy trình này chỉ đọc dữ liệu trong một legal entity. Nếu cần đọc legal entity khác, tạo thêm Connector App với Data Area ID tương ứng.
- Quá trình tạo có thể mất vài phút. Giữ trang mở cho đến khi HexaSync mở Connector App vừa tạo.
Phần 2: Kiểm tra kết quả sau khi kết nối
Sau khi tạo Dynamics 365 F&O Connector App thành công, màn hình app trên HexaSync mặc định hiển thị 2 tác vụ:
- Released Product Variants: đọc các released product variants của legal entity.
- Inventory Levels: đọc tồn kho theo product, site và warehouse.
Lưu ý: Schedulers để các tác vụ chạy tự động chưa được thiết lập. Bạn có thể chọn Pull All để kéo dữ liệu mới nhất. Các tác vụ mặc định trong hướng dẫn này chỉ đọc dữ liệu và không ghi dữ liệu vào F&O.
Phần 3: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| We Couldn’t Connect To Your F&O Environment | Kiểm tra Client Secret, Tenant ID và F&O Environment. Nếu Client Secret đã hết hạn, tạo secret mới và cập nhật lại thông tin kết nối. |
| Please Use Your Own Entra App | Chọn Entra App do doanh nghiệp tự đăng ký, hoặc chọn Another App để nhập ứng dụng khác. |
| HexaSync Could Not Register Your Entra App | Kiểm tra và nhập đủ Client ID cùng Client Secret, sau đó thử lại. |
| The name already exists | Chọn tên khác cho Connector App. |
| Profile Quota Reached | Liên hệ support@beehexa.com để kiểm tra giới hạn hiện tại. |
| A task has no data | Kiểm tra Data Area ID và quyền của F&O user đã liên kết với Entra App. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình lỗi (đã che thông tin nhạy cảm) đến support@beehexa.com.
Lưu ý bảo mật: Không gửi Client Secret trong ảnh chụp hoặc email thông thường.
Phần 4: Câu hỏi thường gặp
Client ID, Tenant ID và Client Secret lấy ở đâu?
Các giá trị này được lấy từ Microsoft Entra App. Xem hướng dẫn tạo Microsoft Entra App để kết nối Dynamics 365 F&O với HexaSync để chuẩn bị ứng dụng và cấp quyền trong F&O.
Data Area ID là gì?
Đây là mã legal entity trong D365 F&O. Mã này được hiển thị ở khu vực công ty trong F&O, ví dụ usmf, và được dùng khi tạo Connector App.
Tạo Entra App xong đã kết nối Dynamics 365 Finance and Operations với HexaSync chưa?
Chưa. Bạn còn phải liên kết Entra App với một User ID trong D365 F&O, gán quyền phù hợp cho user đó, sau đó thực hiện luồng kết nối và tạo Connector App trên HexaSync.
Một Connector App có đọc nhiều legal entity không?
Không trong quy trình được mô tả ở đây. Mỗi Connector App đọc một legal entity. Tạo thêm Connector App nếu cần làm việc với Data Area ID khác.
Sau khi kết nối thành công, HexaSync có tự động lấy dữ liệu từ Dynamics 365 Finance and Operations không?
Chưa. Sau khi tạo thành công Dynamics 365 F&O Connector App, HexaSync cung cấp sẵn 2 tác vụ Released Product Variants và Inventory Levels, nhưng chưa thiết lập lịch chạy tự động (Schedulers). Bạn có thể chọn Pull All để lấy dữ liệu mới từ F&O. Nếu muốn dữ liệu được cập nhật tự động, cần thiết lập Schedulers cho các tác vụ.
HexaSync có ghi hoặc sửa dữ liệu trên Dynamics 365 Finance and Operations không?
Không. Dynamics 365 F&O Connector App chỉ đọc dữ liệu, không ghi hoặc sửa dữ liệu trên Dynamics 365 F&O.