Command/com — конфигурация для управления сервером 1С из браузера

Нас часто просят привести примеры работы с 1С посредством http-сервисов. Command/com является простой, готовой к использованию утилитой, которая позволяет выполнять заранее определенный набор действий на сервере 1С при нажатии кнопки в браузере. Состав кнопок и соответствующие им действия определяются в режиме предприятия, а формирование веб—интерфейса и обработка нажатия кнопок выполняются посредством http-сервиса 1С. Анализ кода Command/com поможет на простых примерах разобраться с работой http-сервисов, понять принцип формирования и обработки параметров GET-запросов.

 

Описание

Утилита выполнена в виде отдельной конфигурации, которая также может быть интегрирована с любой другой конфигурацией 1С путем сравнения и объединения. В этом случае с помощью Command/com возможно удаленное управление родительской конфигурацией. Например, нажатием кнопки можно завершить сеансы пользователей, выполнить регламентные процедуры, перезапустить оборудование, исполнить любой произвольный код на языке 1С или команду системы.

В качестве отдельной конфигурации Command/com может выполнять роль утилиты для управления сервером 1С. Наиболее часто используемые команды — остановка и запуск службы сервера 1С:Предприятия, перезагрузка сервера.

Command/com позволяет максимально упростить процесс выполнения произвольного набора действий с серверами и базами данных 1С:Предприятия.

Объекты конфигурации объединены в отдельную подсистему для удобства интеграции с другими конфигурациями:

Для работы конфигурации на сервере должен быть установлен веб—сервер IIS или Apache.

Конфигурация разработана на управляемых формах. Код конфигурации открыт.

 

Установка

Возможны два варианта работы Command/com — автономный (отдельная конфигурация) и интегрированный (объединение с родительской конфигурацией).

В автономном режиме Command/com устанавливается как обычная конфигурация. После установки необходимо опубликовать ее на веб сервере стандартными средствами платформы (Администрирование — Публикация на веб—сервере). Для доступа к http-сервису необходимо на закладке “Основные — HTTP-сервисы” установить флажок напротив сервиса “vcanCommand”:

 

После этого в режиме конфигуратора необходимо добавить пользователей и выдать им соответствующие права: “КэнКоммандАдминистратор” — для пользователей, которые смогут добавлять/изменять состав выполняемых команд, или “КэнКоммандПользователь” — для тех, кто сможет только выполнять команды из браузера. Также минимум одному из пользователей должны быть присвоены права “Администратор” для управления списком пользователей.

Стоит заметить, что в автономном режиме даже при наличии на компьютере сервера 1С и СУБД конфигурацию Command/com лучше использовать в файловом варианте. Поскольку информации в БД практически нет, а http-запросы выполняются относительно быстро, файловая база легко справляется со своими задачами и при этом сохраняет работоспособность даже при остановленной службе сервера 1С:Предприятия.

В интегрированном режиме Command/com встраивается в родительскую конфигурацию путем сравнения/объединения. После этого существующим пользователям выдаются права ролей “КэнКоммандАдминистратор” или “КэнКоммандПользователь” в зависимости от уровня доступа.

 

Работа с конфигурацией

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

Настройка пользователей

Для администрирования пользователей, которым предоставляется доступ к командам, существует одноименный справочник с единственным реквизитом “Имя пользователя информационной базы”. Имя пользователя в этом реквизите должно совпадать с именем пользователя в конфигураторе:

 

Непосредственно в форме элемента справочника также можно флажками выделить команды или группы команд, к которым данному пользователю разрешен доступ:

 

Создание и настройка команд

Справочник команд — иерархический, что позволяет управлять доступом сразу к целой группе команд.

Каждая команда — это элемент справочника, в котором указываются:

• Наименование — произвольная строка
• Идентификатор — уникальная строка, состоящая из латинских букв и цифр
• Тип действия — перечисление со значениями “Код 1С”, “Команда системы” и “Скрипт”
• Выполняемое действие и Путь к скрипту — строки, в которых указывается либо выполняемый по команде код 1С, команда системы или путь к скрипту *.bat.
• Порядок — число, определяющее положение команды на веб—странице: чем меньше число, тем выше располагается кнопка команды.
• Активна — булево, если равно “Истина”, то команда будет отображаться на веб—странице.

Назначение практически всех реквизитов понятно. Подробнее можно остановиться на реквизите “Тип действия”. Именно он определяет, какое действие будет выполнено при нажатии пользователем соответствующей кнопки в браузере.

При значении “Код 1С” становится активным поле “Выполняемое действие”, в котором необходимо указать код на языке 1С:Предприятие. Например, можно выполнить процедуру общего модуля. Или сразу несколько команд, как это сделано в тестовой команде “Создать файл на сервере”:

 

