Introduktion av API för integrering av system för sökandespårning
Gäller dessa Dynamics 365-appar:
Human Resources
Detta ämne beskriver API för integrering av system för sökandespårning (ATS) för Dynamics 365 Human Resources. Syftet med API:et är att möjliggöra effektiviserad integrering mellan Dynamics 365 Human Resources och ATS-partner.

Den integrerade erfarenheten börjar i Personal när en anställningsansvarig skapar en rekryteringsbegäran. När begäran har aktiverats hämtar ATS uppgifter om förfrågningen för att skapa ett rekryteringsprojekt. Därefter följer det rekryteringsförloppet för att välja och anställa en kandidat för befattningen/befattningarna. Slutligen slutför ATS integreringen genom att skicka den valda kandidatens post till Personal. Kandidatposten kan sedan gå igenom fler registreringsvalideringar och arbetsflöden för att skapa medarbetarposten.
För att aktivera integreringen har Personal lagt till följande komponenter:
- Funktion för att skapa en rekryteringsbegäran.
- En expanderad kandidatprofil och relaterade arbetsflöden.
- Ett integrations-API som öppnar den nya funktionen för integrering av program.
Mer information om hur du ställer in och använder funktionen för rekryteringsbegäran och kandidater finns i Rekrytera jobbkandidater.
Microsoft Dataverse
Detta API bygger på Microsoft Dataverse (tidigare Common Data Service). All RESTful-interaktion med denna API sker via webb-API för Microsoft Dataverse, som använder OData. Detta API är en underuppsättning av webb-API för Dataverse. Webb-API för Dataverse definierar egenskaper såsom autentisering, serviceavtal, batch, samtidighetskontroll och felhantering.
Mer allmän information om webb-API för Microsoft Dataverse finns här:
- Vad är Microsoft Dataverse?
- Använd webb-API för Microsoft Dataverse
- Utvecklarguide för Microsoft Dataverse
Dokumentationen ovan innehåller information och utvecklarvägledning om hur du använder webb-API för Dataverse, exempelvis hanterar autentiseringar, genomför åtgärder, använder Postman med API samt använder ändringsspårnings- eller delta-tokens med API:t.
Alternativuppsättningar
Datamodellen för den API för ATS-integrering som beskrivs i det här dokumentet innehåller alternativuppsättningar som tillhandahåller fasta värden associerade med entitetsegenskaper. Mer information om hur du arbetar med alternativuppsättningar i webb-API för Dataverse finns i Skapa och uppdatera alternativuppsättningar med hjälp av webb-API. Alternativuppsättningar definieras för respektive Dataverse-miljö.
Virtuella register för Personal i Dataverse
Slutpunkterna för API för ATS-integration använder plattformsfunktionerna för det virtuella registret i Microsoft Dataverse. Som standard distribueras inte de virtuella registren och deras associerade API-slutpunkter för Personal-miljöer, vilket låter organisationer att avgöra vilka OData-slutpunkter som ska visas för miljön. Om du vill använda API:t måste de virtuella registren för Personal-entiteterna genereras för miljön.
Information om hur du genererar virtuella register för API:et finns i Konfigurera virtuella Dataverse-register.
Datamodell
Datamodellen centreras kring två huvudentiteter:
- RecruitingRequest representerar en begäran till en ATS att rekrytera för en eller flera öppna befattningar. En exempelfrågeställning finns i Exempelfrågeställning för Rekryteringsbegäran.
- CandidateToHire representerar detaljer om en kandidat som har accepterat ett erbjudande om en befattning. Person representerar den person som är kandidat. En person kan ha flera roller i företaget, till exempel kandidat, medarbetare, anställd eller entreprenör. För en exempelfrågeställning, se Exempelfrågeställning för Kandidat att anställa.
Följande diagram visar relationer inom API:t. Flera typer har utländska nycklar till andra, befintliga entiteter i Personal som inte visas här. Detta dokument innehåller information om entiteter som är specifika för rekryteringintegreringsscenarier. Det finns dock många andra entiteter i webb-API:t för Dataverse för Dynamics 365 Human Resources som också kan vara relevanta för din integrering. Du kanske till exempel också behöver detaljer för medarbetare, jobb, befattningar eller andra entiteter som inte har definierats här. Många av dessa entiteter refereras i relationer med utländska nycklar eller navigeringsegenskaper.

Rekryteringsbegäran och relaterade entiteter och alternativuppsättningar
Exempelfrågeställning:
Enheter:
- Rekryteringsbegäran
- Befattning för rekryteringsbegäran
- Färdighet för rekryteringsbegäran
- Utbildning för rekryteringsbegäran
- Plats för rekryteringsbegäran
Alternativuppsättningar:
- Befrielsestatus för jobb
- Befattningsstatus för rekryteringsbegäran
- Status för rekryteringsbegäran
- Kategori för lagstadgade jobb
Kandidat att anställa och relaterade enheter och alternativuppsättningar
Exempelfrågeställning:
Enheter:
- Kandidat att anställa
- Person
- Personens utbildning
- Personens yrkeserfarenhet
- Personens adress
- Partens kontakt
- Personens färdighet
- Bedömningsnivå
- Personens certifikat
- Certifikattyp
- Personkontroller
- Kontrolltyper
- Personens ID-nummer
Alternativuppsättningar:
- Resultat för integration av sökande
- Tomt Ja nej
- Slutförandestatus
- Kontakttyp
- Bas för utbildningskredit
- Kön
- Civilstånd
- Månader under året
- Nej Ja
- Periodenhet
- Kontrollfrekvens
- Kontrollfrekvens genereras från
- Typ av färdighetsnivå
Se även
Rekrytera jobbkandidater
Vad är Microsoft Dataverse?
Använd webb-API för Microsoft Dataverse
Skapa och uppdatera alternativuppsättningar med hjälp av webb-API:t