Microsoft Entra Id'den SAP SuccessFactors'a öznitelik geri yazma özelliğini yapılandırma

Bu makalenin amacı, Microsoft Entra Id'den SAP SuccessFactors Employee Central'a öznitelikleri geri yazma adımlarını göstermektir.

Genel bakış

SAP SuccessFactors Geri Yazma uygulamasını, Microsoft Entra Id'den SAP SuccessFactors Employee Central'a belirli öznitelikler yazacak şekilde yapılandırabilirsiniz. SuccessFactors geri yazma sağlama uygulaması, aşağıdaki Employee Central özniteliklerine değer atamayı destekler:

• İş E-postası
• Kullanıcı adı
• İş telefonu numarası (ülke kodu, alan kodu, numara ve uzantı dahil)
• İş telefonu numarasının birincil işareti
• Cep telefonu numarası (ülke kodu, alan kodu, numara dahil)
• Cep telefonu birincil bayrağı
• Kullanıcı özelleştirilebilir01-custom15 öznitelikleri
• loginMethod özniteliği

Not

Bu uygulamanın SuccessFactors gelen kullanıcı sağlama tümleştirme uygulamalarına bağımlılığı yoktur. Bunu, SuccessFactors’tan şirket içi AD sağlama uygulamasına veya SuccessFactors’tan Microsoft Entra ID sağlama uygulamasına bağımsız olarak yapılandırabilirsiniz.

Desteklenen senaryolar, bilinen sorunlar ve sınırlamalar hakkında daha fazla ayrıntı için SAP SuccessFactors tümleştirme başvuru kılavuzunun Geri Yazma senaryoları bölümüne bakın.

Bu kullanıcı sağlama çözümü kimin için en uygun?

Bu SuccessFactors Geri Yazma kullanıcı sağlama çözümü aşağıdakiler için idealdir:

• MICROSOFT 365 kullanan ve BT tarafından yönetilen yetkili öznitelikleri (e-posta adresi, telefon, kullanıcı adı gibi) successFactors Employee Central'a geri yazma isteğinde olan kuruluşlar.

SuccessFactors'ı entegrasyon için yapılandırma

Tüm SuccessFactors sağlama bağlayıcıları, Employee Central OData API'lerini çağırmak için doğru izinlere sahip bir SuccessFactors hesabının kimlik bilgilerini gerektirir. Bu bölümde SuccessFactors içinde hizmet hesabı oluşturma ve uygun izinler verme adımları açıklanmaktadır.

• SuccessFactors'ta API kullanıcı hesabı oluşturma/tanımlama
• API izinleri rolü oluşturma
• API kullanıcısı için İzin Grubu oluşturma
• İzin Grubuna İzin Rolü Tanımla

SuccessFactors'ta API kullanıcı hesabı oluşturma/tanımlama

OData API'lerini çağırmak için SuccessFactors'ta bir kullanıcı hesabı oluşturmak veya tanımlamak için SuccessFactors yönetici ekibinizle veya uygulama iş ortağınızla birlikte çalışın. Microsoft Entra Id'de sağlama uygulamaları yapılandırılırken bu hesabın kullanıcı adı ve parola kimlik bilgileri gereklidir.

API izinleri rolü oluşturma

1. Yönetim Merkezi'ne erişimi olan bir kullanıcı hesabıyla SAP SuccessFactors'ta oturum açın.

2. İzin Rollerini Yönet'i arayın, ardından arama sonuçlarından İzin Rollerini Yönet'i seçin.

   

3. Rol İzin Listesi'nden Yeni Oluşturseçin.

   

4. Yeni izin rolü için bir Rol Adı ve Açıklama ekleyin. Ad ve açıklama, rolün API kullanım izinlerine yönelik olduğunu göstermelidir.

