Udostępnij za pośrednictwem

Jak synchronizować atrybuty przepływów pracy cyklu życia

  • Artykuł

Przepływy pracy zawierają określone zadania, które mogą być uruchamiane automatycznie względem użytkowników na podstawie określonych warunków wykonywania. Automatyczne planowanie przepływów pracy jest obsługiwane na podstawie atrybutów użytkownika employeeHireDate i employeeLeaveDateTime w identyfikatorze firmy Microsoft Entra.

Aby w pełni korzystać z przepływów pracy cyklu życia, aprowizacja użytkowników powinna być zautomatyzowana, a planowanie odpowiednich atrybutów powinno być synchronizowane.

Planowanie odpowiednich atrybutów

W poniższej tabeli przedstawiono odpowiednie atrybuty planowania (wyzwalacza) oraz obsługiwane metody synchronizacji.

Atrybut Typ Obsługiwane w aprowizacji ruchu przychodzącego hr Obsługiwane w usłudze Microsoft Entra Connect Cloud Sync Obsługiwane w programie Microsoft Entra Connect Sync
employeeHireDate DateTimeOffset Tak Tak Tak
employeeLeaveDateTime DateTimeOffset Tak Tak Tak

Uwaga

Ręczne ustawienie pracownikaLeaveDateTime dla użytkowników korzystających tylko z chmury wymaga specjalnych uprawnień. Aby uzyskać więcej informacji, zobacz: Configure the employeeLeaveDateTime property for a user (Konfigurowanie właściwości employeeLeaveDateTime dla użytkownika)

W tym dokumencie wyjaśniono, jak skonfigurować synchronizację z lokalnej synchronizacji z chmurą microsoft Entra Connect lub Microsoft Entra Connect dla wymaganych atrybutów.

Uwaga

W usłudze Active Directory nie ma odpowiedniego atrybutu EmployeeHireDate lub EmployeeLeaveDateTime. Jeśli synchronizujesz się z lokalnej usługi AD, musisz zidentyfikować atrybut w usłudze AD, który może być używany. Ten atrybut musi być ciągiem.

Opis formatowania EmployeeHireDate i EmployeeLeaveDateTime

EmployeeHireDate i EmployeeLeaveDateTime zawierają daty i godziny, które muszą być sformatowane w określony sposób. Oznacza to, że może być konieczne użycie wyrażenia w celu przekonwertowania wartości atrybutu źródłowego na format akceptowany przez parametr EmployeeHireDate lub EmployeeLeaveDateTime. W poniższej tabeli przedstawiono oczekiwany format i przedstawiono przykładowe wyrażenie dotyczące sposobu konwertowania wartości.

Scenariusz Wyrażenie/format Obiekt docelowy Więcej informacji
Aprowizowanie użytkowników produktu Workday w usłudze Active Directory FormatDateTime([StatusHireDate], ,"yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ") Atrybut ciągu lokalnej usługi AD Mapowania atrybutów dla produktu Workday
SuccessFactors do aprowizacji użytkowników usługi Active Directory FormatDateTime([endDate], ,"M/d/rrrr hh:mm:ss tt","yyyMmddHHmmss.fZ") Atrybut ciągu lokalnej usługi AD Mapowania atrybutów dla czynników sukcesu SAP
Importowanie niestandardowe do usługi Active Directory Musi być w formacie "yyyyMmddHHmmss.fZ" Atrybut ciągu lokalnej usługi AD Mapowania atrybutów dla dowolnego innego systemu rekordów
Interfejs API użytkownika programu Microsoft Graph Musi mieć format "RRRR-MM-DDThh:mm:ssZ" EmployeeHireDate i EmployeeLeaveDateTime
Aprowizowanie użytkowników produktu Workday w usłudze Microsoft Entra Może używać mapowania bezpośredniego. Nie jest wymagane wyrażenie, ale można go użyć do dostosowania części czasowej employeeHireDate i EmployeeLeaveDateTime EmployeeHireDate i EmployeeLeaveDateTime
SuccessFactors to Microsoft Entra user provisioning (Aprowizacja użytkowników rozwiązania SuccessFactors w usłudze Microsoft Entra) Może używać mapowania bezpośredniego. Nie jest wymagane wyrażenie, ale można go użyć do dostosowania części czasowej employeeHireDate i EmployeeLeaveDateTime EmployeeHireDate i EmployeeLeaveDateTime