При значении “Команда системы” в поле “Выполняемое действие” указывается соответствующая строка. Например, для остановки службы сервера 1С:Предприятия выполняется следующая команда:

При значении “Скрипт” в поле “Путь к скрипту” указывается расположение запускаемого скрипта:

 

Группы пользователей.

Этот справочник облегчает администрирование доступа пользователей к командам при их большом количестве. Например, в прилагаемой к статье тестовой конфигурации помимо управления сервером 1С настроены также тестовые команды и команды для управления шаговым двигателем робота на базе микроконтроллера Arduino через com-порт. Логично разбить эти команды на соответствующие группы:

Теперь можно создать две группы доступа к командам — “Ардуино” и “Сервер” и на их формах выделить флажками группы команд, к которым разрешен доступ данной группы доступа:

В этом же справочнике указываются пользователи, входящие в группу доступа:

Выполнение команд.

Для доступа к веб—интерфейсу пользователю необходимо в адресной строке браузера указать путь к http-сервису конфигурации в формате http://server/base/hs/v-can.command/com где server — имя или IP-адрес сервера с базой Command/com, base — имя, под которым Command/com опубликована на веб—сервере.

После запуска появится окно авторизации, где пользователь должен ввести свои логин и пароль, указанные в конфигураторе:

При успешной авторизации пользователь увидит дерево команд, к которым ему разрешен доступ:

 

Примеры использования

Изначально конфигурация разрабатывалась для управления сервером: остановки и запуска службы агента сервера 1С:Предприятия, перезагрузки сервера. Для этого используются команды с типом действия “Команда системы” и следующими выполняемыми действиями:

net stop "1C:Enterprise 8.3 Server Agent"

net start "1C:Enterprise 8.3 Server Agent"

shutdown /r /t 000

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

Следующий по популярности функционал — перезагрузка компьютеров в локальной сети. Выполняется так же, как и перезагрузка сервера, но с указанием имени компьютера в выполняемой команде:

shutdown -r -f -t 0 -m \имя—или—айпи—адрес—компьютера

В этом случае для каждого компьютера создается отдельная кнопка. Но при небольшой доработке можно обойтись одной кнопкой и добавить в веб—интерфейс текстовое поле для ввода имени или IP-адреса компьютера.

Также иногда очень помогает возможность запустить выключенный компьютер. Для этого в BIOSе компьютера необходимо разрешить возможность запуска по сети (Wake-on-LAN), а на сервер 1С установить соответствующую программу, например одноименную “Wake On Lan”. После этого в Command/com добавляется команда с типом действия “Команда системы” или “Скрипт”, которая из командной строки запускает “Wake On Lan” с MAC-адресом включаемого компьютера в параметрах.

Недавно один из наших клиентов осознал, что Command/com — удобный инструмент для формирования отчетов без входа в 1С. Для этого создается команда с типом действия “Код 1С”, которая выполняет некий набор отчетов, сохраняет их в формате xls и отправляет пользователю на электронную почту. Удобно для руководителей во время командировок.

Описанный абзацем выше функционал можно использовать и для работы клиентов компании. Путем выполнения команд пользователи могут на электронную почту получать свежие прайсы с учетом индивидуальных скидок, таблицы с актуальными остатками товаров.

Веб—интерфейс Command/com может стать простейшей системой сбора заявок. Например, IT-служба одного из наших заказчиков таким образом собирает типовые заявки от сотрудников. Для этого используется страница с кнопками “Не работает компьютер”, “Заправить картридж”, “Принтер не печатает” и т.д. По идентификатору нажатой кнопки формируется тема новой заявки, а привязка заявки к сотруднику—заявителю происходит через параметр сеанса “ТекущийПользователь”. Заявку можно подать даже со смартфона, что особенно удобно для создания обращений с темой “Не работает компьютер”.

Ну а самыми экзотическими случаями использования Command/com стали моменты, когда нам было необходимо по—быстрому привязать к компьютеру оборудование под управлением микроконтроллеров Arduino и управлять им через интернет. Command/com идеально справляется с подобными задачами на этапе прототипирования новых электронных устройств. Например, на видео ниже показан веб—интерфейс для управления самодельным роботом через WiFi. На разработку интерфейса было потрачено около 15 минут. В течение следующего часа опытным путем были подобраны оптимальные параметры команд, передаваемых роботу, после чего уже был создан полноценный пульт управления.

 

Заключение

Мы работаем с конфигурацией Command/com более 5 лет. За это время она зарекомендовала себя как простой, удобный и надежный интерфейс для удаленного управления серверами и БД 1С. Если будет интерес сообщества, возможно дальнейшее развитие функционала конфигурации. Оставляйте ваши пожелания в комментариях.

Спасибо за внимание!