5. İzin Ayarları altında İzin...seçin, ardından izin listesini aşağı kaydırın ve Tümleştirme Araçlarını Yönetseçin. Yöneticinin Temel Kimlik Doğrulaması aracılığıyla OData API'sine Erişmesine İzin Ver kutusunu işaretleyin.

   

6. Aynı kutuda aşağı kaydırın ve Çalışan Merkezi API'sini seçin. ODATA API'sini kullanarak okumak ve ODATA API'sini kullanarak düzenlemek için aşağıda gösterildiği gibi izinleri ekleyin. SuccessFactors senaryosunda aynı hesabı kullanmayı planlıyorsanız, geri yazma işlemi için düzenleme seçeneğini seçin.

   

7. Seç. Bitti. seçin, değişiklikleri kaydet.

API kullanıcısı için İzin Grubu oluşturma

1. SuccessFactors Yönetim Merkezi'nde İzin Gruplarını Yönet'i arayın ve arama sonuçlarından İzin Gruplarını Yönet'i seçin.

   

2. İzin Gruplarını Yönet penceresinden YeniOluştur'u seçin.

   

3. Yeni grup için bir Grup Adı ekleyin. Grup adı, grubun API kullanıcıları için olduğunu göstermelidir.

   

4. Gruba üye ekleyin. Örneğin, Kişi Havuzu açılan menüsünden Kullanıcı Adı'i seçebilir ve ardından tümleştirme için kullanılan API hesabının kullanıcı adını girebilirsiniz.

   

5. İzin Grubunu oluşturmayı bitirmek için Bitti seçin.

İzin Grubuna İzin Rolü Ver

1. SuccessFactors Yönetim Merkezi'nde İzin Rollerini Yönet'i arayın ve arama sonuçlarından İzin Rollerini Yönet'i seçin.
2. İzin Rolü Listesi'nden API kullanım izinleri için oluşturduğunuz rolü seçin.
3. Bu rolü...ver seçeneğinde, Ekle... Düğmesini seçin.
4. Açılan menüden İzin Grubu... seçin, ardından Seç...'ı seçerek yukarıda oluşturulan grubu aramak ve seçmek için Gruplar penceresini açın.
5. İzin Grubuna İzin Rolü verme işlemini gözden geçirin.
6. seçin, değişiklikleri kaydet.

SuccessFactors Geri Yazma İşlemi için Hazırlık

SuccessFactors Geri Yazma sağlama uygulaması, Employee Central'da e-posta ve telefon numaralarını ayarlamak için belirli kod değerlerini kullanır. Bu kod değerleri öznitelik eşleme tablosunda sabit değerler olarak ayarlanır ve her SuccessFactors örneği için farklıdır. Bu bölümde bu kod değerlerini yakalama adımları sağlanır.

Not

Bu bölümdeki adımları tamamlamak için lütfen SuccessFactors Yöneticinizi dahil edin.

E-posta ve Telefon Numarası seçim listesi adlarını belirleme

SAP SuccessFactors'ta seçim listesi, kullanıcının seçim yapabilmesi için yapılandırılabilir bir seçenek kümesidir. Farklı e-posta ve telefon numarası türleri (iş, kişisel ve diğer) bir seçim listesi kullanılarak temsil edilir. Bu adımda, SuccessFactors kiracınızda e-posta ve telefon numarası değerlerini depolamak için yapılandırılan seçim listelerini belirleriz.

1. SuccessFactors Yönetim Merkezi'nde İş yapılandırmasını yönet aramasını yapın.

   

2. HRIS Öğelerialtında, emailInfo seçin ve e-posta türü alanı için Detaylar seçeneğini seçin.

   

3. E-posta türü ayrıntıları sayfasında, bu alanla ilişkilendirilmiş seçim listesinin adını not edin. Varsayılan olarak ecEmailType. Ancak kiracınızda farklı olabilir.

   

4. HRIS Öğelerialtında phoneInfo seçin ve telefon türü alanı için Ayrıntıları seçin.

   

5. Telefon türü ayrıntıları sayfasında, bu alanla ilişkilendirilmiş seçim listesinin adını not edin. Varsayılan olarak ecPhoneType. Ancak kiracınızda farklı olabilir.

   

emailType için sabit değer alma

1. SuccessFactors Yönetim Merkezi'nde Seçim Listesi Merkezi'ni arayın ve açın.

2. E-posta seçim listesini bulmak için önceki bölümden yakalanan e-posta seçim listesinin adını (ecEmailType gibi) kullanın.

   

3. Etkin e-posta seçim listesini açın.

   

4. E-posta türü seçim listesi sayfasında İş e-posta türü'nü seçin.

   

5. İşletme e-postasıyla ilişkili Opsiyon Kimliği'ni not edin. Bu, öznitelik eşleme tablosunda emailType ile kullandığımız koddur.

   

   Not

   Değerin üzerine kopyaladığınızda virgül karakterini bırakın. Örneğin, Seçenek Kimliği değeri 8.448 ise, Microsoft Entra Id içindeki emailType değerini 8448 sabit numarasına (virgül karakteri olmadan) ayarlayın.

phoneType için sabit değeri alma

1. SuccessFactors Yönetim Merkezi'nde Seçim Listesi Merkezi'ni arayın ve açın.

2. Telefon seçim listesini bulmak için önceki bölümdeki telefon seçim listesi adını kullanın.

   

3. Etkin telefon seçim listesini açın.

   

4. Telefon türü seçim listesi sayfasında, Seçim Listesi Değerleri altında listelenen farklı telefon türlerini gözden geçirin.

   

5. Bu iş telefonu ile ilişkili Seçenek Kimliğini not edin. Bu, öznitelik eşleme tablosundaki businessPhoneType ile kullandığımız koddur.

   

6. Cep telefonuyla ilişkili olan Seçenek Kimliğini not edin. Bu, öznitelik eşleme tablosundaki cellPhoneType ile kullandığımız koddur.

   

   Not

   Değerin üzerine kopyaladığınızda virgül karakterini bırakın. Örneğin, Seçenek Kimliği değeri 10.606 ise, Microsoft Entra ID içinde cellPhoneType öğesini 10606 sabit numarasına (virgül karakteri olmadan) ayarlayın.

SuccessFactors Geri Yazma Uygulamasını Yapılandırma

Bu bölümde aşağıdakiler için adımlar sağlanır:

• Sağlama bağlayıcısı uygulamasını ekleme ve SuccessFactors bağlantısını yapılandırma
• Öznitelik eşlemelerini yapılandırma
• Kullanıcı sağlamayı etkinleştirme ve başlatma

1. Bölüm: Sağlama bağlayıcısı uygulamasını ekleme ve SuccessFactors bağlantısını yapılandırma

SuccessFactors Geri Yazma yapılandırma:

1. Microsoft Entra yönetim merkezinde en az bir Bulut Uygulama Yöneticisi olarak oturum açın.

2. Entra ID>Kurumsal uygulamalar>Yeni uygulama'ya göz atın.

3. SuccessFactors Writeback arayın ve bu uygulamayı galeriden ekleyin.

4. Uygulama eklendikten ve uygulama ayrıntıları ekranı gösterildikten sonra Sağlama'yı seçin

5. Sağlama Modu'nuOtomatik olarak değiştir

