Подключение к ExtSdk2 через NativeAPI - Сценарии ExtSdk2

Материал из razgovorov.ru
Перейти к: навигация, поиск

Подключение NativeAPI к 1С

NativeAPI - технология, которая позволяет создавать внешние компоненты для 1С, что рассширяет возможности данной программы. Ее главное преимущество - это работа не только на Windows системах, в отличие от COM объекта, который не может работать в Linux. Подробнее про NativeAPI можно почитать на сайте its.1c.ru

Для подключения расширения NativeAPI к 1С необходимы следующие шаги:

Шаг 1. Иметь архив с расширением .zip, который будет содержать нужную версию dll и файл MANIFEST.XML( Например NativeAPI_Connector.zip )

Шаг 2. Добавить общий макет с типом ДвоичныеДанные и назвать его, например МойМакет. Далее загрузить в макет файлы из подготовленного архива с внешней компонентой с помощью команды карточки макета Загрузить из файла - NativeAPI_Connector.zip.

Шаг 3. Установить внешнюю компоненту: 

       УстановитьВнешнююКомпоненту("ОбщийМакет.МойМакет");

МойМакет - название макета, в который загружена компонента

Шаг 4. Подключение внешней компоненты происходит через последовательные команды: 

       ПодключитьВнешнююКомпоненту("ОбщийМакет.МойМакет", "МойМакетAddIn", ТипВнешнейКомпоненты.Native); 
       МояКомпонента = Новый("AddIn.МойМакетAddIn.AddInNativeExtension");

Текст МойМакетAddIn - произвольный. Единственное условие - он должен совпадать в приведенных выше вызовах.
Строка AddInNativeExtension - уже указана в шаблоне компоненты (RegisterExtensionAs), ее не надо менять.
Переменную МояКомпонента рекомендуется описать в модуле управляемого и обычного приложения как Перем МояКомпонента Экспорт.

Шаг 5. Вызов методов компоненты: 

       Результат = МояКомпонента.ReadAllXml();

Шаг 6. Пожать себе руку за успешное подключение компоненты к 1С.

Полный пример подключения компоненты: 

Процедура Команда1(Команда)  
	
	УстановитьВнешнююКомпоненту("ОбщийМакет.МойМакет");
	ПодключитьВнешнююКомпоненту("ОбщийМакет.МойМакет", "МойМакетAddIn", ТипВнешнейКомпоненты.Native); 
        МояКомпонента = Новый("AddIn.МойМакетAddIn.AddInNativeExtension");

	Результат = МояКомпонента.ReadAllXml();
	 	 	
КонецПроцедуры

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

Решить:

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

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

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

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

Вызов команд

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

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

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

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

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

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

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

Источник — «http://wiki.razgovorov.ru/index.php?title=Подключение_к_ExtSdk2_через_NativeAPI_-_Сценарии_ExtSdk2&oldid=6388»