Aby uzyskać więcej informacji na temat wyrażeń, zobacz Dokumentacja zapisywania wyrażeń mapowań atrybutów w identyfikatorze Entra firmy Microsoft.

Przykłady wyrażeń w tabeli używają endDate dla systemów SAP i StatusHireDate for Workday. Można jednak użyć różnych atrybutów.

Możesz na przykład użyć parametru StatusContinuousFirstDayOfWork zamiast StatusHireDate for Workday. W tym wystąpieniu wyrażenie będzie następujące:

FormatDateTime([StatusContinuousFirstDayOfWork], , "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")

Poniższa tabela zawiera listę sugerowanych atrybutów i ich zaleceń dotyczących scenariuszy.

Atrybut HR HR System Scenariusz Atrybut Entra firmy Microsoft
StatusHireDate Dzień roboczy Stolarz EmployeeHireDate
StatusContinuousFirstDayOfWork Dzień roboczy Stolarz EmployeeHireDate
StatusDateEnteredWorkforce Dzień roboczy Stolarz EmployeeHireDate
StatusOriginalHireDate Dzień roboczy Stolarz EmployeeHireDate
StatusEndEmploymentDate Dzień roboczy Urlop EmployeeLeaveDateTime
StatusResignationDate Dzień roboczy Urlop EmployeeLeaveDateTime
StanRetirementDate Dzień roboczy Urlop EmployeeLeaveDateTime
StatusTerminationDate Dzień roboczy Urlop EmployeeLeaveDateTime
startDate SAP SF Stolarz EmployeeHireDate
firstDateWorked SAP SF Stolarz EmployeeHireDate
lastDateWorked SAP SF Urlop EmployeeLeaveDateTime
endDate SAP SF Urlop EmployeeLeaveDateTime

Aby uzyskać więcej atrybutów, zobacz dokumentację atrybutów produktu Workday i dokumentację atrybutu SAP SuccessFactors.

Znaczenie czasu

Aby zapewnić dokładność chronometrażu zaplanowanych przepływów pracy, należy wziąć pod uwagę następujące kwestie:

  • Część czasowa atrybutu musi być odpowiednio ustawiona, na przykład employeeHireDate powinien mieć czas na początku dnia, takiego jak 1:00 lub 5:00 i employeeLeaveDateTime powinien mieć czas na końcu dnia, takiego jak 20:00 lub 11:00
  • Przepływy pracy nie będą uruchamiane wcześniej niż czas określony w atrybucie, jednak harmonogram dzierżawy (wartość domyślna 3h) może opóźnić uruchomienie przepływu pracy. Jeśli na przykład ustawisz wartość employeeHireDate 8:00, ale harmonogram dzierżawy nie zostanie uruchomiony do godziny 9:00, przepływ pracy nie zostanie przetworzony do tego czasu. Jeśli nowy pracownik zaczyna się o 8:00, chcesz ustawić czas na taki jak (godzina rozpoczęcia — harmonogram dzierżawy), aby upewnić się, że działa przed przybyciem pracownika.
  • Zaleca się, aby w przypadku korzystania z dostępu tymczasowego (TAP) ustawić maksymalny okres istnienia na 24 godziny. Wykonanie tej czynności pomoże zapewnić, że funkcja TAP nie wygasła po wysłaniu do pracownika, który może znajdować się w innej strefie czasowej. Aby uzyskać więcej informacji, zobacz Configure Temporary Access Pass in Microsoft Entra ID to register Passwordless authentication methods (Konfigurowanie dostępu tymczasowego w usłudze Microsoft Entra ID w celu zarejestrowania metod uwierzytelniania bez hasła).
  • Podczas importowania danych należy zrozumieć, czy i w jaki sposób źródło udostępnia użytkownikom informacje o strefie czasowej, aby potencjalnie wprowadzić korekty w celu zapewnienia dokładności chronometrażu.

