Пользовательские инструкции

Настройка лицензирования

Для активации лицензий необходимо установить сервер лицензирования. Сделать можно двумя способами: 1) Через файлы поставки конфигурации (рис. 1). 2) В 1С в окне управления лицензированием (рис. 2). Важно! Адрес лицензирования который вы установите необходимо будет использовать в настройках лицензии

image-1669124482625.png

Рис. 1

image-1669124482631.png

Рис. 2

После этого создаем файл запроса лицензии (рисунки 3-9). Файл передаем сотрудникам отдела лицензирования(?) для формирования файла ответа. 

image-1669124482636.png

Рис. 3

image-1669124482643.png

Рис. 4

image-1669124482648.png

Рис. 5

image-1669124482654.png

Рис. 6

image-1669124482660.png

Рис. 7

image-1669124482667.png

Рис. 8

image-1669124482672.png

Рис. 9

Полученный файл ответа необходимо активировать через команду "Активировать ключ".

image-1669124482679.png

Рис. 10

Подключения

Подключения

Действующие подключения

Настройка области

Настройка области

Создание разделенных пользователей

Для этого необходимо войти в область и кликнуть по ссылке "Создать пользователя" в левой части Администрирования сервиса. Появится следующая форма:

image-1675071808068.png

На ней командой "Сформировать" можно заполнить имя пользователя произвольной комбинацией символов.

Команда "Случайный" формирует случайный пароль.

Для пользователя обязательно должно быть заполнено поле "Почта".  

Смысл настроек "Запрещено изменять пароль" и "Показывать в списке выбора" понятны из названия.

Установка настройки "Отправить пароль на почту" позволяет получить на указанный электронный адрес письмо следующего формата:

Создан новый пользователь:
Логин: ИмяПользователя
Пароль: Пароль
Ссылка: ссылка на вход в область

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

Настройка области

Заполнение данных по умолчанию

При создании области автоматически заполняются следующие данные:

1. Заполняется системная учетная запись почты для возможности отправки электронных сообщений.

2. Заполняется справочник ГруппыДоступа на основании предопределенных профилей доступа.

Настройка области

Создание неразделенных пользователей

Для этого необходимо не входя в область кликнуть по ссылке "Настроить доступ к областям" в левой части Администрирования сервиса. Откроется форма предоставления доступа к областям. Далее, следует кликнуть по команде "Создать пользователя". Появится следующая форма:

image-1675071946274.png

 

На ней командой "Сформировать" можно заполнить имя пользователя произвольной комбинацией символов.

Команда "Случайный" формирует случайный пароль.

Смысл настроек "Запрещено изменять пароль" и "Показывать в списке выбора" понятны из названия.

Настройка области

Настройка доступа к областям

Для установки разрешения/запрета доступа к областям для неразделенных пользователей служит форма "Доступ к областям", которую можно открыть, кликнув по ссылке "Настройка доступа к областям" в левой части Администрирования сервиса.

Откроется форма:

image-1675072718292.png

