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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(Описание:)
 
Строка 19: Строка 19:
  
 
==Параметры==
 
==Параметры==
* Тип – строка, тип объекта
+
* Type – строка, тип объекта
* Объект – json объект с данными объекта  
+
* Object – json объект с данными объекта  
  
 
Описание доступных типов и структуры данных объектов смотрите [[:Категория:SBIS API3 Объект|в справочнике объектов API3]].
 
Описание доступных типов и структуры данных объектов смотрите [[:Категория:SBIS API3 Объект|в справочнике объектов API3]].
Строка 28: Строка 28:
  
 
{  
 
{  
   "Тип": "Сотрудник",
+
   "Type": "Сотрудник",
   "Объект":  
+
   "Object":  
 
   {
 
   {
 
       "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",
 
       "ИдИС": "5f9102f4-28c9-11e7-a6d9-3497f6377b7e",

Текущая версия на 08:30, 20 декабря 2019

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

Описание

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

Алгоритим

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

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

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

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


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

Параметры

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

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

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

{ 
   "Type": "Сотрудник",
   "Object": 
   {
      "ИдИС": "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"
   }
}