Штрих-М: Документация

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======Штрих Помощник======
Функциональность в Кассир 5:\\
  - Подтверждение отсутствующих прав пользователя запросом разрешения выполнения операции у администратора с настройкой набора прав и отправляемых данных
  - Отправка текстовых оповещений администратору
  - Сбор и отправка показателей кассы администратору: текущего пользователя, время работы, кол-во и сумму чеков продажи, кол-во и сумму чеков возврата, наличных в ящике, выручку (для 1С 8.3.5+)
  
\\
Данный модуль взаимодействует с веб-сервисом, в котором выполняется настройка для работы с телеграм-ботом.\\
Подробная инструкция по установке и настройке веб-сервиса доступна по {{ :кассир5:внешниемодули:shtrih_helper_service_documentation_1_0_3.pdf |ссылке}}.\\

=====Настройка=====
====Перед началом работы====

Для взаимодействия с телеграм-ботом необходимо установить и настроить веб-сервис, который будет выполнять взаимодействие с телеграм-ботом.\\
После того, как телеграм-бот создан и веб-сервис установлен и настроен, необходимо подключить и настроить модуль логики shtrih_helper.\\
\\
Для возможности работы с Штрих Помощник требуется разархивировать обработку в каталоге "БД Кассир5\ExtFiles\LogicalModules\shtrih_helper.zip".\\
Это можно сделать вручную или выбрать модуль при установке/обновлении конфигурации Кассир 5 или выбрать через Мастер настройки.\\

====Основные====
Настройки работы с сервисом выполняются в настройках Кассир 5, на закладке "Модули логики"-"Штрих Помощник".\\
"Отключить модуль" - флаг нужно снять для включения работы с сервисом.\\
"Логировать работу модуля" - опция, позволяющая включить запись актуальной информации запросов в веб-сервис в виде текстовых файлов.\\
"Путь к каталогу логов" - путь к папке хранения текстовых файлов с данными запросов. Файлы хранятся в разрезе дней. По умолчанию БД Кассир5\ExtFiles\LogicalModules\shtrih_helper\\\
"Загрузить предустановки" - кнопка, загружающая нужные модулю данные в справочники и регистры.

===Группа "Параметры сервиса"===
**Адрес сервера** - веб-адрес сервиса.\\
**Таймаут запросов, с** - время в секундах, в течение которого будет ожидаться ответ от веб-сервиса. По умолчанию 15.\\
**Идентификационный ключ** - уникальный GUID для получения доступа к API сервиса. Выдается при регистрации кассы в сервисе.\\
**Идентификационный номер** - неуникальный GUID для доступа к API сервиса. Создается кассой один раз при начале работы с сервисом.\\
**Интервал проверки статуса запроса** - время в секундах, раз в которое будет проверяться статус последнего запроса в веб-сервисе. По умолчанию 1.\\
**Разрешить отменять запросы при отсутствии связи** - опция, позволяющая отменить ожидание ответа администратора на запрос, если не удается установить связь с веб-сервисом.\\
**Получать запросы состояния кассы и отвечать на них Помощнику (1С 8.3.5+)** - опция, позволяющая запрашивать актуальные запросы состояния кассы из веб-сервиса, и отправлять в ответ необходимые данные.\\
**Интервал получения запросов состояния и ответов на них** - время в секундах, раз в которое будет начинаться фоновое задание на получение запросов состояния кассы, а если такие запросы уже были получены - фоновое задание на отправку необходимых данных. По умолчанию 5.\\

===Группа "Работа с правами"===
**Подтверждать права через сервис** - опция, позволяющая при отсутствии права у пользователя запросить разрешение на проведение операции у администратора. Заменяет чтение карты администратора.\\
**Подтверждать все права** - опция, позволяющая запрашивать разрешение на проведение операции у администратора даже при условии, если подтверждаемое право отсутствует в составе подтверждаемых прав.\\
**Настроить состав подтверждаемых прав** - кнопка, открывающая форму настройки списка подтверждаемых прав.\\

===Настройка состава подтверждаемых прав===
**Подтверждаемые права** - таблица, строки которых являются подтверждаемыми в сервисе правами. Право - имя права в справочнике "Права пользователей". Наименование права - наименование, которое отобразится администратору в телеграме при получении им запроса на подтверждение.\\
**Отправляемые поля** - таблица, строки которых являются данными, отправляемыми в запросе подтверждения права. Каждое право имеет свой набор отправляемых полей. Значение поля - отправляемое значение параметра чека. Наименование поля - отправляемое наименование параметра чека.\\

=====Для программистов=====
====Транзакции операций====
При запросе подтверждения права записывается транзакция с типом 220\\
[[:таблицатранзакцийкассира|Описание формата транзакций Кассир 5]]