Microsoft Entra 佈建如何與 Workday 整合

Microsoft Entra 使用者布建服務 與 Workday HCM 整合，以管理使用者的身分識別生命週期。 Microsoft Entra ID 提供三個預先建置的整合：

• Workday 至內部部署 Active Directory 使用者布建
• Workday to Microsoft Entra 使用者布建
• Workday 回寫

本文說明整合的運作方式，以及如何針對不同的 HR 案例自訂佈建行為。

建立連線

限制 Workday API 對 Microsoft Entra 端點的存取

Microsoft Entra 佈建服務會使用基本驗證，連線至 Workday Web 服務 API 端點。

若要進一步保護 Microsoft Entra 佈建服務與 Workday 之間的連線，您可以限制存取，讓指定的整合系統使用者只能從允許的 Microsoft Entra IP 範圍存取 Workday API。 請與您的 Workday 系統管理員連絡，在您的 Workday 租用戶中完成下列設定。

1. 下載 Azure 公用雲端 的最新 IP 範圍 。
2. 開啟檔案並搜尋標籤 AzureActiveDirectory。
3. 複製元素 addressPrefixes 內所列的所有 IP 位址範圍，並使用範圍來建置您的 IP 位址清單。
4. 登入 Workday 系統管理入口網站。
5. 存取 [維護 IP 範圍] 工作，為 Azure 資料中心建立新的 IP 範圍。 以逗點分隔清單，指定該 IP 範圍 (使用 CIDR 標記法)。
6. 存取 [管理驗證原則] 工作，建立新的驗證原則。 在驗證原則中，使用驗證允許清單來指定 Microsoft Entra IP 範圍，以及允許從此 IP 範圍內存取的安全性群組。 儲存變更。
7. 存取 [啟用所有擱置中的驗證原則變更] 工作，確認變更。

使用受限制的安全性群組，限制存取 Workday 中的員工資料

設定 Workday 整合系統用戶 的預設步驟會授與存取權，以擷取 Workday 租使用者中的所有使用者。 在某些整合案例中，您可能會想要限制存取。 例如，只從 Get_Workers API 呼叫傳回特定監督組織中的使用者。

您可以使用 Workday 管理員和設定限制整合系統安全性群組來限制存取權。 如需詳細資訊，請檢閱本 Workday 檔概念： 取得背景工作 SOAP Web 服務指導方針 （本文所需的 Workday 社群存取權）一節Get_Workers內容相關安全性一節。

使用受限制的 ISSG (整合系統安全性群組) 來限制存取的這項策略，在下列案例中相當實用：

• 階段式推出案例：您有大型 Workday 租使用者，並計劃執行分階段推出 Workday 以Microsoft Entra ID 自動化布建。 在此案例中，建議您設定受限制的 ISSG，讓 Microsoft Entra ID 只能看見範圍內的員工，而非使用 Microsoft Entra ID 範圍篩選器排除不在目前階段範圍內的使用者。
• 多個布建作業案例：您有大型 Workday 租使用者和多個 AD 網域，每個網域都支援不同的業務單位/部門/公司。 若要支援此拓撲，您想要執行多個 Workday 來進行 Microsoft Entra 佈建作業，每個作業都會佈建一組特定的員工。 在此案例中，建議您設定受限制的 ISSG，讓 Microsoft Entra ID 只能看見相關的員工資料，而非使用 Microsoft Entra ID 範圍篩選器排除員工資料。

Workday 測試連線查詢

若要測試 Workday 的連線能力，Microsoft Entra 標識符會傳送下列 Get_Workers Workday Web 服務要求。

