API-baseret lønintegration med Ceridian Dayforce

I denne artikel beskrives de konfigurationstrin, der kræves til API-baseret lønintegration mellem Microsoft Dynamics 365 Human Resources og Ceridian Dayforce. Konfiguration er påkrævet i begge systemer, før en lønkørsel kan behandles.

Indstillinger for miljø

Før du bruger HR-lønintegrationen, skal du konfigurere følgende parametre:

  • På siden Delte Human Resources-parametre:

    • På fanen Stillinger skal du vælge Kræv afdelinger til stillinger.
    • På fanen Lønintegration skal du vælge Brug lønadresseformål.
  • På siden Human Resources-parametre:

    • På fanen Lønintegration skal du vælge Brug identifikationstyper i lønbehandling.
    • Vælg den relevante identifikationstype for den juridiske enhed i feltet Identifikationstype .
  • I Finans skal du gå til Kontoplan>> programmer >Dataobjekter. Definer økonomiske dimensionsformater for dataobjekter.

Note

Hr-parametre er entydige pr. juridisk enhed og skal konfigureres for hver enkelt enhed. Koordinér med Ceridian for at bestemme, hvilke økonomiske dimensioner der koordineres med Dayforce-stedet (lokation).

Vigtig

For kunder, der bruger mshr-enheder, skal registrering af ændringer af rækkeversioner være deaktiveret. Kontakt Microsoft Support til at aktivere flight DMFDisableSqlRowVersionCtForCDSVirtualEntity .

Aktiver funktioner

Du skal aktivere funktioner i funktionsstyring for at vise Microsoft API'er for integrationen og de data, der skal overføres til Dayforce. Nogle funktioner er muligvis allerede aktiveret som standard.

Følg disse trin for at aktivere funktioner:

  1. Gå til Systemadministration>Funktionsstyring>Alle.
  2. Aktivér følgende funktioner:
    • Objektet Strømlin medarbejder
    • Frynsegodeadministration

Virtuelle tabeller

Human Resources er en virtuel datakilde i Dataverse. Den giver fuld adgang til at oprette, læse, opdatere og slette data fra Dataverse og Microsoft Power Platform.

Følg disse trin for at konfigurere mshr Virtual-tabeller.

Registrere appen i Microsoft Azure

Du skal registrere dine forekomst af Human Resources i Azure-portalen, så Microsoft-identitetsplatformen kan levere godkendelse og autorisationstjenester til appen og brugerne. Du kan få flere oplysninger om registrering af apps i Azure under Registrer et program med Microsoft-identitetsplatformen.

  1. Åbn Microsoft Azure-portalen.
  2. Vælg Appregistreringer på listen Azure-tjenester.
  3. Vælg Ny registrering.
  4. Angiv et sigende navn for appen i feltet Navn. F.eks. Dynamics 365 Human Resources Virtual Tables.
  5. I feltet Omdirigerings-URI skal du vælge Web og angive URL-adressen til navneområdet for dit FinOps-program, f.eks. https://<hostname>.operations.dynamics.com
  6. Vælg Registrer.
  7. Når registreringen er fuldført, viser Azure Portal ruden Oversigt for appregistrering, som indeholder program-id'et (klient).... Bemærk program-id'et (klient).
  8. Vælg Certifikater og hemmeligheder i venstre navigationsrude.
  9. Under sektionen Klienthemmelighed skal du vælge Ny klienthemmelighed.
  10. Indtast en beskrivelse, vælg en varighed, og vælg Tilføj.
  11. Registrer hemmelighedens værdi fra egenskaben Værdi i tabellen.

Vigtig

Vær opmærksom på hemmelighedens værdi, da hemmeligheden ikke vises igen, når du forlader denne side.

Installér den virtuelle tabelapp til Dynamics 365 Human Resources

Installér dynamics 365 Human Resources-appen til virtuelle tabeller i dit Power Apps-miljø for at udrulle den virtuelle tabelløsningspakke til Dataverse.

  1. Gå til Power Platform Administration, og vælg dit miljø.
  2. Vælg Dynamics 365-apps under feltet Ressourcer .
  3. Vælg Installer app.
  4. Vælg appen Virtuelle tabeller til Dynamics 365 HR.

Konfigurere datakilden til den virtuelle tabel

Hvis du vil konfigurere datakilden for den virtuelle tabel i Power Apps-miljøet, skal du følge disse trin:

  1. Åbn udviklerportalen, og vælg dit miljø.

  2. Gå til tabeller, og søg efter konfigurationstabellen Finance and Operations Virtual Data source.

  3. Vælg Microsoft HR-datakildepost, og angiv følgende oplysninger.

  4. Angiv de nødvendige oplysninger til datakildens konfiguration:

    • DESTINATIONS-URL-adresse: URL-adressen til dit Finops-navneområde. Formatet af DESTINATIONS-URL-adressen er: https://<hostname>.operations.dynamics.com/

    Note

    Sørg for at medtage tegnet "/" i slutningen af URL-adressen for at undgå at modtage en fejl.

    • Tenant-ID: Microsoft Entra-Tenant-ID.
    • Microsoft Entra Application ID (AAD ApplicationId): Det program-(klient)-id, der er oprettet for det program, der er registreret på Microsoft Azure-portalen. Du modtog disse oplysninger under trinnet Registrer appen i Microsoft Azure .
    • Microsoft Entra-programhemmelighed: Den programklienthemmelighed, der er oprettet for det program, der er registreret i Microsoft Azure-portalen. Du modtog disse oplysninger tidligere under trinnet Registrer appen i Microsoft Azure .
    • AAD-ressource: Placer denne værdi 00000015-0000-0000-c000-000000000000.
  5. Vælg Gem og luk.

Tildel apptilladelser i Dynamics 365 Finance and Operations

Tildel tilladelser til de to Microsoft Entra-programmer i Dynamics 365 Finance and Operations-programmet:

  1. I Dynamics 365-økonomi og -drift skal du gå til siden Systemadministration –> Installation –> Siden Microsoft Entra ID-programmer .
  2. Vælg Ny for at oprette en ny programpost:
    • Angiv klient-id'et for den app, du har registreret i Microsoft Azure-portalen, i feltet Klient-id.
    • Angiv navnet på den app, du har registreret i Microsoft Azure-portalen, i feltet Navn.
    • I feltet Bruger-id skal du vælge bruger-id'et for en bruger med administratortilladelser i Dynamics 365 Finance and Operations og Power Apps-miljøet.
  3. Vælg Ny for at oprette en anden applikationspost:
    • Klient-id: f9be0c49-aa22-4ec6-911a-c5da515226ff
    • Navn: Dynamics 365 HR Virtual Table
    • I feltet Bruger-id skal du vælge bruger-id'et for en bruger med administratortilladelser i Finops og Power Apps-miljøet.

Generere virtuelle tabeller

Når installationen er fuldført, kan du vælge de virtuelle tabeller, du vil generere og aktivere i din Dataverse-forekomst.

  1. Åbn udviklerportalen, og vælg dit miljø.
  2. Vælg tabellen Tilgængelige HR-enheder .
  3. Vælg den tabel eller de tabeller, du vil oprette i Dataverse.
  4. Vælg Er genereret/opdateret.

Hvis du vil se de enheder, der er til stede til dayforce-integration, skal du se Mshr-lønenheder.

Ændringssporing

Ændringssporingsfunktionen i Dataverse registrerer data, der er ændret, siden dataene oprindeligt blev udtrukket eller sidst synkroniseret. Du kan få flere oplysninger i Bruge sporing af ændringer til at synkronisere data med eksterne systemer.

Følg disse trin for at aktivere sporing af ændringer.

  1. Gå til Systemadministration > Dataadministration > Dataobjekter.
  2. Søg efter destinationsobjektet.
  3. Slå Spor ændringer til.
