Подключение к ExtSdk2 через OLE - Сценарии ExtSdk2 — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
м (Разговоров Михаил переименовал страницу Подключение к ExtSdk2 через OLE - Сценарии ExtSdk2 в Интеграция с СБИС при помощи ExtSdk2 без оставления…)
 
(не показано 27 промежуточных версий 2 участников)
Строка 1: Строка 1:
−
Для работы со СБИС3 Плагин из внешних систем, таких как 1С или SAP, требуется получить COM-объект, зарегистрированный Плагином в Вашей системе. Его название "Tensor.SbisPluginClientCOM". Все примеры кода указаны на языке Python.
+
==Краткое описание==
−
== Получение COM-объекта ==
 
  
−
<syntaxhighlight lang="python">
+
===Подключение к OLE объекту===
−
ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")
 
−
</syntaxhighlight>
 
  
−
Получение COM-объекта занимает одну строку '''''ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")''''' с использованием библиотеки pywin32.
+
Основным способом для подключения к  ExtSdk2 из внешних систем является OLE объект "Tensor.SbisPluginClientCOM". Данный OLE объект устанавливается на ПК пользователя при полной установке СБИС3 Плагин.
−
Далее Плагин подготавливает необходимые внутренние инструменты для подключения и в случае успеха пробрасывает событие '''Event''' в виде json сериализованного в строку. У данного события в объекте 'data' лежит поле 'eventName' со значением 'connected'.
+
Обновляется OLE объект автоматически вместе с обновлением СБИС3 Плагин. Подключение к OLE объекту аналогично работе с другими OLE объектами.
  