<!-- Test connection query tries to retrieve one record from the first page -->
<!-- Replace version with Workday Web Services version present in your connection URL -->
<!-- Replace timestamps with the UTC time corresponding to the test connection event -->
<Get_Workers_Request p1:version="v21.1" xmlns:p1="urn:com.workday/bsvc" xmlns="urn:com.workday/bsvc">
  <p1:Request_Criteria>
    <p1:Transaction_Log_Criteria_Data>
      <p1:Transaction_Date_Range_Data>
        <p1:Updated_From>2021-01-19T02:28:50.1491022Z</p1:Updated_From>
        <p1:Updated_Through>2021-01-19T02:28:50.1491022Z</p1:Updated_Through>
      </p1:Transaction_Date_Range_Data>
    </p1:Transaction_Log_Criteria_Data>
    <p1:Exclude_Employees>true</p1:Exclude_Employees>
    <p1:Exclude_Contingent_Workers>true</p1:Exclude_Contingent_Workers>
    <p1:Exclude_Inactive_Workers>true</p1:Exclude_Inactive_Workers>
  </p1:Request_Criteria>
  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-01-19T02:28:50.1491022Z</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-01-19T02:28:50.1491022Z</p1:As_Of_Entry_DateTime>
    <p1:Page>1</p1:Page>
    <p1:Count>1</p1:Count>
  </p1:Response_Filter>
  <p1:Response_Group>
    <p1:Include_Reference>1</p1:Include_Reference>
    <p1:Include_Personal_Information>1</p1:Include_Personal_Information>
  </p1:Response_Group>
</Get_Workers_Request>

完整同步處理的運作方式

Workday 驅動布建內容中的完整同步處理是指從 Workday 擷取所有身分識別的程式，並判斷要套用至每個背景工作角色物件的布建規則。 當您第一次開啟布建，以及從 Microsoft Entra 系統管理中心或使用 Graph API 重新啟動 布建時，就會發生完整同步處理。

Microsoft Entra 標識符會傳送下列 Get_Workers Workday Web 服務要求來擷取背景工作數據。 該查詢會查詢 Workday 交易記錄中，在截至相對應於執行完整同步處理的時間之前，所有日期有效的員工項目。

<!-- Workday full sync query -->
<!-- Replace version with Workday Web Services version present in your connection URL -->
<!-- Replace timestamps with the UTC time corresponding to full sync run -->
<!-- Count specifies the number of records to return in each page -->
<!-- Response_Group flags derived from provisioning attribute mapping -->

<Get_Workers_Request p1:version="v21.1" xmlns:p1="urn:com.workday/bsvc" xmlns="urn:com.workday/bsvc">
  <p1:Request_Criteria>
    <p1:Transaction_Log_Criteria_Data>
      <p1:Transaction_Type_References>
        <p1:Transaction_Type_Reference>
          <p1:ID p1:type="Business_Process_Type">Hire Employee</p1:ID>
        </p1:Transaction_Type_Reference>
        <p1:Transaction_Type_Reference>
          <p1:ID p1:type="Business_Process_Type">Contract Contingent Worker</p1:ID>
        </p1:Transaction_Type_Reference>
      </p1:Transaction_Type_References>
    </p1:Transaction_Log_Criteria_Data>
  </p1:Request_Criteria>
  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-01-19T02:29:16.0094202Z</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-01-19T02:29:16.0094202Z</p1:As_Of_Entry_DateTime>
    <p1:Count>30</p1:Count>
  </p1:Response_Filter>
  <p1:Response_Group>
    <p1:Include_Reference>1</p1:Include_Reference>
    <p1:Include_Personal_Information>1</p1:Include_Personal_Information>
    <p1:Include_Employment_Information>1</p1:Include_Employment_Information>
    <p1:Include_Organizations>1</p1:Include_Organizations>
    <p1:Exclude_Organization_Support_Role_Data>1</p1:Exclude_Organization_Support_Role_Data>
    <p1:Exclude_Location_Hierarchies>1</p1:Exclude_Location_Hierarchies>
    <p1:Exclude_Cost_Center_Hierarchies>1</p1:Exclude_Cost_Center_Hierarchies>
    <p1:Exclude_Company_Hierarchies>1</p1:Exclude_Company_Hierarchies>
    <p1:Exclude_Matrix_Organizations>1</p1:Exclude_Matrix_Organizations>
    <p1:Exclude_Pay_Groups>1</p1:Exclude_Pay_Groups>
    <p1:Exclude_Regions>1</p1:Exclude_Regions>
    <p1:Exclude_Region_Hierarchies>1</p1:Exclude_Region_Hierarchies>
    <p1:Exclude_Funds>1</p1:Exclude_Funds>
    <p1:Exclude_Fund_Hierarchies>1</p1:Exclude_Fund_Hierarchies>
    <p1:Exclude_Grants>1</p1:Exclude_Grants>
    <p1:Exclude_Grant_Hierarchies>1</p1:Exclude_Grant_Hierarchies>
    <p1:Exclude_Business_Units>1</p1:Exclude_Business_Units>
    <p1:Exclude_Business_Unit_Hierarchies>1</p1:Exclude_Business_Unit_Hierarchies>
    <p1:Exclude_Programs>1</p1:Exclude_Programs>
    <p1:Exclude_Program_Hierarchies>1</p1:Exclude_Program_Hierarchies>
    <p1:Exclude_Gifts>1</p1:Exclude_Gifts>
    <p1:Exclude_Gift_Hierarchies>1</p1:Exclude_Gift_Hierarchies>
    <p1:Include_Management_Chain_Data>1</p1:Include_Management_Chain_Data>
    <p1:Include_Transaction_Log_Data>1</p1:Include_Transaction_Log_Data>
    <p1:Include_Additional_Jobs>1</p1:Include_Additional_Jobs>
  </p1:Response_Group>
