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

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

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

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

Описание

Метод ищет объект по переданным ключам, возвращает массив найденных объектов. Поиск осуществляется по всем ключам. Результат сортируется по весу ключа.

Алгоритм

1. Если передан идентификатор проверяем наличие объекта с указанным идентификатором.

2. Если идентификатор не передан либо объекта с указанным идентификатором не существует - осуществляем последовательный поиск по переданным естественным ключам.

3. Найденные записи объединяются по идентификатору и сортируются по весу ключей. Вес ключа зависит от объекта. Если один и тот же объект найден по разным ключам итоговый вес записи суммируется из весов ключей.

Параметры

  • Тип – тип объекта
  • Фильтр
    • ИдИС - идентификатор ИС
    • ИдСБИС - идентификатор СБИС
    • Название - Представление объекта ИС
    • Ключ1_1 - естественный ключ 1_1
    • Ключ1_2 - естественный ключ 1_2
    • Ключ1_3 - естественный ключ 1_3
    • Ключ2 - естественный ключ 2
    • Ключ3 - естественный ключ 3

Результат:

Метод возвращаем массив подходящих объектов, или пустой массив

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

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

{
   "result":
   [
      {
         "ИдИC": "а12321а3422315",
         "ИдСБИС": "2315",
         "Название": "Иванов Иван Иваныч",
         "Ключ1_1": "21",   
         "Ключ1_2": "175",
      },
      {
         "ИдИC": "а12321а3422314",
         "ИдСБИС": "2316",
         "Название": "Иванов Иван Петрович",
         "Ключ1_1": "22",   
         "Ключ1_2": "176",
      }
   ]

}