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.

Attribut	Typ	Stöds i inkommande HR-etablering	Stöd i Microsoft Entra Anslut molnsynkronisering	Support i Microsoft Entra Anslut Sync
employeeHireDate	DateTimeOffset	Ja	Ja	Ja
employeeLeaveDateTime	DateTimeOffset	Ja	Ja	Ja

Kommentar

Att manuellt ställa in employeeLeaveDateTime för användare som endast är molnbaserade kräver särskilda behörigheter. Mer information finns i: Konfigurera egenskapen employeeLeaveDateTime för en användare

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

Kommentar

Det finns inget motsvarande EmployeeHireDate- eller EmployeeLeaveDateTime-attribut i Active Directory. Om du synkroniserar från lokal AD måste du identifiera ett attribut i AD som kan användas. Det här attributet måste vara en sträng.

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.

Scenario	Uttryck/format	Mål	Mer information
Workday till Active Directory-användaretablering	FormatDateTime([StatusHireDate], "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")	Lokalt AD-strängattribut	Attributmappningar för Workday
SuccessFactors till Active Directory User Provisioning	FormatDateTime([endDate], "M/d/ååååå hh:mm:ss tt","yyyyMMddHHmmss.fZ")	Lokalt AD-strängattribut	Attributmappningar för SAP Success Factors
Anpassad import till Active Directory	Måste vara i formatet "åååååMMddHHmmss.fZ"	Lokalt AD-strängattribut	Attributmappningar för andra postsystem
Användar-API för Microsoft Graph	Måste vara i formatet "ÅÅÅÅ-MM-DDThh:mm:ssZ"	EmployeeHireDate och EmployeeLeaveDateTime
Workday till Microsoft Entra-användaretablering	Kan använda en direktmappning. Inget uttryck behövs men kan användas för att justera tidsdelen av EmployeeHireDate och EmployeeLeaveDateTime	EmployeeHireDate och EmployeeLeaveDateTime
SuccessFactors till Microsoft Entra-användaretablering	Kan använda en direktmappning. Inget uttryck behövs men kan användas för att justera tidsdelen av EmployeeHireDate och EmployeeLeaveDateTime	EmployeeHireDate och EmployeeLeaveDateTime

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.

HR-attribut	HR-system	Scenario	Microsoft Entra-attribut
StatusHireDate	Arbetsdag	Joiner	EmployeeHireDate
StatusContinuousFirstDayOfWork	Arbetsdag	Joiner	EmployeeHireDate
StatusDateEnteredWorkforce	Arbetsdag	Joiner	EmployeeHireDate
StatusOriginalHireDate	Arbetsdag	Joiner	EmployeeHireDate
StatusEndEmploymentDate	Arbetsdag	Leavers	EmployeeLeaveDateTime
StatusResignationDate	Arbetsdag	Leavers	EmployeeLeaveDateTime
StatusRetirementDate	Arbetsdag	Leavers	EmployeeLeaveDateTime
StatusTerminationDate	Arbetsdag	Leavers	EmployeeLeaveDateTime
startDate	SAP SF	Joiner	EmployeeHireDate
firstDateWorked	SAP SF	Joiner	EmployeeHireDate
lastDateWorked	SAP SF	Leavers	EmployeeLeaveDateTime
endDate	SAP SF	Leavers	EmployeeLeaveDateTime

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 Anslut 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 >Microsoft Entra-Anslut för hybridhantering>.
2. Välj Hantera Microsoft Entra Anslut 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 Anslut molnsynkronisering.

Skapa en anpassad synkroniseringsregel i Microsoft Entra Anslut 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 Anslut\ 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
   • Anslut system: contoso.com
   • Anslut systemobjekttyp: 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
    • Anslut ed System: <din klientorganisation>
    • Anslut systemobjekttyp: 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.

Kommentar

• msDS-cloudExtensionAttribute1 är en exempelkälla.
• Från och med Microsoft Entra Anslut 2.0.3.0employeeHireDate läggs till i standardregeln "Ut till Microsoft Entra-ID", så steg 10–16 krävs inte.
• Från och med Microsoft Entra Anslut 2.1.19.0employeeLeaveDateTime läggs till i standardregeln "Ut till Microsoft Entra-ID", så steg 10–16 krävs inte.

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 minst 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