Универсальный HTTP-сервис на платформе 1С, аля HTTP-сервер с примером
Разработка - Инструментарий разработчика
Приветствую коллеги!
В комментариях к статье 1C + Python + Django Rest Framework + Vue.js. Опыт несложной full-stack разработки я оставил комментарий и предложил другой путь решения подобных задач. Завязалась дискуссия в ходе которой я предложил свой подход, который успешно опробован на наших клиентах к решению аналогичной задачи (личный кабинет для техподдержки).
Исходная задача
В организации есть рабочая информационная база 1С (она же учетная система). Необходимо создать личный кабинет для пользователей с возможностью web-доступа. Причем пользователи должны полноценно работать в любом браузере, интерфейс желательно иметь адаптивный (меняет дизайн страницы в зависимости от поведения пользователя, платформы, размера экрана и ориентации устройства: компьютера, смартфона, планшета). Личный кабинет должен быть достаточно легко модифицируемым и расширяемым.
Задач такого круга масса: личный кабинет покупателя для заказа товаров онлайн, внесение показаний счетчиков в сфере ЖКХ, службы доставки товаров, техподдержка и прием заявок клиентов и т.д.
Варианты решений
Первый вариант. Классический. Разделить личный кабинет и информационную базу 1С. Это самый древний способ, который к нам пришел еще с бородатых времен 1С версии 7.7. Личный кабинет при этом делается на каком-нибудь веб-движке и при необходимости какой-нибудь веб-ориентированной СУБД. Например, PHP + MySQL или Django Rest Framework + Vue.js + MariaDB. При этом время от времени происходит обмен данными между веб-частью и центральной ИБ на 1С и происходит синхронизация данных.
Плюсы:
- Независимость 1С и веб-частей друг от друга. В случае остановки работы одной части, вторая продолжает работу.
Минусы:
- Оперативность обмена данными. Необходимо время, чтобы выгрузить информацию из 1С и загрузить ее в веб-часть, а так же время на обратную операцию. Соответственно это влечет за собой паузы между обменами и в некоторых случаях это критично.
- Сложность дальнейшего сопровождения. Сопровождать две системы практически всегда сложнее чем одну при условии, что выполняют по сути они одну и ту же задачу.
- Длинная цепочка взаимодействий всей системы. Здесь я имею ввиду повышение риска остановки обмена, если одно из цепи перестанет работать: остановка регламентных заданий в случае зависания, недоступность FTP-сервера если его используют для обмена, какие-то ошибки, связанные с выгрузкой для веба и т.д. Крепость всей цепи определяется крепостью самого слабого звена.
Несмотря на то, что это один из первых способов, который появился очень давно, его успешно продолжают использовать и по сей день.
С развитием платформы и выходом версии 8.2 появился еще один способ.
Вариант два. Использование стандартного web-клиента 1С. Зачем делить систему на части, если можно дать пользователям доступ к рабочей базе, разграничить все права и пользователь сможет видеть только то, что ему нужно?
Плюсы:
- Все в одном месте. Тут комментарии излишни.
- Простота разработки. Мы вообще не вникаем в веб и все делаем на платформе 1С.
Минусы:
- Лицензии на платформу 1С. Каждый дополнительный сеанс ведет к увеличению стоимости всей системы.
- Права пользователей. Тут надо усиленно следить. Не дай бог, клиент увидит, или еще страшнее сделает, что-то не то, что изначально не запланировали. Из этого пункта вытекает следующий.
- Конфиденциальность. Часто базы 1С размещают на внутренних серверах компании, потому, что не все что есть в базе должно быть публично.
- Ни для кого не секрет, что 1С иногда необходимо останавливать для регламентных операций и обслуживания. Очевидно, что во время этих остановок никто не сможет работать.
- Количество пользователей в онлайне. Если в варианте номер один, веб-странички при достаточно скромных мощностях на хостинге непринужденно могут обслуживать сотни и тысячи клиентов, то на платформе 1С все не так хорошо. Необходимы сумасшедшие мощности сервера 1С.
Вариант три. Использование HTTP-сервисов 1C. С выходом 8.3 в платформу были добавлены новые механизмы: сначала web-сервисы для интеграции с другими информационными системами, а потом и HTTP-сервисы, предназначеные для обработки HTTP-запросов, которые сначала поступают на веб-сервер, который передает на обработку эти запросы 1С, а уже 1С обрабатывает эти запросы и возвращает результат так же по протоколу HTTP, браузер видит ответ и отображает пользователю результат. При этом мы можем возвращать HTTP-запросам клиентов АБСОЛЮТНО любые данные: картинки, HTTP-страницы, JSON-данные, обычный текст и т.п.
Плюсы:
- Все можно сделать очень красиво и не будет понятно, что эти страницы сформированы вообще в 1С. Собственно, в скриншотах есть страничка, которая отображает "как оно есть" в нашей разработке. Тут и адаптивность, разные фреймворки и компоненты, в общем все, что вашей душе угодно.
- Скорость работы по сравнению с вариантом два достаточно высокая, за счет возможности переиспользования сеансов. Но все равно вариант один будет быстрее т.к. нет накладных расходов.
Минусы:
- Лицензии. Тут не все понятно, но понятно то, что они нужны. Как лично понял я, они нужны в объеме онлайн-сеансов (возможно ошибаюсь и если есть более точная информация поправьте меня). Т.е. если в онлайне одновременно работают 10 человек в личном кабинете, то необходимо 10 лицензий. Сеансы живут какое-то время, а потом уничтожаются, временем жизни сеансов можно управлять настройками.
- При изменении поведения HTTP-сервиса необходимо остановить работу.
На ИСе много примеров использования HTTP-сервисов среди которых:
На что действительно способны HTTP-сервисы
HTTP-сервис: отчеты [Расширение]
Реализация простого http-сервиса "Просмотр карточки номенклатуры(товара) в браузере"
Но все они не универсальные и заточены под одну конкретную задачу или решение какой-то одной проблемы. Я бы хотел остановится на использовании HTTP-сервисов немного в другом контексте...
Вариант четыре. Он же гибридный вариант три. Универсальный HTTP-сервис.
Это уже мой подход к этому вопросу. Я долго думал, на тему как сделать так, чтобы HTTP-сервис не нужно было постоянно бы изменять в конфигураторе (хотя это спорно, так как сейчас все идет к расширениям и этот функционал можно реализовать через расширение конфигурации) и реализовать что-то универсальное. И мысли примерно следующие: по факту HTTP-сервис всегда работает по алгоритму: пришел какой-то запрос вида http://site.ru/hs/lk/index.html необходимо понять, что от нас хотят, покопаться в 1С, возможно сделать какой-то запрос или еще что-то и отдать соответствующий ответ. Т.е. схема работы HTTP-сервиса примерно такая:
Это все схематично. Обратите внимание на один важный момент. Для каждого последующего запроса алгоритм будет одинаковый. Пришел запрос - отдаем ответ.
Т.е. если мы в браузере открыли страничку по адресу: http://site.ru/hs/lk/index.html которую обработал HTTP-сервис и вернул нам:
<html><body><img src="/images/1.png" alt="Моя картинка"></body></html>
То автоматически браузером будет выполнен второй запрос по адресу: http://site.ru/hs/lk/images/1.png и в браузер будет подставлена картинка, которая получена вторым запросом.
Т.е. количество запросов к HTTP-сервису будет 2, а показана всего одна страничка, но на ней будет картинка. Если ссылок в документе будет несколько, то каждый раз браузер будет обращаться к HTTP-сервису и просить у него то, чего ему не хватает. Круто да?
Что это дает нам? А это позволяет нам сделать следующее: если мы научимся хранить данные, которые мы хотим отдавать пользователям, присвоим им адреса, по которым можно будет их найти, научимся обрабатывать не найденные страницы и HTTP-сервис будем использовать как низкоуровневую прослойку между этими данными и пользователями, то мы получим универсальный механизм. Мы получаем образно говоря HTTP-сервер на платформе 1С.
Т.е. пусть:
index.html - это вот эта страничка с текстом. Где ее тип text/html, а текст вот такой <html><body><img src="/images/1.png" alt="Моя картинка"></body></html>
/images/1.png - это картинка и она имеет тип image/png и содержит вот такие-то двоичные данные, в которых хранится картинка.
Итого HTTP-сервис теперь все отдает как надо для нашего примера. Получил страничку, нашел ее в списке и отобразил, увидел, что еще требуется картинка, послал запрос за картинкой, получил, дорисовал картинку.
Структура выше ничего не напоминает? Это ведь справочник чистой воды :) Давайте его прикрутим.
Далее скриншоты из нашего решения. Файл index.html - имеет адрес от корня HTTP-сервиса, а вот эта картинка:
Имеет адрес /images/nophoto.png
А вот сама страница:
Обратите внимание, что это шаблон заполнения. Область <!--include(header.html)---> означает, что найди файл по адресу /header.html и вставь его содержимое в это место. Области на страницах повторяются поэтому так делать имеет смысл во избежание дублирования HTML-кода.
Далее, находим все остальные языковые константы вида <!---TEXT---> и заполняем их используя вкладку "Локализация" - это позволит заменить постоянные строки, чтобы их можно было внести в одном месте, а потом использовать как константы:
Далее, когда текст более или менее готов, мы выполняем дополнительный код на встроенном языке 1С, который находится на закладке "Алгоритм заполнения" и дозаполняем глобальную переменную для HTTP-сервиса "Переменные" и/или выполняем какие-то дополнительные действия. У нас есть в этом случае то, что должны вернуть:
- Тело - переменная в которой ответ, который будет передан. Уже с заполненными языковыми переменными и вставленными областями.
- Переменные - если есть переменная, которая отсутствует в локализации, то ее можно дополнительно объявить в алгоритме заполнения добавив ее в структуру.
- Запрос - собственно исходный HTTPЗапрос.
И то, что можем использовать в алгоритме:
- ОтносительныйURL - какой запрос пришел.
- ОтносительныйURLПеренаправления куда безусловно перенаправить если это необходимо. Например реализовав редирект 301 или 302.
- ИмяФайла - наименование элемента в справочнике ЛичныйКабинет.
- Путь - группа где находится элемент в справочнике ЛичныйКабинет.
- POST - POST-переменные, которые были нам переданы в виде Соответствия. Здесь мы можем получить и обработать что-то от веб-форм (например файлы из браузера).
Так же возможна такая ситуация, когда в справочнике не найдена страничка, которую надо отобразить. В этом случае есть специальная настройка, которая говорит какую страничку выводить в этом случае. Страничка будет выведена и отдан ответ 404 (страница не найдена).
В общем случае подобный подход позволит всегда работать по принципу шаблонизатора и на платформе 1С. HTML-страницы формируются автоматически, анализируя запрос от пользователя. Т.е. если пользователь введет адрес или перейдет в личном кабинете по ссылке, например: http://адрес_сервера_1с.ru/имя_публикации/hs/lk/folder1/folder2/file.html?param=1 То для построения страницы пользователю система все, что после lk, т.е. /folder1/folder2/file.html?param=1 будет разбито на блоки и по шагам выполнен алгоритм, который описан выше. При этом мы так же можем использовать различные фреймворки для работы. В справочнике "Личный кабинет" есть возможность загрузить папку с фреймворком, а потом на своих страничках использовать стили и скрипты оттуда. Мы в своей разработке, например, использовали Bootstrap + JQuery + chart.js.
Для демонстрации прикреплена демо-версия подсистемы (dt-файл). Желающие могут скачать и попробовать поработать. Там все, что касается кода присутствует, но сделан примитив заполнения справочника с данными для отображения, не то, что в боевой базе и на скриншотах, но этого вполне достаточно, чтобы понять как это все работает и возможно кто-то возьмет за шаблон в свои аналогичные проекты.
PS: Для работы с демо-базой необходимо опубликовать базу на веб-сервере, и ввести в браузере http://адрес_сервера_1с.ru/имя_публикации/hs/lk/, после ввести данные для аутентификации "Администратор" (без кавычек) и пустой пароль. Можете параллельно в справочнике "Личный кабинет" изменять странички и после смотреть что получается в браузере.
PS: Спасибо, что дочитали до конца! :)
Специальные предложения
См. также
Базовый курс для начинающих 1С-программистов. Пятый поток. Онлайн-курс с 12 февраля по 15 апреля 2020 г. Промо
Данный онлайн-курс является начальной ступенью по изучению базовых принципов программирования в системе “1С:Предприятие” и предназначен для обучения 1С-программированию “с нуля”.
4500/9500 рублей
Просмотр и анализ структуры базы данных (отчет на СКД) 121
5 стартмани
24.07.2019 9167 96 YPermitin 25
Перенос данных УТ 10.3 => УТ 11 / КА 2 / ERP 2 (ЕРП 2) (документы, остатки и справочная информация из "1С:Управление торговлей, ред. 10.3" в УТ 11 / КА 2 / ERP 2). Обновлен до УТ 10.3.56.х, УТ 11.4.10.х, КА 2.4.10.х и ERP 2.4.10.х! Промо
Уже более 100 компаний приобрели перенос и выполнили переход на УТ 11 / КА 2 / ERP 2 с помощью нашей разработки! Обработка перехода с УТ 10.3 на УТ 11 / КА 2 / ERP 2 позволяет перенести не только остатки на указанную дату (как типовой перенос), но и все возможные документы за выбранный период. При выходе новых релизов этих программ оперативно выпускаем обновление обработки. Предоставляем техническую поддержку. Можем сделать бесплатный тестовый перенос!
29700 руб.
Переводим рутину ручного тестирования 1C на рельсы Jenkins-а и ADD 142
1 стартмани
03.06.2019 11945 1 ripreal1 86
Онлайн-курс "Технология выполнения проектов ERP-класса – процессный подход". Третий поток. Курс проходит с 21 января по 18 марта 2020 года. Промо
Курс разработан Внедренческим центром «Раздолье». Курс предназначен для подготовки аналитиков, архитекторов и руководителей проектов автоматизации процессов управления с использованием комплексных ИТ-систем (1С:ERP, 1С:УХ, 1С:КА, 1С:УТ). В основе курса лежит методика применения процессного подхода.
9000 рублей
1C + Python + Django Rest Framework + Vue.js. Опыт несложной full-stack разработки 124
1 стартмани
22.04.2019 18671 18 riposte 63
Готовые переносы данных из различных конфигураций 1C Промо
Рекомендуем готовые решения для переноса данных из различных конфигураций 1C. C техподдержкой от разработчиков и гарантией от Инфостарт.
Расширение "Быстрая проверка кода" для конфигурации 1С:Автоматизированная проверка конфигураций 92
1 стартмани
26.03.2019 11089 42 Bazil 25
Перенос данных БП 2.0 => УТ 11 / КА 2 / ERP 2 (перенос остатков, документов и справочников из "1С:Бухгалтерия предприятия 8", ред. 2.0 в "1С:Управление торговлей 8", ред.11 / КА 2 / ERP 2). Обновлено до УТ 11.4.10.х, КА 2.4.10.х, ERP 2.4.10.х! Промо
Перенос позволяет загрузить в УТ 11 / КА 2 / ERP 2 документы за выбранный период, справочную информацию и остатки по счетам бух. учета. Переносятся остатки денежных средств, взаиморасчетов, остатки товаров и материалов на складах. Переносятся девятнадцать основных видов документов за выбранный период и вся нормативно-справочная информация. Есть фильтр по организации. Если нужно переносить что-то дополнительно, то обычно бесплатно дорабатываю правила (перед покупкой согласуйте необходимые доработки).
29700 руб.
Методика оптимизации программного кода 1С: проведение документов 85
1 стартмани
19.03.2019 15673 14 dmitrydemenew 83
Очный семинар по регулярному менеджменту Александра Фридмана "Вы или Хаос", 12 декабря 2019 г. , Санкт-Петербург Промо
Семинар по регулярному менеджменту от Александра Фридмана для собственников, первых лиц и топов. Технология управленческого планирования, комплексного управления временем и другими ресурсами, выполнением поручений, делами, информацией, контактами (встречи-звонки-почта).
от 11000 до 29000 рублей
Инструктор. Прототип инструмента создания быстрых пользовательских инструкций 71
1 стартмани
15.02.2019 7941 37 ROM_NN 8
Новый раздел на Инфостарте - Electronic Software Distribution Промо
Инфостарт напоминает: на нашем сайте можно купить не только ПО, связанное с 1С. В нашем арсенале – ESD-лицензии на ПО от ведущих вендоров: Microsoft, Kaspersky, ESET, Dr.Web, Аскон и другие.
- Низкие цены, без скрытых платежей и наценок
- Оперативная отгрузка
- Возможность оплаты с личного счета (кешбек, обмен стартмани на рубли и т.п.)
- Покупки идут в накопления для получения скидочных карт лояльности Silver (5%) и Gold (10%)
Конструктор мобильного клиента Simple WMS Client: способ создать полноценный ТСД без мобильной разработки. Теперь новая версия - Simple UI (обновлено 14.11.2019) 178
5 стартмани
09.01.2019 25146 229 informa1555 189
Базовый курс по разработке мобильных 1C-приложений для Android-устройств. Третий поток. Онлайн-интенсив с 11 февраля по 05 марта 2020 г. Промо
Данный онлайн-курс предусматривает изучение базовых принципов создания приложений для операционной системы Android, работающих на мобильной платформе “1С:Предприятие”. Курс предназначен для тех, кто уже имеет определенные навыки конфигурирования и программирования в системе “1С:Предприятие” при разработке прикладных решений для “обычных” компьютеров, но пока ещё не занимался разработкой 1С-приложений, предназначенных для работы на мобильных устройствах.
7500 рублей
Управление задачами в 1С - готовая подсистема с открытым кодом и широким базовым функционалом. Версия 1.0.6 97
2 стартмани
17.12.2018 11670 83 for_sale 38
Реализация простого http-сервиса "Просмотр карточки номенклатуры(товара) в браузере" 144
1 стартмани
07.12.2018 14910 10 dmitry1975 31
Новогодние скидки на авторское ПО Промо
В преддверии праздника в Маркетплейсе на Инфостарт действует скидка на все платные авторские программы. Размер скидок начинается от 10%. Советуем не откладывать покупки, многие наши партнеры повышают цены на свои продукты именно в начале нового года.
Go. Разбор лога технологического журнала. Достойная альтернатива perl'у 85
1 стартмани
24.10.2018 12137 4 lazarenko 39
Подборка решений для взаимодействия со ФГИС «Меркурий» Промо
С 1 июля 2019 года все компании, участвующие в обороте товаров животного происхождения, должны перейти на электронную ветеринарную сертификацию (ЭВС) через ФГИС «Меркурий». Инфостарт предлагает подборку программ, связанных с этим изменением.
Перенос документов и справочников ERP 2 / КА 2 / УТ 11 => БП 3.0 Промо
Перенос позволяет настроить собственный обмен данными между указанными программами, альтернативный предлагаемому фирмой 1С. Предоставляем техподдержку по всем вопросам данного обмена. Можем подключиться к вам удаленно для разбора ситуаций. Оперативно обновляем при выходе новых релизов 1С. Бесплатные обновления в течение полугода.
19700 руб.
1C:Предприятие для программистов: Запросы и отчеты. Второй поток. Онлайн-интенсив с 17 марта по 16 апреля 2020 г. Промо
Данный онлайн-курс предусматривает углубленное изучение языка запросов и возможностей системы компоновки данных, которые понадобятся при разработке отчетов, работающих на платформе “1С:Предприятие” в рамках различных прикладных решений. Курс предназначен для тех, кто уже имеет определенные навыки конфигурирования и программирования в системе “1С:Предприятие”, а также для опытных пользователей различных прикладных решений, которые используют в своей работе отчеты разного назначения.
6500 рублей
Позиционирование в помещении с помощью нейросети по сигналу Wi-Fi. Интерактивная карта склада в 1С с показом позиции 65
5 стартмани
09.08.2018 17465 23 informa1555 26