Nạp dữ liệu và metadata từ Workday sang Adaptive Planning

Mô hình kế hoạch chỉ đáng tin khi actuals, hệ tài khoản và danh mục tổ chức tự chảy từ Workday sang — không ai chép tay. Bài này trình bày đường ống đó theo đúng thứ tự dựng, kèm các quy tắc làm báo cáo nguồn và những lỗi kinh điển.

Đường ống tổng thể

flowchart LR
  R["Custom reports Workday<br/>(advanced, web service)"] --> DS["Workday Data Source<br/>trong Adaptive Planning"]
  J["Journal Line Summaries<br/>(actuals sổ cái)"] --> DS
  DS --> ST["Staging tables<br/>(mỗi report/summary 1 bảng)"]
  ST --> L["5 Planning Loaders<br/>Level · Dimension · Attribute<br/>Account · Data"]
  L --> M["Mô hình Adaptive Planning"]
  M -.->|"drill ngược qua<br/>External System"| WD["Chứng từ gốc<br/>trong Workday"]

Trình tự dựng (tên task gốc): Create Workday Credentials → Configure Workday to Import Data (ISU + API client phía Workday) → Create Workday Data Sources → Select Workday Reports → Import Structure → Import Data → chạy loaders.

Credentials — vài quy tắc cứng

Dùng JWT Bearer Grant cho mọi credential (publish plans bắt buộc loại này); đang dùng Authorization Code thì có quy trình chuyển đổi — phải đăng ký API client mới phía Workday.
Connection Local (cặp instance đã ghép khi provisioning) mới drill và publish được; External (nối tenant Workday khác) chỉ import.
Workday khuyến nghị mỗi use-case một ISU riêng (Integration System User) — ISU import dữ liệu cần nhiều domain hơn ISU chỉ sync user.

Báo cáo nguồn — luật làm report để import được

Custom report Workday muốn làm nguồn phải đạt đủ:

Loại advanced report, bật cả Enable as Web Service và Enable for Worksheets, và share cho ISSG chứa ISU.
Không dùng calculated field (sẽ mất khả năng drill ngược), chạy dưới 20 phút, dưới 1 triệu dòng, XML alias cột duy nhất.
Ưu tiên prompt thay vì hardcode filter; sau go-live nên chuyển prompt về “kỳ đóng sổ gần nhất” để báo cáo tự chạy đúng kỳ.
Report lớn: bật RaaS (timeout lên 6 giờ) hoặc enhanced data import (bỏ giới hạn timeout) — cả hai có ràng buộc riêng: tên ISU chỉ chữ-số + underscore, không column filter, không trả loại tiền tệ (phải thêm cột Currency Type trong report).

Workday giao sẵn bộ report nền: Plan Companies/Hierarchies, Plan Dimensions/Hierarchies, Ledger Accounts or Ledger Account Summaries; làm workforce planning thì migrate thêm bộ PLN * từ tenant Customer Central.

Actuals sổ cái: Journal Line Summaries

Cách nạp actuals gọn nhất — không phải tự quản report gộp bút toán: Manage Journal Line Summaries ngay trong data source, mỗi summary thành một staging table. Chịu tải tới 5 triệu dòng bút toán mỗi kỳ; khai Amount Type Activity cho tài khoản kết quả kinh doanh, Ending balance cho tài khoản số dư (loại này phải nhờ Support bật). Sau khi refresh sandbox hoặc migrate lên production, dùng nút Repair để nối lại — khỏi dựng lại từ đầu.

Metadata: 5 loader và các luật hierarchy

Loader	Nạp gì	Luật đáng nhớ
Level	Cây tổ chức lập kế hoạch	Dùng WID làm ID; phải nạp đủ chuỗi cha–con tới đỉnh; Parent ID của đỉnh để trống; tên level không được trùng ở bất kỳ đâu
Dimension	Danh mục phân tích	Đa số nên nạp flat list, gán attribute trong AP
Attribute	Nhãn bổ sung	Import value phải khai parent column giá trị null
Account	Hệ tài khoản	Mỗi root account một staging table + một loader riêng; chỉ rename được root có sẵn, không tạo/xóa; mã tài khoản làm sạch bằng hàm `TO_ACCOUNT_CODE`
Association	Gán user ↔ level/dimension (data security từ Workday roles)	Chạy CUỐI CÙNG — sau khi mọi metadata đã nạp và đã sync user ít nhất một lần

Ghép nhiều chiều Workday thành một chiều AP (ví dụ Company + Cost Center): dùng SQL column nối WID bằng delimiter — chọn một delimiter, dùng nhất quán cho mọi data source; worktag không bắt buộc thì nối [blank] để giữ chỗ. Thứ tự nối phải khớp cấu hình trong External System, nếu không drill/publish lệch.

Drill ngược — kế hoạch soi về chứng từ

Sau khi dựng Workday External System (cùng credential Local), người dùng đứng trong sheet/báo cáo của Adaptive Planning drill thẳng về business object và giao dịch gốc bên Workday — chuỗi “con số này từ đâu” liền mạch xuyên hai hệ thống. Lưu ý: chỉ matrix và composite report phía Workday hỗ trợ làm đích drill.

Những lỗi kinh điển — nhận diện nhanh

“Subtree root nodes cannot be recognized” → hierarchy thiếu cha; phải nạp đủ cây trong cùng một loader.
“Unable to re-parent underneath a Leaf account” → tạo placeholder tạm trong AP, chạy loader, xóa placeholder.
“More than one column resolves to the same label” → hai cột trùng XML alias (alias X tự sinh X_Id/X_Label — đụng cột đặt tên kiểu đó); sửa cột mới thêm, xong phải Import Structure trước Import Data.
Không thấy object vừa nạp → sync có độ trễ; chờ 15–30 phút giữa nạp metadata và nạp data; mẹo ép sync: đổi display name hồ sơ của mình một ký tự rồi lưu.
Trùng dòng dữ liệu → khử tại nguồn (report gộp) là tốt nhất; trong AP có pattern subquery lọc duplicate nhưng nên là đường cùng.
Luôn Preview Loader Output (soi XML) và test SQL filter trên staging trước khi chạy loader thật.

Chắt lọc từ Workday Adaptive Planning Administrator Guide (mục Data Imports into Adaptive Planning) — doc.workday.com.