Введение в интерфейс API интеграции системы отслеживания кандидатов

2024-04-30

Применяется к следующим приложениям Dynamics 365:
Human Resources

В этой статье описывается API-интерфейс интеграции системы отслеживания кандидатов (ATS) Dynamics 365 Human Resources. Целью API является обеспечение оптимизации интеграции между Dynamics 365 Human Resources и партнерскими системами ATS.

Поток интеграци ATS.

Интегрированный опыт начинается в модуле Human Resources, когда менеджер по найму создает запрос на прием на работу. Когда запрос активирован, ATS извлекает сведения о запросе для создания проекта набора персонала. Затем она следует конвейеру набора персонала, чтобы выбрать и нанять кандидата на должности. Наконец, ATS выполняет обратную интеграцию, отправляя запись выбранного кандидата в модуль Human Resources. Затем запись кандидата может пройти несколько проверок адаптации и рабочих процессов для создания записи сотрудника.

Для включения интеграции модуль Human Resources добавил следующие компоненты:

Функциональность для создания запроса на набор персонала.
Расширенный профиль кандидата и соответствующие рабочие процессы.
API интеграции, открывающий новые функции для интеграции приложений.

Дополнительные сведения о настройке и использовании запроса на набор персонала и функции кандидата см. в разделе Набор кандидатов на должности.

Microsoft Dataverse

Этот API построен на основе Microsoft Dataverse (ранее Common Data Service). Все взаимодействие RESTful с этим API осуществляется с помощью веб-API Microsoft Dataverse, использующего OData. Этот API является подмножеством веб-API Dataverse. Веб-API Dataverse определяет такие характеристики, как проверка подлинности, соглашения SLA, пакет, управление одновременным доступом и обработка ошибок.

Дополнительные общие сведения о веб-API Microsoft Dataverse см. в разделах:

В приведенной выше документации содержится информация и рекомендации для разработчиков по использованию веб-API Dataverse, например по управлению проверкой подлинности, выполнению операций и использования отслеживания изменений или разностных токенов с помощью API.

Наборы параметров

Модель данных для интерфейса API интеграции ATS, описанная в данном документе, включает наборы параметров, которые предоставляют перечисляемые значения, связанные со свойствами сущностей. Подробные сведения о работе с наборами параметров в веб-API Dataverse см. в разделе Создание и обновление наборов параметров с помощью веб-API. Наборы параметров определяются для каждой среды Dataverse.

Виртуальные таблицы для Human Resources в Dataverse

Конечные точки для API интеграции ATS используют возможности платформы виртуальных таблиц Microsoft Dataverse. По умолчанию виртуальные таблицы и связанные с ними конечные точки API не развертываются для сред Human Resources, позволяя организациям определять, какие конечные точки OData будут доступны для данной среды. Для использования API-интерфейса необходимо создать виртуальные таблицы для сущностей Human Resources для данной среды.

Сведения о создании виртуальных таблиц для API см. в разделе Настройка виртуальных таблиц Dataverse.

Модель данных

Модель данных центрируется вокруг двух основных сущностей:

RecruitingRequest представляет запрос ATS для найма одной или нескольких открытых должностей. Пример запроса см. в разделе Пример запроса по набору сотрудников.
CandidateToHire представляет сведения о кандидате, который принял предложение на должность. Физическое лицо представляет человека, который является кандидатом. Физическое лицо может иметь в компании несколько ролей, таких как кандидат, работник, сотрудник или подрядчик. Пример запроса см. в разделе Пример запроса кандидата для приема на работу.

На следующей схеме показаны отношения внутри API. У нескольких типов есть внешние ключи для других, ранее существующих сущностей в модуле Human Resources, которые здесь не иллюстрируются. В этом документе приводятся сведения о сущностях, предназначенных специально для сценариев интеграции набора персонала. Однако в веб-API Dataverse для Dynamics 365 Human Resources имеется множество других сущностей, которые также могут быть связаны с интеграцией. Например, можно также получить сведения о работниках, заданиях, должностях или других сущностях, не определенных здесь. Многие из этих сущностей упоминаются в отношениях внешнего ключа или свойствах навигации.

Модель данных API интеграции ATS.