Tworzenie niestandardowej reguły synchronizacji w usłudze Microsoft Entra Connect w chmurze synchronizacji dla elementu EmployeeHireDate

Poniższe kroki zawierają instrukcje tworzenia reguły synchronizacji przy użyciu synchronizacji w chmurze.

  1. W centrum administracyjnym firmy Microsoft Entra przejdź do >pozycji Zarządzanie>hybrydowe Microsoft Entra Connect.
  2. Wybierz pozycję Zarządzaj synchronizacją z chmurą Microsoft Entra Connect.
  3. W obszarze Konfiguracja wybierz konfigurację.
  4. Wybierz pozycję Kliknij, aby edytować mapowania. Ten link otwiera ekran Mapowania atrybutów .
  5. Wybierz pozycję Dodaj atrybut.
  6. Wypełnij następujące informacje:
    • Typ mapowania: Bezpośredni
    • Atrybut źródłowy: msDS-cloudExtensionAttribute1
    • Wartość domyślna: Pozostaw puste
    • Atrybut docelowy: employeeHireDate
    • Zastosuj to mapowanie: Zawsze Zrzut ekranu przedstawiający mapowanie atrybutów chmury.
  7. Wybierz Zastosuj.
  8. Po powrocie do ekranu Mapowania atrybutów powinno zostać wyświetlone nowe mapowanie atrybutów .
  9. Wybierz pozycję Zapisz schemat.

Aby uzyskać więcej informacji na temat atrybutów, zobacz Mapowanie atrybutów w usłudze Microsoft Entra Connect Cloud Sync.

Jak utworzyć niestandardową regułę synchronizacji w programie Microsoft Entra Connect dla employeeHireDate

W poniższym przykładzie przedstawiono sposób konfigurowania niestandardowej reguły synchronizacji, która synchronizuje atrybut usługi Active Directory z atrybutem employeeHireDate w identyfikatorze Entra firmy Microsoft.

  1. Otwórz okno programu PowerShell jako administrator i uruchom polecenie Set-ADSyncScheduler -SyncCycleEnabled $false , aby wyłączyć harmonogram.
  2. Przejdź do pozycji Start\Microsoft Entra Connect\ i otwórz Edytor reguł synchronizacji
  3. Upewnij się, że w górnej części ustawiono kierunek ruchu przychodzącego.
  4. Wybierz Dodaj regułę.
  5. Na ekranie Tworzenie reguły synchronizacji ruchu przychodzącego wprowadź następujące informacje i wybierz przycisk Dalej.
    • Nazwa: w usłudze AD — EmployeeHireDate
    • Połączony system: contoso.com
    • Typ obiektu systemu połączonego: użytkownik
    • Typ obiektu Metaverse: osoba
    • Pierwszeństwo: 20 Zrzut ekranu przedstawiający tworzenie podstaw reguły synchronizacji ruchu przychodzącego.
  6. Na ekranie Filtr określania zakresu wybierz pozycję Dalej.
  7. Na ekranie Reguły dołączania wybierz pozycję Dalej.
  8. Na ekranie Przekształcenia w obszarze Dodawanie przekształceń wprowadź następujące informacje.
    • FlowType: Bezpośredni
    • Atrybut docelowy: employeeHireDate
    • Źródło: msDS-cloudExtensionAttribute1 Zrzut ekranu przedstawiający tworzenie przekształceń reguł synchronizacji ruchu przychodzącego.
  9. Wybierz Dodaj.
  10. W Edytorze reguł synchronizacji upewnij się, że kierunek u góry jest ustawiony na wychodzący.
  11. Wybierz Dodaj regułę.
  12. Na ekranie Tworzenie reguły synchronizacji ruchu wychodzącego wprowadź następujące informacje i wybierz pozycję Dalej.
    • Nazwa: do identyfikatora Entra firmy Microsoft — EmployeeHireDate
    • Połączony system: <dzierżawa>
    • Typ obiektu systemu połączonego: użytkownik
    • Typ obiektu Metaverse: osoba
    • Pierwszeństwo: 21
  13. Na ekranie Filtr określania zakresu wybierz pozycję Dalej.
  14. Na ekranie Reguły dołączania wybierz pozycję Dalej.
  15. Na ekranie Przekształcenia w obszarze Dodawanie przekształceń wprowadź następujące informacje.
    • FlowType: Bezpośredni
    • Atrybut docelowy: employeeHireDate
    • Źródło: employeeHireDate Zrzut ekranu przedstawiający tworzenie przekształceń reguł synchronizacji ruchu wychodzącego.
  16. Wybierz Dodaj.
  17. Zamknij edytor reguł synchronizacji
  18. Ponownie włącz harmonogram, uruchamiając polecenie Set-ADSyncScheduler -SyncCycleEnabled $true.

