Compartir a través de

Introducción a la API de integración del sistema de seguimiento de candidatos

  • Artículo

Se aplica a estas aplicaciones de Dynamics 365:
Human Resources

Este artículo describe la API de integración del sistema de seguimiento de candidatos (ATS) de Dynamics 365 Human Resources. La intención de la API es permitir integraciones optimizadas entre Dynamics 365 Human Resources y los ATS asociados.

Flujo de integración con ATS.

La experiencia integrada comienza en Recursos Humanos, cuando un gerente de contratación crea una solicitud de contratación. Cuando se activa la solicitud, el ATS extrae el detalle de la solicitud para crear un proyecto de contratación. Luego sigue el proceso de contratación para seleccionar y contratar candidatos para los puestos. Finalmente, el ATS completa la integración de ida y vuelta enviando el registro del candidato seleccionado a Recursos Humanos. El registro de candidato puede luego pasar por más validaciones de incorporación y flujos de trabajo para crear el registro de empleado.

Para habilitar la integración, Recursos Humanos ha agregado los siguientes componentes:

  1. Funcionalidad para crear una solicitud de contratación.
  2. Un perfil de candidato ampliado y flujos de trabajo relacionados.
  3. Una API de integración que abre la nueva funcionalidad para integrar aplicaciones.

Para obtener más información sobre cómo configurar y utilizar la funcionalidad de solicitud de contratación y candidatos, consulte Contratar candidatos para el trabajo.

Microsoft Dataverse

Esta API se basa en Microsoft Dataverse (antes Common Data Service). Toda la interacción RESTful con esta API se realiza a través de la API web Microsoft Dataverse, que utiliza OData. Esta API es un subconjunto de la API web de Dataverse. La API web de Dataverse define características como autenticación, SLA, lotes, control de concurrencia y manejo de errores.

Para obtener más información general acerca de la API web de Microsoft Dataverse, consulte:

La documentación anterior incluye detalles y orientación para desarrolladores sobre el uso de la API web de Dataverse, como gestionar la autenticación, realizar operaciones y uso de seguimiento de cambios o tokens delta con la API.

Conjuntos de opciones

El modelo de datos para la API de integración ATS descrito en este documento incluye conjuntos de opciones que proporcionan valores enumerados asociados con las propiedades de la entidad. Para obtener detalles sobre cómo trabajar con conjuntos de opciones en la API web de Dataverse, consulte Crear y actualizar conjuntos de opciones usando la API web. Los conjuntos de opciones se definen para cada entorno de Dataverse.

Tablas virtuales para Recursos Humanos en Dataverse

Los puntos de conexión de la API de integración ATS utilizan las capacidades de la plataforma de tabla virtual de Microsoft Dataverse. De forma predeterminada, las tablas virtuales y sus puntos de conexión de API asociados no se implementan para entornos de Recursos Humanos, lo que permite a las organizaciones determinar qué punto de conexión estarán expuestos para el entorno. Para utilizar la API, se deben generar las tablas virtuales para las entidades de Recursos Humanos para el entorno.

Para obtener información sobre la generación de tablas virtuales para la API, consulte Configurar tablas virtuales de Dataverse.

Modelo de datos

El modelo de datos se centra en dos entidades principales:

  • RecruitingRequest representa una solicitud a un ATS de contratar para una o más posiciones abiertas. Para una consulta de ejemplo, vea Consulta de ejemplo para solicitud de contratación.
  • CandidateToHire representa detalles de un candidato que ha aceptado una oferta para un puesto. Persona representa al individuo que es el candidato. Una persona puede tener varios roles en la empresa, como candidato, trabajador, empleado o contratista. Para obtener una consulta de ejemplo, consulte Consulta de ejemplo para candidato a contratar.

El siguiente diagrama ilustra las relaciones dentro de la API. Diversos tipos tienen claves extranjeras para otras entidades preexistentes en Recursos Humanos que no se ilustran aquí. Este documento proporciona información sobre las entidades específicas para los escenarios de integración de contratación. Sin embargo, hay muchas otras entidades en la API web de Dataverse para Dynamics 365 Human Resources que también pueden ser relevantes para su integración. Por ejemplo, es posible que también necesite detalles para trabajadores, trabajos, puestos u otras entidades no definidas aquí. Muchas de estas entidades están referenciadas en relaciones de clave externa o propiedades de navegación.

Modelo de datos de API de integración de ATS.

Consulta de ejemplo:

Entidades:

Conjuntos de opciones:

Consulta de ejemplo:

Entidades:

Conjuntos de opciones:

Consulte también

Contratar candidatos de trabajo
¿Qué es Microsoft Dataverse?
Utilizar la API web de Microsoft Dataverse
Crear y actualizar conjuntos de opciones usando la API web