Einführung der API zur Integration des Bewerber-Tracking-Systems

Gilt für diese Dynamics 365-Apps:
Human Resources

Dieser Artikel beschreibt die Dynamics 365 Human Resources-API zur Integration des Applicant Tracking System (ATS). Die Absicht der API ist es, optimierte Integrationen zwischen Dynamics 365 Human Resources und ATSs, die eine Partnerschaft eingehen, zu ermöglichen.

Flow der ATS-Integration.

Die integrierte Erfahrung beginnt in der Personalabteilung, wenn ein Personalchef einen Personalbeschaffungsantrag erstellt. Wenn die Anfrage aktiviert ist, ruft der ATS die Details für die Anfrage ab, um ein Rekrutierungsprojekt zu erstellen. Anschließend folgt er die Rekrutierungspipeline, um einen Kandidaten für die Position(en) auszuwählen und einzustellen. Schließlich schließt der ATS die umfassende Integration ab, indem er den Datensatz des ausgewählten Kandidaten an die Personalabteilung sendet. Der Kandidatendatensatz kann dann weitere Onboarding-Validierungen und Workflows durchlaufen, um den Mitarbeiterdatensatz zu erstellen.

Um die Integration zu ermöglichen, hat Human Resources die folgenden Komponenten hinzugefügt:

  1. Funktionalität zum Erstellen eines Personalbeschaffungsantrags.
  2. Ein erweitertes Kandidatenprofil und zugehörige Workflows.
  3. Eine Integrations-API öffnet die neue Funktionalität für die Integration von Anwendungen.

Weitere Informationen zum Einrichten und Verwenden des Personalbeschaffungsantrags und der Kandidatenfunktionalität finden Sie unter Rekrutieren von Bewerbern auf eine Stelle.

Microsoft Dataverse

Diese API basiert auf Microsoft Dataverse (früher Common Data Service). Alle RESTful-Interaktionen mit dieser API erfolgen über die Microsoft Dataverse-Web-API, die OData verwendet. Diese API ist eine Teilmenge der Dataverse-Web-API. Die Dataverse-Web-API definiert Merkmale wie Authentifizierung, SLAs, Stapelverarbeitung, Parallelitätskontrolle und Fehlerbehandlung.

Weitere allgemeine Informationen zur Microsoft Dataverse-Web-API finden Sie unter:

Die obige Dokumentation enthält detaillierte und Entwickleranleitungen zur Verwendung der Dataverse-Web-API, z. B. Authentifizierung verwalten, Vorgänge durchführen und Änderungsverfolgung oder Delta-Token verwenden mit der API.

Optionssätze

Das in diesem Dokument beschriebene Datenmodell für die ATS-Integrations-API enthält Optionssätze, die Aufzählungswerte für Entitätseigenschaften bereitstellen. Ausführliche Informationen zum Arbeiten mit Optionssätzen finden Sie in der Dataverse-Web-API unter Erstellen und Aktualisieren von Optionssätze mithilfe der Web-API. Optionssätze sind für jede Dataverse-Umgebung definiert.

Virtuelle Tabellen für Human Resources in Dataverse

Die Endpunkte für die ATS-Integrations-API verwenden die Funktionen der Plattform für virtuelle Tabellen von Microsoft Dataverse. Standardmäßig werden die virtuellen Tabellen und die zugehörigen API-Endpunkte nicht für Human Resources-Umgebungen bereitgestellt, sodass Unternehmen bestimmen können, welche OData-Endpunkte für die Umgebung verfügbar gemacht werden. Um die API verwenden zu können, müssen die virtuellen Tabellen für die Personalentitäten für die Umgebung generiert werden.

Informationen zum Generieren der virtuellen Tabellen für die API finden Sie unter Konfigurieren von virtuellen Dataverse-Tabellen.

Datenmodell

Das Datenmodell konzentriert sich auf zwei Hauptentitäten:

  • RecruitingRequest stellt eine Anfrage an einen ATS dar, für eine oder mehrere offene Positionen zu rekrutieren. Eine Beispielabfrage finden Sie unter Beispielabfrage für den Personalbeschaffungsantrag.
  • CandidateToHire stellt Details eines Kandidaten dar, der ein Angebot für eine Position angenommen hat. Person repräsentiert die Person, die der Kandidat ist. Eine Person kann mehrere Rollen im Unternehmen haben, z. B. ein Kandidat, eine Arbeitskraft, ein Mitarbeiter oder ein Auftragnehmer. Eine Beispielabfrage finden Sie unter Beispielabfrage für Kandidaten zur Einstellung.

Das folgende Diagramm veranschaulicht die Beziehungen innerhalb der API. Einige Typen verfügen über Fremdschlüssel für andere bereits vorhandene Entitäten in Human Resources, die hier nicht dargestellt sind. Dieses Dokument enthält Informationen zu Entitäten, die für die Rekrutierung von Integrationsszenarien spezifisch sind. Es gibt jedoch viele andere Entitäten in der Dataverse-Web-API für Dynamics 365 Human Resources, die auch für Ihre Integration relevant sein können. Beispielsweise benötigen Sie möglicherweise auch Details für Mitarbeiter, Stellen, Positionen oder andere Entitäten, die hier nicht definiert sind. Viele dieser Entitäten werden in Fremdschlüsselbeziehungen oder Navigationseigenschaften referenziert.

Datenmodell von ATS-Integrations-API.

Beispielabfrage:

Entitäten:

Optionssätze:

Beispielabfrage:

Entitäten:

Optionssätze:

Siehe auch

Kandidaten für Stelle anwerben
Was ist Microsoft Dataverse?
Verwenden der Microsoft Dataverse-Web-API
Erstellen und Aktualisieren von Optionssätzen mithilfe der Web-API