</Get_Workers_Request>

Response_Group節點可用來指定要從 Workday 擷取的背景工作屬性。 如需 Response_Group 節點中每個旗標的描述，請參閱 Workday Get_Workers API 檔。

Response_Group 節點中指定的特定旗標值是根據 Workday Microsoft Entra 布建應用程式中設定的屬性來計算。 如需用來設定旗標值的準則，請參閱 支持的實體 一節。

上述查詢的 Workday 回應 Get_Workers 包含背景工作記錄和頁面計數的數目。

  <wd:Response_Results>
    <wd:Total_Results>509</wd:Total_Results>
    <wd:Total_Pages>17</wd:Total_Pages>
    <wd:Page_Results>30</wd:Page_Results>
    <wd:Page>1</wd:Page>
  </wd:Response_Results>

若要擷取結果集的下一頁，下一個 Get_Workers 查詢會將頁碼指定為 Response_Filter中的參數。

  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-01-19T02:29:16.0094202Z</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-01-19T02:29:16.0094202Z</p1:As_Of_Entry_DateTime>
    <p1:Page>2</p1:Page>
    <p1:Count>30</p1:Count>
  </p1:Response_Filter>

Microsoft Entra 佈建服務會處理每個頁面，並在完整同步處理期間逐一查看所有有效的員工。針對從 Workday 匯入的每個員工項目：

• XPATH 表達式會套用至從 Workday 擷取屬性值。
• 套用屬性對應與比對規則，同時
• 服務會決定目標中要執行的作業 (Microsoft Entra ID / Active Directory)。

處理完成之後，該服務會將與完整同步處理的開始相關聯的時間戳記，儲存為浮水印。 此浮水印可作為增量同步處理週期的起始點。

增量同步處理的運作方式

完成完整同步處理之後，Microsoft Entra 佈建服務會保有 LastExecutionTimestamp，並將其用於建立差異查詢，以擷取增量變更。 在累加同步處理期間，Microsoft Entra ID 會將下列類型的查詢傳送至 Workday：

• 查詢手動更新
• 查詢有效日期的更新和終止
• 查詢未來日期的雇用人員

查詢手動更新

下列 Get_Workers 要求查詢上次執行與目前運行時間之間發生的手動更新。

<!-- Workday incremental sync query for manual updates -->
<!-- Replace version with Workday Web Services version present in your connection URL -->
<!-- Replace timestamps with the UTC time corresponding to last execution and current execution time -->
<!-- Count specifies the number of records to return in each page -->
<!-- Response_Group flags derived from provisioning attribute mapping -->

