Hogyan integrálható a Microsoft Entra kiépítése a Workday szolgáltatással?

  • Cikk

A Microsoft Entra felhasználói kiépítési szolgáltatás integrálható a Workday HCM-sel a felhasználók identitás-életciklusának kezelése érdekében. A Microsoft Entra ID három előre összeállított integrációt kínál:

Ez a cikk bemutatja, hogyan működik az integráció, és hogyan szabhatja testre a kiépítési viselkedést a különböző HR-forgatókönyvekhez.

Kapcsolat létrehozása

A Workday API hozzáférésének korlátozása a Microsoft Entra-végpontokhoz

A Microsoft Entra kiépítési szolgáltatás alapszintű hitelesítést használ a Workday Web Services API-végpontokhoz való csatlakozáshoz.

A Microsoft Entra kiépítési szolgáltatás és a Workday közötti kapcsolat további védelme érdekében korlátozhatja a hozzáférést, hogy a kijelölt integrációs rendszer felhasználója csak az engedélyezett Microsoft Entra IP-tartományokból férhessen hozzá a Workday API-khoz. Kérje meg a Workday-rendszergazdát, hogy végezze el az alábbi konfigurációt a Workday-bérlőben.

  1. Töltse le az Azure Public Cloud legújabb IP-tartományait .
  2. Nyissa meg a fájlt, és keresse meg a Microsoft Entra-azonosító címkét
  3. Másolja ki a címelőtagok elemben felsorolt összes IP-címtartományt , és használja a tartományt az IP-címlista összeállításához.
  4. Jelentkezzen be a Workday felügyeleti portálra.
  5. Az IP-tartományok karbantartása feladat eléréséhez hozzon létre egy új IP-tartományt az Azure-adatközpontokhoz. Vesszővel elválasztott listaként adja meg az IP-tartományokat (CIDR jelöléssel).
  6. Új hitelesítési szabályzat létrehozásához lépjen a Hitelesítési házirendek kezelése feladathoz. A hitelesítési házirendben a hitelesítési engedélyezési listával adja meg a Microsoft Entra IP-tartományát és azt a biztonsági csoportot, amely az IP-tartományból engedélyezi a hozzáférést. Mentse el a módosításokat.
  7. A módosítások megerősítéséhez lépjen az Összes függőben lévő hitelesítési házirend módosítása művelethez.

A munkavégző adatokhoz való hozzáférés korlátozása a Workdayben korlátozott biztonsági csoportok használatával

A Workday integrációs rendszer felhasználójának konfigurálására vonatkozó alapértelmezett lépések hozzáférést biztosítanak a Workday-bérlő összes felhasználójának lekéréséhez. Bizonyos integrációs helyzetekben érdemes lehet korlátozni a hozzáférést. Például csak bizonyos felügyeleti szervezetek felhasználóit adja vissza az Get_Workers API-hívásból.

A hozzáférést úgy korlátozhatja, hogy a Workday-rendszergazdával dolgozik, és konfigurálja a korlátozott integrációs rendszer biztonsági csoportjait. A Workday szolgáltatással kapcsolatos további információkért lásd : Workday community (A cikkhez szükséges workday közösségi hozzáférés).

Ez a korlátozott ISSG-vel (integrációs rendszer biztonsági csoportjaival) való hozzáférés korlátozására vonatkozó stratégia a következő forgatókönyvekben hasznos:

  • Szakaszos bevezetési forgatókönyv: Nagy Workday-bérlővel rendelkezik, és tervezi a Workday fokozatos bevezetésének végrehajtását a Microsoft Entra ID-ra automatizált kiépítésre. Ebben a forgatókönyvben ahelyett, hogy kizárnánk az aktuális fázis hatókörébe nem tartozó felhasználókat a Microsoft Entra-azonosító hatókörkezelési szűrőivel, javasoljuk, hogy konfigurálja a korlátozott ISSG-t, hogy csak a hatókörön belüli feldolgozók legyenek láthatók a Microsoft Entra-azonosítóban.
  • Több kiépítési feladat forgatókönyve: Nagy Workday-bérlővel és több AD-tartománnyal rendelkezik, amelyek mindegyike egy másik üzleti egységet/részleget/vállalatot támogat. Ennek a topológiának a támogatásához több Munkanapot szeretne futtatni a Microsoft Entra kiépítési feladataihoz minden egyes feladathoz, amelyek egy adott feldolgozócsoportot építenek ki. Ebben a forgatókönyvben ahelyett, hogy a Microsoft Entra-azonosító hatókörkezelési szűrőit használnánk a feldolgozói adatok kizárására, javasoljuk, hogy konfigurálja a korlátozott ISSG-t, hogy csak a vonatkozó feldolgozói adatok láthatók maradjanak a Microsoft Entra-azonosítóban.

