Пример запроса кандидата для приема на работу

  • Статья

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

В этой статье представлен пример запроса для сущности "Кандидат для приема на работу" в Dynamics 365 Human Resources.

В этой статье представлен пример, демонстрирующий, как можно использовать глубокие вставки для создания всех сведений новой записи кандидата с помощью одной операции API. Дополнительные сведения о глубокой вставке см. в разделе Создание записей связанной сущности в одной операции.

Сущность mshr_hcmcandidatetohireentity является уникальной, поскольку связана с сущностью mshr_dirpersonentity. Многие свойства сущности mshr_hcmcandidatetohireentity (например, mshr_firstname, mshr_lastname и mshr_birthdate) наследуются из записи mshr_dirpersonentity. При разноске новой записи кандидата в mshr_hcmcandidatetohireentity без использования операций глубокой вставки можно определить значения для этих свойств непосредственно в записи mshr_hcmcandidatetohireentity. Соответствующая запись mshr_dirpersonentity создается неявно с определенными значениями для свойств. Затем можно создать любые другие записи сущности (такие как навыки или образование) как отдельные вызовы API.

Однако, если необходимо использовать глубокие вставки для создания всех связанных сущностей в одной операции, свойства, относящиеся к сущности mshr_dirpersonentity, должны быть определены на этом вложенном уровне операции.

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

Примечание

Пример не включает все свойства для каждой из сущностей API. Это упрощено для демонстрационных целей.

Запрос


POST [Organization URI]/api/data/v9.1/mshr_hcmcandidatetohireentities
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
    "mshr_dataareaid": "usmf",
    "mshr_recruitingrequestid": "USMF-000141",
    "mshr_positionid": "000601",
    "mshr_iswillingtorelocate": 200000000,
    "mshr_availabilitydate": "2021-03-18",
    "mshr_comments": "Evelyn's experience is exactly what we need for this position.",
    "mshr_FK_Person_id":
        {
            "mshr_firstname": "Evelyn",
            "mshr_lastname": "Chambers",
            "mshr_namesequencedisplayas": "FirstMiddleLast",
            "mshr_FK_HcmPersonSkillEntity_Person":
            [
                {
                    "mshr_skillid": "CustFocus",
                    "mshr_ratingid": "Skills",
                    "mshr_levelid": "4",
                    "mshr_ratinglevelexaminer": "",
                    "mshr_leveltype": 200000000,
                    "mshr_yearsofexperience": 0,
                    "mshr_verified": 200000000,
                    "mshr_leveldate": "2013-01-01T00:00:00Z"
                },
                {
                    "mshr_skillid": "CashFlow",
                    "mshr_ratingid": "Skills",
                    "mshr_levelid": "4",
                    "mshr_ratinglevelexaminer": "",
                    "mshr_leveltype": 200000000,
                    "mshr_yearsofexperience": 0,
                    "mshr_verified": 200000000,
                    "mshr_leveldate": "2013-01-01T00:00:00Z"
                }
            ],
            "mshr_FK_HcmPersonEducationEntity_Person": [
                {
                    "mshr_creditbasis": 200000000,
                    "mshr_enddate": "2021-02-22T00:00:00Z",
                    "mshr_educationlevelid": "Bachelor",
                    "mshr_creditsearned": 0,
                    "mshr_startdate": "2017-02-21T00:00:00Z",
                    "mshr_creditscompleted": 0,
                    "mshr_educationinstitutionid": "Cottonwood Univ",
                    "mshr_educationdisciplineid": "Business Mgmt",
                    "mshr_durationunit": 200000000
                }              
            ]
        }
}

Отклик


HTTP/1/1 204 No Content
OData-Version: 4.0
OData-EntityId: [Organization URI]/api/data/v9.1/mshr_hcmcandidatetohireentities(00000d2d-0000-0000-7317-005001000000)

См. также

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