Destinationsobjekt Ændringssporing
DirPersonNameHistoricalEntity Alle tabeller
HcmCompFixedEmplEntity Alle tabeller
HcmCompFixedPlanTableEntity Alle tabeller
HcmCompVarPlanTableEntity Alle tabeller
HcmEmployeeEntity Alle tabeller
HcmEmployeeV2Entity Alle tabeller
HcmEmploymentDetailEntity Alle tabeller
HcmEmploymentEmployeeEntity Alle tabeller
HcmEmploymentEntity Alle tabeller
HcmEmploymentTypeEntity Alle tabeller
HcmEmploymentV2Entity Alle tabeller
HcmIdentificationTypeEntity Alle tabeller
HcmJobBaseEntity Alle tabeller
HcmJobCompensationEntity Alle tabeller
HcmJobDetailEntity Alle tabeller
HcmJobEntity Primær tabel
HcmJobFamilyEntity Alle tabeller
HcmJobFunctionEntity Alle tabeller
HcmJobTaskEntity Alle tabeller
HcmJobTypeEntity Alle tabeller
HcmLaborUnionEntity Alle tabeller
HcmPersonDetailsEntity Alle tabeller
HcmPersonIdentificationNumberEntity Alle tabeller
HcmPositionBaseEntity Alle tabeller
HcmPositionDefaultDimensionEntity Alle tabeller
HcmPositionDetailEntity Alle tabeller
HcmPositionEntity Primær tabel
HcmPositionHierarchyEntity Alle tabeller
HcmPositionHierarchyTypeEntity Alle tabeller
HcmPositionTypeEntity Alle tabeller
hcmPositionUnionAgreementEntity Alle tabeller
HcmPositionV2Entity Alle tabeller
HcmPositionWorkerAssignmentEntity Primær tabel
HcmPositionWorkerAssignmentV2Entity Primær tabel
HcmUnionsEntity Alle tabeller
HcmVariableCompensationTypeEntity Alle tabeller
HcmWorkerBankAccountEntity Alle tabeller
HcmWorkerBaseEntity Brugerdefineret
HcmWorkerEntity Brugerdefineret
HcmWorkerPayrollInfoEntity Alle tabeller
PayrollBankAccountDisbursementEntity Primær tabel
PayrollEmployeeEntity Primær tabel
PayrollFixedCompensationPlanEntity Alle tabeller
PayrollPositionDetailsEntity Alle tabeller
PayrollPositionEntity Alle tabeller
PayrollPositionJobEntity Alle tabeller
PayrollWorkerAddressCurrentEntity Alle tabeller

Tilføj Dayforce Connector-bruger i Dynamics 365 Finance and Operations

  1. Gå til Systemadministration>Lederbruger, og vælg Ny bruger.
  2. Angiv værdier i felterne Bruger-id, Brugernavn, Brugermail og Rolle.
  3. Brug den tidligere oprettede API Dayforce Connector-rolle.

Note

Brugernavnet og adgangskoden er påkrævet til opsætning af MyIntegration-portalen i Dayforce.

Aktivere forbindelsen

Vigtig

Denne sektion kræver en bruger, der har fuld administrativ sikkerhedsadgang til Dataverse og Azure-lejer. Brugeren skal også have ret til at give samtykke på vegne af virksomheden (lejer) for at tillade adgang til Human Resources API'erne.

Hvis du vil forbinde HR-miljøet med Dayforce-lønningslisten, skal du følge disse trin:

  1. Tilføj Dayforce payroll connector-applikationen i lejeren.
  2. Konfigurer en API-rolle for Dataverse-miljøet.

Aktivere Dayforce people connector-applikationen på kundelejeren

Kundens Microsoft-lejer kontrollerer al aktivitet i kundens Microsoft-miljø. Denne aktivitet omfatter sikkerhed og adgang til alle Microsoft-applikationer. Ved at aktivere Dayforce people-connectoren på lejeren sætter du den i stand til at kommunikere med de nødvendige Microsoft-applikationer, der bruges i denne integration.

  1. Gå til https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=6817703f-e5b3-4eec-b11f-ba6367f1b156&response_type=id_token&redirect_uri=https://developersdev.dayforce.com/Dev/Microsoft-to-Dayforce-Connector.aspx&scope=openid&response_mode=fragment&state=12345&nonce=678910.
  2. Aktivér URL-adressen for virksomheden.
  3. Vælg Samtykke på vegne af din organisation.

Tilføj Dayforce people-connectoren i Dataverse

Du skal tilføje Dayforce people-connectoren i din specifikke Dataverse-instans.

  1. Åbn Power Platform Administration, gå til Miljø>Indstillinger>Programbrugere, og vælg Ny bruger.

  2. Tilføj programmet Dayforce people-connectoren. App-id'et er 6817703f-e5b3-4eec-b11f-ba6367f1b156.

  3. Giv programmet følgende sikkerhedsroller:

    • Basic-bruger
    • Basic-bruger af finans og drift

Du kan finde flere oplysninger i følgende ressourcer:

Tilføj Dayforce people-connectoren i Human Resources-miljøet

  1. I Human Resources skal du gå til Microsoft Entra-applikation og vælge Ny.
  2. Tilføj den Dayforce payroll-connector, der har klient-id'et 6817703f-e5b3-4eec-b11f-ba6367f1b156 og bruger-id'et DFAPIConnector.

Klar til at betale

Vigtig

Før medarbejdere kan integreres i Dayforce, skal de være markeret Klar til at betale. Medarbejdere, der ikke er markeret Klar til at betale, bliver ikke afhentet.

Dayforce people connector-integrationen bruger Microsofts betalingsklare funktion til at sikre, at der er oprettet en komplet, gyldig medarbejderprofil, før lønnen behandles. Du kan finde flere oplysninger i Klar til at betale.