<Get_Workers_Request p1:version="v21.1" xmlns:p1="urn:com.workday/bsvc" xmlns="urn:com.workday/bsvc">
  <p1:Request_Criteria>
    <p1:Transaction_Log_Criteria_Data>
      <p1:Transaction_Date_Range_Data>
        <p1:Updated_From>2021-01-19T02:29:16.0094202Z</p1:Updated_From>
        <p1:Updated_Through>2021-01-19T02:49:06.290136Z</p1:Updated_Through>
      </p1:Transaction_Date_Range_Data>
    </p1:Transaction_Log_Criteria_Data>
  </p1:Request_Criteria>
  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-01-19T02:49:06.290136Z</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-01-19T02:49:06.290136Z</p1:As_Of_Entry_DateTime>
    <p1:Count>30</p1:Count>
  </p1:Response_Filter>
  <p1:Response_Group>
    <p1:Include_Reference>1</p1:Include_Reference>
    <p1:Include_Personal_Information>1</p1:Include_Personal_Information>
    <p1:Include_Employment_Information>1</p1:Include_Employment_Information>
    <p1:Include_Organizations>1</p1:Include_Organizations>
    <p1:Exclude_Organization_Support_Role_Data>1</p1:Exclude_Organization_Support_Role_Data>
    <p1:Exclude_Location_Hierarchies>1</p1:Exclude_Location_Hierarchies>
    <p1:Exclude_Cost_Center_Hierarchies>1</p1:Exclude_Cost_Center_Hierarchies>
    <p1:Exclude_Company_Hierarchies>1</p1:Exclude_Company_Hierarchies>
    <p1:Exclude_Matrix_Organizations>1</p1:Exclude_Matrix_Organizations>
    <p1:Exclude_Pay_Groups>1</p1:Exclude_Pay_Groups>
    <p1:Exclude_Regions>1</p1:Exclude_Regions>
    <p1:Exclude_Region_Hierarchies>1</p1:Exclude_Region_Hierarchies>
    <p1:Exclude_Funds>1</p1:Exclude_Funds>
    <p1:Exclude_Fund_Hierarchies>1</p1:Exclude_Fund_Hierarchies>
    <p1:Exclude_Grants>1</p1:Exclude_Grants>
    <p1:Exclude_Grant_Hierarchies>1</p1:Exclude_Grant_Hierarchies>
    <p1:Exclude_Business_Units>1</p1:Exclude_Business_Units>
    <p1:Exclude_Business_Unit_Hierarchies>1</p1:Exclude_Business_Unit_Hierarchies>
    <p1:Exclude_Programs>1</p1:Exclude_Programs>
    <p1:Exclude_Program_Hierarchies>1</p1:Exclude_Program_Hierarchies>
    <p1:Exclude_Gifts>1</p1:Exclude_Gifts>
    <p1:Exclude_Gift_Hierarchies>1</p1:Exclude_Gift_Hierarchies>
    <p1:Include_Management_Chain_Data>1</p1:Include_Management_Chain_Data>
    <p1:Include_Additional_Jobs>1</p1:Include_Additional_Jobs>
  </p1:Response_Group>
</Get_Workers_Request>

查詢有效日期更新與終止

下列 Get_Workers 要求查詢上次執行與目前運行時間之間發生的有效日期更新。

<!-- Workday incremental sync query for effective-dated updates -->
<!-- Replace version with Workday Web Services version present in your connection URL -->
<!-- Replace timestamps with the UTC time corresponding to last execution and current execution time -->
<!-- Count specifies the number of records to return in each page -->
<!-- Response_Group flags derived from provisioning attribute mapping -->

