Создание внешних компонент 1с

Обновлено: 01.07.2024

Внешние компоненты можно использовать на разных операционных системах:

А также может быть 32-х разрядная версия внешней компоненты и 64-х разрядная.

Внешние компоненты могут использоваться при работе через веб-клиент для браузеров:

Google Chrome
Microsoft Internet Explorer
Mozilla Firefox
Safari;

И в мобильной платформе 1С для мобильных операционных систем:

Существует две технологии создания внешних компонент для 1С:

Внешние компоненты разработанные по технологии COM можно использовать только:

В тонком и толстом клиентах
В веб клиенте, только для ОС Windows

Для подключения внешней компоненты используется метод НачатьПодключениеВнешнейКомпоненты, вторым параметром нужно указать ProgID COM компоненты.

ОбратныйВызов = Новый ОписаниеОповещения ( "ОбратныйВызов" , ЭтотОбъект ) ; НачатьПодключениеВнешнейКомпоненты ( ОбратныйВызов , "AddIn.Test" ) ; Процедура ОбратныйВызов ( Подключено , ДопПараметры ) Экспорт

Также можно использовать синхронный метод ПодключитьВнешнююКомпоненту и асинхронный ПодключитьВнешнююКомпонентуАсинх.

На данный момент данная технология является устаревшей, рекомендуется использовать технологию Native API.

Native API

Внешние компоненты разработанные по технологии Native API можно использовать:

В тонком и толстом клиентах
В веб-клиенте
На сервере
В мобильном приложении

Внешняя компонента может быть запакована в ZIP-архив или представлена в виде отдельного файла.

Так как внешние компоненты по технологии Native API могут быть использованы как в Windows, так и в Linux, то желательно помещать в архив с компонентой 5 файлов:

dll файл 32-х разрядной версии
dll файл 64-х разрядной версии
so файл 32-х разрядной версии
so файл 64-х разрядной версии
Файл-манифест

В этом случае при подключении внешней компоненты платформа сама определит какой файл использовать по файлу-манифесту.

Подключение внешней компоненты на клиенте

Перед подключением внешней компоненты на клиенте, ее сначала нужно установить методом НачатьУстановкуВнешнейКомпоненты. Установка выполняется в каталог компьютера клиента %APPDATA%\1C\1Cv8\ExtCompT. Установка выполняется один раз. В дальнейшем перед использованием компоненты ее нужно только подключать. Подключение выполняется методом НачатьПодключениеВнешнейКомпоненты.

Эта статья дает представление о работе внешних компонент в системе «1С: Предприятие».
Будет показан процесс разработки внешней компоненты для системы «1С: Предприятие» версии 8.2, работающей под управлением ОС семейства Windows с файловым вариантом работы. Такой вариант работы используется в большинстве решений, предназначенных для предприятий малого бизнеса. ВК будет реализована на языке программирования C++.

Внешние компоненты «1C: Предприятие»

с использованием Native API
с использованием технологии COM

Структура ВК

Внешняя компонента системы «1С: Предприятие» представлена в виде DLL-библиотеки. В коде библиотеки описывается класс-наследник IComponentBase. В создаваемом классе должны быть определены методы, отвечающие за реализацию функций внешней компоненты. Более подробно переопределяемые методы будут описаны ниже по ходу изложения материала.

Запуск демонстрационной ВК

Выполнить сборку внешней компоненты, поставляемой с подпиской ИТС и предназначенной для демонстрации основных возможностей механизма внешних компонент в 1С
Подключить демонстрационную компоненту к конфигурации 1С
Убедиться в корректной работоспособности заявленных функций

Компиляция

Демонстрационная ВК расположена на диске подписки ИТС в каталоге «/VNCOMP82/example/NativeAPI».
Для сборки демонстрационной ВК будем использовать Microsoft Visual Studio 2008. Другие версии данного продукта не поддерживают используемый формат проекта Visual Studio.

Открываем проект AddInNative. В настройках проекта подключаем каталог с заголовочными файлами, необходимыми для сборки проекта. По умолчанию они располагаются на диске ИТС в каталоге /VNCOMP82/include.
Результатом сборки является файл /bind/AddInNative.dll. Это и есть скомпилированная библиотека для подключения к конфигурации 1С.

Подключение ВК к конфигурации 1С

Создадим пустую конфигурацию 1С.
Ниже приведен код модуля управляемого приложения.

