Introduction à l’API d’intégration du système de suivi des candidats

Important

La fonctionnalité indiquée dans cet article est actuellement disponible dans la version autonome de Dynamics 365 Human Resources et l’infrastructure de Finance fusionnée. La navigation peut être différente de celle indiquée pendant que nous effectuons des mises à jour. Si vous avez besoin de trouver une page spécifique, vous pouvez utiliser la fonction de recherche.

S’applique aux applications Dynamics 365 suivantes :
Ressources humaines

Cet article décrit l’API d’intégration du système de suivi des candidats Dynamics 365 Human Resources. Cette API a pour but de permettre des intégrations rationalisées entre Dynamics 365 Human Resources et les ATS partenaires.

Flux d’intégration ATS.

L’expérience intégrée débute dans Human Resources lorsqu’un responsable du recrutement crée une demande de recrutement. Lorsque la demande est activée, l’ATS extrait le détail de la demande pour créer un projet de recrutement. Ensuite, il suit le processus de recrutement pour sélectionner et embaucher un candidat. Enfin, l’ATS complète l’intégration complète en envoyant le dossier du candidat sélectionné dans Human Resources. Le dossier de candidature peut ensuite passer par d’autres validations d’intégration et flux de travail pour créer la fiche du collaborateur.

Pour permettre l’intégration, Human Resources a ajouté les composants suivants :

  1. Fonctionnalité pour créer une demande de recrutement.
  2. Un profil de candidat étendu et les flux de travail associés.
  3. Une API d’intégration ouvrant la nouvelle fonctionnalité à l’intégration d’applications.

Pour plus d’informations sur la configuration et l’utilisation de la demande de recrutement et de la fonctionnalité de candidature, voir Recruter des candidats à un poste.

Microsoft Dataverse

Cette API repose sur Microsoft Dataverse (auparavant Common Data Service). Toutes les interactions RESTful avec cette API se font via l’API Web Microsoft Dataverse, qui utilise OData. Cette API est un sous-ensemble de l’API Web Dataverse. L’API Web Dataverse définit des caractéristiques telles que l’authentification, les SLA, les lots, le contrôle de la concurrence et la gestion des erreurs.

Pour plus d’informations générales sur l’API Web Microsoft Dataverse :

La documentation ci-dessus comprend des détails et des conseils pour les développeurs sur l’utilisation de l’API Web Dataverse, comme gérer l’authentification, effectuer des opérations, utiliser Postman avec l’API, et utiliser le suivi des modifications ou des jetons delta avec l’API.

Jeux d’options

Le modèle de données pour l’API d’intégration ATS décrit dans ce document comprend des ensembles d’options qui fournissent des valeurs énumérées associées aux propriétés d’entité. Pour plus de détails sur l’utilisation des jeux d’options dans l’API Web Dataverse, voir Créer et mettre à jour des ensembles d’options à l’aide de l’API Web. Des ensembles d’options sont définis pour chaque environnement Dataverse.

Tables virtuelles pour Human Resources dans Dataverse

Les points de terminaison de l’API d’intégration ATS utilisent les capacités de la plateforme de table virtuelle de Microsoft Dataverse. Par défaut, les tables virtuelles et leurs points de terminaison d’API associés ne sont pas déployés pour les environnements Human Resources, ce qui permet aux organisations de déterminer quels points de terminaison OData seront exposés pour l’environnement. Pour utiliser l’API, les tables virtuelles des entités Ressources humaines doivent être générées pour l’environnement.

Pour plus d’informations sur la génération des tables virtuelles pour l’API, consultez Configurer les tables virtuelles Dataverse.

Modèle de données

Le modèle de données est centré autour de deux entités principales :

  • RecruitingRequest représente une demande adressée à un ATS pour recruter un ou plusieurs candidats. Pour obtenir un exemple de requête, voir Exemple de requête pour une demande de recrutement.
  • CandidateToHire représente les détails d’un candidat qui a accepté une offre de poste. Personne représente l’individu qui est le candidat. Une personne peut avoir plusieurs rôles dans l’entreprise, tels que candidat, travailleur, employé ou sous-traitant. Pour un exemple de requête, voir Exemple de requête pour l’entité Candidat à l’embauche.

Le diagramme suivant illustre les relations au sein de l’API. Plusieurs types ont des clés étrangères vers d’autres entités préexistantes dans Human Resources qui ne sont pas illustrées ici. Ce document fournit des informations sur les entités spécifiques aux scénarios d’intégration de recrutement. Cependant, il existe de nombreuses autres entités dans l’API Web Dataverse pour Dynamics 365 Human Resources qui peuvent également être pertinentes pour votre intégration. Par exemple, vous pouvez également avoir besoin de détails sur les travailleurs, les emplois, les postes ou d’autres entités non définies ici. Beaucoup de ces entités sont référencées dans des relations de clé étrangère ou des propriétés de navigation.

Modèle de données de l’API d’intégration ATS.

Exemple de requête :

Entités :

Jeux d’options :

Exemple de requête :

Entités :

Jeux d’options :

Voir également :

Recruter des candidats à un poste
Qu’est-ce que Microsoft Dataverse ?
Utiliser l’API Web Microsoft Dataverse
Créer et mettre à jour des ensembles d’options à l’aide de l’API Web