<Get_Workers_Request p1:version="v21.1" xmlns:p1="urn:com.workday/bsvc" xmlns="urn:com.workday/bsvc">
  <p1:Request_Criteria>
    <p1:Transaction_Log_Criteria_Data>
      <p1:Transaction_Date_Range_Data>
        <p1:Effective_From>2021-01-19T02:29:16.0094202Z</p1:Effective_From>
        <p1:Effective_Through>2021-01-19T02:49:06.290136Z</p1:Effective_Through>
      </p1:Transaction_Date_Range_Data>
    </p1:Transaction_Log_Criteria_Data>
  </p1:Request_Criteria>
  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-01-19T02:49:06.290136Z</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-01-19T02:49:06.290136Z</p1:As_Of_Entry_DateTime>
    <p1:Page>1</p1:Page>
    <p1:Count>30</p1:Count>
  </p1:Response_Filter>
  <p1:Response_Group>
    <p1:Include_Reference>1</p1:Include_Reference>
    <p1:Include_Personal_Information>1</p1:Include_Personal_Information>
    <p1:Include_Employment_Information>1</p1:Include_Employment_Information>
    <p1:Include_Organizations>1</p1:Include_Organizations>
    <p1:Exclude_Organization_Support_Role_Data>1</p1:Exclude_Organization_Support_Role_Data>
    <p1:Exclude_Location_Hierarchies>1</p1:Exclude_Location_Hierarchies>
    <p1:Exclude_Cost_Center_Hierarchies>1</p1:Exclude_Cost_Center_Hierarchies>
    <p1:Exclude_Company_Hierarchies>1</p1:Exclude_Company_Hierarchies>
    <p1:Exclude_Matrix_Organizations>1</p1:Exclude_Matrix_Organizations>
    <p1:Exclude_Pay_Groups>1</p1:Exclude_Pay_Groups>
    <p1:Exclude_Regions>1</p1:Exclude_Regions>
    <p1:Exclude_Region_Hierarchies>1</p1:Exclude_Region_Hierarchies>
    <p1:Exclude_Funds>1</p1:Exclude_Funds>
    <p1:Exclude_Fund_Hierarchies>1</p1:Exclude_Fund_Hierarchies>
    <p1:Exclude_Grants>1</p1:Exclude_Grants>
    <p1:Exclude_Grant_Hierarchies>1</p1:Exclude_Grant_Hierarchies>
    <p1:Exclude_Business_Units>1</p1:Exclude_Business_Units>
    <p1:Exclude_Business_Unit_Hierarchies>1</p1:Exclude_Business_Unit_Hierarchies>
    <p1:Exclude_Programs>1</p1:Exclude_Programs>
    <p1:Exclude_Program_Hierarchies>1</p1:Exclude_Program_Hierarchies>
    <p1:Exclude_Gifts>1</p1:Exclude_Gifts>
    <p1:Exclude_Gift_Hierarchies>1</p1:Exclude_Gift_Hierarchies>
    <p1:Include_Management_Chain_Data>1</p1:Include_Management_Chain_Data>
    <p1:Include_Additional_Jobs>1</p1:Include_Additional_Jobs>
  </p1:Response_Group>
</Get_Workers_Request>

查詢未來就職的員工

如果上述任何查詢傳回未來日期的僱用，則會使用下列 Get_Workers 要求來擷取未來日期新進員工的相關信息。 新進員工的 WID 屬性可用來執行查閱，而有效日期會設定為雇用的日期和時間。

<!-- Workday incremental sync query to get new hire data effective as on hire date/first day of work -->
<!-- Replace version with Workday Web Services version present in your connection URL -->
<!-- Replace timestamps hire date/first day of work -->
<!-- Count specifies the number of records to return in each page -->
<!-- Response_Group flags derived from provisioning attribute mapping -->

<Get_Workers_Request p1:version="v21.1" xmlns:p1="urn:com.workday/bsvc" xmlns="urn:com.workday/bsvc">
  <p1:Request_References>
    <p1:Worker_Reference>
      <p1:ID p1:type="WID">7bf6322f1ea101fd0b4433077f09cb04</p1:ID>
    </p1:Worker_Reference>
  </p1:Request_References>
  <p1:Response_Filter>
    <p1:As_Of_Effective_Date>2021-02-01T08:00:00+00:00</p1:As_Of_Effective_Date>
    <p1:As_Of_Entry_DateTime>2021-02-01T08:00:00+00:00</p1:As_Of_Entry_DateTime>
    <p1:Count>30</p1:Count>
  </p1:Response_Filter>
  <p1:Response_Group>
    <p1:Include_Reference>1</p1:Include_Reference>
    <p1:Include_Personal_Information>1</p1:Include_Personal_Information>
    <p1:Include_Employment_Information>1</p1:Include_Employment_Information>
    <p1:Include_Organizations>1</p1:Include_Organizations>
    <p1:Exclude_Organization_Support_Role_Data>1</p1:Exclude_Organization_Support_Role_Data>
    <p1:Exclude_Location_Hierarchies>1</p1:Exclude_Location_Hierarchies>
    <p1:Exclude_Cost_Center_Hierarchies>1</p1:Exclude_Cost_Center_Hierarchies>
    <p1:Exclude_Company_Hierarchies>1</p1:Exclude_Company_Hierarchies>
    <p1:Exclude_Matrix_Organizations>1</p1:Exclude_Matrix_Organizations>
    <p1:Exclude_Pay_Groups>1</p1:Exclude_Pay_Groups>
    <p1:Exclude_Regions>1</p1:Exclude_Regions>
    <p1:Exclude_Region_Hierarchies>1</p1:Exclude_Region_Hierarchies>
    <p1:Exclude_Funds>1</p1:Exclude_Funds>
    <p1:Exclude_Fund_Hierarchies>1</p1:Exclude_Fund_Hierarchies>
    <p1:Exclude_Grants>1</p1:Exclude_Grants>
    <p1:Exclude_Grant_Hierarchies>1</p1:Exclude_Grant_Hierarchies>
    <p1:Exclude_Business_Units>1</p1:Exclude_Business_Units>
    <p1:Exclude_Business_Unit_Hierarchies>1</p1:Exclude_Business_Unit_Hierarchies>
    <p1:Exclude_Programs>1</p1:Exclude_Programs>
    <p1:Exclude_Program_Hierarchies>1</p1:Exclude_Program_Hierarchies>
    <p1:Exclude_Gifts>1</p1:Exclude_Gifts>
    <p1:Exclude_Gift_Hierarchies>1</p1:Exclude_Gift_Hierarchies>
    <p1:Include_Management_Chain_Data>1</p1:Include_Management_Chain_Data>
    <p1:Include_Additional_Jobs>1</p1:Include_Additional_Jobs>
  </p1:Response_Group>