Если при запуске конфигурации 1С не было сообщено об ошибке, то ВК была успешно подключена.
В результате выполнения приведенного кода в глобальной видимости конфигурации появляется объект ДемоКомп, имеющий свойства и методы, которые определены в коде внешней компоненты.

Демонстрация заложенного функционала

Произвольное имя внешней компоненты

Задача: Изменить имя внешней компоненты на произвольное.
В предыдущем разделе использовался идентификатор AddInNativeExtension, смысл которого не был пояснен. В данном случае AddInNativeExtension — это наименование расширения.
В коде ВК определен метод RegisterExtensionAs, возвращающий системе «1С: Предприятие» имя, которое необходимо для последующей регистрации ВК в системе. Рекомендуется указывать идентификатор, который в известной мере раскрывает суть внешней компоненты.
Приведем полный код метода RegisterExtensionAs с измененным наименованием расширения:

В приведенном примере имя ВК изменено на SomeName. Тогда при подключении ВК необходимо указывать новое имя:

Расширение списка свойств ВК

Изучить реализацию свойств ВК
Добавить свойство строкового типа, доступное для чтения и записи
Добавить свойство строкового типа, доступное для чтения и записи, которое хранит тип данных последнего установленного свойства. При установке значения свойства никаких действий не производится
Убедиться в работоспособности произведенных изменений

Полное описание методов, включая список параметров подробно описан в документации, поставляемой на диске ИТС.
Рассмотрим реализацию приведенных методов класса CAddInNative.
В демонстрационной ВК определены 2 свойства: Включен и ЕстьТаймер (IsEnabled и IsTimerPresent).
В глобальной области видимости кода библиотеки определено два массива:

которые хранят русское и английское названия свойств. В заголовочном файле AddInNative.h определяется перечисление:

Добавить имя добавляемого свойства в массивы g_PropNames и g_PropNamesRu (файл AddInNative.cpp)
В перечисление Props (файл AddInNative.h) перед ePropLast добавить имя, однозначно идентифицирующее добавляемое свойство
Организовать память под хранение значений свойств (завести поля модуля компоненты, хранящие соответствующие значения)
Внести изменения в методы GetPropVal и SetPropVal для взаимодействия с выделенной на предыдущем шаге памятью
В соответствии с логикой приложения внести изменения в методы IsPropReadable и IsPropWritable

Перечисление Props будет иметь вид:

Для значительного упрощения кода будем использовать STL C++. В частности, для работы со строками WCHAR, подключим библиотеку wstring.
Для сохранения значения метода Тест, определим в классе CAddInNative в области видимости private поле:

Для передачи строковых параметров между «1С: Предприятие» и внешней компонентов используется менеджер памяти «1С: Предприятие». Рассмотрим его работу подробнее. Для выделения и освобождения памяти соответственно используются функции AllocMemory и FreeMemory, определенные в файле ImemoryManager.h. При необходимости передать системе «1С: Предприятие» строковый параметр, внешняя компонента должна выделить под нее память вызовом функции AllocMemory. Ее прототип выглядит следующим образом:

где pMemory — адрес указателя, в который будет помещен адрес выделенного участка памяти,
ulCountByte — размер выделяемого участка памяти.
Пример выделения памяти под строку:

Для удобства работы с строковыми типами данными опишем функцию wstring_to_p. Она получает в качестве параметра wstring-строку. Результатом функции является заполненная структура tVariant. Код функции:

Тогда соответствующая секция case оператора switch метода GetPropVal примет вид:

Метода SetPropVal:

Для реализации второго свойства определим поле класса CaddInNative

в котором будем сохранять тип последнего переданного значения. Для этого в метод CaddInNative::SetPropVal добавим команду:

Теперь при запросе чтения значения второго свойства будем возвращать значение last_type, чего требует обозначенное задание.
Проверим работоспособность произведенных изменений.
Для этого приведем внешний вид конфигурации 1С к виду:

Расширение списка методов

Расширить функционал внешней компоненты следующим функционалом:
Изучить способы реализации методов внешней компоненты
Добавить метод-функцию Функц1, которая в качестве параметра принимает две строки («Параметр1» и «Параметр2»). В качестве результата возвращается строка вида: «Проверка. Параметр1, Параметр2»
Убедиться в работоспособности произведенных изменений