Команда "Создать пользователя" открывает форму создания неразделенного пользователя.(подробнее https://rzn-wb-02.1c-hosting.com/books/polzovatelskie-instruktsii/page/sozdanie-nerazdelennykh-polzovateley).

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

После этого нужно нажать выполнить одну из команд "Разрешить" или "Запретить". 

Настройка области

Настройка отправки команд устройствам регламентно

В настройках поведения сервиса добавлен раздел "Отправка команд устройствам".

Флаг "Используется регламентная отправка команд устройству" - если "Истина", то регламентная отправка команд устройству будет производится. 

Настроить расписание - настройка расписание регламентного задания отправки команд.

Настройка FTP для команд - это настройка подключения к ftp-серверу на который будет выгружаться скриншоты. 

На текущей момент регламентно выполняются следующий команды:

  1. Снятие скриншотов с устройств

Отправка команд будет происходить по всем устройствам с установленным флагом расширенного обслуживания.

image-1675879573315.png

 

image-1675879660434.png

Настройка области

Снятие активности клиента

Для снятие активности клиента необходимо в списке клиентов выполнить команду "Пометить к удалению" (рис. 1).

После выполненной команды у клиента будет:

image-1677509512298.png

Управление данными

Управление данными

Добавление устройств/зон в переходы из устройств/зон

Для добавления устройств/зон в переходы в упрощенном порядке в формах устройств/зон добавлена возможность добавлять переход непосредственно в самих элементах. 

Для этого на формы устройств и зон добавлена вкладка "Переходы", на этой вкладке есть команды "Добавить переход" и "Удалить переход". 

image-1677679865359.png

 

При добавлении переходы открывается форма добавление перехода, на которой необходимо внести информацию по переходу.

image-1677679899664.png

image-1677679993765.png

После добавления он также появится в списке переходов

image-1677680054692.png

 

По кнопке удалить происходит удаления элемента из перехода.

image-1677680121113.png

image-1677680134827.png

Сервисный режим

Сервисный режим

Процесс настройки сервисного режима коробки и сервиса

1. Настройки коробки и выгрузка объектов

2. Настройка сервиса и загрузка объектов

3. Настройка агента коробки

4. Выгрузка исторических метрик из коробки в сервис

Сервисный режим

Настройка сервисного режима в коробке

  1.  В настройках "Сервис интеграции" необходимо установить флаг "Используется сервисный режим".

image-1692774891154.png

После указания этого режима будет не доступно изменение структуры объектов.

image-1692775024515.png

2. После необходимо выгрузить объекты в файл для загрузки их в сервис

 

Сервисный режим

Настройка сервисного режима в сервисе

1. Необходимо создать область для будущей загрузки в нее коробки. После создания области необходимо удалить элемент справочника "Клиенты" из области.

image-1693395790815.png

image-1693395805918.png

В форме удаления помеченных объектов удалить объекты с типом "Клиенты"

image-1693395821866.png

2. В настройках "Сервис интеграции" необходимо установить флаг "Используется сервисный режим".

image-1692775169796.png

3. Необходимо загрузить файл с объектами выгруженных из коробки в сервис.

Сервисный режим

Выгрузка структуры объектов из коробки для загрузки в сервис

1. На форме настроек сервиса интеграции открыть форму по команде "Открыть форму загрузки выгрузки данных"

image-1692775315432.png

2. При открытии формы галки для выгрузки уже указаны для необходимых объектов (кроме метрик). 

Для выгрузки необходимо указать указанные настройки 

image-1692775789533.png

3. После этого по нажатию кнопки "Выгрузить данные" будет начат процесс выгрузки объектов и по окончанию выдано сообщение для сохранения файла выгрузки. Этот файл необходим для загрузки в сервис.

image-1692775866701.png

 

Сервисный режим

Загрузка структуры объектов в сервис

1. На форме настроек сервиса интеграции открыть форму по команде "Открыть форму загрузки выгрузки данных"

 

image-1692775315432.png

2. Перейти на вкладку "Загрузка", выбрать галки "Загружать данные в режиме обмена" и "Загрузка из коробочного решения в сервис" и указать путь до файла выгруженного из коробки и нажать кнопку "Загрузить данные". В результате загрузки будет загружена вся структура объектов.

image-1692776747568.png

 

Сервисный режим

Настройка коробочного агента для работы в режиме сервиса

Описание перемен агента описаны в документации

1. Указать значение переменной CFG_AGENT_SERVICE_MODE в значение "1"

2. Указать ссылку на сервис в переменную CFG_AGENT_SERVICE_MODE_URL_BASE (Значение ссылки равно той, что используется в случае когда агент находится у клиента но работает в нашем сервисе, в переменной CFG_COLLECTOR_SERVICE_BASE)

3. Указать ссылку на сервис в переменную CFG_AGENT_SERVICE_MODE_URL_DATA (Значение ссылки равно той, что используется в случае когда агент находится у клиента но работает в нашем сервисе, в переменной CFG_COLLECTOR_SERVICE_DATA)

4. Указать токен агента из области сервиса в переменную CFG_AGENT_SERVICE_MODE_TOKEN. Необходимо т.к. токены одного и того же агента в сервисе и в коробке отличаются (и должны отличаться). 

Сервисный режим

Выгрузка исторических метрик из коробки в сервис

1. В коробке на форме настроек сервиса интеграции открыть форму по команде "Открыть форму загрузки выгрузки данных"

2. По командам "Выгрузить данные метрик устройств" и "Выгрузить данные метрик переходов" будет выгружены файлы .csv формата. Сохраненные файлы необходимо отправить команде разработки для их загрузки напрямую в базу ClickHouse клиента.

image-1693560681780.png

ВАЖНО! Процесс точно не быстрый т.к. очень много данных, этап выгрузки и загрузки может достигать 24 часов.

Мониторинг отклонений

Описание обработки "Мониторинг отклонений"

Мониторинг отклонений

Состояние данных по всему проекту

В "Мониторинге отклонений" есть возможность перехода в отчет "Состояние данных по всему проекту". При открытии в дереве может быть выбрана любая сущность:

image-1702880335904.png

Форма отчета выглядит следующим образом:

image-1702880679978.png

Реквизиты "Дата" и "Период отображения" заполнятся данными из "Мониторинга отклонений". Остальные реквизиты будут заполнены данными по умолчанию: 

- Время проверки: "Рабочее время";

- Тип объекта: "Зона";

- Показатели: выбраны все позиции;

- Сортировка: "Наименование объекта";

- Порядок сортировки: "Возр".

Отчет позволяет получить сводную информацию в разрезе типов объектов (зоны, переходы, сенсоры) по всему проекту по выбранным показателям. Вид разреза задается реквизитом "Тип объекта". 

Перед формированием отчета есть возможность задать поле и порядок сортировки - за это отвечают реквизиты "Сортировка" и "Порядок сортировки". Список полей сортировки меняется в зависимости от выбранного типа объекта (доступна сортировка по полям К):

image-1702881212745.png

 Формирование отчета происходит по команде "Показать":

image-1702881446461.png

При формировании пользователю отображается таблица с данными:

image-1702881807183.png

Данные выбранных показателей выводятся в разрезе дат в соответствии с полями "Дата" и "Период отображения".

Поля показателей в таблица раскрашиваются также, как в "Мониторинге отклонений". Ссылка на описание цветов раскраски: https://docs.google.com/spreadsheets/d/1tXQ95OC1_4hg-r_DwmjLOAUtH0r7H4Mw/edit?pli=1#gid=194474640

После вывода таблицы на экран возможны следующие действия:

1. Быстрый фильтр по части строки (показываются строки, которые содержат введенный набор символов):

image-1702882172629.png

Применение поиска происходит по кнопке с изображением лупы, отмена поиска - команда с лупой и крестиком.

2. Получение данных по подчиненным сущностям: при двойном клике по строке с данными отчет будет сформирован в разрезе данных, которые входят в состав выбранного элемента (работает для зон и переходов.)

Пример:

Кликнули по выбранной строке:

image-1702882667582.png

 Результат:

image-1702882792506.png