Condividi tramite

Introduzione all'API di integrazione del sistema di tracciabilità dei candidati

  • Articolo

Si applica a queste app Dynamics 365:
Human Resources

Questo articolo descrive l'API di integrazione del sistema di tracciabilità dei candidati (ATS) Dynamics 365 Human Resources. Lo scopo dell'API è abilitare le integrazioni semplificate tra Dynamics 365 Human Resources e i sistemi ATS dei partner.

Flusso di integrazione ATS.

L'esperienza integrata inizia in Human Resources quando un responsabile delle assunzioni crea una richiesta di reclutamento. Quando la richiesta viene attivata, l'ATS estrae i dettagli della richiesta per creare un progetto di reclutamento. Quindi segue la pipeline di reclutamento per selezionare e assumere un candidato per le posizioni. Infine, l'ATS completa l'integrazione round trip inviando il record del candidato selezionato in Human Resources. Il record del candidato può quindi passare attraverso più convalide e flussi di lavoro di onboarding per creare il record del dipendente.

Per abilitare l'integrazione, Human Resources ha aggiunto i seguenti componenti:

  1. Funzionalità per creare una richiesta di reclutamento.
  2. Un profilo candidato ampliato e flussi di lavoro correlati.
  3. Un'API di integrazione che apre le nuove funzionalità alle applicazioni di integrazione.

Per ulteriori informazioni sulla configurazione e l'utilizzo della richiesta di reclutamento e della funzionalità candidato, vedi Selezione dei candidati.

Microsoft Dataverse

Questa API è creata su Microsoft Dataverse (in precedenza Common Data Service). Tutta l'interazione RESTful con questa API viene eseguita tramite l'API Web Microsoft Dataverse, che utilizza OData. Questa API è un sottoinsieme di API Web Dataverse. L'API Web Dataverse definisce caratteristiche quali autenticazione, SLA, batch, controllo della concorrenza e gestione degli errori.

Per ulteriori informazioni generali sull'API Web Microsoft Dataverse, vedi:

La documentazione di cui sopra include dettagli e indicazioni per sviluppatori sull'utilizzo dell'API Web Dataverse, ad esempio gestione dell'autenticazione, esecuzione delle operazioni e uso del rilevamento delle modifiche o i token delta con l'API.

Set di opzioni

Il modello di dati per l'API di integrazione ATS descritto in questo documento include set di opzioni che forniscono valori enumerati associati alle proprietà dell'entità. Per i dettagli su come lavorare con i set di opzioni nell'API Web Dataverse, vedi Crea e aggiorna i set di opzioni utilizzando l'API Web. I set di opzioni sono definiti per ciascun ambiente Dataverse.

Tabelle virtuali per Human Resources in Dataverse

Gli endpoint per l'API di integrazione ATS utilizzano le funzionalità della piattaforma di tabelle virtuali di Microsoft Dataverse. Per impostazione predefinita, le tabelle virtuali e gli endpoint API associati non vengono distribuiti per gli ambienti Human Resources, consentendo alle organizzazioni di determinare quali endpoint OData saranno esposti per l'ambiente. Per utilizzare l'API, le tabelle virtuali per le entità Human Resources devono essere generate per l'ambiente.

Per informazioni sulla generazione delle tabelle virtuali per l'API, vedi Configura tabelle virtuali Dataverse.

Modello dati

Il modello di dati è incentrato su due entità principali:

  • RecruitingRequest rappresenta una richiesta a un ATS di reclutare per una o più posizioni aperte. Per una query di esempio, vedi Query di esempio per richiesta di selezione.
  • CandidateToHire rappresenta i dettagli di un candidato che ha accettato un'offerta per una posizione. Person rappresenta l'individuo che è il candidato. Una persona può avere più ruoli nell'azienda, come candidato, lavoratore, dipendente o terzista. Per una query di esempio, vedi Query di esempio per il candidato da assumere.

Nel diagramma riportato di seguito vengono illustrate le relazioni all'interno dell'API. Diversi tipi hanno chiavi esterne per altre entità preesistenti in Human Resources che non sono illustrate qui. Questo documento fornisce informazioni sulle entità specifiche per gli scenari di integrazione della selezione. Tuttavia, ci sono molte altre entità nell'API Web Dataverse per Dynamics 365 Human Resources potrebbe anche essere rilevante per la tua integrazione. Ad esempio, potresti anche aver bisogno di dettagli per lavoratori, lavori, posizioni o altre entità non definite qui. Molte di queste entità sono referenziate in relazioni di chiavi esterne o proprietà di navigazione.

Modello di dati dell'API di integrazione ATS.

Query di esempio:

Entità:

Set di opzioni:

Query di esempio:

Entità:

Set di opzioni:

Vedere anche

Selezione dei candidati
Che cos'è Microsoft Dataverse?
Usa l'API Web Microsoft Dataverse
Crea e aggiorna i set di opzioni utilizzando l'API Web