Добавить имя метода в массивы g_MethodNames и g_MethodNamesRu (файл AddInNative.cpp)
Добавить осмысленный идентефикатор метода в перечисление Methods (файл AddInNative.h)
Внести изменения в код функции GetNParams в соответствии с логикой программы
При необходимости внести изменения в код метода GetParamDefValue, если требуется использовать значения по умолчанию параметров метода.
Внести изменения в функцию HasRetVal
Внести изменения в логику работы функций CallAsProc или CallAsFunc, поместив туда непосредственно исполняемый код метода

Отредактируем функцию GetNProps, чтобы она возвращала количество параметров метода «Тест»:

Внесем изменения в функцию CAddInNative::GetParamDefValue:

Благодаря добавленной строке

в случае отсутствия одного или нескольких аргументов соответствующие параметры будут иметь пустое значение (VTYPE_EMPTY). Если необходимо наличие значения по умолчанию для параметра, следует задать его в секции eMethTest оператора switch функции CAddInNative::GetParamDefValue.
Так как метод «Тест» может возвращать значение, необходимо внести изменения в код функции HasRetVal:

И добавим исполняемый код метода в функцию CallAsFunc:

Скомпилируем компоненту и приведем код конфигурации к виду:

Таймер

Изучить реализацию таймера в демонстрационной ВК
Модифицировать метод «СтартТаймер», добавив возможность передавать в параметрах интервал срабатывания таймера (в миллисекундах)
Убедиться в работоспособности произведенных изменений

Рассмотрим реализацию таймера в демонстрационной ВК.
Так как мы рассматриваем процесс разработки внешней компоненты для ОС семейства Windows, не будем рассматривать реализацию таймера в других операционных системах. Для ОС GNU/Linux, в частности, реализация будет отличаться синтаксисом функции SetTimer и TimerProc.
В исполняемом коде вызывается метод SetTimer, в который передается функция MyTimerProc:

Идентефикатор созданного таймера помещается в переменную m_uiTimer, чтобы в последствии его можно было отключить.
Функция MyTimerProc выглядит следующим образом:

Приведем код метода CallAsProc к виду:

Теперь проверим работоспособность. Для этого в модуле управляемого приложения конфигурации напишем код:

Взаимодействие с системой «1С: Предприятие»

Внешние компоненты «1C: Предприятие»

с использованием Native API
с использованием технологии COM

Структура ВК

Запуск демонстрационной ВК

Выполнить сборку внешней компоненты, поставляемой с подпиской ИТС и предназначенной для демонстрации основных возможностей механизма внешних компонент в 1С
Подключить демонстрационную компоненту к конфигурации 1С
Убедиться в корректной работоспособности заявленных функций

Компиляция

Подключение ВК к конфигурации 1С

Создадим пустую конфигурацию 1С.
Ниже приведен код модуля управляемого приложения.

Демонстрация заложенного функционала

Произвольное имя внешней компоненты

В приведенном примере имя ВК изменено на SomeName. Тогда при подключении ВК необходимо указывать новое имя:

Расширение списка свойств ВК

Изучить реализацию свойств ВК
Добавить свойство строкового типа, доступное для чтения и записи
Добавить свойство строкового типа, доступное для чтения и записи, которое хранит тип данных последнего установленного свойства. При установке значения свойства никаких действий не производится
Убедиться в работоспособности произведенных изменений

Добавить имя добавляемого свойства в массивы g_PropNames и g_PropNamesRu (файл AddInNative.cpp)
В перечисление Props (файл AddInNative.h) перед ePropLast добавить имя, однозначно идентифицирующее добавляемое свойство
Организовать память под хранение значений свойств (завести поля модуля компоненты, хранящие соответствующие значения)
Внести изменения в методы GetPropVal и SetPropVal для взаимодействия с выделенной на предыдущем шаге памятью
В соответствии с логикой приложения внести изменения в методы IsPropReadable и IsPropWritable

Перечисление Props будет иметь вид:

Тогда соответствующая секция case оператора switch метода GetPropVal примет вид:

Метода SetPropVal:

Для реализации второго свойства определим поле класса CaddInNative

Расширение списка методов

Расширить функционал внешней компоненты следующим функционалом:
Изучить способы реализации методов внешней компоненты
Добавить метод-функцию Функц1, которая в качестве параметра принимает две строки («Параметр1» и «Параметр2»). В качестве результата возвращается строка вида: «Проверка. Параметр1, Параметр2»
Убедиться в работоспособности произведенных изменений

