Метод POST

Метод POST служит для изменения или вставки ресурса.

Чтобы изменить ресурс, нужно указать его ID. Чтобы создать ресурс, нужно задать первичный ключ и все обязательные поля, у которых нет значения по умолчанию, но ID не требуется.

Чтобы изменить или вставить ресурс структуры объектов, можно задать параметр _action для идентификации действий, задаваемых каркасом интеграции, таких как Change или AddChange.

Чтобы изменить или вставить дочерний объект ресурса структуры объектов, в данных формы нужно указать каждое вхождение дочернего объекта.

Если для создания ресурса используется метод POST, надо задать параметр запроса _ulcr со значением 1, чтобы ответ содержал ссылку для обращения клиента к новому ресурсу. В противном случае в ответ будет включено содержимое ресурса. Ссылка включается в свойство заголовка Location, а код HTTP 201 указывает, что вместо данных задана ссылка.

Пример: Вставка актива

Следующий метод вставляет актив 127, находящийся на площадке BEDFORD, при помощи ресурса бизнес-объекта. Актив и площадка составляют первичный ключ.

POST maxrest/rest/mbo/asset HTTP/1.1
assetnum=127&siteid=BEDFORD&description=my_new_description&type=OPERATING

Пример: Изменение актива с указанием его ID

Следующий метод изменяет актив, для чего в составе URI задается ID:

POST maxrest/rest/mbo/asset/1234 HTTP/1.1
description=my_new_description&type=OPERATING

Пример: Задание действия

Следующий метод использует параметр _action для задания действия Change:

POST maxrest/rest/mbo/asset/968 HTTP/1.1
_action=Change&description=my_new_description

Пример: Изменение записи с несколькими дочерними объектами

Следующий метод добавляет в заказ на закупку две строки ЗНЗ (poline), каждая из которых содержит две стоимости в заказе на закупку (pocost).

POST maxrest/rest/os/mxpo/1234 HTTP/1.1
description=new_po_desc&
poline.id1.polinenum=1&poline.id1.item=ABC&poline.id1.description=new_description& 
poline.id1.pocost.id1-1.costlinenum=1&poline.id1.pocost.id1-1.gldebitacct=new_gl_acct_a& 
poline.id1.pocost.id1-2.costlinenum=2&poline.id1.pocost.id1-2.gldebitacct=new_gl_acct_b& 
poline.id2.polinenum=2&poline.id2.item=XYZ&poline.id2.description=new_description& 
poline.id2.pocost.id2-1.costlinenum=1&poline.id2.pocost.id2-1.gldebitacct=new_gl_acct_c& 
poline.id2.pocost.id2-2.costlinenum=2&poline.id2.pocost.id2-2.gldebitacct=new_gl_acct_d&

В этом примере используются идентификаторы для следующих параметров:

Идентификатор группы	Указанные параметры
id1	Параметры, принадлежащие к poline 1
id1-1	Параметры, принадлежащие к pocost 1 для poline 1
id1-2	Параметры, принадлежащие к pocost 2 для poline 1
id2	Параметры, принадлежащие к poline 2
id2-1	Параметры, принадлежащие к pocost 1 для poline 2
id2-2	Параметры, принадлежащие к pocost 2 для poline 2