</Get_Workers_Request>

擷取員工資料屬性

Get_Workers API 可以傳回與背景工作角色相關聯的不同數據集。 根據布建架構中所設定的 XPATH API 運算式 ，Microsoft Entra 布建服務會決定要從 Workday 擷取的數據集。 因此， Response_Group 旗標是在 Get_Workers 要求中設定。

下表提供用來擷取特定資料集的對應組態的指引。

以下是一些範例，說明如何擴充 Workday 整合以符合特定需求。

範例 1：擷取成本中心與付費群組資訊

假設您想要從 Workday 擷取下列資料集，並在您的佈建規則中使用這些資料集：

• 成本中心
• 成本中心階層
• 付費群組

根據預設，不會包括上述資料集。 若要擷取這些資料集：

1. 以至少應用程式管理員身分登入 Microsoft Entra 系統管理中心。

2. 流覽至 Entra ID>Enterprise 應用程式。

3. 選取您的 Workday 至 Active Directory /Microsoft Entra 使用者佈建應用程式。

4. 選取 [佈建]

5. 編輯對應，然後從進階區段開啟 Workday 屬性清單。

6. 新增下列屬性定義，並將其標記為「必要」。 這些屬性不會對應至 Active Directory 或 Microsoft Entra ID 中的任何屬性。 它們的作用是通知連接器擷取成本中心、成本中心階層與付費群組資訊。

   屬性名稱	XPATH API 運算式
   CostCenterHierarchyFlag	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data[wd：Organization_Data/wd：Organization_Type_Reference/wd：ID[@wd：type='Organization_Type_ID']='COST_CENTER_HIERARCHY']/wd：Organization_Reference/@wd：Descriptor
   CostCenterFlag	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data[wd：Organization_Data/wd：Organization_Type_Reference/wd：ID[@wd：type='Organization_Type_ID']='COST_CENTER']/wd：Organization_Data/wd：Organization_Code/text（）
   PayGroupFlag	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data[wd：Organization_Data/wd：Organization_Type_Reference/wd：ID[@wd：type='Organization_Type_ID']='PAY_GROUP']/wd：Organization_Data/wd：Organization_Reference_ID/text（）

7. 在 Get_Workers 回應中提供成本中心和支付群組數據集之後，您可以使用 XPATH 值來擷取成本中心名稱、成本中心代碼和付款群組。

   屬性名稱	XPATH API 運算式
   成本中心名稱	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data/wd：Organization_Data[wd：Organization_Type_Reference/@wd：Descriptor='Cost Center']/wd：Organization_Name/text（）
   成本中心代碼	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data/wd：Organization_Data[wd：Organization_Type_Reference/@wd：Descriptor='Cost Center']/wd：Organization_Code/text（）
   支付組	wd：Worker/wd：Worker_Data/wd：Organization_Data/wd：Worker_Organization_Data/wd：Organization_Data[wd：Organization_Type_Reference/@wd：Descriptor='Pay Group']/wd：Organization_Name/text（）

