Synkronisera attribut för livscykelarbetsflöden

Arbetsflöden innehåller specifika aktiviteter som kan köras automatiskt mot användare baserat på de angivna körningsvillkoren. Automatisk schemaläggning av arbetsflöden stöds baserat på användarattributen employeeHireDate och employeeLeaveDateTime i Microsoft Entra ID.

För att dra full nytta av arbetsflöden för livscykeln bör användaretablering automatiseras och de relevanta attributen för schemaläggning ska synkroniseras.

Schemalägga relevanta attribut

I följande tabell visas relevanta attribut för schemaläggning (utlösare) och de synkroniseringsmetoder som stöds.

Det här dokumentet beskriver hur du konfigurerar synkronisering från lokal Microsoft Entra Connect-molnsynkronisering eller Microsoft Entra Connect för de attribut som krävs.

Förstå EmployeeHireDate- och EmployeeLeaveDateTime-formatering

EmployeeHireDate och EmployeeLeaveDateTime innehåller datum och tider som måste formateras på ett visst sätt. Det innebär att du kan behöva använda ett uttryck för att konvertera värdet för källattributet till ett format som EmployeeHireDate eller EmployeeLeaveDateTime accepterar. I följande tabell beskrivs det format som förväntas och innehåller ett exempeluttryck om hur du konverterar värdena.

Mer information om uttryck finns i Referens för att skriva uttryck för attributmappningar i Microsoft Entra-ID.

Uttrycksexemplen i tabellen använder endDate för SAP och StatusHireDate för Workday. Du kan dock välja att använda olika attribut.

Du kan till exempel använda StatusContinuousFirstDayOfWork i stället för StatusHireDate för Workday. I det här fallet skulle ditt uttryck vara:

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

I följande tabell finns en lista över föreslagna attribut och deras scenariorekommendationer.

Fler attribut finns i referensen för attributet Workday och attributet SAP SuccessFactors.

Tidsvikt

För att säkerställa att schemalagda arbetsflöden är korrekta är det viktigt att tänka på följande:

• Tidsdelen av attributet måste anges i enlighet med detta, till exempel employeeHireDate ska ha en tid i början av dagen som 01:00 eller 05:00 och employeeLeaveDateTime bör ha tid i slutet av dagen som 21:00 eller 23:00
• Arbetsflödena körs inte tidigare än den tid som anges i attributet, men klientschemat (standard 3h) kan fördröja arbetsflödeskörningen. Om du till exempel anger employeeHireDate till 08.00 men klientorganisationens schema inte körs förrän 09.00 bearbetas inte arbetsflödet förrän då. Om en ny anställning börjar kl. 08.00 vill du ange tiden till något i stil med (starttid – klientschema) för att säkerställa att den körs innan medarbetaren anländer.
• Vi rekommenderar att du anger den maximala livslängden till 24 timmar om du använder tillfälligt åtkomstpass (TAP). Om du gör detta ser du till att TAP inte har upphört att gälla efter att ha skickats till en anställd som kan vara i en annan tidszon. Mer information finns i Konfigurera tillfälligt åtkomstpass i Microsoft Entra-ID för att registrera autentiseringsmetoder utan lösenord.
• När du importerar data bör du förstå om och hur källan tillhandahåller tidszonsinformation för dina användare för att eventuellt göra justeringar för att säkerställa tidsnoggrannhet.

Skapa en anpassad synkroniseringsregel i Microsoft Entra Connect-molnsynkronisering för EmployeeHireDate

Följande steg vägleder dig genom att skapa en synkroniseringsregel med hjälp av molnsynkronisering.

1. I administrationscentret för Microsoft Entra bläddrar du till >Hybridhantering>Microsoft Entra Connect.
2. Välj Hantera Microsoft Entra Connect-molnsynkronisering.
3. Under Konfiguration väljer du din konfiguration.
4. Välj Klicka för att redigera mappningar. Den här länken öppnar skärmen Attributmappningar .
5. Välj Lägg till attribut.
6. Fyll i följande information:
   • Mappningstyp: Direkt
   • Källattribut: msDS-cloudExtensionAttribute1
   • Standardvärde: Lämna tomt
   • Målattribut: employeeHireDate
   • Använd den här mappningen: Alltid
7. Välj Använd.
8. Tillbaka på skärmen Attributmappningar bör du se din nya attributmappning.
9. Välj Spara schema.

