Область применения
Доступ к данным 1С без единой строки кода через СКД- Поддержка JSON-RPC и запросов из браузера
- Превращение 1С в Headless CMS
- Методы добавляются без изменения конфигурации
- Код можно разместить в общем модуле или справочнике
- Работа с планами обмена и отдача только изменённых данных
- В поставке — демо-база с примерами и схемами
Технические требования
(в базовых конфигурациях 1С, возможности подключения расширений - отсутствуют)
Полностью открытый код, не требует наличия каких-либо объектов метаданных
Поддерживается три варианта работы
API
- • API с передачей параметров в адресной строке.
- • Получить описание API можно запросом такого вида: https://server1s/baza/hs/lemurr/md/json?k=123456.
API по протоколу json-rpc
- • При таком подходе адрес для обращения всегда один, а имя правила и параметры передаются в запросе json-rpc.
Web hook
- • Подход web hook подразумевает отправку данных по инициативе системы.
- • Может отправлять накопленные данные по расписанию или по запросу.
- • Такой подход удобен, когда система «знает» какие данные нужны корреспондирующей системе.
Функциональные возможности обмена данными
Правила обмена
- Описание правил обмена в расширении
- Указание полей данных для каждого правила
- Алгоритмы чтения из 1С, записи и отправки
- Поддержка одинаковых правил в корреспондирующих системах
Наборы правил (API)
1. Множество наборов
В одной базе возможно описать несколько наборов правил, каждый из которых представляет собой отдельное API.
2. План синхронизации
Правила объединяются в наборы с помощью плана синхронизации для гибкой настройки сценариев обмена.
3. Гибкая конфигурация
Возможность создания различных комбинаций правил под разные бизнес-процессы.
Обмен изменениями
Только изменения
Система поддерживает обмен только изменёнными данными при использовании планов обмена.
Настройка отслеживания
Для каждого правила необходимо указать объект метаданных и узел обмена для отслеживания изменений.
Эффективность
Минимизация передаваемых данных за счёт отправки только актуальных изменений.
Пример описания API
Параметры: План синхронизации: Внутренние сайты
- Адрес для получения данных в общем виде выглядит так:
https://server1s/baza/hs/lemurr/data/80213a3c-6a2d-11ef-825d-f43bd8ccef6b/json/100/200?k=123456&n=1- Где:
- https — протокол (обязательно защищенный)
- server1s — имя web сервера
- baza — имя базы 1С на web сервере
- hs — признак обращения к http сервису
- lemurr — имя http сервиса
- data — признак получения данных (можно заменить на md для описания API)
- 80213a3c-6a2d-11ef-825d-f43bd8ccef6b — идентификатор правила синхронизации
- json — формат возвращаемых данных (можно указать html для отладки)
- 100 — количество возвращаемых записей
- 200 — начальная позиция для постраничного просмотра
- Параметры после ?:
- k=123456 — ключ плана синхронизации
- n=1 — флаг возврата только измененных данных
- Примеры запросов:
- Описание API в JSON:
https://server1s/baza/hs/lemurr/md/json?k=123456 - Описание API в HTML:
https://server1s/baza/hs/lemurr/md/html?k=123456 - Отправка данных:
https://server1s/baza/hs/lemurr?k=123456
- Пример curl-запроса для записи данных:
curl -X POST -T "zapis.json" https://server1s/baza/hs/lemurr/data/80213a3c-6a2d-11ef-825d-f43bd8ccef6b/json?k=123456- Содержимое файла zapis.json:
-
{ "Наименование": "1С:Упрощенка 8", "Артикул": "4601546048264", "ПолноеНаименование": "1С:Упрощенка 8" } - Алгоритм исполнит скрипт обработки загрузки, передав ему полученные данные.
- Работа в формате JSON-RPC осуществляется только через POST-запросы.
- Базовый адрес для всех запросов:
https://server1s/baza/hs/lemurr?k=123456- Где 123456 — ключ плана синхронизации.
- Пример запроса для получения описания API:
-
{ "jsonrpc": "2.0", "method": "__описание__", "params": null, "id": "произвольный идентификатор" } - __описание__ — зарезервированное слово для получения описания API.
Видеодемонстрация
Демонстрация решения. Посмотрите короткое видео, в котором подробно рассказываем про основные функции продукта.
Пример записи данных в 1С
Видеоинструкция
Установка решения. Установка,включает распаковку архива и подключение расширения к существующей базе 1С.
Также важно учесть технические требования: решение работает на платформе 8.3 с управляемыми формами, не подходит для базовых версий
Остались вопросы?
Для получения дополнительной информации и помощи в настройке модуля под нужды вашего бизнеса — оставьте заявку