範例 2：擷取資格與技能資料

假設您想要擷取與使用者相關聯的認證。 這項資訊是 限定性數據集 的一部分。 若要取得此數據集作為 Get_Workers 回應的一部分，請使用下列 XPATH：

wd:Worker/wd:Worker_Data/wd:Qualification_Data/wd:Certification/wd:Certification_Data/wd:Issuer/text()

範例 3：擷取佈建群組指派

假設您想要擷取指派給背景工作角色的 布建群組 。 這項資訊是 帳戶布建數據集 的一部分。 若要取得此數據，作為 Get_Workers 回應的一部分，請使用下列 XPATH：

wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned']/wd:Provisioning_Group/text()

處理不同的 HR 案例

本節說明如何針對下列 HR 案例自訂佈建應用程式：

• 支援背景工作角色轉換
• 擷取國際作業指派和次要作業詳細數據

支援員工轉換

本節描述 Microsoft Entra 佈建服務支援，用於將員工角色從全職員工 (FTE) 轉換為臨時工 (CW)(反之亦然) 的案例。 根據 Workday 中處理工作者角色轉換的方式，可能會有不同的實作層面需要考慮。

• 案例 1：從 FTE 到 CW 的備份轉換，反之亦然
• 案例 2：今天雇用為 CW/FTE 的工人，今天對 FTE/CW 的變更
• 案例 3：僱用為 CW/FTE 的背景工作人員終止，在大幅差距后重新加入 FTE/CW
• 案例 4：背景工作角色為使用中 CW/FTE 時的未來日期轉換

案例 1：從 FTE 到 CW (反之亦然) 的過去日期轉換

您的 HR 小組可能會基於有效的商務原因，追溯 Workday 中的員工轉換異動。 範例包括薪資處理、預算合規性、法律要求和權益管理。 以下是說明如何針對此案例處理佈建的範例。

• 今天是 2023 年 1 月 15 日，Jane Doe 被聘為一名臨時工。 HR 為 Jane 提供一個全職職位。
• Jane 合約變更的條款需要回溯異動，使其與當月的開頭一致。 HR 在 2023 年 1 月 15 日啟動回溯的員工轉換異動，生效日期為 2023 年 1 月 1 日。 現在 Jane 在 Workday 中有兩個工作者設定檔。 CW 設定檔為非使用中，而 FTE 設定檔為使用中。
• Microsoft Entra 佈建服務會在 2023 年 1 月 15 日的 Workday 變更檔中偵測到此變更。 該服務會在下一個同步週期中自動佈建新 FTE 設定檔的屬性。
• 佈建應用程式組態不需要變更即可處理此案例。

案例 2：今天雇用為 CW/FTE 的員工，今天對 FTE/CW 的變更

此案例類似於上述案例，不同之處在於 HR 會執行立即生效的工作者角色轉換，而不是回溯異動。 Microsoft Entra 佈建服務會在 Workday 變更檔中偵測到此變更。 在下一個同步處理週期中，服務會自動使用有效的 FTE 設定檔來佈建任何關聯的屬性。 佈建應用程式組態不需要變更即可處理此案例。

案例 3：已將雇用為 CW/FTE 的工作者角色解雇，該員工在經過很長一段間隔之後以 FTE/CW 的角色重新加入

員工通常會以臨時工作者身分在公司開始工作、離開公司，然後在數個月之後重新加入為全職員工。 以下是說明如何針對此案例處理佈建的範例。

