Hogyan integrálható a Microsoft Entra kiépítése a Workday szolgáltatással?
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:
- Workday –helyi Active Directory felhasználókiépítés
- Workday to Microsoft Entra user provisioning
- Workday Visszaírás
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.
- Töltse le az Azure Public Cloud legújabb IP-tartományait .
- Nyissa meg a fájlt, és keresse meg a címkét
AzureActiveDirectory
. - 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.
- Jelentkezzen be a Workday felügyeleti portálra.
- 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).
- Ú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 a módosításokat.
- 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. További információkért tekintse át Get_Workers környezetfüggő biztonságot ebben a Workday-dokumentum koncepciójában: Get Workers SOAP Web Service Guidelines (Workday Community access required for this article).
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
- Érvényes dátumú frissítések és leállítások lekérdezése
- Jövőbeli alkalmazottak lekérdezése
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.
Jegyzet
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 |
---|---|---|---|
1 | 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 |
Jegyzet
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:
Jelentkezzen be a Microsoft Entra felügyeleti központba legalább alkalmazásadminisztrátorként.
Keresse meg az Identity>Applications>Enterprise-alkalmazásokat.
Válassza ki a Workday-et az Active Directory/Microsoft Entra felhasználókiépítési alkalmazásba.
Válassza a Kiépítés lehetőséget.
Szerkessze a leképezéseket, és nyissa meg a Workday attribútumlistát a speciális szakaszból.
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() 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
- Nemzetközi feladat-hozzárendelések és másodlagos feladatok adatainak lekérése
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
- 2. forgatókönyv: A CW/FTE-ként ma alkalmazott feldolgozó, az FTE/CW mai módosítása
- 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
- 4. forgatókönyv: Jövőbeli konverzió, ha a feldolgozó aktív CW/FTE
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
- 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.
- 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.
- 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
- 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.
- 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.
- 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.
Jegyzet
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:
- Á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.
- A csomópont választógombjának
@wd:Primary_Job=0
Worker_Job_Data
használatával kérje le a megfelelő attribútumot.- 1. példa: A lekéréshez
SecondaryBusinessTitle
használja az XPATH-twd: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
SecondaryBusinessLocation
használja az XPATH-twd: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
- 1. példa: A lekéréshez
Ismert korlátozások
Ez a szakasz azokat az aktuális, ismert korlátozásokat sorolja fel, amelyek az ügyfelek számára a Workday-integráció során merülhetnek fel.
- Az összekötő nem támogatja a Workday számított mezőinek lekérését.
- Az összekötő nem támogatja a Fényképek szinkronizálását a Workdayből.
- Az összekötő nem támogatja azoknak a dolgozóknak a speciális lekérését, akiknek az utolsó munkanapja esedékes.
- A növekményes szinkronizálás során előfordulhat, hogy a felmondási esemény feldolgozása késik az Ázsiai-csendes-óceáni régióban és Ausztráliában/Új-Zélandon található munkavállalók esetében.