Microsoft Entra sağlama, Workday ile nasıl tümleşir?
Microsoft Entra kullanıcı sağlama hizmeti, kullanıcıların kimlik yaşam döngüsünü yönetmek için Workday HCM ile tümleşir. Microsoft Entra ID, önceden oluşturulmuş üç tümleştirme sunar:
- Kullanıcı sağlamayı şirket içi Active Directory için Workday
- Workday'de Microsoft Entra kullanıcı sağlama
- Workday Geri Yazma
Bu makalede tümleştirmenin nasıl çalıştığı ve farklı İk senaryoları için sağlama davranışını nasıl özelleştirebileceğiniz açıklanmaktadır.
Bağlantı kuruluyor
Workday API erişimini Microsoft Entra uç noktalarına kısıtlama
Microsoft Entra sağlama hizmeti, Workday Web Services API uç noktalarına bağlanmak için temel kimlik doğrulamasını kullanır.
Microsoft Entra sağlama hizmeti ile Workday arasındaki bağlantıyı daha da güvenli bir şekilde sağlamak için, erişimi kısıtlayarak belirlenen tümleştirme sistemi kullanıcısının yalnızca izin verilen Microsoft Entra IP aralıklarından Workday API'lerine erişmesini sağlayabilirsiniz. Workday kiracınızda aşağıdaki yapılandırmayı tamamlamak için Workday yöneticinizle etkileşim kurun.
- Azure Genel Bulutu için en son IP Aralıklarını indirin.
- Dosyayı açın ve Microsoft Entra Id etiketini arayın
- Öğe adresiönerinde listelenen tüm IP adresi aralıklarını kopyalayın Düzeltmeler ve ip adresi listenizi oluşturmak için aralığı kullanın.
- Workday yönetici portalında oturum açın.
- Azure veri merkezleri için yeni bir IP aralığı oluşturmak için IP Aralıklarını Koru görevine erişin. IP aralıklarını (CIDR gösterimini kullanarak) virgülle ayrılmış liste olarak belirtin.
- Yeni bir kimlik doğrulama ilkesi oluşturmak için Kimlik Doğrulama İlkelerini Yönet görevine erişin. Kimlik doğrulama ilkesinde, Microsoft Entra IP aralığını ve bu IP aralığından erişime izin verilen güvenlik grubunu belirtmek için kimlik doğrulaması izin verilenler listesini kullanın. Değişiklikleri kaydedin.
- Değişiklikleri onaylamak için Tüm Bekleyen Kimlik Doğrulama İlkesi Değişikliklerini Etkinleştir görevine erişin.
Kısıtlı güvenlik gruplarını kullanarak Workday'de çalışan verilerine erişimi sınırlama
Workday tümleştirme sistemi kullanıcısını yapılandırmaya yönelik varsayılan adımlar, Workday kiracınızdaki tüm kullanıcıları almak için erişim verir. Bazı tümleştirme senaryolarında erişimi sınırlamak isteyebilirsiniz. Örneğin, API çağrısından yalnızca belirli denetleyici kuruluşlardaki kullanıcıları döndür.Get_Workers
Workday yöneticinizle birlikte çalışarak ve kısıtlanmış tümleştirme sistemi güvenlik gruplarını yapılandırarak erişimi sınırlayabilirsiniz. Workday hakkında daha fazla bilgi için bkz . Workday topluluğu (Bu makale için Workday Topluluk erişimi gerekiyor).
Kısıtlanmış ISSG (Tümleştirme Sistemi Güvenlik Grupları) kullanarak erişimi sınırlama stratejisi aşağıdaki senaryolarda yararlıdır:
- Aşamalı dağıtım senaryosu: Büyük bir Workday kiracınız var ve Workday'i Microsoft Entra ID'ye aşamalı olarak dağıtmayı otomatik sağlamayı planlıyorsunuz. Bu senaryoda, Microsoft Entra Id kapsam belirleme filtreleri ile geçerli aşama kapsamında olmayan kullanıcıları dışlamak yerine, kısıtlanmış ISSG'yi yalnızca kapsam içi çalışanların Microsoft Entra Id'ye görünür olması için yapılandırmanızı öneririz.
- Birden çok sağlama işi senaryosu: Büyük bir Workday kiracınız ve her birinin farklı bir iş birimini/bölümünü/şirketini destekleyen birden çok AD etki alanınız vardır. Bu topolojiyi desteklemek için, her iş belirli bir çalışan kümesini sağlarken Microsoft Entra sağlama işleri için birden çok Workday çalıştırmak istiyorsunuz. Bu senaryoda, çalışan verilerini dışlamak için Microsoft Entra ID kapsam filtreleri kullanmak yerine, kısıtlanmış ISSG'yi yalnızca ilgili çalışan verilerinin Microsoft Entra ID tarafından görülebilmesi için yapılandırmanızı öneririz.
Workday test bağlantı sorgusu
Workday bağlantısını test etmek için Microsoft Entra ID, Workday Web Services isteği Get_Workers aşağıdakini gönderir.
<!-- 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>
Tam eşitleme nasıl çalışır?
Workday temelli sağlama bağlamında tam eşitleme , Workday'den tüm kimlikleri getirme ve her çalışan nesnesine uygulanacak sağlama kurallarını belirleme işlemini ifade eder. Tam eşitleme, sağlamayı ilk kez açtığınızda ve ayrıca Microsoft Entra yönetim merkezinden veya Graph API'lerini kullanarak sağlamayı yeniden başlattığınızda gerçekleşir.
Microsoft Entra Id, çalışan verilerini almak için aşağıdaki Get_Workers Workday Web Services isteğini gönderir. Sorgu, tam eşitleme çalıştırmasına karşılık gelen süre itibarıyla tüm etkin tarihli çalışan girişleri için Workday işlem günlüğünü arar.
<!-- 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 düğümü, Workday'den hangi çalışan özniteliklerinin getirileceğini belirtmek için kullanılır. Response_Group düğümündeki her bayrağın açıklaması için Workday Get_Workers API belgelerine bakın.
Response_Group düğümünde belirtilen bazı bayrak değerleri, Workday Microsoft Entra sağlama uygulamasında yapılandırılan özniteliklere göre hesaplanır. Bayrak değerlerini ayarlamak için kullanılan ölçütler için Desteklenen varlıklar bölümüne bakın.
Yukarıdaki sorgu için Workday'den gelen Get_Workers yanıtı, çalışan kayıtlarının sayısını ve sayfa sayısını içerir.
<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>
Sonuç kümesinin sonraki sayfasını almak için, sonraki Get_Workers sorgusu sayfa numarasını Response_Filter parametre olarak belirtir.
<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 sağlama hizmeti her sayfayı işler ve tam eşitleme sırasında tüm etkin çalışanlar aracılığıyla yinelenir. Workday'den içeri aktarılan her çalışan girişi için:
- XPATH ifadesi Workday'den öznitelik değerlerini almak için uygulanır.
- Öznitelik eşlemesi ve eşleştirme kuralları uygulanır ve
- Hizmet, hedefte hangi işlemin gerçekleştirileceğini belirler (Microsoft Entra Id / Active Directory).
İşlem tamamlandıktan sonra, tam eşitlemenin başlamasıyla ilişkili zaman damgasını filigran olarak kaydeder. Bu filigran, artımlı eşitleme döngüsü için başlangıç noktası görevi görür.
Artımlı eşitleme nasıl çalışır?
Tam eşitlemeden sonra, Microsoft Entra sağlama hizmeti bunu tutar LastExecutionTimestamp ve artımlı değişiklikleri almak üzere delta sorguları oluşturmak için kullanır. Artımlı eşitleme sırasında, Microsoft Entra Id Workday'e aşağıdaki sorgu türlerini gönderir:
- El ile güncelleştirmeleri sorgulama
- Geçerli tarihli güncelleştirmeleri ve sonlandırmaları sorgulama
- Gelecekteki tarihli işe alımları sorgulama
El ile güncelleştirmeleri sorgulama
Aşağıdaki Get_Workers , son yürütme ve geçerli yürütme süresi arasında gerçekleşen el ile güncelleştirmeleri sorgular.
<!-- 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>
Geçerli tarihli güncelleştirmeleri ve sonlandırmaları sorgulama
Aşağıdaki Get_Workers , son yürütme ve geçerli yürütme zamanı arasında gerçekleşen etkin tarihli güncelleştirmeler için sorgular iste.
<!-- 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>
Gelecekteki tarihli işe alımları sorgulama
Yukarıdaki sorgulardan herhangi biri gelecekteki tarihli bir işe alım döndürürse, gelecekteki yeni bir işe alma hakkında bilgi getirmek için aşağıdaki Get_Workers isteği kullanılır. Yeni işe alma işleminin WID özniteliği aramayı gerçekleştirmek için kullanılır ve geçerlilik tarihi işe alma tarihi ve saati olarak ayarlanır.
Not
Workday'deki gelecekteki tarihli işe alımlar Etkin alanı "0" olarak ayarlanmıştır ve işe alma tarihinde "1" olarak değişir. Bağlayıcı, işe alım tarihinde geçerli olan gelecekteki işe alma bilgilerini sorgular ve bu nedenle her zaman etkin alanı "1" olarak ayarlanmış gelecekteki işe alma Çalışanı profilini alır. Bu, önceden doldurulmuş tüm doğru bilgilerle gelecekteki işe alımlar için Microsoft Entra profilini önceden ayarlamanıza olanak tanır. Microsoft Entra hesabının gelecekteki işe alımlar için etkinleştirilmesini geciktirmek isterseniz DateDiff dönüştürme işlevini kullanın.
<!-- 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>
Çalışan veri özniteliklerini alma
Get_Workers API'sinde çalışanla ilişkili farklı veri kümeleri döndürülebilir. Sağlama şemasında yapılandırılan XPATH API ifadelerine bağlı olarak, Microsoft Entra sağlama hizmeti Workday'den alınacak veri kümelerini belirler. Buna göre, Response_Group bayrakları Get_Workers isteğinde ayarlanır.
Tablo, belirli bir veri kümesini almak için kullanılacak eşleme yapılandırması hakkında rehberlik sağlar.
| # | Workday Varlığı | Varsayılan olarak dahil | Bilinmeyen varlıkları getirmek için eşlemede belirtilmesi gereken XPATH deseni |
|---|---|---|---|
| 1 | Personal Data |
Yes | wd:Worker_Data/wd:Personal_Data |
| 2 | Employment Data |
Yes | wd:Worker_Data/wd:Employment_Data |
| 3 | Additional Job Data |
Yes | wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0] |
| 4 | Organization Data |
Yes | wd:Worker_Data/wd:Organization_Data |
| 5 | Management Chain Data |
Yes | wd:Worker_Data/wd:Management_Chain_Data |
| 6 | Supervisory Organization |
Yes | SUPERVISORY |
| 7 | Company |
Yes | COMPANY |
| 8 | Business Unit |
Hayır | BUSINESS_UNIT |
| 9 | Business Unit Hierarchy |
Hayır | BUSINESS_UNIT_HIERARCHY |
| 10 | Company Hierarchy |
Hayır | COMPANY_HIERARCHY |
| 11 | Cost Center |
Hayır | COST_CENTER |
| 12 | Cost Center Hierarchy |
Hayır | COST_CENTER_HIERARCHY |
| 13 | Fund |
Hayır | FUND |
| 14 | Fund Hierarchy |
Hayır | FUND_HIERARCHY |
| 15 | Gift |
Hayır | GIFT |
| 16 | Gift Hierarchy |
Hayır | GIFT_HIERARCHY |
| 17 | Grant |
Hayır | GRANT |
| 18 | Grant Hierarchy |
Hayır | GRANT_HIERARCHY |
| 19 | Business Site Hierarchy |
Hayır | BUSINESS_SITE_HIERARCHY |
| 20 | Matrix Organization |
Hayır | MATRIX |
| 21 | Pay Group |
Hayır | PAY_GROUP |
| 22 | Programs |
Hayır | PROGRAMS |
| 23 | Program Hierarchy |
Hayır | PROGRAM_HIERARCHY |
| 24 | Region |
Hayır | REGION_HIERARCHY |
| 25 | Location Hierarchy |
Hayır | LOCATION_HIERARCHY |
| 26 | Account Provisioning Data |
Hayır | wd:Worker_Data/wd:Account_Provisioning_Data |
| 27 | Background Check Data |
Hayır | wd:Worker_Data/wd:Background_Check_Data |
| 28 | Benefit Eligibility Data |
Hayır | wd:Worker_Data/wd:Benefit_Eligibility_Data |
| 29 | Benefit Enrollment Data |
Hayır | wd:Worker_Data/wd:Benefit_Enrollment_Data |
| 30 | Career Data |
Hayır | wd:Worker_Data/wd:Career_Data |
| 31 | Compensation Data |
Hayır | wd:Worker_Data/wd:Compensation_Data |
| 32 | Contingent Worker Tax Authority Data |
Hayır | wd:Worker_Data/wd:Contingent_Worker_Tax_Authority_Form_Type_Data |
| 33 | Development Item Data |
Hayır | wd:Worker_Data/wd:Development_Item_Data |
| 34 | Employee Contracts Data |
Hayır | wd:Worker_Data/wd:Employee_Contracts_Data |
| 35 | Employee Review Data |
Hayır | wd:Worker_Data/wd:Employee_Review_Data |
| 36 | Feedback Received Data |
Hayır | wd:Worker_Data/wd:Feedback_Received_Data |
| 37 | Worker Goal Data |
Hayır | wd:Worker_Data/wd:Worker_Goal_Data |
| 38 | Photo Data |
Hayır | wd:Worker_Data/wd:Photo_Data |
| 39 | Qualification Data |
Hayır | wd:Worker_Data/wd:Qualification_Data |
| 40 | Related Persons Data |
Hayır | wd:Worker_Data/wd:Related_Persons_Data |
| 41 | Role Data |
Hayır | wd:Worker_Data/wd:Role_Data |
| 42 | Skill Data |
Hayır | wd:Worker_Data/wd:Skill_Data |
| 43 | Succession Profile Data |
Hayır | wd:Worker_Data/wd:Succession_Profile_Data |
| 44 | Talent Assessment Data |
Hayır | wd:Worker_Data/wd:Talent_Assessment_Data |
| 45 | User Account Data |
Hayır | wd:Worker_Data/wd:User_Account_Data |
| 46 | Worker Document Data |
Hayır | wd:Worker_Data/wd:Worker_Document_Data |
Not
Tabloda listelenen her Workday varlığı, Workday'de bir Etki Alanı Güvenlik İlkesi tarafından korunur. Doğru XPATH'i ayarladıktan sonra varlıkla ilişkili öznitelikleri alamıyorsanız, Workday yöneticinize başvurarak sağlama uygulamasıyla ilişkili tümleştirme sistemi kullanıcısı için uygun etki alanı güvenlik ilkesinin yapılandırıldığından emin olun. Örneğin, Beceri verilerini almak için Workday etki alanı Çalışan Verileri: Beceriler ve Deneyim'de Erişim al gereklidir.
Belirli gereksinimleri karşılamak için Workday tümleştirmesini nasıl genişletebileceğinize ilişkin bazı örnekler aşağıda verilmiştir.
Örnek 1: Maliyet merkezi ve ödeme grubu bilgilerini alma
Workday'den aşağıdaki veri kümelerini almak ve bunları sağlama kurallarınızda kullanmak istediğinizi varsayalım:
- Maliyet merkezi
- Maliyet merkezi hiyerarşisi
- Ödeme grubu
Yukarıdaki veri kümeleri varsayılan olarak dahil değildir. Bu veri kümelerini almak için:
Microsoft Entra yönetim merkezinde en az Uygulama Yönetici istrator olarak oturum açın.
Kimlik>Uygulamaları>Kurumsal uygulamaları'na göz atın.
Workday to Active Directory / Microsoft Entra kullanıcı sağlama uygulamanızı seçin.
Sağlama'ya tıklayın.
Eşlemeleri düzenleyin ve gelişmiş bölümden Workday öznitelik listesini açın.
Aşağıdaki öznitelik tanımlarını ekleyin ve "Gerekli" olarak işaretleyin. Bu öznitelikler Active Directory veya Microsoft Entra Id içindeki hiçbir öznitelikle eşlenmez. Maliyet Merkezi, Maliyet Merkezi Hiyerarşisi ve Ödeme Grubu bilgilerini almak için bağlayıcıya sinyal görevi görür.
Öznitelik Adı XPATH API ifadesi 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:Tanımlayıcı 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() Maliyet Merkezi ve Ödeme Grubu veri kümesi Get_Workers yanıtında kullanılabilir olduğunda, maliyet merkezi adını, maliyet merkezi kodunu ve ödeme grubunu almak için XPATH değerlerini kullanabilirsiniz.
Öznitelik Adı XPATH API ifadesi CostCenterName wd:Worker/wd:Worker_Data/wd:Organization_Data/wd:Worker_Organization_Data/wd:Organization_Data[wd:Organization_Type_Reference/@wd:Descriptor='Maliyet Merkezi']/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='Maliyet Merkezi']/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']/wd:Organization_Name/text()
Örnek 2: Nitelik ve beceri verilerini alma
Bir kullanıcıyla ilişkili sertifikaları almak istediğinizi varsayalım. Bu bilgiler, Nitelik Verileri kümesinin bir parçası olarak sağlanır. Bu veri kümesini Get_Workers yanıtının bir parçası olarak almak için aşağıdaki XPATH'i kullanın:
wd:Worker/wd:Worker_Data/wd:Qualification_Data/wd:Certification/wd:Certification_Data/wd:Issuer/text()
Örnek 3: Sağlama grubu atamalarını alma
Bir çalışana atanan Sağlama Gruplarını almak istediğinizi varsayalım. Bu bilgiler, Hesap Sağlama Verileri kümesinin bir parçası olarak kullanılabilir. Bu verileri almak için Get_Workers yanıtının bir parçası olarak aşağıdaki XPATH'i kullanın:
wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned']/wd:Provisioning_Group/text()
Farklı İk senaryolarını işleme
Bu bölüm, aşağıdaki İk senaryoları için sağlama uygulamasını nasıl özelleştirebileceğinizi kapsar:
Çalışan dönüştürmeleri desteği
Bu bölümde, bir çalışanın tam zamanlı çalışandan (FTE) bağlı çalışana (CW) (CW) dönüştürdüğü senaryolar için Microsoft Entra sağlama hizmeti desteği açıklanmaktadır. Çalışan dönüştürmelerinin Workday'de nasıl işlendiğine bağlı olarak, dikkate alınması gereken farklı uygulama yönleri olabilir.
- Senaryo 1: FTE'den CW'ye veya tersine geri alınmış dönüştürme
- Senaryo 2: Bugün CW/FTE olarak çalışan çalışan, bugün FTE/CW olarak değişiyor
- Senaryo 3: CW/FTE olarak çalışan çalışan sonlandırılır, önemli bir boşluktan sonra FTE/CW olarak yeniden katılır
- Senaryo 4: Çalışan etkin bir CW/FTE olduğunda gelecekteki tarihli dönüştürme
Senaryo 1: FTE'den CW'ye veya tersine geri alınmış dönüştürme
İk ekibiniz geçerli iş nedenleriyle Workday'de çalışan dönüştürme işlemini geri alabilir. Örnek olarak bordro işleme, bütçe uyumluluğu, yasal gereksinimler ve avantaj yönetimi verilebilir. Aşağıda, sağlamanın senaryo için nasıl işleneceğini gösteren bir örnek verilmiştir.
- 15 Ocak 2023'de Jane Doe bir çalışan olarak çalışıyor. İk, Jane'e tam zamanlı bir pozisyon sunar.
- Jane'in sözleşme değişikliği koşulları, işlemin geçerli ayın başlangıcıyla uyumlu olması için yedeklenmiş olmasını gerektirir. İk, 15 Ocak 2023'te geçerlilik tarihi 1 Ocak 2023 olan bir yedeklenmiş çalışan dönüştürme işlemi başlatır. Artık Workday'de Jane için iki çalışan profili var. CW profili etkin değilken, FTE profili etkindir.
- Microsoft Entra sağlama hizmeti bu değişikliği 15 Ocak 2023'teki Workday işlem günlüğünde algılar. Hizmet, sonraki eşitleme döngüsünde yeni FTE profilinin özniteliklerini otomatik olarak sağlar.
- Bu senaryoyu işlemek için sağlama uygulaması yapılandırmasında değişiklik yapılması gerekmez.
Senaryo 2: Bugün CW/FTE olarak çalışan çalışan, bugün FTE/CW olarak değişiyor
Bu senaryo yukarıdaki senaryoya benzer, ancak hr işlemi yedeklemek yerine hemen etkili bir çalışan dönüştürmesi gerçekleştirir. Microsoft Entra sağlama hizmeti bu değişikliği Workday işlem günlüğünde algılar. Sonraki eşitleme döngüsünde hizmet, etkin bir FTE profiliyle ilişkili tüm öznitelikleri otomatik olarak sağlar. Bu senaryoyu işlemek için sağlama uygulaması yapılandırmasında değişiklik yapılması gerekmez.
Senaryo 3: CW/FTE olarak çalışan çalışan sonlandırılır, önemli bir boşluktan sonra FTE/CW olarak yeniden katılır
Çalışanların bir şirkette çalışan olarak çalışmaya başlaması, şirketten ayrılması ve birkaç ay sonra tam zamanlı çalışan olarak yeniden katılması yaygın bir durumdur. Bu senaryo için sağlamanın nasıl işleneceğini gösteren bir örnek aşağıda verilmiştir.
- 1 Ocak 2023'te John Smith bir çalışan olarak çalışmaya başladı. John's WorkerID (eşleşen öznitelik) ile ilişkilendirilmiş bir AD hesabı olmadığından, sağlama hizmeti yeni bir AD hesabı oluşturur ve John'un bağlı çalışan WID'sini (WorkdayID) John'un AD hesabına bağlar.
- John'un sözleşmesi 31 Ocak 2023'te sona eriyor. 31 Ocak'ın sonundan sonra çalışan sağlama döngüsünde John'un AD hesabı devre dışı bırakılır.
- John başka bir pozisyon için başvurur ve 1 Mayıs 2023 tarihinden itibaren tam zamanlı çalışan olarak şirkete yeniden katılmaya karar verir. İk, John'un bilgilerini 15 Nisan 2023'te bir şirket öncesi çalışanı olarak girer. Artık Workday'de John için iki çalışan profili var. CW profili etkin değilken, FTE profili etkindir. İki kayıt aynı WorkerID'ye ancak farklı WID'leresahiptir.
- 15 Nisan'da, artımlı döngü sırasında Microsoft Entra sağlama hizmeti AD hesabının sahipliğini otomatik olarak etkin çalışan profiline aktarır. Bu durumda, bağlı çalışan profilinin AD hesabıyla bağlantısını kaldırır ve John'un etkin çalışan çalışanı profili ile John'un AD hesabı arasında yeni bir bağlantı oluşturur.
- Bu senaryoyu işlemek için sağlama uygulaması yapılandırmasında değişiklik yapılması gerekmez.
Senaryo 4: Çalışan etkin bir CW/FTE olduğunda gelecekteki tarihli dönüştürme
Bazen, İk geleceğe dönük bir çalışan dönüştürme işlemi başlattığında, bir çalışan zaten etkin bir çalışan olabilir. Bu senaryo için sağlamanın nasıl işleneceğini ve bu senaryo için hangi yapılandırma değişikliklerinin gerekli olduğunu gösteren bir örnek aşağıda verilmiştir.
1 Ocak 2023'te John Smith bir çalışan olarak çalışmaya başladı. John's WorkerID (eşleşen öznitelik) ile ilişkilendirilmiş bir AD hesabı olmadığından, sağlama hizmeti yeni bir AD hesabı oluşturur ve John'un bağlı çalışan WID'sini (WorkdayID) John'un AD hesabına bağlar.
15 Ocak'ta İk, John'un 1 Şubat 2023'ten itibaren geçerli olan bir çalışandan tam zamanlı çalışana dönüştürülmesi için bir işlem başlatır.
Microsoft Entra sağlama hizmeti, gelecekteki işe alımları otomatik olarak işlediğinden, John'un yeni tam zamanlı çalışan profilini 15 Ocak'ta işler ve hala bir bağlı çalışan olmasına rağmen John'un AD'deki profilini tam zamanlı çalışma ayrıntılarıyla güncelleştirir.
Bu davranışı önlemek ve John'un FTE ayrıntılarının 1 Şubat 2023'te sağlanmasını sağlamak için aşağıdaki yapılandırma değişikliklerini gerçekleştirin.
Yapılandırma değişiklikleri
- Workday yöneticinizle etkileşim kurarak "Gelecek tarihli dönüşümler" adlı bir sağlama grubu oluşturun.
- Workday'de mantığı uygulayarak bu sağlama grubuna gelecekteki tarihli dönüştürmelerle çalışan/birlik olan çalışan kayıtlarını ekleyin.
- Bu sağlama grubunu okumak için Microsoft Entra sağlama uygulamasını güncelleştirin. Sağlama grubunu alma yönergelerine buradan bakın
- Bu sağlama grubunun parçası olan çalışan profillerini dışlamak için Microsoft Entra Id'de bir kapsam filtresi oluşturun.
- Workday'de, dönüştürme tarihi geçerli olduğunda Workday'in workday'deki sağlama grubundan ilgili çalışan/şirket çalışanı kaydını kaldırması için mantığı uygulayın.
- Bu yapılandırmayla, mevcut çalışan/bağlı çalışan kaydı etkin olmaya devam eder ve sağlama değişiklikleri yalnızca dönüştürme gününde gerçekleşir.
Not
İlk tam eşitleme sırasında, önceki etkin olmayan çalışan profiliyle ilişkili öznitelik değerlerinin dönüştürülmüş çalışanların AD hesabına aktığı bir davranışla karşılaşabilirsiniz. Bu geçicidir ve tam eşitleme ilerledikçe, sonunda etkin çalışan profilindeki öznitelik değerleri tarafından üzerine yazılır. Tam eşitleme tamamlandıktan ve sağlama işi kararlı duruma ulaştığında, artımlı eşitleme sırasında her zaman etkin çalışan profilini seçer.
Uluslararası iş atamalarını ve ikincil iş ayrıntılarını alma
Varsayılan olarak, Workday bağlayıcısı çalışanın birincil işiyle ilişkili öznitelikleri alır. Bağlayıcı, uluslararası iş atamalarıyla veya ikincil işlerle ilişkili alma Additional Job Data işlemini de destekler.
Uluslararası iş atamalarıyla ilişkili öznitelikleri almak için adımları kullanın:
- Workday bağlantı URL'sinin Workday Web Hizmeti API'si sürüm 30.0 veya üzerini kullandığını ayarlayın. Buna göre Workday sağlama uygulamanızda doğru XPATH değerlerini ayarlayın.
- Doğru özniteliği almak için düğümdeki
Worker_Job_Dataseçiciyi@wd:Primary_Job=0kullanın.- Örnek 1: almak
SecondaryBusinessTitleiçin XPATH kullanınwd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Worker_Job_Data[@wd:Primary_Job=0]/wd:Position_Data/wd:Business_Title/text() - Örnek 2: almak
SecondaryBusinessLocationiçin XPATH kullanınwd: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
- Örnek 1: almak