• 今天是 2023 年 1 月 1 日，John Smith 會以臨時工的身分開始工作。 由於沒有任何 AD 帳戶與 John 的 WorkerID （比對屬性）相關聯，布建服務會建立新的 AD 帳戶，並將 John 的隊伍背景工作 WID （WorkdayID） 連結到 John 的 AD 帳戶。
• John 的合約將於 2023 年 1 月 31 日結束。 在 1 月 31 日結束時執行的佈建週期中，John 的 AD 帳戶會停用。
• John 應徵另一個職位，並決定以全職員工身分重新加入公司，合約將於 2023 年 5 月 1 日生效。 HR 在 2023 年 4 月 15 日以預先雇用員工的身分輸入 John 的資訊。 現在 John 在 Workday 中有兩個工作者設定檔。 CW 設定檔為非使用中，而 FTE 設定檔為使用中。 這兩筆記錄具有相同 的 WorkerID ，但不同的 WID。
• 在 4 月 15 日，在累加週期期間，Microsoft Entra 佈建服務會自動將 AD 帳戶的擁有權轉移給作用中的員工設定檔。 在此情況下，它會取消與 AD 帳戶臨時工設定檔的連結，並建立 John 作用中員工設定檔與 John AD 帳戶之間的新連結。
• 佈建應用程式組態不需要變更即可處理此案例。

案例 4：當工作者角色為作用中 CW/FTE 時，未來日期轉換

有時候，當 HR 起始未來日期的工作者轉換異動時，工作者角色可能已經是作用中工作者。 以下是說明如何針對此案例處理佈建的範例。

• 今天是 2023 年 1 月 1 日，John Smith 會以臨時工的身分開始工作。 由於沒有任何 AD 帳戶與 John 的 WorkerID （比對屬性）相關聯，布建服務會建立新的 AD 帳戶，並將 John 的隊伍背景工作 WID （WorkdayID） 連結到 John 的 AD 帳戶。

• 1 月 15 日，HR 啟動將 John 從臨時工轉換為全職員工的異動，生效日期為 2023 年 2 月 1 日。

• 由於 Microsoft Entra 佈建服務會自動處理未來日期的僱用，因此它會在 1 月 15 日處理 John 的新全職員工設定檔，並以全職雇用詳細資料更新 John 的設定檔，即使他仍然是一名臨時工。

• 若要避免此行為，並確保會在 2023 年 2 月 1 日佈建 John 的 FTE 詳細資料，請執行下列組態變更。

  組態變更

  1. 請洽詢您的 Workday 系統管理員，以建立稱為「未來日期轉換」的佈建群組。
  2. 在 Workday 中實作邏輯，將具有未來日期轉換的員工/員工記錄新增至此佈建群組。
  3. 更新 Microsoft Entra 佈建應用程式以讀取此佈建群組。 請參閱此處有關如何擷取布建群組的指示
  4. 在 Microsoft Entra ID 中建立 範圍篩選 條件，以排除屬於此布建群組一部分的背景工作配置檔。
  5. 在 Workday 中，實作邏輯，使得 Workday 在轉換生效的日期會從 Workday 中的佈建群組中移除相關的員工/臨時工作者記錄。
  6. 使用此設定時，現有的員工/臨時工記錄將繼續有效，而且佈建變更只會在轉換當天發生。

擷取國際作業指派與次要作業詳細資料

根據預設，Workday 連接器會擷取與員工主要工作相關聯的屬性。 該連接器也支援擷取與國際工作指派或次要工作相關聯的 Additional Job Data。

使用以下步驟來擷取與國際工作指派相關聯的屬性：

1. 將 Workday 連線 URL 設定為使用 Workday Web 服務 API 30.0 版或更新版本。 因此，在您的 Workday 布建應用程式中設定 正確的 XPATH 值 。
2. 使用 @wd:Primary_Job=0 節點上的選取器 Worker_Job_Data，擷取正確的屬性。
   • 範例 1： 若要取得 SecondaryBusinessTitle，請使用 XPATH wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0]/wd:Position_Data/wd:Business_Title/text()
   • 範例 2： 若要取得 SecondaryBusinessLocation，請使用 XPATH wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0]/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Location_Reference/@wd:Descriptor

已知的限制

本節列出客戶在 Workday 整合中可能會遇到的當前已知限制。

1. 連接器不支援 擷取 Workday 匯出字段。
2. 連接器不支援同步 Workday 中的相片。
3. 連接器不支援 進階擷取工作最後一天到期的員工。
4. 在累加同步處理期間，可能會 延遲處理 位於亞太地區和澳大利亞/紐西蘭區域之背景工作角色的終止事件。

下一步

• 瞭解如何設定 Workday 至 Active Directory 布建
• 瞭解如何設定回寫至 Workday
• 深入了解支援的 Workday 屬性以進行輸入布建