−
== Пример вызовов методов плагина через COM-объект ==
+
В момент подключения, OLE объект устанавливает WebSocket соединение с СБИС3 Плагин, по этому до отправки первой команды нужно убедиться, что данное подключение установлено дождавшись событие "connected" (type=Event, data.eventName=connected).
−
<syntaxhighlight lang="python">
+
. Подробнее см. в разделе [[#Получение и обработка событий | Получение и обработка событий]].
  
−
# Получение модуля
+
===Подготовительные операции===
  
−
guid_module = ole.GetModule(name)
+
ExtSdk2 является расширением (модулем) СБИС3 Плагин. При обращении к модулю плагину требуется указывать идентификатор модуля. Получить идентификатор ExtSdk можно при помощи команды ole.[[GetModule|GetModule]].
  
  
−
# Вызов методов модуля через COM-объект
+
Кроме идентификатора модуля, для отправки команд в ExtSdk2 вызывающая сторона (клиент) должен быть аутентифицирован. Для аутентификации в ExtSdk2 доступны [[Аутентификация_-_Сценарии_ExtSdk2|несколько вариантов]]. Результатом аутентификации является полученный идентификатор сессии который следует передавать при каждом вызове ExtSdk2 (допускается на одном соединении вызов команд из разных сессий).
  
−
query_id = str(uuid.uuid4())
+
Важно! Рекомендуется хранить данный идентификатор сессии между подключениями и вызывать аутентификацию только при получении ошибки аутентификации.
−
module_method = "ExtSdk2.AuthByPassword"
 
−
parameters_module_method = json.dumps({"Login": "login", "Password": "password"}, ensure_ascii=True)
 
−
host = online.sbis.ru
 
  
−
ole.CallMethodWithoutAuth( query_id, guid_module, module_method, parameters_module_method, host )
+
===Вызов команд===
  
−
account_id = ********@plugin.sbis.ru
+
Для взаимодействия с OLE объектом, в зависимости от возможностей Вашей системы, можно использовать либо JSON либо XML (в данном случае XML это безусловно сериализованный в XML JSON). Структура передаваемых данных идентична в обоих вариантах, выбор вариант зависит от наличия в ИС и скорости работы соответствующего парсера. В наших интеграционных модулях для 1С и SAP из-за необходимости поддержки старых версий используется XML.  
  
−
ole.CallMethod( query_id, guid_module, module_method, parameters_module_method, account_id )
+
Все вызовы СБИС3 Плагин асинхронны - вы отправляете команду и ждете сообщения о результатах выполнения команды. Для отправки команды, нужно вызвать метод ole.[[CallMethod|CallMethod]] или ole.[[CallMethodXML|CallMethodXML]] (исключение составляют команды аутентификации, их следует вызывать при помощи методов [[CallMethodWithoutAuth|CallMethodWithoutAuth]] и [[CallMethodWithoutAuthXML|CallMethodWithoutAuthXML]]). В ответ вы получите идентификатор запроса (UUID), данный идентификатор будет присутствовать в событии ответа и по нему вы сможете понять к какому запросу относится данное событие.
  
−
</syntaxhighlight>
+
Со списком всех доступных команд Вы можете ознакомиться [[Категория:Методы_ExtSdk2|здесь]]. В [[Категория:Сценарии_ExtSdk2|сценариях работы]] изложены наиболее оптимальные алгоритмы работы с ExtSdk2.
  
−
Для вызова методов модуля ExtSdk2 необходимо сначала получить его guid с помощью функции COM-объекта [[GetModule]].
+
===Получение и обработка событий===
  
−
Вызов методов ExtSdk2 выполняется через вызов методов COM-объекта. Метод [[CallMethodWithoutAuth]] вызывается для авторизации в плагине и позволяет получить идентификатор сессии - '''account_id'''. С данным идентификаторов следует вызывать все остальные методы модуля через [[CallMethod]].
+
Работа с ExtSdk2 и СБИС3 Плагин осуществляется асинхронно, т.е. в ответ на ваш вызов Вы получите только его идентификатор, а не результат или ошибку. Для получения результата требуется делать периодический вызов функции ole.[[ReadAllObject|ReadAllObject]] или ole.[[ReadAllXml2|ReadAllXml2]] (в зависимости от формата обмена Json или XML). Данные функции возвращают все события которые поступили от плагина с момента последнего вызова этой функции (или запуска плагина если это первый вызов). Между вызовами ReadAllObject и ReadAllXml2 необходимо делать таймаут 100-500мс, для этого можно воспользоваться методом ole.[[Sleep|Sleep]]  
  
−
Для интегрируемых систем, работающих с xml, следует использовать [[CallMethodWithoutAuthXML]] и [[CallMethodXML]] соответственно.
+
По мимо событий содержащих результат вызова команды, в OLE Объект могут приходить события содержащие прогресс выполнения длительной операции (например загрузки больших файлов) или события произошедшие в СБИС, например распознавание документа и т.п. В интеграционных модулях рекомендуется построить обработку событий на принципах регистрации и вызова обработчика обратного вызова. Интеграционный модуль должен игнорировать не интересующие или неожиданные события.  
  
−
== Пример получения ответов от COM-объекта ==
+
Кроме асинхронных вызовов, сами команды ExtSdk2 могут выполняться асинхронно. В основном это касается методов отправки. Такие методы в качестве ответа возвращают специальный тип ошибки [[Обработка_ответов_от_плагина_-_Сценарии_ExtSdk2#Событие Error #ASYNC|Error #ASYNC]]. Результат выполнения приходит отдельным событием [[Обработка_ответов_от_плагина_-_Сценарии_ExtSdk2#События Event #ASYNC|Event #ASYNC]]. Такой подход обусловлен тем, что изначально предполагалось исключительно синхронное выполнение методов внутри СБИС3 Плагин.  
−
<syntaxhighlight lang="python">
 
−
json_string = ole.ReadAllObject()
 
−
</syntaxhighlight>
 
  
−
[[ReadAllObject]] функция COM-объекта, возвращающая json массив событий в виде строки.
+
[[Виды_событий_от_плагина_-_Сценарии_ExtSdk2|Более подробно о событиях]]
  
−
Для интегрируемых систем, работающих с xml, следует использовать [[ReadAllXml2]].
+
Рекомендуем ознакомиться с примером реализации подключения к ExtSdk2, аутентификации и вызова одного метода на python. Данный пример не следует использовать как образец. Приведен только для понимания работы с модулем.
  
−
<syntaxhighlight lang="python">
+
<syntaxhighlight lang="json">
−
xml_string = ole.ReadAllXml2()
+
 
−
</syntaxhighlight>
+
import win32com.client
 +
import json
 +
import uuid
 +
 
 +
"""Шаг 1. Подключение к СБИС3.Плагин"""
 +
 
 +
ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")  # Получаем COM объект
 +
 
 +
# При получении COM объекта плагин генерирует событие типа 'Event' c eventName=connected,
 +
# поэтому если среди полученных ответов от ReadAllObject() есть событие стаким eventName, то вам удалось подключиться
 +
# к плагину, иначе стоит сделать таймаут 100 - 500мс и повторить вызов ReadAllObject().Пример цикла.
 +
 
 +
# состояние подключения = False
 +
connect = False
 +
while not connect:
 +
    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов
 +
    # в цикле проходим по каждому событию и ищем нужное с eventName=connected
 +
    for event in events:
 +
        if event['type'] == 'Event' and event['data']['eventName'] == 'connected':
 +
            # если нужное событие пришло, то меняем состояние подключения на true и выходим из цикла
 +
            connect = True
 +
            break
 +
 
 +
    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
 +
    ole.Sleep(300)
  
−
События бывают трех типов: '''Message''', '''Error''', '''Event''', которые следует разобрать и найти ответ по переданному '''query_id'''
+
# После подключения к плагину вы можете подключаться к ExtSdk2 и звать методы данного модуля
  
−
== Примеры событий от модуля ==
+
# Получаем uuid модуля ExtSdk2 через ole.GetModule. Если uuid получен, значит подключение к ExtSdk2 успешно и можно совершать запросы в модуль.
 +
guid_module = ole.GetModule("ExtSdk2")  # Получаем uuid модуля ExtSdk2
  
−
=== Событие Message ===
+
"""Шаг 2. Пример аутентификации по логину и паролю"""
−
Событие типа Message содержит '''queryID''' вызываемого метода и результат работы в поле 'Result'.
+
 
−
<syntaxhighlight lang="json">
+
query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
−
{
+
module_method = "ExtSdk2.AuthByPassword"  # метод, который хотим позвать
−
  'type': 'Message',
+
parameters_module_method = json.dumps({"Login": "Ivanov", "Password": "Ivanov123"},
−
  'queryID': '15e79572-b1be-4dc2-a0e9-3652ecb187c5',
+
                                      ensure_ascii=True)  # формируем параметры метода ExtSdk2.AuthByPassword
−
  'data': {
+
host = "online.sbis.ru"  # хост, на который хотим пойти online.sbis.ru.
−
    'Result': ...,
+
 
−
     'Stat': ...
+
# Вызов метода аутентификации без авторизаии, чтобы получить идентификатор сессии
 +
ole.CallMethodWithoutAuth(query_id, guid_module, module_method, parameters_module_method, host)
 +
 
 +
# Ожидаем ответ через ReadAllObject в цикле по query_id
 +
session_id = ""  # Переменная для сохранения идентификатора сессии для вызов методов ExtSdk2 с пройденной аутентификацией
 +
while not session_id:
 +
 
 +
    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов
 +
 
 +
    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
 +
    for event in events:
 +
        if event['type'] == 'Message' and event['queryID'] == query_id:
 +
            # если нужное событие пришло, то записываем идентификатор сессии в переменную
 +
            session_id = event['data']['Result']
 +
            break
 +
 
 +
    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
 +
    ole.Sleep(300)
 +
 
 +
"""Шаг 3. Пример вызова метода с пройденной аутентификацией"""
 +
query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
 +
module_method = "ExtSdk2.ReadTasksList"  # метод, который хотим позвать
 +
# filter_task =  # сформируем пустой фильтр для ExtSdk2.ReadTasksList
 +
parameters_module_method = json.dumps({"Filter": {
 +
     "Навигация": {
 +
        "РазмерСтраницы": "15",
 +
        "Страница": "0"
 
     }
 
     }
−
  }
+
}},
−
}
+
    ensure_ascii=True)  # формируем параметры метода ExtSdk2.ReadTasksList.
−
</syntaxhighlight>
+
 
−
=== Событие Error ===
+
# Вызов метода ExtSdk2.ReadTasksList с пройденной аутентификацией
−
Событие типа Error содержит '''queryID''' вызываемого метода и объект ошибки в поле 'data'.
+
ole.CallMethod(query_id, guid_module, module_method, parameters_module_method, session_id)
−
<syntaxhighlight lang="json">
+
 
−
{
+
# Ожидаем ответ через ReadAllObject в цикле по query_id
−
  'type': 'Error',
+
result = {}  # Переменная для сохранения результата ExtSdk2.ReadTasksList
−
  'queryID': '15e79572-b1be-4dc2-a0e9-3652ecb187c5',
+
result_checked = False
−
  'data': {
+
while not result_checked:
−
     'code': ...,
+
 
−
     'detail': ...,
+
    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов
−
     'dump': {},
+
 
−
     'message': ...,
+
    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
−
     'method_name': 'ExtSdk2....',
+
    for event in events:
−
    ...
+
        if event['type'] == 'Message' and event['queryID'] == query_id:
−
  }
+
            # если нужное событие пришло, то записываем результат в нужную переменную
−
}
+
            result = event['data']['Result']
−
</syntaxhighlight>
+
            result_checked = True
−
=== Событие Event ===
+
            break
−
Событие типа Event содержит '''queryID''' вызываемого метода и имя события в поле 'eventName'.
+
 
−
<syntaxhighlight lang="json">
+
    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
−
{
+
     ole.Sleep(300)
−
  'type': 'Event',
+
 
−
  'data': {
+
"""Шаг 4. Пример вызова методов с несколькими параметрами на примере CallSabyApi"""
−
    'channelName': 'SbisPluginEvent',
+
query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
−
    'eventName': 'connected',
+
module_method = "ExtSdk2.CallSabyApi"  # метод, который хотим позвать
−
     'type': 'object',
+
parameters_module_method = json.dumps({
−
     'data': ...
+
     "Method": "СБИС.ПрочитатьДокумент",
−
  }
+
     "Params": {
−
  'queryID': '15e79572-b1be-4dc2-a0e9-3652ecb187c5'
+
        "Идентификатор": "f2a7c885-269a-44e4-8781-cb928df94163",
−
}
+
        "ДопПоля": "ДополнительныеПоля"
−
</syntaxhighlight>
+
     }},
 +
     ensure_ascii=True)  # формируем параметры метода ExtSdk2.CallSabyApi.
 +
 
 +
# Вызов метода ExtSdk2.CallSabyApi с пройденной аутентификацией
 +
ole.CallMethod(query_id, guid_module, module_method, parameters_module_method, session_id)
 +
 
 +
# Ожидаем ответ через ReadAllObject в цикле по query_id
 +
result = {}  # Переменная для сохранения результата ExtSdk2.CallSabyApi
 +
result_checked = False
 +
while not result_checked:
 +
 
 +
    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов
 +
 
 +
    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
 +
    for event in events:
 +
        if event['type'] == 'Message' and event['queryID'] == query_id:
 +
            # если нужное событие пришло, то записываем результат в нужную переменную
 +
            result = event['data']['Result']
 +
            result_checked = True
 +
            break
 +
 
 +
     # если ожидаемое событие не найдено, то делаем таймаут в 300мс
 +
     ole.Sleep(300)
 +
 
 +
</syntaxhighlight>  
 +
 
 
[[Категория:Сценарии ExtSdk2]]
 
[[Категория:Сценарии ExtSdk2]]

Текущая версия на 11:44, 11 мая 2022

Краткое описание

Подключение к OLE объекту

Основным способом для подключения к ExtSdk2 из внешних систем является OLE объект "Tensor.SbisPluginClientCOM". Данный OLE объект устанавливается на ПК пользователя при полной установке СБИС3 Плагин. Обновляется OLE объект автоматически вместе с обновлением СБИС3 Плагин. Подключение к OLE объекту аналогично работе с другими OLE объектами.

В момент подключения, OLE объект устанавливает WebSocket соединение с СБИС3 Плагин, по этому до отправки первой команды нужно убедиться, что данное подключение установлено дождавшись событие "connected" (type=Event, data.eventName=connected). . Подробнее см. в разделе Получение и обработка событий.

Подготовительные операции

ExtSdk2 является расширением (модулем) СБИС3 Плагин. При обращении к модулю плагину требуется указывать идентификатор модуля. Получить идентификатор ExtSdk можно при помощи команды ole.GetModule.


Кроме идентификатора модуля, для отправки команд в ExtSdk2 вызывающая сторона (клиент) должен быть аутентифицирован. Для аутентификации в ExtSdk2 доступны несколько вариантов. Результатом аутентификации является полученный идентификатор сессии который следует передавать при каждом вызове ExtSdk2 (допускается на одном соединении вызов команд из разных сессий).

Важно! Рекомендуется хранить данный идентификатор сессии между подключениями и вызывать аутентификацию только при получении ошибки аутентификации.

Вызов команд

Для взаимодействия с OLE объектом, в зависимости от возможностей Вашей системы, можно использовать либо JSON либо XML (в данном случае XML это безусловно сериализованный в XML JSON). Структура передаваемых данных идентична в обоих вариантах, выбор вариант зависит от наличия в ИС и скорости работы соответствующего парсера. В наших интеграционных модулях для 1С и SAP из-за необходимости поддержки старых версий используется XML.

Все вызовы СБИС3 Плагин асинхронны - вы отправляете команду и ждете сообщения о результатах выполнения команды. Для отправки команды, нужно вызвать метод ole.CallMethod или ole.CallMethodXML (исключение составляют команды аутентификации, их следует вызывать при помощи методов CallMethodWithoutAuth и CallMethodWithoutAuthXML). В ответ вы получите идентификатор запроса (UUID), данный идентификатор будет присутствовать в событии ответа и по нему вы сможете понять к какому запросу относится данное событие.

Со списком всех доступных команд Вы можете ознакомиться. В изложены наиболее оптимальные алгоритмы работы с ExtSdk2.

Получение и обработка событий

Работа с ExtSdk2 и СБИС3 Плагин осуществляется асинхронно, т.е. в ответ на ваш вызов Вы получите только его идентификатор, а не результат или ошибку. Для получения результата требуется делать периодический вызов функции ole.ReadAllObject или ole.ReadAllXml2 (в зависимости от формата обмена Json или XML). Данные функции возвращают все события которые поступили от плагина с момента последнего вызова этой функции (или запуска плагина если это первый вызов). Между вызовами ReadAllObject и ReadAllXml2 необходимо делать таймаут 100-500мс, для этого можно воспользоваться методом ole.Sleep

По мимо событий содержащих результат вызова команды, в OLE Объект могут приходить события содержащие прогресс выполнения длительной операции (например загрузки больших файлов) или события произошедшие в СБИС, например распознавание документа и т.п. В интеграционных модулях рекомендуется построить обработку событий на принципах регистрации и вызова обработчика обратного вызова. Интеграционный модуль должен игнорировать не интересующие или неожиданные события.

Кроме асинхронных вызовов, сами команды ExtSdk2 могут выполняться асинхронно. В основном это касается методов отправки. Такие методы в качестве ответа возвращают специальный тип ошибки Error #ASYNC. Результат выполнения приходит отдельным событием Event #ASYNC. Такой подход обусловлен тем, что изначально предполагалось исключительно синхронное выполнение методов внутри СБИС3 Плагин.

Более подробно о событиях

Рекомендуем ознакомиться с примером реализации подключения к ExtSdk2, аутентификации и вызова одного метода на python. Данный пример не следует использовать как образец. Приведен только для понимания работы с модулем. 

import win32com.client
import json
import uuid

"""Шаг 1. Подключение к СБИС3.Плагин"""

ole = win32com.client.Dispatch("Tensor.SbisPluginClientCOM")  # Получаем COM объект

# При получении COM объекта плагин генерирует событие типа 'Event' c eventName=connected,
# поэтому если среди полученных ответов от ReadAllObject() есть событие стаким eventName, то вам удалось подключиться
# к плагину, иначе стоит сделать таймаут 100 - 500мс и повторить вызов ReadAllObject().Пример цикла.

# состояние подключения = False
connect = False
while not connect:
    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов
    # в цикле проходим по каждому событию и ищем нужное с eventName=connected
    for event in events:
        if event['type'] == 'Event' and event['data']['eventName'] == 'connected':
            # если нужное событие пришло, то меняем состояние подключения на true и выходим из цикла
            connect = True
            break

    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
    ole.Sleep(300)

# После подключения к плагину вы можете подключаться к ExtSdk2 и звать методы данного модуля

# Получаем uuid модуля ExtSdk2 через ole.GetModule. Если uuid получен, значит подключение к ExtSdk2 успешно и можно совершать запросы в модуль.
guid_module = ole.GetModule("ExtSdk2")  # Получаем uuid модуля ExtSdk2

"""Шаг 2. Пример аутентификации по логину и паролю"""

query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
module_method = "ExtSdk2.AuthByPassword"  # метод, который хотим позвать
parameters_module_method = json.dumps({"Login": "Ivanov", "Password": "Ivanov123"},
                                      ensure_ascii=True)  # формируем параметры метода ExtSdk2.AuthByPassword
host = "online.sbis.ru"  # хост, на который хотим пойти online.sbis.ru.

# Вызов метода аутентификации без авторизаии, чтобы получить идентификатор сессии
ole.CallMethodWithoutAuth(query_id, guid_module, module_method, parameters_module_method, host)

# Ожидаем ответ через ReadAllObject в цикле по query_id
session_id = ""  # Переменная для сохранения идентификатора сессии для вызов методов ExtSdk2 с пройденной аутентификацией
while not session_id:

    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов

    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
    for event in events:
        if event['type'] == 'Message' and event['queryID'] == query_id:
            # если нужное событие пришло, то записываем идентификатор сессии в переменную
            session_id = event['data']['Result']
            break

    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
    ole.Sleep(300)

"""Шаг 3. Пример вызова метода с пройденной аутентификацией"""
query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
module_method = "ExtSdk2.ReadTasksList"  # метод, который хотим позвать
# filter_task =   # сформируем пустой фильтр для ExtSdk2.ReadTasksList
parameters_module_method = json.dumps({"Filter": {
    "Навигация": {
        "РазмерСтраницы": "15",
        "Страница": "0"
    }
}},
    ensure_ascii=True)  # формируем параметры метода ExtSdk2.ReadTasksList.

# Вызов метода ExtSdk2.ReadTasksList с пройденной аутентификацией
ole.CallMethod(query_id, guid_module, module_method, parameters_module_method, session_id)

# Ожидаем ответ через ReadAllObject в цикле по query_id
result = {}  # Переменная для сохранения результата ExtSdk2.ReadTasksList
result_checked = False
while not result_checked:

    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов

    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
    for event in events:
        if event['type'] == 'Message' and event['queryID'] == query_id:
            # если нужное событие пришло, то записываем результат в нужную переменную
            result = event['data']['Result']
            result_checked = True
            break

    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
    ole.Sleep(300)

"""Шаг 4. Пример вызова методов с несколькими параметрами на примере CallSabyApi"""
query_id = str(uuid.uuid4())  # генерируем идентификатор запроса (UUID) по которому будем ожидать ответ
module_method = "ExtSdk2.CallSabyApi"  # метод, который хотим позвать
parameters_module_method = json.dumps({
    "Method": "СБИС.ПрочитатьДокумент",
    "Params": {
        "Идентификатор": "f2a7c885-269a-44e4-8781-cb928df94163",
        "ДопПоля": "ДополнительныеПоля"
    }},
    ensure_ascii=True)  # формируем параметры метода ExtSdk2.CallSabyApi.

# Вызов метода ExtSdk2.CallSabyApi с пройденной аутентификацией
ole.CallMethod(query_id, guid_module, module_method, parameters_module_method, session_id)

# Ожидаем ответ через ReadAllObject в цикле по query_id
result = {}  # Переменная для сохранения результата ExtSdk2.CallSabyApi
result_checked = False
while not result_checked:

    events = json.loads(ole.ReadAllObject())  # получаем события от плагина и преобразуем в массив json объектов

    # в цикле проходим по каждому событию и ищем нужное с ожидаемым query_id
    for event in events:
        if event['type'] == 'Message' and event['queryID'] == query_id:
            # если нужное событие пришло, то записываем результат в нужную переменную
            result = event['data']['Result']
            result_checked = True
            break

    # если ожидаемое событие не найдено, то делаем таймаут в 300мс
    ole.Sleep(300)
Источник — «http://wiki.razgovorov.ru/index.php?title=Подключение_к_ExtSdk2_через_OLE_-_Сценарии_ExtSdk2&oldid=6088»