Uwaga

  • msDS-cloudExtensionAttribute1 to przykładowe źródło.
  • Począwszy od programu Microsoft Entra Connect 2.0.3.0, employeeHireDate jest dodawany do domyślnej reguły "Out to Microsoft Entra ID", więc kroki 10–16 nie są wymagane.
  • Począwszy od programu Microsoft Entra Connect 2.1.19.0, employeeLeaveDateTime jest dodawany do domyślnej reguły "Out to Microsoft Entra ID", więc kroki 10–16 nie są wymagane.

Aby uzyskać więcej informacji, zobacz How to customize a synchronization rule (Jak dostosować regułę synchronizacji) i Make a change to the default configuration (Jak dostosować regułę synchronizacji) i Make a change to the default configuration (Wprowadzanie zmiany w domyślnej konfiguracji).

Edytowanie mapowania atrybutów w aplikacji aprowizacji

Po skonfigurowaniu aplikacji aprowizacji możesz edytować jej mapowanie atrybutów. Po utworzeniu aplikacji zostanie wyświetlona lista domyślnych mapowań między usługą HRM i usługą Active Directory. Z tego miejsca możesz edytować istniejące mapowanie lub dodać nowe mapowanie.

Aby zaktualizować to mapowanie, wykonaj następujące czynności:

  1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako administrator globalny.

  2. Przejdź do aplikacji dla przedsiębiorstw usługi Identity>Applications>.

  3. Otwórz aprowizowaną aplikację.

  4. Wybierz pozycję Aprowizowanie, a następnie wybierz pozycję Edytuj mapowanie atrybutów.

  5. Wybierz pozycję Pokaż opcje zaawansowane, a następnie wybierz pozycję Edytuj listę atrybutów dla lokalnej usługi Active Directory. Zrzut ekranu przedstawiający edytowanie atrybutu lokalnego.

  6. Dodaj atrybut źródłowy lub atrybuty utworzone jako Ciąg typu, a następnie wybierz pole wyboru wymagane. Zrzut ekranu przedstawiający źródłową listę interfejsów API.

    Uwaga

    Liczba dodanych atrybutów źródłowych i nazwa zależą od atrybutów synchronizowanych z usługi Active Directory.

  7. Wybierz pozycję Zapisz.

  8. W tym miejscu należy zamapować atrybuty HRM na dodane atrybuty usługi Active Directory. W tym celu dodaj nowe mapowanie przy użyciu wyrażenia.

  9. Wyrażenie musi odpowiadać formatowaniu znalezionemu w sekcji Understanding EmployeeHireDate i EmployeeLeaveDateDateTime. Zrzut ekranu przedstawiający ustawianie formatu atrybutu.

  10. Wybierz przycisk OK.

Jak zweryfikować te wartości atrybutów w identyfikatorze Entra firmy Microsoft

Aby przejrzeć wartości ustawione na tych właściwościach obiektów użytkownika w identyfikatorze Entra firmy Microsoft, możesz użyć zestawu MICROSOFT Graph PowerShell SDK. Na przykład:

# Import Module
Import-Module Microsoft.Graph.Users

# Define the necessary scopes
$Scopes =@("User.Read.All", "User-LifeCycleInfo.Read.All")

# Connect using the scopes defined and select the Beta API Version
Connect-MgGraph -Scopes $Scopes


# Query a user, using its user ID, and return the desired properties
$user = Get-MgUser -UserID "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" -Property EmployeeLeaveDateTime
$User.EmployeeLeaveDateTime

Zrzut ekranu przedstawiający wynik.

Następne kroki