Mer information om attribut finns i Attributmappning i Microsoft Entra Connect-molnsynkronisering.

Så här skapar du en anpassad synkroniseringsregel i Microsoft Entra Connect för EmployeeHireDate

I följande exempel går vi igenom hur du konfigurerar en anpassad synkroniseringsregel som synkroniserar Active Directory-attributet med attributet employeeHireDate i Microsoft Entra-ID.

1. Öppna ett PowerShell-fönster som administratör och kör Set-ADSyncScheduler -SyncCycleEnabled $false för att inaktivera schemaläggaren.
2. Gå till Start\Microsoft Entra Connect\ och öppna redigeraren för synkroniseringsregler
3. Kontrollera att riktningen längst upp är inställd på Inkommande.
4. Välj Lägg till regel.
5. På skärmen Skapa regel för inkommande synkronisering anger du följande information och väljer Nästa.
   • Namn: In från AD – EmployeeHireDate
   • Anslutet system: contoso.com
   • Typ av anslutet systemobjekt: användare
   • Metaversumobjekttyp: person
   • Prioritet: 20
6. På skärmen Omfångsfilter väljer du Nästa.
7. På skärmen Anslut regler väljer du Nästa.
8. Ange följande information under Lägg till transformeringar på skärmen Transformeringar.
   • FlowType: Direkt
   • Målattribut: employeeHireDate
   • Källa: msDS-cloudExtensionAttribute1
9. Markera Lägga till.
10. I redigeraren för synkroniseringsregler kontrollerar du att riktningen längst upp är inställd på Utgående.
11. Välj Lägg till regel.
12. På skärmen Skapa regel för utgående synkronisering anger du följande information och väljer Nästa.
    • Namn: Ut till Microsoft Entra ID – EmployeeHireDate
    • Anslutet system: <din klientorganisation>
    • Typ av anslutet systemobjekt: användare
    • Metaversumobjekttyp: person
    • Prioritet: 21
13. På skärmen Omfångsfilter väljer du Nästa.
14. På skärmen Anslut regler väljer du Nästa.
15. Ange följande information under Lägg till transformeringar på skärmen Transformeringar.
    • FlowType: Direkt
    • Målattribut: employeeHireDate
    • Källa: employeeHireDate
16. Markera Lägga till.
17. Stäng redigeraren för synkroniseringsregler
18. Aktivera schemaläggaren igen genom att köra Set-ADSyncScheduler -SyncCycleEnabled $true.

Mer information finns i Anpassa en synkroniseringsregel och Gör en ändring i standardkonfigurationen.

Redigera attributmappning i etableringsprogrammet

När du har konfigurerat etableringsprogrammet kan du redigera dess attributmappning. När appen skapas får du en lista över standardmappningar mellan din HRM och Active Directory. Därifrån kan du antingen redigera den befintliga mappningen eller lägga till ny mappning.

Om du vill uppdatera den här mappningen gör du följande:

1. Logga in på administrationscentret för Microsoft Entra som global administratör.

2. Bläddra till Identity>Applications Enterprise-program.>

3. Öppna ditt etablerade program.

4. Välj Etablering och välj sedan Redigera attributmappning.

5. Välj Visa avancerade alternativ och välj sedan Redigera attributlista för Lokal Active Directory.

6. Lägg till källattributet eller attributen som skapats som Typsträng och välj i kryssrutan för obligatoriskt.

   Kommentar

   Antalet och namnet på de källattribut som läggs till beror på vilka attribut du synkroniserar från Active Directory.

7. Välj Spara.

8. Därifrån måste du mappa HRM-attributen till de tillagda Active Directory-attributen. Det gör du genom att lägga till ny mappning med ett uttryck.

9. Uttrycket måste matcha formateringen som finns i formateringsavsnittet Understanding EmployeeHireDate och EmployeeLeaveDateTime.

10. Välj ok.

Så här verifierar du dessa attributvärden i Microsoft Entra-ID

Om du vill granska de värden som anges för dessa egenskaper för användarobjekt i Microsoft Entra-ID kan du använda Microsoft Graph PowerShell SDK. Till exempel:

# 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

Nästa steg

• Vad är livscykelarbetsflöden?
• Skapa ett anpassat arbetsflöde med hjälp av administrationscentret för Microsoft Entra
• Konfigurera API-driven inkommande etableringsapp (offentlig förhandsversion)
• Skapa ett livscykelarbetsflöde