Изменение инстанции бизнес-объекта (БО)

Предусловие:

У вас должно иметься БО (Что это такое и как создать?)
Также созданная инстанция данного БО (Как создать инстанцию через API-service?)
Получить (API_TOKEN)

Запрос (Request):

POST /api/v1/boi/update-with-id
Content-Type: application/json
API-TOKEN/TOKEN: your_token

Метод: POST
URL: http://your-domain.kz/api/v1/boi/update-with-id

Headers:

Content-Type: application/json
API-TOKEN/TOKEN: your_token

Как получить API_TOKEN или TOKEN?

Входные данные:

{
  "boId": "Идентификатор бизнес-объекта",
  "boiId": "Идентификатор инстанции бизнес-объекта",
  "fieldValues": {
    "идентификатор поля 1": "новое значение 1",
    "идентификатор поля 2": "новое значение 2",
    "идентификатор поля 3": "новое значение 3"
  },
  "removeAfter": true,
  "fieldRefAdd": [{
    "fieldCode": "код поля 4",
    "boCode": "код БО который содержит в себе поле с кодом поля 4",
    "fieldRefUniqCode": "код уникального поля 1",
    "apiValues": [
      "значение 1 уникального поля 1",
      "значение 2 уникального поля 1"
    ]
  }, ...],
  "fieldRefRemove": [{
    "fieldCode": "код поля 4",
    "boCode": "код БО который содержит в себе поле с кодом поля 4",
    "fieldRefUniqCode": "код уникального поля 1",
    "apiValues": [
      "значение 3 уникального поля 1",
      "значение 4 уникального поля 1"
    ]
  }, ...]
}

Атрибут входного JSON	Описание
boId	(String): Идентификатор бизнес-объекта. Как получить идентификаторы БО?
boiId	(String): Идентификатор инстанции бизнес-объекта. Как получить boiId?
fieldValues.key	(String): Код определенного поля внутри БО. Как получить идентификаторы полей?
fieldValues.value	(String): Значение определенного поля внутри БО. Какие значения для каких полей надо вводить?
removeAfter	(Boolean): Указывает что будет раньше добавление или удаление новых инстанции в поле БО. По умолчанию false значит удаление потом добавление.
fieldRefAdd	(Массив объектов): Для добавления ссылок в поле БО по значениям уникальных полей вложенного БО
fieldRefRemove	(Массив объектов): Для удаления ссылок из поля БО по значениям уникальных полей вложенного БО
fieldRefAdd.fieldCode	(String): Код поля БО. Смотрите выше как получить код поля?
fieldRefAdd.boCode	(String): Если поле с fieldCode находится внутри СО, то данное поле обязательное к заполнению, так как она будет показывать к какому БО относится ваше поле.
fieldRefAdd.fieldRefUniqCode	(String): Код уникального поля БО на которое ссылается ваше поле. Смотрите выше как получить код поля?
fieldRefAdd.apiValues	(Массив String): Значения уникальных полей которы надо добавить. Если в fieldRefRemove, то удалить.

Примечание: Вы можете указывать несколько уникальных полей одного и того же БО.

Пример:

{
  "boId": "gWmNg9ec3yI0wv4V",
  "boiId": "jJY02CrDmAQw1OMz",
  "fieldValues": {
    "UweuNeV8aG3~Tuvf": "15",
    "CV~4boDWzp2SpQ@U": "Alimzhan",
    "84uP6Ml@gq87Fs2u": "1231231.0123",
    "eK3Owd6xaY7YCODc": "2023-12-23T14:30:45.123Z",
    "DybDzyYFS9csQLoJ": "cOtDX2KPeLv3nrjS"
  }
}

Ответ (Response):

Ответ: код 200

Также можете проверить изменения на клиенте или через загрузку инстанции БО: