Чтобы в POST-запросе заполнить свойство-ссылку, нужно чтобы объект, на который идет ссылка, уже существовал в системе. Например, у дополнительных соглашений есть свойство-ссылка Договор (LeadingDocument). Рассмотрим 2 варианта:

•в системе есть нужный договор с идентификатором 34. Поэтому:

1.Напишите запрос, который создаст дополнительное соглашение.

2.В теле этого запроса для свойства-ссылки LeadingDocument укажите идентификатор договора;

•в системе нет нужного договора. Поэтому:

1.Напишите запрос, который создаст договор и в ответе вернет идентификатор созданного документа.

2.Напишите запрос, который создаст дополнительное соглашение.

3.В теле второго запроса для свойства-ссылки LeadingDocument укажите идентификатор созданного договора.

При написании тела запроса для свойства-ссылки используйте синтаксис OData или упрощенный синтаксис.

Синтаксис OData

Формат тела POST-запроса для заполнения свойства-ссылки:

"<Имя свойства>@odata.bind": "URL сущности(ИД)"

Пример:

{
   "LeadingDocument@odata.bind" : "https://DirectumRXServer.com/Integration/odata/IContracts(34)"
}

Упрощенный синтаксис

Формат тела POST-запроса для заполнения свойства-ссылки:

"<Имя свойства>": { "Id": <Идентификатор сущности> }

Пример:

{
   "Author": { "Id": 34 },
}

Пример

С помощью POST-запроса создадим дополнительное соглашение, в котором заполним свойства:

•Содержание – «План-график работ». Тип: строка;

•Вид документа – дополнительное соглашение. Тип: свойство-ссылка на запись с идентификатором 27;

•Договор – документ. Тип: свойство-ссылка на запись с идентификатором 34;

•Наша организация – Прибор-Консалт. Тип: свойство-ссылка на запись с идентификатором 98;

•Подразделение – отдел продаж. Тип: свойство-ссылка на запись с идентификатором 96.

Вид запроса с синтаксисом OData:

POST /Integration/odata/ISupAgreements HTTP/1.1
Host: DirectumRXServer.com
Username: {Логин}
Password: {Пароль}
Content-Type: application/json
Accept: application/json
Content-Length: 414
{
   "Subject":"План-график работ",
   "DocumentKind@odata.bind":"https://DirectumRXServer.com/Integration/odata/IDepartments(27)",
   "LeadingDocument@odata.bind":"https://DirectumRXServer.com/Integration/odata/IContracts(34)",
   "BusinessUnit@odata.bind":"https://DirectumRXServer.com/Integration/odata/IBusinessUnits(98)",
   "Department@odata.bind":"https://DirectumRXServer.com/Integration/odata/IDepartments(96)"
}

Вид запроса с упрощенным синтаксисом:

POST /Integration/odata/ISupAgreements HTTP/1.1
Host: DirectumRXServer.com
Username: {Логин}
Password: {Пароль}
Content-Type: application/json
Accept: application/json
Content-Length: 171
{
   "Subject":"План-график работ",
   "DocumentKind":{"Id": 27},
   "LeadingDocument":{"Id": 34},
   "BusinessUnit":{"Id": 98},
   "Department":{"Id": 96}
}

© Компания Directum, 2024