Индикаторы связи

Минимальная версия конфигурации Штрих-М: Кассир 5.1.6.10 или новее.

Назначение

Служит инструментом для отображения наличия связи с веб-сервисами или другими сервисами.

Возможности

Получение состояния соединения с веб-сервисами и наличие связи ККМ с ОФД;

Авторизация на веб-узле во время проверки соединения при помощи логина и пароля;

Индивидуально настраиваемые текст и цвет текста при показе результата проверки соединения;

Индивидуально настраиваемые периоды проверки соединения;

Отображение состояния соединения на форме регистрации, используя возможности адаптивного интерфейса;

Хранение результатов проверки в базе SQLite с указанием места ее хранения.

Ограничения

Работа индикаторов типа GET поддерживается только в версиях платформы 1С:Предприятие 8.3.5 или более новых;

Отображение состояния соединения на форме регистрации доступно только в адаптивном интерфейсе;

Соединение с веб-узлами, выполняющих переадресацию, всегда считается неустановленным.

Настройка

Для начала, нужно создать описание индикатора. По этому описанию будет выполняться проверка связи и добавляться элемент формы для отображения.
Последовательность создания индикатора:

Запустить Кассир 5, авторизоваться под пользователем с правом захода в настройки программы;

В настройках открыть вкладку ‘Дополнительные’, в правом нижнем углу окна найти кнопку ‘Настройка индикаторов связи’ и нажать на нее. Откроется форма настройки индикаторов связи.

Путь к базе данных индикаторов - путь, по которому будет читаться и сохраняться база SQLite с результатами проверки связи. (Перед заполнением описаний индикаторов рекомендуется выбрать путь к базе данных индикаторов. В противном случае, база будет читаться и сохраняться в каталоге /ExtFiles программы);

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

Описание табличной части

Колонка ‘Имя’ - имя индикатора в системе. Не должно иметь пробелов, должно обязательно начинаться с буквы или символа ‘_’;
Колонка ‘Тип’ - тип индикатора. Программа будет проверять связь с указанным адресом тем способом, который связан с выбранным типом индикатора;

Тип ‘GET-запрос’ (GET) - программа будет выполнять GET-запрос на указанный адрес для получения ответа от сервера.
Использует фоновое задание для проверки связи.
Доступен в версиях платформы 8.3.5 и более новых;

Тип ‘Связь с ОФД’ (OFD) - индикатор наличия связи с ОФД в ККМ
в поле «Адрес хоста» указывается номер ККМ;

Тип ‘Другой’ (ANOTHER) - для доработок, статус индикатора определяется модулем логики.

Колонка ‘Наименование’ - наименование индикатора для отображения надписи на форме регистрации;
Колонка ‘Адрес хоста’ - адрес веб-сервиса, с которым необходимо проверять связь;
Колонка ‘Период, сек’ - частота проверки связи в секундах.

Вкладка ‘Основные’

Текст “Ожидание” - текст индикатора, использующийся если проверки связи еще не было;
Текст “Соединение есть” - текст индикатора, использующийся если соединение было установлено;
Текст “Соединения нет” - текст индикатора, использующийся если соединение не было установлено;
Цвет “Ожидание” - цвет текста индикатора, использующийся если проверки связи еще не было;
Цвет “Соединение есть” - цвет текст индикатора, использующийся если соединение было установлено;
Цвет “Соединения нет” - цвет текст индикатора, использующийся если соединение не было установлено.

Вкладка ‘Дополнительные’

Логин - логин аккаунта для авторизации на веб-узле (необязательное);
Пароль - пароль аккаунта для авторизации на веб-узле (необязательное).

Добавления индикатора

Автоматическое заполнение

При нажатии кнопки ‘Заполнить автоматически’ добавятся индикаторы:

индикатор связи с УТМ (данные берутся из настроек ЕГАИС)

индикатор связи с HTTP-сервисом обмена (данные берутся из настроек обмена по http)

индикатора связи с сетью интернет

Ручное добавление

На командной панели над таблицей описаний нажать на крайнюю левую иконку с подсказкой ‘Добавить’. Появится пустая строка в таблице;

Заполнить поле ‘Имя’. Имя должно состоять из одного слова, начинаться с буквы или символа ‘_’;

Выбрать тип индикатора. Рекомендуемый тип - GET (для остальных необходимы специальные доработки);

Заполнить поле ‘Наименование’;

Заполнить поле ‘Адрес хоста’. Это должен быть либо IP-адрес, либо имя домена. Адрес может начинаться с http://;

Заполнить поле ‘Период. сек’. Если оставить поле пустым (установить значение 0), проверки связи с указанным адресом не будет.

После окончания заполнения описаний индикаторов, нажмите кнопку ‘Применить’ или ‘ОК’ для сохранения настроек.

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

По шаблону можно создать только один индикатор по одному и тому же описанию. Для того, что создать несколько индикаторов по одному описанию, нужно:

Создать новую пользовательскую надпись и открыть ее настройки;

В настройках пользовательской надписи установить флаг ‘Использовать как индикатор’;

В поле ‘Данные индикатора’ выбрать то описание индикатора, информацию о котором мы хотим отображать в выбранной пользовательской надписи.

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

Частые проблемы

Не отображается текущее состояние - У пользовательской надписи не указаны данные индикатора.
Отображается текст ‘Ошибка’ - Имя у описания индикатора, связанного с данной пользовательской надписи, было изменено.