Jak aprowizacja firmy Microsoft integruje się z rozwiązaniem SAP SuccessFactors
Usługa aprowizacji użytkowników firmy Microsoft integruje się z usługą SAP SuccessFactors Employee Central w celu zarządzania cyklem życia tożsamości użytkowników. Identyfikator Entra firmy Microsoft oferuje trzy wstępnie utworzone integracje:
- SuccessFactors do lokalna usługa Active Directory aprowizacji użytkowników
- SuccessFactors to Microsoft Entra user provisioning (Aprowizacja użytkowników rozwiązania SuccessFactors w usłudze Microsoft Entra)
- Zapisywanie zwrotne rozwiązania SuccessFactors
W tym artykule wyjaśniono, jak działa integracja i jak można dostosować zachowanie aprowizacji dla różnych scenariuszy kadr.
Firma Microsoft Entra obsługuje również logowanie jednokrotne do rozwiązania SuccessFactors. Aby uzyskać więcej informacji, zobacz Microsoft Entra single sign-on (SSO) integration with SuccessFactors (Integracja logowania jednokrotnego firmy Microsoft z rozwiązaniem SuccessFactors).
Ustanawianie łączności
Usługa aprowizacji firmy Microsoft używa uwierzytelniania podstawowego do łączenia się z punktami końcowymi interfejsu API OData usługi Employee Central. Podczas konfigurowania aplikacji aprowizacji SuccessFactors użyj parametru Adres URL dzierżawy w sekcji Poświadczenia administratora, aby skonfigurować adres URL centrum danych interfejsu API.
Aby dodatkowo zabezpieczyć łączność między usługą aprowizacji firmy Microsoft i usługą SuccessFactors, dodaj zakresy adresów IP firmy Microsoft Entra na liście dozwolonych adresów IP SuccessFactors:
- Pobierz najnowsze zakresy adresów IP dla chmury publicznej platformy Azure.
- Otwórz plik i wyszukaj tag
AzureActiveDirectory
. - Skopiuj wszystkie zakresy adresów IP wymienione w elemecie addressPrefixes i użyj zakresu do skompilowania listy ograniczeń adresów IP.
- Przetłumacz wartości CIDR na zakresy adresów IP.
- Zaloguj się do portalu administracyjnego SuccessFactors, aby dodać zakresy adresów IP do listy dozwolonych. Zapoznaj się z dokumentacją pomocy technicznej sap 2253200. Teraz możesz wprowadzić zakresy adresów IP w tym narzędziu.
Obsługiwane jednostki
Dla każdego użytkownika w rozwiązaniu SuccessFactors usługa aprowizacji firmy Microsoft pobiera następujące jednostki. Każda jednostka jest rozszerzana przy użyciu interfejsu API OData $expand parametru zapytania zgodnie z opisem w kolumnie Reguła pobierania. Niektóre jednostki są domyślnie rozwinięte, podczas gdy niektóre jednostki są rozwinięte tylko wtedy, gdy określony atrybut znajduje się w mapowaniu.
# | Jednostka SuccessFactors | Węzeł OData | Reguła pobierania |
---|---|---|---|
1 | PerPerson |
*root node* |
Zawsze |
2 | PerPersonal |
personalInfoNav |
Zawsze |
3 | PerPhone |
phoneNav |
Zawsze |
100 | PerEmail |
emailNav |
Zawsze |
5 | EmpEmployment |
employmentNav |
Zawsze |
6 | User |
employmentNav/userNav |
Zawsze |
7 | EmpJob |
employmentNav/jobInfoNav |
Zawsze |
8 | EmpEmploymentTermination |
activeEmploymentsCount |
Zawsze |
9 | User's manager |
employmentNav/userNav/manager/empInfo |
Zawsze |
10 | FOCompany |
employmentNav/jobInfoNav/companyNav |
Tylko wtedy, gdy company atrybut lub companyId jest mapowany |
11 | FODepartment |
employmentNav/jobInfoNav/departmentNav |
Tylko wtedy, gdy department atrybut lub departmentId jest mapowany |
12 | FOBusinessUnit |
employmentNav/jobInfoNav/businessUnitNav |
Tylko wtedy, gdy businessUnit atrybut lub businessUnitId jest mapowany |
13 | FOCostCenter |
employmentNav/jobInfoNav/costCenterNav |
Tylko wtedy, gdy costCenter atrybut lub costCenterId jest mapowany |
14 | FODivision |
employmentNav/jobInfoNav/divisionNav |
Tylko wtedy, gdy division atrybut lub divisionId jest mapowany |
15 | FOJobCode |
employmentNav/jobInfoNav/jobCodeNav |
Tylko wtedy, gdy jobCode atrybut lub jobCodeId jest mapowany |
16 | FOPayGrade |
employmentNav/jobInfoNav/payGradeNav |
Tylko wtedy, gdy payGrade atrybut jest mapowany |
17 | FOLocation |
employmentNav/jobInfoNav/locationNav |
Tylko wtedy, gdy location atrybut jest mapowany |
18 | FOCorporateAddressDEFLT |
employmentNav/jobInfoNav/addressNavDEFLT |
Jeśli mapowanie zawiera jeden z następujących atrybutów: officeLocationAddress, officeLocationCity, officeLocationZipCode |
19 | FOEventReason |
employmentNav/jobInfoNav/eventReasonNav |
Tylko wtedy, gdy eventReason atrybut jest mapowany |
20 | EmpGlobalAssignment |
employmentNav/empGlobalAssignmentNav |
Tylko wtedy, gdy assignmentType jest mapowany |
21 | EmploymentType Picklist |
employmentNav/jobInfoNav/employmentTypeNav |
Tylko wtedy, gdy employmentType jest mapowany |
22 | EmployeeClass Picklist |
employmentNav/jobInfoNav/employeeClassNav |
Tylko wtedy, gdy employeeClass jest mapowany |
23 | EmplStatus Picklist |
employmentNav/jobInfoNav/emplStatusNav |
Tylko wtedy, gdy emplStatus jest mapowany |
24 | AssignmentType Picklist |
employmentNav/empGlobalAssignmentNav/assignmentTypeNav |
Tylko wtedy, gdy assignmentType jest mapowany |
25 | Position |
employmentNav/jobInfoNav/positionNav |
Tylko wtedy, gdy positioNav jest mapowany |
26 | Manager User |
employmentNav/jobInfoNav/managerUserNav |
Tylko wtedy, gdy managerUserNav jest mapowany |
Jak działa pełna synchronizacja
Na podstawie mapowania atrybutów podczas pełnej synchronizacji usługa aprowizacji firmy Microsoft wysyła następujące zapytanie "GET" interfejsu API OData w celu pobrania skutecznych danych wszystkich aktywnych i zakończonych procesów roboczych.
Parametr | Opis |
---|---|
OData API Host | Dołącza adres HTTPS do adresu URL dzierżawy. Przykład: https://api4.successfactors.com |
Punkt końcowy interfejsu API OData | /odata/v2/PerPerson |
Parametr zapytania OData $format | json |
Parametr zapytania OData $filter | (personEmpTerminationInfoNav/activeEmploymentsCount ne null) and (lastModifiedDateTime le <CurrentExecutionTime>) |
Parametr zapytania OData $expand | Ta wartość parametru zależy od atrybutów mapowanych. Przykład: employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav |
Parametr zapytania OData customPageSize | 100 |
Uwaga
Podczas pełnej synchronizacji początkowej pobierane są zarówno aktywne, jak i zakończone procesy robocze z rozwiązania SAP SuccessFactors.
Dla każdego użytkownika SuccessFactors usługa aprowizacji szuka konta w obiekcie docelowym (Microsoft Entra ID / lokalna usługa Active Directory) przy użyciu zgodnego atrybutu zdefiniowanego w mapowaniu. Na przykład: jeśli właściwość personIdExternal jest mapowany na employeeId i jest ustawiona jako pasujący atrybut, usługa aprowizacji używa wartości personIdExternal do wyszukiwania użytkownika z filtrem employeeId . Jeśli zostanie znalezione dopasowanie użytkownika, zaktualizuje atrybuty docelowe. Jeśli nie zostanie znalezione dopasowanie, zostanie utworzony nowy wpis w obiekcie docelowym.
Aby zweryfikować dane zwrócone przez punkt końcowy interfejsu API OData dla określonego personIdExternal
elementu , zaktualizuj SuccessFactorsAPIEndpoint
element w zapytaniu interfejsu API przy użyciu adresu URL serwera centrum danych interfejsu API i użyj narzędzia, takiego jak cURL lub Graph Explorer, aby wywołać zapytanie. Jeśli filtr "in" nie działa, możesz wypróbować filtr "eq".
https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json&
$filter=(personIdExternal in '[personIdExternalValue]')&
$expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,
phoneNav,phoneNav/phoneTypeNav,emailNav,employmentNav/jobInfoNav/businessUnitNav,employmentNav/jobInfoNav/companyNav,
employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/costCenterNav,
employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/jobCodeNav,
employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/payGradeNav,
employmentNav/empGlobalAssignmentNav,employmentNav/empGlobalAssignmentNav/assignmentTypeNav,employmentNav/jobInfoNav/emplStatusNav,
employmentNav/jobInfoNav/employmentTypeNav,employmentNav/jobInfoNav/employeeClassNav,employmentNav/jobInfoNav/eventReasonNav
Jak działa synchronizacja przyrostowa
Po pełnej synchronizacji usługa aprowizacji firmy Microsoft utrzymuje LastExecutionTimestamp
i używa jej do tworzenia zapytań różnicowych w celu pobierania zmian przyrostowych. Atrybuty znacznika czasu obecne w każdej jednostce SuccessFactors, takie jak lastModifiedDateTime
, , endDate
startDate
i latestTerminationDate
, są oceniane, aby sprawdzić, czy zmiana przypada między elementami LastExecutionTimestamp
i CurrentExecutionTime
. Jeśli tak, zmiana wpisu jest uważana za obowiązującą i przetworzoną na potrzeby synchronizacji.
Oto szablon żądania interfejsu API OData używany przez firmę Microsoft Entra ID do wykonywania zapytań dotyczących rozwiązania SuccessFactors pod kątem zmian przyrostowych. Możesz zaktualizować zmienne SuccessFactorsAPIEndpoint
, LastExecutionTimestamp
a CurrentExecutionTime
w szablonie żądania użyj narzędzia, takiego jak cURL lub Graph Explorer, aby sprawdzić, jakie dane są zwracane. Alternatywnie możesz również pobrać rzeczywisty ładunek żądania z rozwiązania SuccessFactors, włączając dzienniki inspekcji interfejsu API OData.
https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson/$count?$format=json&$filter=(personEmpTerminationInfoNav/activeEmploymentsCount ne null) and
((lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(personalInfoNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and personalInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((personalInfoNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and personalInfoNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (personalInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (personalInfoNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or personalInfoNav/endDate eq null))) or
(employmentNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((employmentNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (employmentNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (employmentNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or employmentNav/endDate eq null)))
(employmentNav/jobInfoNav/startDate ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/jobInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>') or
((employmentNav/jobInfoNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/jobInfoNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') and (employmentNav/jobInfoNav/startDate le datetimeoffset'<CurrentExecutionTime>' and (employmentNav/jobInfoNav/endDate ge datetimeoffset'<CurrentExecutionTime>' or employmentNav/jobInfoNav/endDate eq null))) or
(phoneNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and phoneNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(emailNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and emailNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>') or
(personEmpTerminationInfoNav/latestTerminationDate ge datetimeoffset'<previousDayDateStartTime24hrs>' and personEmpTerminationInfoNav/latestTerminationDate le datetimeoffset'<previousDayDateTime24hrs>') or
(employmentNav/userNav/lastModifiedDateTime ge datetimeoffset'<LastExecutionTimestamp>' and employmentNav/userNav/lastModifiedDateTime le datetimeoffset'<CurrentExecutionTime>'))
&$expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/userNav/manager/empInfo,employmentNav/jobInfoNav/companyNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/locationNav/addressNavDEFLT/stateNav&customPageSize=100
Jak działa przetwarzanie przed zatrudnieniem
W tej sekcji wyjaśniono, jak łącznik SAP SuccessFactors przetwarza rekordy wstępne zatrudnienia (pracownicy z datą zatrudnienia/datą rozpoczęcia w przyszłości).
Załóżmy, że istnieje wstępne zatrudnienie z employeeId "1234" w SuccessFactors Employee Central z datą rozpoczęcia 1-czerwiec-2023. Załóżmy, że ten rekord wstępny został utworzony po raz pierwszy w usłudze Employee Central lub w module dołączania w dniach 15-maj-2023. Gdy usługa aprowizacji po raz pierwszy obserwuje ten rekord w dniach 15-maj-2023 (w ramach pełnej synchronizacji lub synchronizacji przyrostowej), ten rekord jest nadal w stanie wstępnego zatrudnienia. W związku z tym usługa SuccessFactors nie wysyła wszystkich atrybutów usługi aprowizacji (na przykład userNav/username) skojarzonych z użytkownikiem. Dostępne są tylko minimalne dane dotyczące użytkownika, takie jak companyName
, personIdExternal
, firstname
lastname
istartDate
. Aby pomyślnie przetworzyć wstępne zatrudnienie, należy spełnić następujące wymagania wstępne:
- Atrybut
personIdExternal
musi być ustawiony jako podstawowy identyfikator dopasowania (właściwość dołączania). Jeśli skonfigurujesz inny atrybut (na przykład userName) jako właściwość dołączania, usługa aprowizacji nie będzie mogła pobrać informacji wstępnych. - Atrybut
startDate
musi być dostępny, a jego ścieżka JSONPath musi być ustawiona na$.employmentNav.results[0].startDate
wartość lub$.employmentNav.results[-1:].startDate
. - Rekord przed zatrudnieniem musi znajdować się w jednym z następujących stanów w centrum pracowników: "aktywny" (t), "nieaktywny" (f) lub "active_external_suite" (e). Aby uzyskać szczegółowe informacje na temat tych stanów, zapoznaj się z artykułem 2736579 pomocy technicznej sap.
Uwaga
W przypadku wstępnego zatrudnienia, który nie ma historii w organizacji, indeks [0] i [-1:] będzie działać dla .startDate
W przypadku wstępnego zatrudnienia, który jest ponownym zatrudnieniem lub konwersją, nie możemy określić kolejności i może to spowodować przetworzenie niektórych pracowników ponownie/przekonwertowanych w celu przetworzenia ich rzeczywistej daty rozpoczęcia. Jest to znane ograniczenie łącznika.
Podczas pełnej synchronizacji lub synchronizacji przyrostowej lub aprowizacji na żądanie, gdy usługa aprowizacji napotka rekord wstępny, wysyła następujące zapytanie OData do rozwiązania SuccessFactors z filtrem "asOfDate" ustawionym na wartość startDate użytkownika (np.OfDate=2023-06-01).
https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json&$
filter=(personIdExternal in '1234' and employmentNav/userNav/status in 't','f','e')&asOfDate=2023-06-01&$
expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav,phoneNav,emailNav,employmentNav/userNav/manager/empInfo,employmentNav/jobInfoNav/companyNav,employmentNav/jobInfoNav/costCenterNav,employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/
Jeśli występują problemy z przetwarzaniem wstępnym, możesz użyć powyższego formatu żądania OData, aby wykonać zapytanie względem wystąpienia rozwiązania SuccessFactors zastępując punkt końcowy interfejsu API i personIdExternal
asOfDate
filtrować wartościami odpowiadającymi scenariuszowi testowemu.
Odczytywanie danych atrybutów
Gdy usługa aprowizacji firmy Microsoft wysyła zapytanie SuccessFactors, pobiera zestaw wyników JSON. Zestaw wyników JSON zawiera wiele atrybutów przechowywanych w usłudze Employee Central. Domyślnie schemat aprowizacji jest skonfigurowany do pobierania tylko podzestawu tych atrybutów.
Aby pobrać więcej atrybutów, wykonaj wymienione kroki:
Przejdź do pozycji Aplikacje dla przedsiębiorstw -SuccessFactors App -Provisioning -Edit Provisioning -attribute-mapping page (Aplikacje dla przedsiębiorstw -> SuccessFactors App ->Provisioning -Edit Provisioning ->>attribute-mapping page).
Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
Kliknij pozycję Edytuj listę atrybutów dla elementu SuccessFactors.
Uwaga
Jeśli opcja Edytuj atrybuty dla rozwiązania SuccessFactors nie jest wyświetlana w centrum administracyjnym firmy Microsoft Entra, użyj adresu URLhttps://portal.azure.com/?Microsoft_AAD_IAM_forceSchemaEditorEnabled=true, aby uzyskać dostęp do strony.
Kolumna wyrażeń interfejsu API w tym widoku wyświetla wyrażenia JSONPath używane przez łącznik.
Możesz edytować istniejącą wartość JSONPath lub dodać nowy atrybut z prawidłowym wyrażeniem JSONPath do schematu.
W następnej sekcji przedstawiono listę typowych scenariuszy edytowania wartości JSONPath.
Obsługa różnych scenariuszy kadr
JSONPath to język zapytań dla formatu JSON podobny do XPath dla kodu XML. Podobnie jak XPath, JSONPath umożliwia wyodrębnianie i filtrowanie danych z ładunku JSON.
Za pomocą przekształcenia JSONPath można dostosować zachowanie aplikacji microsoft Entra provisioning w celu pobrania atrybutów niestandardowych i obsługi scenariuszy, takich jak ponowne wirowanie, konwersja procesów roboczych i przypisanie globalne.
W tej sekcji opisano sposób dostosowywania aplikacji aprowizacji dla następujących scenariuszy kadr:
- Pobieranie większej liczby atrybutów
- Pobieranie atrybutów niestandardowych
- Mapowanie stanu zatrudnienia na stan konta
- Obsługa scenariuszy konwersji i ponownego instalowania procesów roboczych
- Pobieranie bieżącego aktywnego rekordu zatrudnienia
- Obsługa scenariusza przypisania globalnego
- Obsługa scenariusza współbieżnych zadań
- Pobieranie szczegółów położenia
- Aprowizowanie użytkowników w module dołączania
- Włączanie dzienników inspekcji interfejsu API OData w rozwiązaniu SuccessFactors
Pobieranie większej liczby atrybutów
Domyślny schemat aplikacji aprowizacji firmy Microsoft Entra SuccessFactors jest dostarczany ze wstępnie zdefiniowanymi atrybutami 90+. Aby dodać więcej atrybutów SuccessFactors do schematu aprowizacji, wykonaj wymienione kroki:
Użyj zapytania OData, aby pobrać dane prawidłowego użytkownika testowego z usługi Employee Central.
https://[SuccessFactorsAPIEndpoint]/odata/v2/PerPerson?$format=json& $filter=(personIdExternal in '[personIdExternalValue]')& $expand=employmentNav/userNav,employmentNav/jobInfoNav,personalInfoNav,personEmpTerminationInfoNav, phoneNav,phoneNav/phoneTypeNav,emailNav,employmentNav/jobInfoNav/businessUnitNav,employmentNav/jobInfoNav/companyNav, employmentNav/jobInfoNav/companyNav/countryOfRegistrationNav,employmentNav/jobInfoNav/costCenterNav, employmentNav/jobInfoNav/divisionNav,employmentNav/jobInfoNav/departmentNav,employmentNav/jobInfoNav/jobCodeNav, employmentNav/jobInfoNav/locationNav,employmentNav/jobInfoNav/locationNav/addressNavDEFLT,employmentNav/jobInfoNav/payGradeNav, employmentNav/empGlobalAssignmentNav,employmentNav/empGlobalAssignmentNav/assignmentTypeNav,employmentNav/jobInfoNav/emplStatusNav, employmentNav/jobInfoNav/employmentTypeNav,employmentNav/jobInfoNav/employeeClassNav,employmentNav/jobInfoNav/eventReasonNav
Określanie jednostki Employee Central skojarzonej z atrybutem
- Jeśli atrybut jest częścią jednostki EmpEmployment , poszukaj atrybutu w węźle employmentNav .
- Jeśli atrybut jest częścią jednostki Użytkownik , wyszukaj atrybut w obszarze employmentNav/userNav node.
- Jeśli atrybut jest częścią jednostki EmpJob , poszukaj atrybutu w węźle employmentNav/jobInfoNav .
Skonstruuj ścieżkę JSON skojarzoną z atrybutem i dodaj ten nowy atrybut do listy atrybutów SuccessFactors.
- Przykład 1: Załóżmy, że chcesz dodać atrybut
okToRehire
, który jest częściąemploymentNav
jednostki, a następnie użyj polecenia JSONPath$.employmentNav.results[0].okToRehire
- Przykład 2: Załóżmy, że chcesz dodać atrybut timeZone, który jest częścią jednostki userNav , a następnie użyć ścieżki JSONPath
$.employmentNav.results[0].userNav.timeZone
- Przykład 3: Załóżmy, że chcesz dodać atrybut flsaStatus, który jest częścią jednostki jobInfoNav , a następnie użyj JSONPath
$.employmentNav.results[0].jobInfoNav.results[0].flsaStatus
- Przykład 1: Załóżmy, że chcesz dodać atrybut
Zapisz schemat.
Ponowne uruchamianie aprowizacji.
Pobieranie atrybutów niestandardowych
Domyślnie następujące atrybuty niestandardowe są wstępnie zdefiniowane w aplikacji aprowizacji Microsoft Entra SuccessFactors:
- custom01-custom15 z jednostki User (userNav)
- customString1-customString15 z jednostki EmpEmployment (employmentNav) o nazwie empNavCustomString1-empNavCustomString15
- customString1-customString15 z jednostki EmpJobInfo (jobInfoNav) o nazwie empJobNavCustomString1-empNavJobCustomString15
Załóżmy, że w wystąpieniu usługi Employee Central atrybut customString35 w pliku EmpJobInfo przechowuje opis lokalizacji. Chcesz przepływać tę wartość do atrybutu physicalDeliveryOfficeName usługi Active Directory. Aby skonfigurować mapowanie atrybutów dla tego scenariusza, wykonaj następujące czynności:
- Edytuj listę atrybutów SuccessFactors, aby dodać nowy atrybut o nazwie empJobNavCustomString35.
- Ustaw wyrażenie interfejsu API JSONPath dla tego atrybutu jako:
$.employmentNav.results[0].jobInfoNav.results[0].customString35
- Zapisz i załaduj ponownie zmianę mapowania w centrum administracyjnym firmy Microsoft Entra.
- W bloku mapowania atrybutów zamapuj element empJobNavCustomString35 na physicalDeliveryOfficeName.
- Zapisz mapowanie.
Rozszerzanie tego scenariusza:
- Jeśli chcesz mapować atrybut custom35 z jednostki User, użyj ścieżki JSONPath
$.employmentNav.results[0].userNav.custom35
- Jeśli chcesz mapować atrybut customString35 z jednostki EmpEmployment , użyj ścieżki JSONPath
$.employmentNav.results[0].customString35
Mapowanie stanu zatrudnienia na stan konta
Domyślnie łącznik Microsoft Entra SuccessFactors używa activeEmploymentsCount
pola PersonEmpTerminationInfo
obiektu do ustawiania stanu konta. Może wystąpić jeden z następujących problemów z tym atrybutem.
- Istnieje znany problem polegający na tym, że łącznik może wyłączyć konto przerwanego procesu roboczego pewnego dnia przed zakończeniem pracy.
PersonEmpTerminationInfo
Jeśli obiekt zostanie ustawiony na wartość null, podczas kończenia, wyłączenie konta usługi AD nie działa, ponieważ aparat aprowizacji filtruje rekordy, w którychpersonEmpTerminationInfoNav
obiekt jest ustawiony na wartość null.
Jeśli masz problemy lub preferujesz mapowanie stanu zatrudnienia na stan konta, możesz zaktualizować mapowanie, aby rozwinąć emplStatus
pole i użyć kodu stanu zatrudnienia w polu emplStatus.externalCode
. Na podstawie uwagi dotyczącej pomocy technicznej sap 2505526 znajduje się lista kodów stanu zatrudnienia, które można pobrać w aplikacji aprowizacji.
- A = Aktywne
- D = Uśpiony
- U = urlop niezapłacony
- P = płatny urlop
- S = zawieszone
- F = Furlough
- O = odrzucone
- R = wycofana
- T = zakończone
Aby pobrać te kody, wykonaj kroki aktualizacji mapowania.
Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
W obszarze Pokaż opcje zaawansowane kliknij pozycję Edytuj listę atrybutów SuccessFactors.
Znajdź atrybut i zaktualizuj ścieżkę
emplStatus
JSONPath do$.employmentNav.results[0].jobInfoNav.results[0].emplStatusNav.externalCode
. Aktualizacja sprawia, że łącznik pobiera kody stanu zatrudnienia w tabeli.Zapisz zmiany.
W bloku mapowania atrybutów zaktualizuj mapowanie wyrażeń flagi stanu konta.
Zadanie aprowizacji Atrybut stanu konta Wyrażenie mapowania SuccessFactors do aprowizacji użytkowników usługi Active Directory accountDisabled
Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
SuccessFactors to Microsoft Entra user provisioning (Aprowizacja użytkowników rozwiązania SuccessFactors w usłudze Microsoft Entra) accountEnabled
Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")
Zapisz zmiany.
Przetestuj konfigurację przy użyciu aprowizacji na żądanie.
Po potwierdzeniu, że synchronizacja działa zgodnie z oczekiwaniami, uruchom ponownie zadanie aprowizacji.
Obsługa scenariuszy konwersji i ponownego instalowania procesów roboczych
Scenariusz konwersji procesu roboczego: Konwersja procesu roboczego to proces konwertowania istniejącego pracownika pełnoetatowego na wykonawcę lub wykonawcę na pracownika pełnoetatowego. W tym scenariuszu usługa Employee Central dodaje nową jednostkę EmpEmployment wraz z nową jednostką User dla tej samej jednostki Person . Jednostka User zagnieżdżona w ramach poprzedniej jednostki EmpEmployment ma wartość null.
Informacje o scenariuszach ponownego instalowania: W rozwiązaniu SuccessFactors istnieją dwie opcje przetwarzania ponownego instalowania pracowników:
- Opcja 1. Tworzenie nowego profilu osoby w centrum pracowników
- Opcja 2. Ponowne używanie istniejącego profilu osoby w centrum pracowników
Jeśli proces hr używa opcji 1, żadne zmiany nie są wymagane do schematu aprowizacji. Jeśli proces KADR używa opcji 2, usługa Employee Central dodaje nową jednostkę EmpEmployment wraz z nową jednostką User dla tej samej jednostki Person .
Oba scenariusze można obsługiwać tak, aby nowe dane zatrudnienia pojawiały się po konwersji lub ponownym uruchomieniu. Zbiorcze aktualizowanie schematu aplikacji aprowizacji przy użyciu wymienionych kroków:
Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
Kliknij link Przejrzyj schemat tutaj , aby otworzyć edytor schematu.
Kliknij link Pobierz, aby zapisać kopię schematu przed edycją.
W edytorze schematów naciśnij Ctrl-H, aby otworzyć kontrolkę find-replace.
W polu tekstowym znajdź skopiuj i wklej wartość
$.employmentNav.results[0]
W polu tekstowym zamień skopiuj i wklej wartość
$.employmentNav.results[-1:]
. To wyrażenie JSONPath zwraca najnowszy rekord EmpEmployment .Kliknij opcję "Zamień wszystko", aby zaktualizować schemat.
Zapisz schemat.
Powyższy proces aktualizuje wszystkie wyrażenia JSONPath w następujący sposób:
- Stara ścieżka JSONPath:
$.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
- Nowa ścieżka JSONPath:
$.employmentNav.results[-1:].jobInfoNav.results[0].departmentNav.name_localized
- Stara ścieżka JSONPath:
Przetestuj konfigurację przy użyciu aprowizacji na żądanie.
Po potwierdzeniu, że synchronizacja działa zgodnie z oczekiwaniami, uruchom ponownie zadanie aprowizacji.
Uwaga
Opisane powyżej podejście działa tylko wtedy, gdy firma SAP SuccessFactors zwraca obiekty zatrudnienia w kolejności rosnącej, gdzie najnowszy rekord zatrudnienia jest zawsze ostatnim rekordem w tablicy wyników zatrudnieniaNav . Kolejność zwracania wielu rekordów zatrudnienia nie jest gwarantowana przez rozwiązanie SuccessFactors. Jeśli wystąpienie rozwiązania SuccessFactors zawiera wiele rekordów zatrudnienia odpowiadających procesowi roboczemu i zawsze chcesz pobrać atrybuty skojarzone z aktywnym rekordem zatrudnienia, wykonaj kroki opisane w następnej sekcji.
Pobieranie bieżącego aktywnego rekordu zatrudnienia
Używanie katalogu głównego JSONPath lub $.employmentNav.results[-1:]
pobierania $.employmentNav.results[0]
rekordów zatrudnienia działa w większości scenariuszy i utrzymuje prostą konfigurację. Jednak w zależności od konfiguracji wystąpienia SuccessFactors może być konieczne zaktualizowanie tej konfiguracji w celu zapewnienia, że łącznik zawsze pobiera najnowszy aktywny rekord zatrudnienia.
W tej sekcji opisano sposób aktualizowania ustawień JSONPath, aby na pewno pobrać bieżący aktywny rekord zatrudnienia użytkownika. Obsługuje również konwersję procesów roboczych i scenariusze ponownego instalowania.
Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
Kliknij link Przejrzyj schemat tutaj , aby otworzyć edytor schematu.
Kliknij link Pobierz, aby zapisać kopię schematu przed edycją.
W edytorze schematów naciśnij Ctrl-H, aby otworzyć kontrolkę find-replace.
Wykonaj następujące operacje znajdowania zamiany. Upewnij się, że podczas wykonywania operacji znajdowania zamiany nie ma miejsca wiodącego ani końcowego. Jeśli używasz
[-1:]
indeksu[0]
zamiast , zaktualizuj odpowiednio pole string-to-find .Ciąg do znalezienia Ciąg do użycia do zamiany Przeznaczenie $.employmentNav.results[0].jobInfoNav.results[0].emplStatus
$.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P' )].emplStatusNav.externalCode
Za pomocą tego polecenia find-replace dodamy możliwość rozwinięcia obiektu emplStatusNav OData. $.employmentNav.results[0].jobInfoNav.results[0]
$.employmentNav..jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')]
Za pomocą tego polecenia find-replace poinstruujemy łącznik, aby zawsze pobierał atrybuty skojarzone z aktywnym rekordem SuccessFactors EmpJobInfo. Atrybuty skojarzone z zakończonymi/nieaktywnymi rekordami w rozwiązaniach SuccessFactors są ignorowane. $.employmentNav.results[0]
$.employmentNav..results[?(@.jobInfoNav..results[?(@.emplStatusNav.externalCode == 'A' || @.emplStatusNav.externalCode == 'U' || @.emplStatusNav.externalCode == 'P')])]
Za pomocą tego polecenia find-replace poinstruujemy łącznik, aby zawsze pobierał atrybuty skojarzone z aktywnym rekordem SuccessFactors Employment. Atrybuty skojarzone z zakończonymi/nieaktywnymi rekordami w rozwiązaniach SuccessFactors są ignorowane. Zapisz schemat.
Powyższy proces aktualizuje wszystkie wyrażenia JSONPath.
Aby przetwarzanie wstępne działało, ścieżka JSONPath skojarzona z atrybutem
startDate
musi używać atrybutu[0]
lub[-1:]
indeksu. W obszarze Pokaż opcje zaawansowane kliknij pozycję Edytuj listę atrybutów SuccessFactors. Znajdź atrybutstartDate
i ustaw go na wartość$.employmentNav.results[-1:].startDate
Zapisz schemat.
Aby upewnić się, że zakończenia są przetwarzane zgodnie z oczekiwaniami, możesz użyć jednego z następujących ustawień w sekcji mapowania atrybutów.
Zadanie aprowizacji Atrybut stanu konta Wyrażenie do użycia, jeśli stan konta jest oparty na "activeEmploymentsCount" Wyrażenie do użycia, jeśli stan konta jest oparty na wartości "emplStatus" SuccessFactors do aprowizacji użytkowników usługi Active Directory accountDisabled
Switch([activeEmploymentsCount], "False", "0", "True")
Switch([emplStatus], "True", "A", "False", "U", "False", "P", "False")
SuccessFactors to Microsoft Entra user provisioning (Aprowizacja użytkowników rozwiązania SuccessFactors w usłudze Microsoft Entra) accountEnabled
Switch([activeEmploymentsCount], "True", "0", "False")
Switch([emplStatus], "False", "A", "True", "U", "True", "P", "True")
Zapisz zmiany. 1.
Przetestuj konfigurację przy użyciu aprowizacji na żądanie.
Po potwierdzeniu, że synchronizacja działa zgodnie z oczekiwaniami, uruchom ponownie zadanie aprowizacji.
Obsługa scenariusza przypisania globalnego
Gdy użytkownik w usłudze Employee Central jest przetwarzany na potrzeby przypisania globalnego, successFactors dodaje nową jednostkę EmpEmployment i ustawia klasę assignmentClass na wartość "GA". Spowoduje to również utworzenie nowej jednostki Użytkownik . W związku z tym użytkownik ma teraz następujące elementy:
- Jedna jednostka Użytkownika EmpEmployment + odpowiadająca przypisaniu głównemu z przypisaniem przypisaniaClass ustawiona na wartość "ST" i
- Inna jednostka użytkownika EmpEmployment + odpowiadająca przydziałowi globalnemu z wartością assignmentClass ustawioną na wartość "GA"
Aby pobrać atrybuty należące do standardowego przypisania i profilu użytkownika przypisania globalnego, wykonaj wymienione kroki:
Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
Kliknij link Przejrzyj schemat tutaj , aby otworzyć edytor schematu.
Kliknij link Pobierz, aby zapisać kopię schematu przed edycją.
W edytorze schematów naciśnij Ctrl-H, aby otworzyć kontrolkę find-replace.
W polu tekstowym znajdź skopiuj i wklej wartość
$.employmentNav.results[0]
W polu tekstowym zamień skopiuj i wklej wartość
$.employmentNav.results[?(@.assignmentClass == 'ST')]
. Zwróć uwagę na białe znaki otaczające operator ==, który jest ważny dla pomyślnego przetwarzania wyrażenia JSONPath.Kliknij opcję "Zamień wszystko", aby zaktualizować schemat.
Zapisz schemat.
Powyższy proces aktualizuje wszystkie wyrażenia JSONPath w następujący sposób:
- Stara ścieżka JSONPath:
$.employmentNav.results[0].jobInfoNav.results[0].departmentNav.name_localized
- Nowa ścieżka JSONPath:
$.employmentNav.results[?(@.assignmentClass == 'ST')].jobInfoNav.results[0].departmentNav.name_localized
- Stara ścieżka JSONPath:
Załaduj ponownie blok mapowania atrybutów aplikacji.
Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
Kliknij pozycję Edytuj listę atrybutów dla elementu SuccessFactors.
Dodaj nowe atrybuty, aby pobrać dane przydziału globalnego. Na przykład: jeśli chcesz pobrać nazwę działu skojarzona z globalnym profilem przypisania, możesz dodać atrybut globalAssignmentDepartment z wyrażeniem JSONPath ustawionym na
$.employmentNav.results[?(@.assignmentClass == 'GA')].jobInfoNav.results[0].departmentNav.name_localized
wartość .Teraz możesz przepływać obie wartości działu do atrybutów usługi Active Directory lub selektywnie przepływać wartość przy użyciu mapowania wyrażeń. Przykład: wyrażenie ustawia wartość atrybutu działu usługi AD na globalAssignmentDepartment, jeśli istnieje, w przeciwnym razie ustawia wartość dla działu skojarzonego ze standardowym przypisaniem.
IIF(IsPresent([globalAssignmentDepartment]),[globalAssignmentDepartment],[department])
Zapisz mapowanie.
Przetestuj konfigurację przy użyciu aprowizacji na żądanie.
Po potwierdzeniu, że synchronizacja działa zgodnie z oczekiwaniami, uruchom ponownie zadanie aprowizacji.
Obsługa scenariusza współbieżnych zadań
Gdy użytkownik w usłudze Employee Central ma współbieżne/wiele zadań, istnieją dwie jednostki EmpEmployment i User z przypisaniemKlasa ustawiona na wartość "ST". Aby pobrać atrybuty należące do obu zadań, wykonaj wymienione kroki:
- Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
- Przewiń w dół i kliknij pozycję Pokaż opcje zaawansowane.
- Kliknij pozycję Edytuj listę atrybutów dla elementu SuccessFactors.
- Załóżmy, że chcesz ściągnąć dział skojarzony z zadaniem 1 i 2. Wstępnie zdefiniowany dział atrybutów pobiera już wartość działu dla pierwszego zadania. Możesz zdefiniować nowy atrybut o nazwie secondJobDepartment i ustawić wyrażenie JSONPath na
$.employmentNav.results[1].jobInfoNav.results[0].departmentNav.name_localized
- Teraz możesz przepływać obie wartości działu do atrybutów usługi Active Directory lub selektywnie przepływać wartość przy użyciu mapowania wyrażeń.
- Zapisz mapowanie.
- Przetestuj konfigurację przy użyciu aprowizacji na żądanie.
- Po potwierdzeniu, że synchronizacja działa zgodnie z oczekiwaniami, uruchom ponownie zadanie aprowizacji.
Pobieranie szczegółów położenia
Łącznik SuccessFactors obsługuje rozszerzanie obiektu position. Aby rozwinąć i pobrać atrybuty obiektu pozycji, takie jak nazwy poziomu zadania lub pozycji w określonym języku, można użyć wyrażeń JSONPath, jak pokazano.
Nazwa atrybutu | Wyrażenie JSONPath |
---|---|
positionJobLevel | $.employmentNav.results[0].jobInfoNav.results[0].positionNav.jobLevel |
positionNameFR | $.employmentNav.results[0].jobInfoNav.results[0].positionNav.externalName_fr_FR |
positionNameDE | $.employmentNav.results[0].jobInfoNav.results[0].positionNav.externalName_de_DE |
Aprowizowanie użytkowników w module dołączania
Aprowizacja użytkowników przychodzących z rozwiązania SAP SuccessFactors do lokalnej usługi Active Directory i identyfikatora Entra firmy Microsoft obsługuje teraz zaawansowane aprowizowanie prehires obecnych w module SAP SuccessFactors Onboarding 2.0. Gdy usługa aprowizacji firmy Microsoft napotka nowy profil zatrudnienia z datą rozpoczęcia w przyszłości, wysyła zapytanie do rozwiązania SAP SuccessFactors, aby uzyskać nowych pracowników z jednym z następujących kodów stanu: active
, , active_external_suite
inactive
. Kod active_external_suite
stanu odpowiada prehires obecnym w module SAP SuccessFactors Onboarding 2.0. Aby uzyskać opis tych kodów stanu, zapoznaj się z uwagami dotyczącymi pomocy technicznej sap 2736579.
Domyślnym zachowaniem usługi aprowizacji jest przetwarzanie prehires w module dołączania.
Jeśli chcesz wykluczyć przetwarzanie prehires w module dołączania, zaktualizuj konfigurację zadania aprowizacji w następujący sposób:
- Otwórz blok mapowania atrybutów aplikacji aprowizacji SuccessFactors.
- W obszarze Pokaż opcje zaawansowane edytuj listę atrybutów SuccessFactors, aby dodać nowy atrybut o nazwie
userStatus
. - Ustaw wyrażenie interfejsu API JSONPath dla tego atrybutu jako:
$.employmentNav.results[0].userNav.status
- Zapisz schemat, aby wrócić do bloku mapowania atrybutów.
- Edytowanie zakresu obiektu źródłowego w celu zastosowania filtru określania zakresu
userStatus NOT EQUALS
- Zapisz mapowanie i sprawdź, czy filtr określania zakresu działa przy użyciu aprowizacji na żądanie.
Włączanie dzienników inspekcji interfejsu API OData w rozwiązaniu SuccessFactors
Łącznik Microsoft Entra SuccessFactors używa interfejsu API OData SuccessFactors do pobierania zmian i aprowizacji użytkowników. Jeśli zaobserwujesz problemy z usługą aprowizacji i chcesz potwierdzić, jakie dane zostały pobrane z rozwiązania SuccessFactors, możesz włączyć dzienniki inspekcji interfejsu API OData w rozwiązaniu SuccessFactors. Pobierz ładunek żądania wysłany przez identyfikator Entra firmy Microsoft z dzienników inspekcji. Aby rozwiązać problemy, możesz skopiować ten ładunek żądania w narzędziu, takim jak cURL lub Graph Explorer, skonfigurować go tak, aby używał tego samego użytkownika interfejsu API, który jest używany przez łącznik i sprawdzić, czy zwraca żądane zmiany z successFactors.
Scenariusze zapisywania zwrotnego
W tej sekcji omówiono różne scenariusze zapisu zwrotnego. Zaleca ona metody konfiguracji na podstawie sposobu konfigurowania poczty e-mail i numeru telefonu w rozwiązaniu SuccessFactors.
Obsługiwane scenariusze zapisu na telefonach i wiadomościach e-mail
# | Wymaganie dotyczące scenariusza | Adres e-mail podstawowy wartość flagi |
Telefon służbowy wartość flagi podstawowej |
Komórka wartość flagi podstawowej |
Telefon służbowy mapping |
Komórka mapping |
---|---|---|---|---|---|---|
1 | * Ustaw tylko służbową pocztę e-mail jako podstawową. * Nie ustawiaj numerów telefonów. |
prawda | prawda | fałsz | [Nie ustawiono] | [Nie ustawiono] |
2 | * W rozwiązaniach SuccessFactors, firmowa poczta e-mail i telefon służbowy są podstawowe * Zawsze przepływaj numer telefonu Microsoft Entra do telefonu służbowego i telefonu komórkowego na telefon komórkowy. |
prawda | prawda | fałsz | telephoneNumber | mobilnych |
3 | * W rozwiązaniach SuccessFactors, firmowa poczta e-mail i telefon komórkowy są podstawowe * Zawsze przepływaj numer telefonu Microsoft Entra do telefonu służbowego i telefonu komórkowego na telefon komórkowy |
prawda | fałsz | prawda | telephoneNumber | mobilnych |
100 | * W firmowej wiadomości e-mail successFactors jest podstawowa. * W elemecie Microsoft Entra ID sprawdź, czy numer telefonu służbowego jest obecny, a następnie sprawdź, czy numer telefonu komórkowego jest również obecny. Oznacz numer telefonu służbowego jako podstawowy tylko wtedy, gdy numer telefonu komórkowego nie jest obecny. |
prawda | Użyj mapowania wyrażeń: IIF(IsPresent([telephoneNumber]), IIF(IsPresent([mobile]),"false", "true"), "false") |
Użyj mapowania wyrażeń: IIF(IsPresent([mobile]),"false", "true") |
telephoneNumber | mobilnych |
5 | * W firmowej wiadomości e-mail i telefonie służbowym SuccessFactors jest podstawowym elementem. * W identyfikatorze Entra firmy Microsoft, jeśli jest dostępny, ustaw go jako telefon służbowy, a następnie użyj numeru telefonu. |
prawda | prawda | fałsz | IIF(IsPresent([mobile]), [mobile], [telephoneNumber]) |
[Nie ustawiono] |
- Jeśli nie ma mapowania numeru telefonu w mapowaniu atrybutów zapisu zwrotnego, w zapisie jest uwzględniana tylko wiadomość e-mail.
- Podczas dołączania nowych pracowników w usłudze Employee Central może być niedostępny służbowy adres e-mail i numer telefonu. Jeśli ustawienie służbowej poczty e-mail i telefonu służbowego jako podstawowego jest obowiązkowe podczas dołączania, możesz ustawić fikcyjną wartość dla telefonu służbowego i poczty e-mail podczas tworzenia nowego zatrudnienia. Po pewnym czasie aplikacja zapisywania zwrotnego aktualizuje wartość.
Włączanie zapisywania zwrotnego za pomocą identyfikatora UserID
Aplikacja SuccessFactors Writeback używa następującej logiki do aktualizowania atrybutów obiektu Użytkownika:
- Pierwszym krokiem jest wyszukiwanie atrybutu userId w zestawie zmian. Jeśli jest obecny, użyje wartości "UserId" do wywołania interfejsu API SuccessFactors.
- Jeśli identyfikator userId nie zostanie znaleziony, wartość domyślna to użycie wartości atrybutu personIdExternal .
Zazwyczaj wartość atrybutu personIdExternal w successFactors jest zgodna z wartością atrybutu userId . Jednak w scenariuszach, takich jak ponowne wirowanie i konwersja procesu roboczego, pracownik w successFactors może mieć dwa rekordy zatrudnienia, jeden aktywny i jeden nieaktywny. W takich scenariuszach, aby zapewnić aktualizację zapisu zwrotnego aktywnego profilu użytkownika, zaktualizuj konfigurację aplikacji aprowizacji SuccessFactors zgodnie z opisem. Ta konfiguracja gwarantuje, że identyfikator userId jest zawsze obecny w zestawie zmian widocznym dla łącznika i jest używany w wywołaniu interfejsu API SuccessFactors.
- Otwórz aplikację SuccessFactors do aprowizacji użytkowników firmy Microsoft lub rozwiązanie SuccessFactors do lokalnej aplikacji aprowizacji użytkowników usługi AD.
- Upewnij się, że
extensionAttribute[1-15]
w usłudzeuserId
Microsoft Entra ID zawsze są przechowywane aktywne rekordy zatrudnienia każdego pracownika. Rekord mapuje atrybut SuccessFactorsuserId
naextensionAttribute[1-15]
w identyfikatorze Entra firmy Microsoft. - Aby uzyskać wskazówki dotyczące ustawień JSONPath, zapoznaj się z sekcją Obsługa konwersji procesów roboczych i scenariuszy ponownego instalowania, aby upewnić się, że wartość userId aktywnego rekordu zatrudnienia przepływa do identyfikatora Entra firmy Microsoft.
- Zapisz mapowanie.
- Uruchom zadanie aprowizacji, aby upewnić się, że wartości userId przepływają do identyfikatora Entra firmy Microsoft.
Uwaga
Jeśli używasz rozwiązania SuccessFactors do lokalna usługa Active Directory aprowizacji użytkowników, skonfiguruj program Microsoft Entra Connect, aby zsynchronizować wartość atrybutu userId z lokalna usługa Active Directory do identyfikatora Entra firmy Microsoft.
- Otwórz aplikację Writeback SuccessFactors w witrynie Azure Portal.
- Zamapuj żądane rozszerzenieAttribute zawierające wartość userId na atrybut UserId SuccessFactors.
- Zapisz mapowanie.
- Przejdź do pozycji Mapowanie atrybutów — zaawansowane —>> przejrzyj schemat, aby otworzyć edytor schematu JSON.
- Pobierz kopię schematu jako kopię zapasową.
- W edytorze schematu naciśnij Ctrl-F i wyszukaj węzeł JSON zawierający mapowanie userId, gdzie jest mapowany na źródłowy atrybut Microsoft Entra.
- Zaktualizuj atrybut flowBehavior z "FlowWhenChanged" na "FlowAlways", jak pokazano.
- Zapisz mapowanie i przetestuj scenariusz zapisu zwrotnego przy użyciu aprowizacji na żądanie.
Nieobsługiwane scenariusze na telefon i zapisywanie zwrotne wiadomości e-mail
- W usłudze Employee Central podczas dołączania osobistej poczty e-mail i osobistego telefonu jest ustawiony jako podstawowy. Aplikacja zapisu zwrotnego nie może przełączyć tego ustawienia i ustawić służbowej poczty e-mail i telefonu służbowego jako podstawowego.
- W usłudze Employee Central telefon służbowy jest ustawiony jako podstawowy. Aplikacja zapisu zwrotnego nie może zmienić tego i ustawić telefon komórkowy jako podstawowy.
- Aplikacja zapisu zwrotnego nie może odczytać bieżących ustawień flagi podstawowej i używać tych samych wartości dla operacji zapisu. Wartości flag skonfigurowane w mapowaniu atrybutów są zawsze używane.