6. Yönetici Kimlik Bilgileri bölümünü aşağıdaki gibi tamamlayın:

   • Yönetici Kullanıcı Adı – SuccessFactors API kullanıcı hesabının kullanıcı adını, şirket kimliği eklenmiş olarak girin. Şu biçime sahiptir: username@companyID

   • Yönetici parolası – SuccessFactors API kullanıcı hesabının parolasını girin.

   • Kiracı URL'si – SuccessFactors OData API hizmetleri uç noktasının adını girin. Sunucunun ana bilgisayar adını yalnızca http veya https olmadan girin. Bu değer şöyle görünmelidir: api4.successfactors.com.

   • Bildirim E-postası – E-posta adresinizi girin ve "hata oluşursa e-posta gönder" onay kutusunu işaretleyin.

   Not

   Microsoft Entra sağlama hizmeti, sağlama işi karantina durumuna geçerse e-posta bildirimi gönderir.

   • Bağlantıyı Test Et düğmesini seçin. Bağlantı testi başarılı olursa üstteki Kaydet düğmesini seçin. Başarısız olursa SuccessFactors kimlik bilgilerinin ve URL'sinin geçerli olup olmadığını bir kez daha denetleyin.

   • Kimlik bilgileri başarıyla kaydedildikten sonra Eşlemeler bölümünde varsayılan eşleme görüntülenir. Öznitelik eşlemeleri görünmüyorsa sayfayı yenileyin.

Bölüm 2: Öznitelik eşlemelerini yapılandırma

Bu bölümde, kullanıcı verilerinin SuccessFactors'tan Active Directory'ye nasıl aktığını yapılandıracaksınız.

1. Eşlemeleraltında, Sağlama sekmesinde Microsoft Entra kullanıcılarını sağlaseçeneğini seçin.

2. Kaynak Nesne Kapsamı alanında, bir dizi öznitelik tabanlı filtre tanımlayarak Microsoft Entra Id'deki hangi kullanıcı kümelerinin geri yazma için dikkate alınması gerektiğini seçebilirsiniz. Varsayılan kapsam, Microsoft Entra Id içindeki tüm kullanıcılardır.

   İpucu

   Sağlama uygulamasını ilk kez yapılandırırken, istediğiniz sonucu sağladığından emin olmak için öznitelik eşlemelerinizi ve ifadelerinizi test edip doğrulamanız gerekir. Microsoft, Microsoft Entra ID'den birkaç test kullanıcısı ile eşlemelerinizi test etmek için Kaynak Nesne Kapsamı altındaki kapsam filtrelerini kullanmanızı önerir. Eşlemelerin çalıştığını doğruladıktan sonra filtreyi kaldırabilir veya daha fazla kullanıcı içerecek şekilde kademeli olarak genişletebilirsiniz.

3. Hedef Nesne Eylemleri alanı yalnızca Güncelleştirme işlemini destekler.

4. Öznitelik eşlemeleri bölümündeki eşleme tablosunda, aşağıdaki Microsoft Entra özniteliklerini SuccessFactors ile eşleyebilirsiniz. Aşağıdaki tabloda, geri yazma özniteliklerini eşleme hakkında yönergeler sağlanmaktadır.

   #	Microsoft Entra özniteliği	SuccessFactors Özniteliği	Açıklamalar
   1	çalışan kimliği	kişiIdDışsal	Varsayılan olarak, bu öznitelik eşleşen tanımlayıcıdır. employeeId yerine, SuccessFactors içinde personIdExternal değerine eşit değeri depolayan başka bir Microsoft Entra özniteliği kullanabilirsiniz.
   2	e-posta	e-posta	E-posta öznitelik kaynağını eşleyin. Test amacıyla userPrincipalName öğesini e-postayla eşleyebilirsiniz.
   3	8448	emailTürü	Bu sabit değer, iş e-postasıyla ilişkili SuccessFactors Kimliği değeridir. Bu değeri SuccessFactors ortamınızla eşleşecek şekilde güncelleştirin. Bu değeri ayarlama adımları için emailType için sabit değer alma bölümüne bakın.
   4	doğru	emailIsPrimary	SuccessFactors'ta iş e-postasını birincil olarak ayarlamak için bu özniteliği kullanın. İş e-postası birincil değilse, bu bayrağı false olarak ayarlayın.
   5	kullanıcıAnaAdı	[custom01 – custom15]	Yeni bir eşleme ekleyerek, SuccessFactors Kullanıcı nesnesinde bulunan özel bir özniteliğe userPrincipalName veya herhangi bir Microsoft Entra özniteliği yazabilirsiniz.
   6	Prem SamAccountName üzerinde	kullanıcı adı	Yeni Eşleme Ekle'yi kullanarak isteğe bağlı olarak şirket içi samAccountName öğesini SuccessFactors kullanıcı adı özniteliğiyle eşleyebilirsiniz. SamAccountName'i Microsoft Entra Id ile eşitlemek için Microsoft Entra Connect Sync: Dizin uzantılarını kullanın. Kaynak açılır listesinde extension_yourTenantGUID_samAccountName olarak görünür.
   7	Tek oturum açma (SSO)	girişYöntemi	SuccessFactors kiracısı kısmi SSO için ayarlandıysa, Yeni Eşleme Ekle'yi kullanarak isteğe bağlı olarak loginMethod değerini "SSO" veya "PWD" sabit değerine ayarlayabilirsiniz.
   8	telefon numarası	işTelefonuNumarası	Microsoft Entra ID'den SuccessFactors iş / iş telefon numarasına telefonNumarası aktarmak için bu eşlemeyi kullanın.
   9	10605	işTelefonTipi	Bu sabit değer, iş telefonuyla ilişkili SuccessFactors Kimliği değeridir. Bu değeri SuccessFactors ortamınızla eşleşecek şekilde güncelleştirin. Bu değeri ayarlama adımları için phoneType için sabit değer alma bölümüne bakın.
   10	doğru	işTelefonuBirincil	İş telefon numarasının birincil bayrağını ayarlamak için bu özniteliği kullanın. Geçerli değerler doğru veya yanlış şeklindedir.
   11	mobil	cep telefonu numarası	Microsoft Entra ID'den SuccessFactors iş / iş telefon numarasına telefonNumarası aktarmak için bu eşlemeyi kullanın.
   12	10606	cepTelefonuTürü	Bu sabit değer, cep telefonuyla ilişkili SuccessFactors Kimliği değeridir. Bu değeri SuccessFactors ortamınızla eşleşecek şekilde güncelleştirin. Bu değeri ayarlama adımları için phoneType için sabit değer alma bölümüne bakın.
   13 (on üç)	yanlış	cepTelefonuAna	Cep telefonu numarası için birincil bayrağı ayarlamak için bu özniteliği kullanın. Geçerli değerler doğru veya yanlış şeklindedir.
   14	[extensionAttribute1-15]	userId (kullanıcı kimliği)	Aynı kullanıcı için birden çok çalışma kaydı olduğunda SuccessFactors içindeki etkin kaydın güncelleştirildiğinden emin olmak için bu eşlemeyi kullanın. Daha fazla ayrıntı için bkz. UserID ile geri yazmayı etkinleştirme

5. Öznitelik eşlemelerinizi doğrulayın ve gözden geçirin.

6. Eşlemeleri kaydetmek için Kaydet'i seçin. Ardından, SuccessFactors örneğinizdeki phoneType kodlarını kullanmak için JSON Yol API'sinin ifadelerini güncelleştireceğiz.

7. Gelişmiş seçenekleri göster'i seçin.

8. SuccessFactors içinÖznitelik listesini düzenle'yi seçin.

   Not

   SuccessFactors için Öznitelik listesini düzenle seçeneği Entra yönetim merkezinde gösterilmiyorsa, sayfaya erişmek için URL https://portal.azure.com/?Microsoft_AAD_IAM_forceSchemaEditorEnabled=true kullanın.

9. Bu görünümdeki API ifade sütunu, bağlayıcı tarafından kullanılan JSON Yolu ifadelerini görüntüler.

10. ortamınıza karşılık gelen kimlik değerini (businessPhoneType ve cellPhoneType) kullanmak üzere iş telefonu ve cep telefonu için JSON Yolu ifadelerini güncelleştirin.

    

11. Eşlemeleri kaydetmek için Kaydet'i seçin.

Kullanıcı sağlamayı etkinleştirme ve başlatma

SuccessFactors sağlama uygulaması yapılandırmaları tamamlandıktan sonra sağlama hizmetini açabilirsiniz.

İpucu

Sağlama hizmetini açtığınızda varsayılan olarak, kapsamdaki tüm kullanıcılar için sağlama işlemlerini başlatır. Eşleme veya veri sorunlarında hatalar varsa sağlama işi başarısız olabilir ve karantina durumuna geçebilir. Bunu önlemek için, tüm kullanıcılar için tam eşitlemeyi başlatmadan önce Kaynak Nesne Kapsamı filtresini yapılandırmanızı ve öznitelik eşlemelerinizi birkaç test kullanıcısı ile test etmenizi öneririz. Eşlemelerin çalıştığını doğruladıktan ve size istenen sonuçları verdikten sonra, filtreyi kaldırabilir veya daha fazla kullanıcı içerecek şekilde aşamalı olarak genişletebilirsiniz.

1. Sağlama sekmesinde Sağlama Durumu'nuAçık olarak ayarlayın.

2. Kapsam'ı seçin. Aşağıdaki seçeneklerden birini seçebilirsiniz:

   • Tüm kullanıcıları ve grupları eşitle: EşlemelerKaynak Nesne Kapsamı altında tanımlanan kapsam kurallarına bağlı olarak, Microsoft Entra Id'den SuccessFactors'a tüm kullanıcıların eşlenmiş > geri yazmayı planlıyorsanız bu seçeneği belirleyin.
   • Yalnızca atanan kullanıcıları ve grupları eşitle: Uygulama> Kullanıcılarıve grupları> menü seçeneğinde yalnızca bu uygulamaya atadığınız kullanıcıların eşlenmiş özniteliklerini geri yazmayı planlıyorsanız bu seçeneği belirleyin. Bu kullanıcılar, Eşlemeler>Kaynak Nesne Kapsamı altında tanımlanan kapsam kurallarına da tabidir.

   

   Not

   12 Ekim 2022'den sonra oluşturulan SuccessFactors Geri Yazma sağlama uygulamaları "grup ataması" özelliğini desteklemektedir. Uygulamayı 12 Ekim 2022 tarihinden önce oluşturduysanız yalnızca "kullanıcı ataması" desteği vardır. "Grup ataması" özelliğini kullanmak için SuccessFactors Geri Yazma uygulamasının yeni bir örneğini oluşturun ve mevcut eşleme yapılandırmalarınızı bu uygulamaya taşıyın.

3. Kaydetseçeneğini seçin.

4. Bu işlem ilk eşitlemeyi başlatır. Bu işlem, Microsoft Entra kiracısında kaç kullanıcının bulunduğuna ve işlem için tanımlanan kapsama bağlı olarak birkaç saat sürebilir. Eşitleme döngüsünün ilerleme durumunu izlemek için ilerleme çubuğunu de kontrol edebilirsiniz.

5. İstediğiniz zaman, Sağlama hizmeti tarafından gerçekleştirilen eylemleri görmek için Entra yönetim merkezindeki Sağlama günlükleri sekmesini denetleyin. Sağlama günlükleri, sağlama hizmeti tarafından gerçekleştirilen tüm eşitleme olaylarını listeler.

6. İlk eşitleme tamamlandıktan sonra, aşağıda gösterildiği gibi Sağlama sekmesine bir denetim özeti raporu yazar.

   

İlgili içerik

• Microsoft Entra ID ve SAP SuccessFactors tümleştirme referansına derinlemesine inceleme
• SuccessFactors ile Microsoft Entra Id arasında çoklu oturum açmayı yapılandırmayı öğrenin
• Diğer SaaS uygulamalarını Microsoft Entra ID ile tümleştirmeyi öğrenin