Добавить имя метода в массивы g_MethodNames и g_MethodNamesRu (файл AddInNative.cpp)
Добавить осмысленный идентефикатор метода в перечисление Methods (файл AddInNative.h)
Внести изменения в код функции GetNParams в соответствии с логикой программы
При необходимости внести изменения в код метода GetParamDefValue, если требуется использовать значения по умолчанию параметров метода.
Внести изменения в функцию HasRetVal
Внести изменения в логику работы функций CallAsProc или CallAsFunc, поместив туда непосредственно исполняемый код метода

Отредактируем функцию GetNProps, чтобы она возвращала количество параметров метода «Тест»:

Внесем изменения в функцию CAddInNative::GetParamDefValue:

Благодаря добавленной строке

И добавим исполняемый код метода в функцию CallAsFunc:

Скомпилируем компоненту и приведем код конфигурации к виду:

Таймер

Изучить реализацию таймера в демонстрационной ВК
Модифицировать метод «СтартТаймер», добавив возможность передавать в параметрах интервал срабатывания таймера (в миллисекундах)
Убедиться в работоспособности произведенных изменений

Приведем код метода CallAsProc к виду:

Теперь проверим работоспособность. Для этого в модуле управляемого приложения конфигурации напишем код:

Взаимодействие с системой «1С: Предприятие»

На сайте ИТС есть руководство для разработки внешних компонент, но оно не для новичков. Это скорее документация. Там же есть примеры готовых внешних компонент, но опять же будучи новичком довольно сложно в них разобраться. После прохождения данного курса Вам будет намного легче разобраться в документации и в примерах и разрабатывать свои внешние компоненты.

В комментариях к урокам курса можно задавать вопросы, по возможности буду стараться отвечать.

Если есть вопросы касательно курса, то можете задавать их в комментариях к этой статье.

Как получить курс

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

Курс представлен в текстовом формате со скриншотами, с примерами кода. Это не видео уроки.

Полный курс доступен после оплаты. На данный момент стоимость курса составляет 1750 рублей.

Курс будет пополняться. В планах добавить уроки по сборке компонент для веб-клиента, по использованию JNI в мобильной платформе под Android. Соответственно цена будет расти.

После оплаты Вы навсегда (пока существует данный сайт) получите доступ к материалам курса, в том числе ко всем новым урокам.

На страницах курса нет рекламы!

Содержание курса

Урок 1. Внешние компоненты в 1С 8.3

Разберем что такое внешние компоненты, какие бывают технологии разработки внешних компонент, как устанавливать и подключать внешние компоненты в 1С.

Урок 2. COM объект в 1С 8.3

Разберем как работать с COM объектом в 1С, а также что такое COMSafeArray.

Урок 4. Передача параметров из 1С в COM сервер

Научимся передавать параметры из 1С в COM сервер, а также обрабатывать события COM сервера в 1С.

Урок 5. TCP клиент через COM

Урок 9. Внешняя компонента 1С по технологии Native API. Привет мир из компоненты

Пошаговое создание внешней компоненты 1С по технологии Native API на С++ с возможностью вызова внешнего события в 1С.

Урок 10. Внешняя компонента 1С по технологии Native API. Разбор API

Разберем почти весь API внешних компонент по технологии Native API. Добавление свойств и методов. Что такое WCHAR_T. Зачем нужен тип tVariant. Как вызвать внешнее событие в 1С. Как задать вопрос из внешней компоненты. Обработка исключительных ситуаций. Передача двоичных данных во внешнюю компоненту.

Урок 11. Внешняя компонента 1С по технологии Native API. Сборка для 64-х разрядной платформы

Научимся собирать 64-х разрядную версию внешней компоненты.

Урок 12. Пример внешней компоненты 1С по технологии Native API на C++

Данный урок содержит пример внешней компоненты 1С по технологии Native API на С++:

Урок 13. Отладка внешних компонент Native API

Пример отладки внешних компонент Native API через логирование в текстовый файл, а также через Visual Studio.

Урок 14. Сборка внешней компоненты Native API для Linux

Разработка кроссплатформенной внешней компоненты Natipe API для Windows и Linux. Сборка внешней компоненты Natipe API для Linux.

Урок 15. Разработка внешней компоненты для мобильной платформы на C++

Пример разработки внешней компоненты Natipe API для мобильной платформы только на C++. Пример вызова внешнего события в мобильной платформе. Только для ОС Android.

Урок 16. Взаимодействие мобильного приложения на 1С с мобильным приложением на Java

Пример разработки простого мобильного приложения на Java и его вызов из мобильного приложения на 1С. Передача параметров как в мобильное приложение на Java, так и в мобильное приложение на 1С.

Читайте также: