Пример 1. Настройка обмена данными между базой на платформе «1С:Предприятие» и интернет-сайтом
В данном примере используется демонстрационная база «1С:Предприятие 8». Ее можно скачать по ссылке.
«1С:Исполнитель» поддерживает обмен данными между системами посредством HTTP-протокола, это дает возможность использовать обмен при помощи HTTP-сервисов, например, в соответствии с имеющимся REST API.
В примере выполняется синхронизация изменений по товарным позициям между информационной базой «1С:Предприятие» и сайтом, т. е. при создании или изменении товара в базе эти изменения автоматически отражаются на сайте.
Для того чтобы настроить синхронизацию между базой «1С:Предприятие» и сайтом при помощи «1С:Исполнителя», необходимо, чтобы сайт работал по протоколу безопасного соединения HТТPS.
В ходе этого примера вы:
- В среде разработки «1С:Исполнителя»:
- создадите проект и настроите в нем процесс интеграции;
- опубликуете проект на сервере и создадите приложение;
- проверите работоспособность приложения.
- В панели управления сайтом:
- сгенерируете ключи API;
- определите метод для создания элемента на сайте.
- На сервере «1С:Исполнителя»:
- заполните параметры для подключения к сайту;
- создадите информационную систему;
- включите ее в состав процесса интеграции;
- запустите процесс интеграции.
- Создадите демонстрационную базу «1С:Предприятия»:
- создадите план обмена;
- добавите сервис интеграции;
- загрузите в него информацию о доступных каналах;
- напишете код обмена сообщениями;
- добавите регламентное задание для обмена сообщениями с «1С:Исполнителем»;
- настроите подключение к серверу;
- проверите обмен сообщениями.
Создание проекта
На этом этапе вы создадите в среде разработки «1С:Исполнителя» проект с описанием схемы интеграции и опубликуете его на сервере «1С:Исполнителя», создав приложение.
-
Откройте панель управления.
-
Нажмите Приложения ⟶ + Новое приложение:
-
Убедитесь, что выбраны варианты Из проекта и Новый проект:
-
Укажите поставщика, имя, представление и версию проекта. «1С:Исполнитель» заполнит остальные поля и включит режим разработки для создаваемого приложения:
-
Выберите тип СУБД (в примере это будет Файловая СУБД) и нажмите Создать:
-
Новое приложение появится в списке со статусом Создается. Через некоторое время статус приложения изменится на Работает:
Добавление элемента проекта
На этом этапе вы откроете приложение в среде разработки и добавите в него элемент проекта — процесс интеграции.
-
Чтобы открыть проект в среде разработки, нажмите Разработать в конце строки:
-
«1С:Исполнитель» откроет новую вкладку браузера для среды разработки и запросит пароль. Введите пароль администратора, который вы создали при установке сервера, и нажмите Войти:
-
«1С:Исполнитель» подготовит рабочую область, построит проект и откроет его в среде разработки:
-
Добавьте новый элемент проекта — процесс интеграции. Для этого в навигаторе проекта нажмите на значок плюса, затем в контекстном меню выберите Процесс интеграции:
-
Задайте имя создаваемого элемента — ОбменССайтом — и нажмите Ввод:
-
«1С:Исполнитель» создаст в проекте новый процесс интеграции и откроет редактор для создания его схемы:
Редактирование схемы процесса интеграции
На этом этапе вы создадите схему процесса интеграции, которая описывает взаимодействие информационных систем.
-
Добавьте в схему группу участников. Для этого прокрутите палитру узлов, выберите ГруппаУчастников и кликните в верхней части схемы, чтобы разместить там группу:
-
Выделите групп у и в панели Свойства задайте ее имя — Офис:
-
Добавьте на схему узел Канал1СИсточник и задайте имя — ИзОфиса:
-
Свяжите группу участников Офис с узлом ИзОфиса. Для этого прокрутите палитру узлов, выберите Связь, а затем кликните последовательно на группу участников Офис и на узел ИзОфиса:
-
Теперь добавьте на схему узел Http:
-
Свяжите узел Http маршрутом с узлом ИзОфиса. Для этого выберите в панели Маршрут, а затем кликните последовательно на узел ИзОфиса и на узел Http:
-
Переименуйте узел Http в ОбменССайтом:
-
В подсистеме Основной нажмите на значок плюса рядом с процессом интеграции ОбменССайтом и добавьте Параметр:
-
Назовите параметр URL. Затем нажмите Ввод:
-
По аналогии создайте еще три параметра: API, Login, Password. Созданные параметры отобразятся слева на панели:
-
Кликните на узел ОбменССайтом. В панели Свойства заполните параметр Url. Откройте список параметров и выберите URL:
-
Далее таким же образом добавьте к параметру URL еще один параметр — API:
-
Аналогично заполните остальные параметры. В качестве имени пользователя и пароля укажите параметры Login и Password. В поле Метод выберите значение POST:
-
Чтобы опубликовать проект на сервере, нажмите F9.
примечание -
Откройте опубликованное приложение. Для этого нажмите на имя приложения в строке состояния слева. В открывшемся меню выберите Открыть приложение.
примечание -
Сервер запросит имя пользователя и пароль. Для аутентификации используйте учетную запись администратора и пароль, который вы создали при установке сервера:
-
После успешной авторизации вы увидите приложение, а в нем — список процессов интеграции, существующих в приложении. В примере это будет единственный процесс интеграции ОбменССайтом:
Настройки на стороне сайта
В данном примере используется сайт на базе WordPress, созданный при помощи кроссплатформенной сборки локального веб-сервера XAMPP (https://www.apachefriends.org/ru/index.html). В качестве шаблона сайта был использован плагин WooCommerce (https://woocommerce.com/). Самоподписанный сертификат SSL был выпущен с помощью библиотеки OpenSSL (https://github.com/openssl/openssl).
Для взаимодействия с сайтом мы будем использовать имеющийся у плагина WooCommerce собственный REST API.
-
В панели управления сайтом перейдите в WooCommerce ⟶ Настройки ⟶ Дополнительно ⟶ REST API ⟶ Создать ключ API:
-
Сгенерируйте и сохраните ключ от сайта. Для этого введите описание ключа в поле Описание (1). В поле Права кликните на выпадающий список (2) и выберите Чтение/Запись. Затем нажмите Генерировать ключ API:
-
Скопируйте и сохраните Пользовательский ключ и Секретный код пользователя:
-
В документации к WooCommerce найдем метод, создающий новый продукт на сайте:
-
Отметим, что метод POST совпадает с тем методом, который ранее мы указывали в качестве параметра в узле ОбменССайтом на схеме интеграции в «1С:Исполнителе».
Настройка приложения в панели управления
-
Откройте приложение, если оно у вас закрыто.
-
Нажмите Инфосистемы ⟶ Добавить систему:
-
Задайте код системы — office и наименование — Офис. Нажмите Добавить:
-
Теперь для информационной системы нужно получить ключ, который она будет использовать при подключении к серверу «1С:Исполнителя». Чтобы получить ключ, нажмите на информационную систему, а затем нажмите Выдать ключ API:
-
Скопируйте и сохраните Идентификатор ключа и Секрет клиента. Позднее вы будете использовать его при подключении информационной базы к серверу «1С:Исполнителя»:
-
Перейдите на вкладку Процессы и нажмите на процесс ОбменССайтом:
-
Вы увидите схему процесса интеграции и панель, позволяющую задавать свойства узлов этой схемы. На схеме выберите группу Офис, а затем нажмите Состав группы в правом нижнем углу:
-
Вы увидите список информационных систем, входящих в группу Офис. Сейчас в группе нет ни одной информационной системы. Установите флажок у информационной системы office и нажмите Добавить в группу:
-
Закройте окно Состав группы Офис.
Далее необходимо заполнить параметры узла ОбменССайтом, которые позволят взаимодействовать «1С:Исполнителю» с сайтом.
-
На схеме выберите узел ОбменССайтом и в правом нижнем углу нажмите Параметры:
-
Заполните параметры следующим образом:
- URL:
https://имя-вашего-сервера/имя-вашего-сайта
(в примере: https://localhost/testsite); - API:
/wp-json/wc/v3/products
; - в полях Login и Password укажите пользовательский ключ и секретный код пользователя, полученные при генерации ключа на сайте.
Нажмите Применить:
- URL:
-
Теперь можно запустить созданный процесс интеграции. Для этого нажмите Запустить в правом верхнем углу:
Следующим шагом мы создадим и настроим информационную базу 1С:Предприятие.