Workday-teszt kapcsolat lekérdezése

A Workday-kapcsolat teszteléséhez a Microsoft Entra ID a következő Get_Workers Workday Web Services-kérést küldi el.

<!-- 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>

A teljes szinkronizálás működése

A Workday-alapú kiépítés kontextusában a teljes szinkronizálás az összes identitás Workdayből való lekérésének és az egyes munkavégző objektumokra alkalmazandó kiépítési szabályok meghatározásának folyamatára utal. A teljes szinkronizálás akkor fordul elő, ha első alkalommal kapcsolja be a kiépítést, és akkor is, ha újraindítja a kiépítést a Microsoft Entra felügyeleti központból vagy a Graph API-k használatával.

A Microsoft Entra ID a következő Get_Workers Workday Web Services-kérést küldi a feldolgozói adatok lekéréséhez. A lekérdezés megkeresi a Workday tranzakciónaplót a teljes szinkronizálási futtatásnak megfelelő időponttól kezdve az összes érvényes dátummal megadott munkavégző bejegyzéshez.

<!-- 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>

A Response_Group csomópont határozza meg, hogy mely feldolgozói attribútumokat kell beolvasni a Workdayből. A Response_Group csomópont egyes jelzőinek leírását a Workday Get_Workers API dokumentációjában találja.

A Response_Group csomópontban megadott egyes jelzőértékek kiszámítása a Workday Microsoft Entra kiépítési alkalmazásban konfigurált attribútumok alapján történik. Tekintse meg a támogatott entitások szakaszát a jelzőértékek beállításához használt feltételekhez.

A fenti lekérdezésHez tartozó Workday Get_Workers válasza tartalmazza a feldolgozói rekordok számát és az oldalszámot.

  <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>

Az eredményhalmaz következő oldalának lekéréséhez a következő Get_Workers lekérdezés paraméterként adja meg az oldalszámot a 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>

A Microsoft Entra kiépítési szolgáltatás minden oldalt feldolgoz, és a teljes szinkronizálás során végigvezeti az összes hatékony feldolgozót. Minden munkavégző bejegyzéshez, amelyet a Workdayből importáltak:

  • Az XPATH kifejezés az attribútumértékek Workdayből való lekérésére lesz alkalmazva.
  • A rendszer alkalmazza az attribútumleképezést és az egyeztetési szabályokat, és
  • A szolgáltatás határozza meg, hogy milyen műveletet kell végrehajtani a célban (Microsoft Entra ID/Active Directory).

Miután a feldolgozás befejeződött, vízjelként menti a teljes szinkronizálás kezdetéhez társított időbélyeget. Ez a vízjel szolgál a növekményes szinkronizálási ciklus kiindulópontjaként.

A növekményes szinkronizálás működése

A teljes szinkronizálást követően a Microsoft Entra kiépítési szolgáltatás fenntartja és használja a növekményes LastExecutionTimestamp módosítások lekérésére irányuló delta-lekérdezések létrehozására. A növekményes szinkronizálás során a Microsoft Entra ID a következő típusú lekérdezéseket küldi el a Workdaynek:

Manuális frissítések lekérdezése

Az alábbi Get_Workers lekérdezi a legutóbbi végrehajtás és az aktuális végrehajtási idő között történt manuális frissítéseket.

<!-- 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>

Érvényes dátumú frissítések és leállítások lekérdezése

Az alábbi Get_Workers lekérdezéseket kér le a legutóbbi végrehajtás és az aktuális végrehajtási idő közötti, érvényes dátumú frissítésekről.

<!-- 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>

Jövőbeli alkalmazottak lekérdezése

Ha a fenti lekérdezések bármelyike egy jövőbeli bérbeadót ad vissza, akkor a következő Get_Workers kéréssel adatokat kérhet le egy jövőbeli új alkalmazottról. Az új alkalmazott WID attribútuma a keresés végrehajtására szolgál, a tényleges dátum pedig a felvétel dátuma és időpontja.

Feljegyzés

A Workday jövőbeli dátumú felvételeinél az Aktív mező értéke "0", és a felvétel napján "1" értékre változik. Az összekötő tervezési lekérdezéseket készít a jövőbeli munkaerő-kölcsönzési információkról, amelyek a felvétel napján érvénybe lépnek, és ezért mindig lekéri a jövőbeli alkalmazotti profilt az "1" értékre állított Aktív mezővel. Ez lehetővé teszi, hogy előre beállítsa a Microsoft Entra-profilt a jövőbeli alkalmazottak számára az előre kitöltött összes megfelelő információval. Ha késleltetni szeretné a Microsoft Entra-fiók engedélyezését a jövőbeli alkalmazottak számára, használja a DateDiff átalakítási függvényt.

<!-- 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>

Feldolgozói adatattribútumok lekérése

A Get_Workers API a feldolgozóhoz társított különböző adatkészleteket tud visszaadni. A kiépítési sémában konfigurált XPATH API-kifejezésektől függően a Microsoft Entra kiépítési szolgáltatás határozza meg, hogy mely adatkészleteket szeretné lekérni a Workdayből. Ennek megfelelően a Response_Group jelzők a Get_Workers kérelemben vannak beállítva.

A táblázat útmutatást nyújt egy adott adatkészlet lekéréséhez használandó leképezési konfigurációhoz.

# Workday-entitás Alapértelmezés szerint belefoglalva XPATH-minta, amely nem hibás entitások lekéréséhez adható meg a leképezésben
0 Personal Data Igen wd:Worker_Data/wd:Personal_Data
2 Employment Data Igen wd:Worker_Data/wd:Employment_Data
3 Additional Job Data Igen wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0]
4 Organization Data Igen wd:Worker_Data/wd:Organization_Data
5 Management Chain Data Igen wd:Worker_Data/wd:Management_Chain_Data
6 Supervisory Organization Igen SUPERVISORY
7 Company Igen COMPANY
8 Business Unit Nem BUSINESS_UNIT
9 Business Unit Hierarchy Nem BUSINESS_UNIT_HIERARCHY
10 Company Hierarchy Nem COMPANY_HIERARCHY
11 Cost Center Nem COST_CENTER
12 Cost Center Hierarchy Nem COST_CENTER_HIERARCHY
13 Fund Nem FUND
14 Fund Hierarchy Nem FUND_HIERARCHY
15 Gift Nem GIFT
16 Gift Hierarchy Nem GIFT_HIERARCHY
17 Grant Nem GRANT
18 Grant Hierarchy Nem GRANT_HIERARCHY
19 Business Site Hierarchy Nem BUSINESS_SITE_HIERARCHY
20 Matrix Organization Nem MATRIX
21 Pay Group Nem PAY_GROUP
22 Programs Nem PROGRAMS
23 Program Hierarchy Nem PROGRAM_HIERARCHY
24 Region Nem REGION_HIERARCHY
25 Location Hierarchy Nem LOCATION_HIERARCHY
26 Account Provisioning Data Nem wd:Worker_Data/wd:Account_Provisioning_Data
27 Background Check Data Nem wd:Worker_Data/wd:Background_Check_Data
28 Benefit Eligibility Data Nem wd:Worker_Data/wd:Benefit_Eligibility_Data
29 Benefit Enrollment Data Nem wd:Worker_Data/wd:Benefit_Enrollment_Data
30 Career Data Nem wd:Worker_Data/wd:Career_Data
31 Compensation Data Nem wd:Worker_Data/wd:Compensation_Data
32 Contingent Worker Tax Authority Data Nem wd:Worker_Data/wd:Contingent_Worker_Tax_Authority_Form_Type_Data
33 Development Item Data Nem wd:Worker_Data/wd:Development_Item_Data
34 Employee Contracts Data Nem wd:Worker_Data/wd:Employee_Contracts_Data
35 Employee Review Data Nem wd:Worker_Data/wd:Employee_Review_Data
36 Feedback Received Data Nem wd:Worker_Data/wd:Feedback_Received_Data
37 Worker Goal Data Nem wd:Worker_Data/wd:Worker_Goal_Data
38 Photo Data Nem wd:Worker_Data/wd:Photo_Data
39 Qualification Data Nem wd:Worker_Data/wd:Qualification_Data
40 Related Persons Data Nem wd:Worker_Data/wd:Related_Persons_Data
41 Role Data Nem wd:Worker_Data/wd:Role_Data
42 Skill Data Nem wd:Worker_Data/wd:Skill_Data
43 Succession Profile Data Nem wd:Worker_Data/wd:Succession_Profile_Data
44 Talent Assessment Data Nem wd:Worker_Data/wd:Talent_Assessment_Data
45 User Account Data Nem wd:Worker_Data/wd:User_Account_Data
46 Worker Document Data Nem wd:Worker_Data/wd:Worker_Document_Data

Feljegyzés

A táblázatban felsorolt minden Workday-entitást tartományi biztonsági szabályzat véd a Workdayben. Ha a megfelelő XPATH beállítása után nem tudja lekérni az entitáshoz társított attribútumokat, forduljon a Workday rendszergazdájához, és győződjön meg arról, hogy a megfelelő tartományi biztonsági szabályzat konfigurálva van a kiépítési alkalmazáshoz társított integrációs rendszer felhasználójához. A szakértelem adatainak lekéréséhez például hozzáférés szükséges a Workday tartomány feldolgozói adataihoz: Készségek és tapasztalat.

Íme néhány példa arra, hogyan terjesztheti ki a Workday-integrációt az adott követelményeknek való megfelelésre.

1. példa: Költséghely és fizetési csoport adatainak lekérése

Tegyük fel, hogy le szeretné kérni a következő adatkészleteket a Workdayből, és használni szeretné őket a kiépítési szabályokban:

  • Költséghely
  • Költséghely-hierarchia
  • Fizetési csoport

A fenti adatkészletek alapértelmezés szerint nem jelennek meg. Az adatkészletek lekérése:

  1. Jelentkezzen be a Microsoft Entra felügyeleti központba legalább alkalmazásként Rendszergazda istratorként.

  2. Keresse meg az Identity>Applications>Enterprise-alkalmazásokat.

  3. Válassza ki a Workday-et az Active Directory/Microsoft Entra felhasználókiépítési alkalmazásba.

  4. Válassza a Kiépítés lehetőséget.

  5. Szerkessze a leképezéseket, és nyissa meg a Workday attribútumlistát a speciális szakaszból.

  6. Adja hozzá a következő attribútumdefiníciókat, és jelölje meg őket kötelezőként. Ezek az attribútumok nincsenek leképezve az Active Directory vagy a Microsoft Entra ID egyik attribútumára sem. Jelekként szolgálnak az összekötőnek a Cost Center, a Cost Center Hierarchy és a Pay Group adatainak lekéréséhez.

    Attribútum neve XPATH API-kifejezés
    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:Leíró
    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. Miután a Cost Center és a Pay Group adatkészlet elérhető a Get_Workers válaszban, az XPATH-értékekkel lekérheti a költséghely nevét, a költséghely kódját és a fizetési csoportot.

    Attribútum neve XPATH API-kifejezés
    CostCenterName 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()
    CostCenterCode 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()
    PayGroup wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data/wd:Organization_Data[wd:Organization_Type_Reference/@wd:Descriptor='Pay Group

2. példa: Képesítési és képzettségi adatok lekérése

Tegyük fel, hogy le szeretné kérni a felhasználóhoz társított tanúsítványokat. Ez az információ a minősítési adatkészlet részeként érhető el. Ha a Get_Workers válasz részeként szeretné lekérni ezt az adatkészletet, használja a következő XPATH-t:

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

3. példa: Kiépítési csoport hozzárendeléseinek lekérése

Tegyük fel, hogy egy feldolgozóhoz rendelt kiépítési csoportokat szeretne lekérni. Ezek az információk a fiókkiépítési adatkészlet részeként érhetők el. Az adatok lekéréséhez a Get_Workers válasz részeként használja a következő XPATH-t:

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

Különböző HR-forgatókönyvek kezelése

Ez a szakasz bemutatja, hogyan szabhatja testre a kiépítési alkalmazást a következő HR-forgatókönyvekhez:

A feldolgozók átalakításának támogatása

Ez a szakasz a Microsoft Entra kiépítési szolgáltatás támogatását ismerteti azokhoz az esetekhez, amikor egy feldolgozó teljes munkaidős alkalmazottból (FTE) függő feldolgozóvá (CW) alakul át, vagy fordítva. Attól függően, hogy a munkavégzők konvertálása hogyan történik a Workdayben, különböző megvalósítási szempontokat kell figyelembe venni.

1. forgatókönyv: Háttérbeli átalakítás FTE-ről CW-re vagy fordítva

A HR-csapat érvényes üzleti okokból háttérbe hozhat egy feldolgozókonvertálási tranzakciót a Workdayben. Ilyenek például a bérszámfejtés, a költségvetés megfelelősége, a jogi követelmények és az előnyök kezelése. Az alábbi példa bemutatja, hogyan kezeli a kiépítést a forgatókönyv.

  • 2023. január 15-én van, Jane Doe pedig függő munkavállalóként dolgozik. A HR teljes munkaidős állást kínál Jane-nek.
  • Jane szerződésmódosításának feltételeihez vissza kell adni a tranzakciót, hogy az igazodjon az aktuális hónap elejéhez. A HR 2023. január 15-én kezdeményezi a háttérbeli feldolgozók konverziós tranzakcióját, amelynek érvényessége 2023. január 1. lesz. Most már két munkavégző profil van Jane-nek a Workdayben. A CW-profil inaktív, míg az FTE-profil aktív.
  • A Microsoft Entra kiépítési szolgáltatás 2023. január 15-én észleli ezt a változást a Workday tranzakciónaplójában. A szolgáltatás automatikusan kiépíti az új FTE-profil attribútumait a következő szinkronizálási ciklusban.
  • A forgatókönyv kezeléséhez nincs szükség módosításra a kiépítési alkalmazás konfigurációjában.

2. forgatókönyv: A CW/FTE-ként ma alkalmazott feldolgozó, az FTE/CW mai módosítása

Ez a forgatókönyv hasonló a fenti forgatókönyvhöz, azzal a különbségekkel, hogy a hr a tranzakció háttérbe helyezése helyett egy azonnal érvényes feldolgozó-átalakítást hajt végre. A Microsoft Entra kiépítési szolgáltatás észleli ezt a változást a Workday tranzakciónaplójában. A következő szinkronizálási ciklusban a szolgáltatás automatikusan kiépíti az aktív FTE-profillal társított attribútumokat. A forgatókönyv kezeléséhez nincs szükség módosításra a kiépítési alkalmazás konfigurációjában.

3. forgatókönyv: A CW/FTE-ként alkalmazott feldolgozó megszűnik, jelentős eltérés után újra csatlakozik FTE/CW-ként

Gyakran előfordul, hogy a munkavállalók függő munkavállalóként kezdik el a munkát egy vállalatnál, elhagyják a vállalatot, majd több hónap után teljes munkaidős alkalmazottként újra csatlakoznak. Az alábbi példa bemutatja, hogyan kezeli a kiépítést ehhez a forgatókönyvhöz.

  • 2023. január 1-jén john Smith függő munkavállalóként kezd dolgozni. Mivel nincs társítva AD-fiók a John's WorkerID -hez (egyező attribútum), a kiépítési szolgáltatás létrehoz egy új AD-fiókot, és John függő feldolgozójának WID-jét (WorkdayID) John AD-fiókjához kapcsolja.
  • John szerződése 2023. január 31-én lejár. A január 31-e után lefutott kiépítési ciklusban John AD-fiókja le van tiltva.
  • John egy másik pozíciót keres, és úgy dönt, hogy 2023. május 1-étől teljes munkaidős alkalmazottként csatlakozik a vállalathoz. A HR 2023. április 15-én adja meg John adatait őskori alkalmazottként. Most két munkavégző profil van a Workdayben John számára. A CW-profil inaktív, míg az FTE-profil aktív. A két rekord ugyanazzal a WorkerID azonosítóval rendelkezik, de eltérő WID-selrendelkezik.
  • Április 15-én a növekményes ciklus során a Microsoft Entra kiépítési szolgáltatás automatikusan átadja az AD-fiók tulajdonjogát az aktív feldolgozói profilnak. Ebben az esetben leválasztja a függő feldolgozói profilt az AD-fiókról, és új kapcsolatot hoz létre John aktív alkalmazotti profilja és John AD-fiókja között.
  • A forgatókönyv kezeléséhez nincs szükség módosításra a kiépítési alkalmazás konfigurációjában.

4. forgatókönyv: Jövőbeli konverzió, ha a feldolgozó aktív CW/FTE

Előfordulhat, hogy egy feldolgozó már aktív függő feldolgozó, amikor a HR egy jövőbeli dátumú feldolgozó-konverziós tranzakciót kezdeményez. Az alábbi példa bemutatja, hogyan kezeli a kiépítést ebben a forgatókönyvben, és milyen konfigurációs módosítások szükségesek a forgatókönyv támogatásához.

  • 2023. január 1-jén john Smith függő munkavállalóként kezd dolgozni. Mivel nincs társítva AD-fiók a John's WorkerID -hez (egyező attribútum), a kiépítési szolgáltatás létrehoz egy új AD-fiókot, és John függő feldolgozójának WID-jét (WorkdayID) John AD-fiókjához kapcsolja.

  • 2023. január 15-én a HR elindít egy tranzakciót, a 2023. február 1-jei hatállyal, hogy Johnt a függő munkavállalóból teljes munkaidős munkavállalóvá alakítsa.

  • Mivel a Microsoft Entra kiépítési szolgáltatás automatikusan feldolgozza a jövőbeli alkalmazottakat, január 15-én feldolgozza John új teljes munkaidős alkalmazotti profilját, és frissíti John profilját az AD-ben teljes munkaidős foglalkoztatási adatokkal annak ellenére, hogy továbbra is függő munkavállaló.

  • Ha szeretné elkerülni ezt a viselkedést, és biztosítani szeretné, hogy John FTE-adatai 2023. február 1-jén kiépültek legyenek, hajtsa végre a következő konfigurációs módosításokat.

    Konfigurációs módosítások

    1. Vegye fel a kapcsolatot a Workday rendszergazdájával, hogy hozzon létre egy "Jövőbeli konverziók" nevű kiépítési csoportot.
    2. Implementálja a logikát a Workdayben az alkalmazotti/függő feldolgozói rekordok hozzáadásához a kiépítési csoport későbbi dátummal rendelkező átalakításaival.
    3. Frissítse a Microsoft Entra kiépítési alkalmazást a kiépítési csoport olvasásához. A kiépítési csoport lekérésére vonatkozó utasítások itt olvashatók
    4. Hozzon létre egy hatókörszűrőt a Microsoft Entra-azonosítóban a kiépítési csoport részét képező feldolgozói profilok kizárásához.
    5. A Workdayben implementálja a logikát, hogy amikor az átalakítás dátuma érvényes, a Workday eltávolítja a megfelelő alkalmazotti/függő feldolgozói rekordot a Workday kiépítési csoportjából.
    6. Ezzel a konfigurációval a meglévő alkalmazott/függő feldolgozó rekord továbbra is érvényes marad, és a kiépítési módosítások csak az átalakítás napján történnek.

Feljegyzés

A kezdeti teljes szinkronizálás során olyan viselkedést tapasztalhat, amikor az előző inaktív feldolgozóprofilhoz társított attribútumértékek a konvertált feldolgozók AD-fiókjába kerülnek. Ez ideiglenes, és a teljes szinkronizálás előrehaladtával a rendszer végül felülírja az aktív feldolgozói profil attribútumértékeivel. Miután a teljes szinkronizálás befejeződött, és a kiépítési feladat elérte az állandó állapotot, a növekményes szinkronizálás során mindig kiválasztja az aktív feldolgozói profilt.

Nemzetközi feladat-hozzárendelések és másodlagos feladatok adatainak lekérése

Alapértelmezés szerint a Workday-összekötő lekéri a feldolgozó elsődleges feladatához társított attribútumokat. Az összekötő támogatja a nemzetközi feladat-hozzárendelésekhez vagy másodlagos feladatokhoz társított lekéréseket Additional Job Data is.

A lépéseket követve lekérheti a nemzetközi feladat-hozzárendelésekhez társított attribútumokat:

  1. Állítsa be a Workday kapcsolat URL-címét a Workday Web Service API 30.0-s vagy újabb verziójával. Ennek megfelelően állítsa be a megfelelő XPATH-értékeket a Workday kiépítési alkalmazásban.
  2. A csomópont választógombjának @wd:Primary_Job=0Worker_Job_Data használatával kérje le a megfelelő attribútumot.
    • 1. példa: A lekéréshez SecondaryBusinessTitlehasználja az XPATH-t wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0]/wd:Position_Data/wd:Business_Title/text()
    • 2. példa: A lekéréshez SecondaryBusinessLocationhasználja az XPATH-t 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

Következő lépések