Категория:SBIS API3 — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показана 1 промежуточная версия этого же участника)
Строка 9: Строка 9:
 
Порядок действий внешней системы для синхронизации данных с СБИС.
 
Порядок действий внешней системы для синхронизации данных с СБИС.
  
# Создать ExtSyncDoc и поместить в него все изменившиеся в ИС объекты при помощи метода Write
+
# Создать ExtSyncDoc и поместить в него все изменившиеся в ИС объекты при помощи метода ExtSyncDoc.Write
# Для созданного ExtSyncDoc вызывать метод подготовки данных Prepare. Метод вызывается до тех пор, пока все данные не будут подготовлены. Несколько итераций сделано для возможности вывода прогресс бара.
+
# Для созданного ExtSyncDoc вызывать метод подготовки данных ExtSyncDoc.Prepare. Метод вызывается до тех пор, пока все данные не будут подготовлены.  
## Prepare проанализирует список объектов которые необходимо загрузить, и выдаст список вложенных объектов, которых не хватает для успешной загрузки.
+
## Prepare проанализирует список объектов которые необходимо загрузить, и выдаст список вложенных объектов, которых не хватает для успешной загрузки. .
## Внешняя система добавляет в этот ExtSyncDoc необходимые объекты (Write) и при помощи метода Prepare завершает подготовку документа.
+
## Внешняя система добавляет в этот ExtSyncDoc необходимые объекты (Write) и продолжает вызывать Prepare.
# После того как все данные загружены вызывает для ExtSyncDoc асинхронный метод метод Execute, который обновит в СБИС все указанные в ExtSyncDoc объекты.
+
# После того как все данные загружены вызывает для ExtSyncDoc асинхронный метод метод ExtSyncDoc.Execute, который обновит в СБИС все указанные в ExtSyncDoc объекты.
  
 
Для двухсторонней синхронизации необходимо от ExtSyncDoc вызвать асинхронный метод getChanges, который добавит с данный документ список изменений со стороны СБИС и пометит конфликтные записи (записи у которых есть изменения с обеих сторон). Для разрешения конфликтов в СБИС есть соответствующий интерфейс доступный в истории синхронизации.
 
Для двухсторонней синхронизации необходимо от ExtSyncDoc вызвать асинхронный метод getChanges, который добавит с данный документ список изменений со стороны СБИС и пометит конфликтные записи (записи у которых есть изменения с обеих сторон). Для разрешения конфликтов в СБИС есть соответствующий интерфейс доступный в истории синхронизации.
  
 
Получить данные для обновления во внешней системе, можно при помощи метода Read у объекта ExtSyncDoc с фильтром по направлению Export.
 
Получить данные для обновления во внешней системе, можно при помощи метода Read у объекта ExtSyncDoc с фильтром по направлению Export.
 +
 +
Данный API активно изменяется, фиксация планируется к концу 2021 года, поэтому актуально покрытие Вашей интеграции юнит тестами и постоянное тестирование на тестовом портале.

Текущая версия на 18:45, 30 июня 2021

Данный API позволяет реализовать двустороннюю автоматическую синхронизировать объектов СБИС с внешней системой.

Термины:

  • Connection - объект содержащий параметры синхронизации и настройки подключения, любая интеграция с внешней системой начинается с создания подключения к внешней системы через мастер в интерфейсе СБИС.
  • ExtSyncDoc - объект содержащий данные одной итерации синхронизации - Список объектов синхронизации (ExtSyncObj) и направление обмена.
  • ExtSybcObj - данные объекта синхронизации.

Порядок действий внешней системы для синхронизации данных с СБИС.

  1. Создать ExtSyncDoc и поместить в него все изменившиеся в ИС объекты при помощи метода ExtSyncDoc.Write
  2. Для созданного ExtSyncDoc вызывать метод подготовки данных ExtSyncDoc.Prepare. Метод вызывается до тех пор, пока все данные не будут подготовлены.
    1. Prepare проанализирует список объектов которые необходимо загрузить, и выдаст список вложенных объектов, которых не хватает для успешной загрузки. .
    2. Внешняя система добавляет в этот ExtSyncDoc необходимые объекты (Write) и продолжает вызывать Prepare.
  3. После того как все данные загружены вызывает для ExtSyncDoc асинхронный метод метод ExtSyncDoc.Execute, который обновит в СБИС все указанные в ExtSyncDoc объекты.

Для двухсторонней синхронизации необходимо от ExtSyncDoc вызвать асинхронный метод getChanges, который добавит с данный документ список изменений со стороны СБИС и пометит конфликтные записи (записи у которых есть изменения с обеих сторон). Для разрешения конфликтов в СБИС есть соответствующий интерфейс доступный в истории синхронизации.

Получить данные для обновления во внешней системе, можно при помощи метода Read у объекта ExtSyncDoc с фильтром по направлению Export.

Данный API активно изменяется, фиксация планируется к концу 2021 года, поэтому актуально покрытие Вашей интеграции юнит тестами и постоянное тестирование на тестовом портале.

Подкатегории

В этой категории отображается 3 подкатегории из имеющихся 3.

Страницы в категории «SBIS API3»

Эта категория содержит единственную страницу.