Introdução da API de integração do sistema de acompanhamento de candidatos

  • Artigo

Aplica-se a estes aplicativos do Dynamics 365:
Recursos Humanos

Este artigo descreve a API de integração do ATS (Sistema de Acompanhamento de Candidatos) do Dynamics 365 Human Resources. A intenção da API é habilitar integrações otimizadas entre o Dynamics 365 Human Resources e ATSs de parceria.

Fluxo de integração do ATS.

A experiência integrada começa no Human Resources quando um gerente de contratação cria uma solicitação de recrutamento. Quando a solicitação é ativada, o ATS recebe os detalhes da solicitação para criar um projeto de recrutamento. Ele segue o pipeline de recrutamento para selecionar e contratar um candidato para as posições. Finalmente, o ATS conclui a integração de ida e volta enviando o registro do candidato selecionado para o Human Resources. O registro de candidatos pode passar pela integração de mais validações e fluxos de trabalho para criar o registro de funcionário.

Para habilitar a integração, o Human Resources adicionou os seguintes componentes:

  1. Funcionalidade para criar uma solicitação de recrutamento.
  2. Um perfil de candidato expandido e os fluxos de trabalho relacionados.
  3. Uma API de integração que abre a nova funcionalidade para integrar aplicativos.

Para obter mais informações sobre como configurar e usar a solicitação de recrutamento e a funcionalidade do candidato, consulte Recrutar candidatos ao trabalho.

Microsoft Dataverse

Esta API foi desenvolvida com base no Microsoft Dataverse (antes conhecido como Common Data Service). Toda a interação RESTful com essa API é realizada por meio da API Web do Microsoft Dataverse, que usa OData. Essa API é um subconjunto da API Web do Dataverse. A API Web do Dataverse define características como autenticação, SLAs, lote, controle de simultaneidade e tratamento de erros.

Para obter mais informações gerais sobre a API Web do Microsoft Dataverse, consulte:

A documentação acima inclui detalhes e orientações do desenvolvedor sobre o uso da API Web do Dataverse, como gerenciamento de autenticação, execução de operações e uso do controle de alterações ou tokens delta com a API.

Conjuntos de opções

O modelo de dados para a API de integração ATS descrito neste documento inclui conjuntos de opções que fornecem valores enumerados associados a propriedades da entidade. Para obter detalhes sobre como trabalhar com conjuntos de opções na API Web do Dataverse, consulte Criar e atualizar conjuntos de opções usando a API Web. Os conjuntos de opções são definidos para cada ambiente do Dataverse.

Tabelas virtuais para o Human Resources no Dataverse

Os pontos de extremidade para a API de integração ATS usam os recursos da plataforma de tabela virtual do Microsoft Dataverse. Por padrão, as tabelas virtuais e os pontos de extremidade da API associados não são implantados para ambientes do Human Resources, permitindo que organizações determinem quais pontos de extremidade OData serão expostos para o ambiente. Para usar a API, as tabelas virtuais de entidades do Human Resources devem ser geradas para o ambiente.

Para obter informações sobre como gerar as tabelas virtuais da API, consulte Configurar tabelas virtuais do Dataverse.

Modelo de dados

O modelo de dados está centrado em duas entidades principais:

  • RecruitingRequest representa uma solicitação de um ATS para recrutar uma ou mais posições abertas. Para obter um exemplo de consulta, consulte Exemplo de consulta para solicitação de recrutamento.
  • CandidateToHire representa detalhes de um candidato que aceitou uma oferta para uma posição. Pessoa representa o indivíduo que é o candidato. Uma pessoa pode ter várias funções na empresa, como candidato, trabalhador, funcionário ou prestador de serviço. Para obter um exemplo de consulta, consulte Exemplo de consulta de candidato a ser contratado.

O diagrama a seguir ilustra relacionamentos na API. Vários tipos têm chaves estrangeiras para outras entidades preexistentes no Human Resources que não estão ilustradas aqui. Este documento fornece informações sobre entidades específicas para recrutar cenários de integração. No entanto, há várias outras entidades na API Web do Dataverse para o Dynamics 365 Human Resources que também podem ser relevantes para sua integração. Por exemplo, você também pode precisar de detalhes sobre trabalhadores, cargos, posições ou outras entidades não definidas aqui. Muitas dessas entidades são referenciadas em relações de chave estrangeira ou propriedades de navegação.

Modelo de dados de API de integração do ATS.

Exemplo de consulta:

Entidades:

Conjuntos de opções:

Exemplo de consulta:

Entidades:

Conjuntos de opções:

Consulte também

Candidatos de trabalho de recrutamento
O que é o Microsoft Dataverse?
Use a API Web do Microsoft Dataverse
Criar e atualizar conjuntos de opções usando a API Web