UpdateSbisObject (API3) — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 1: Строка 1:
Полное имя метода (синоним): API3.UpdateSbisObject (ВИ3.ЗаписатьОбъект)
+
Полное имя метода: API3.UpdateSbisObject
 +
 
 +
==Описание:==
 +
Метод создает или обновляет [[:Категория:SBIS API3 Объект |объекте ИС]] СБИС.
 +
 
 +
==Алгоритим:==
 +
 
 +
1. Если указан идентификатор объекта пытаемся обновить данные указанного объекта. Обновляются только те свойства которые пришли во параметрах метода. Не переданные свойства остаются без изменений.
 +
 
 +
2. Если указан идентификатор, но по этому идентификатору ничего нет, либо идентификатор не указан: ищем объект по естественным ключам при помощи FindSbisObject и если находим обновляем (см.п.1) если не находим создаем.
 +
 
 +
На сервисе интеграции метод дополнительно вызывает UpdateSbisObject для всех подобъектов с данными.
 +
 
 +
Если переданных данных не достаточно для выполнения обновления / создания метод должен вернуть исключение ExtException содержащей dump достаточный для диагностики причины.
  
Описание: Метод создает/обновляет информацию о [[:Категория:SBIS API3 Объект |объекте ИС]]
 
загружает прикладной объект. Если не указан идентификатор объекта, то выполняется поиск по всем естественным ключам пока не будет найдено точное соответствие. Если передаваемый объект уже существует в СБИС, то в нем обновляются только переданные атрибуты. Если передаваемый объект ещё не существует – он создается. Если переданных данных не достаточно для создания объекта – возвращается ошибка. Если в объекте передана информация о подобъектах, что-то кроме идентификатора и типа,  то для подобъекта будет вызван аналогичный метод).
 
  
 
Результат:
 
Результат:
возвращает объект содержащий идентификатор, название и список естественных ключей объекта.
+
возвращает объект содержащий идентификатор, название и список естественных ключей объекта, либо исключение (варнинг).
  
 
==Параметры==
 
==Параметры==

Версия 15:26, 14 мая 2019

Полное имя метода: API3.UpdateSbisObject

Описание:

Метод создает или обновляет объекте ИС СБИС.

Алгоритим:

1. Если указан идентификатор объекта пытаемся обновить данные указанного объекта. Обновляются только те свойства которые пришли во параметрах метода. Не переданные свойства остаются без изменений.

2. Если указан идентификатор, но по этому идентификатору ничего нет, либо идентификатор не указан: ищем объект по естественным ключам при помощи FindSbisObject и если находим обновляем (см.п.1) если не находим создаем.

На сервисе интеграции метод дополнительно вызывает UpdateSbisObject для всех подобъектов с данными.

Если переданных данных не достаточно для выполнения обновления / создания метод должен вернуть исключение ExtException содержащей dump достаточный для диагностики причины.


Результат: возвращает объект содержащий идентификатор, название и список естественных ключей объекта, либо исключение (варнинг).

Параметры

  • Тип – строка, тип объекта
  • Объект – json объект с данными объекта

Описание доступных типов и структуры данных объектов смотрите в справочнике объектов API3.

Пример параметров метода для объекта Сотрудник:

{ 
   "Тип": "Сотрудник",
   "Объект": 
   {
      "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
      "ЧастноеЛицо_ИдИС": "5f9102f3-28c9-11e7-a6d9-3497f6377b7e",
      "НашаОрганизация_ИдИС": "5f9102f2-28c9-11e7-a6d9-3497f6377b7e",
      "ПодразделениеОрганизации_ИдИС": "6a185a64-2979-11e7-9bfa-3497f6377b7e"
   }
}


Результат

  • ИдИС - Идентификатор объекта ИС
  • ИдСБИС - Идентификатор объекта СБИС
  • Название - Представления объекта(Строка)
  • Ключ1_1 - Значение ключа 1_1 в СБИС
  • Ключ1_2 - Значение ключа 1_2 в СБИС
  • Ключ1_3 - Значение ключа 1_3 в СБИС
  • Ключ2 - Значение ключа 2 в СБИС
  • Ключ3 - Значение ключа 3 в СБИС

Пример результата для объекта Сотрудник:

{
   "result":
   {
      "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
      "ИдСБИС": "75",
      "Название": "Иванов Иван Иванович",
      "Ключ1_1": "2315",
      "Ключ1_2: "155",
      "Ключ1_3: "108"
   }
}