odg_assist_5.0:администрирование_odg
Различия
Показаны различия между двумя версиями страницы.
| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия | ||
| odg_assist_5.0:администрирование_odg [2026/10/05 13:04] – [Функциональные характеристики ПО “OdgAssist”] denis | odg_assist_5.0:администрирование_odg [2026/10/19 18:51] (текущий) – [Настройка приложения] denis | ||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ====== Настройка приложения ====== | ||
| + | |||
| + | Перейдите по ссылке: | ||
| + | |||
| + | <code -> | ||
| + | http:// | ||
| + | </ | ||
| + | |||
| + | Отобразится форма авторизации: | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Войдите в систему под учётной записью администратора. Данные для первого входа передаёт ООО «Оптимальное Движение»; | ||
| + | |||
| + | Для работы приложения требуется добавить лицензионный ключ. \\ Нажмите пункт меню " | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Щелкните дважды по записи и введите лицензионный ключ, полученный от ООО «Оптимальное Движение». | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Добавить ключ, кол-во конкурентных пользователей: | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Ключ количества конкурентных пользователей (свойство ru.user_count) также предоставляет ООО «Оптимальное Движение». | ||
| + | |||
| + | После добавления ключа необходимо перезапустить приложение через терминал сервера: | ||
| + | |||
| + | Ознакомится с интерфейсом приложения можно перейдя по ссылке: | ||
| + | |||
| + | |||
| + | |||
| + | === Настройка после установки === | ||
| + | |||
| + | |||
| + | |||
| + | После установки проверить время сохраняемых и изменяемых сущностей. Например добавить папку и проверить время ее создания или изменения. | ||
| + | |||
| + | ==== Назначенные задания ==== | ||
| + | |||
| + | Пункт меню " | ||
| + | |||
| + | // | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | Нажмите пункт меню " | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Пример содержимого письма: | ||
| + | |||
| + | // | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Пример содержимого письма: | ||
| + | |||
| + | {{: | ||
| + | |||
| + | **Отправка оповещений по действиям** | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | * крайний срок выполнения сегодня | ||
| + | * крайний срок выполнения наступит через '' | ||
| + | * просроченные действия | ||
| + | |||
| + | '' | ||
| + | |||
| + | {{: | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | {{: | ||
| + | |||
| + | **Описание полей формы настройки " | ||
| + | |||
| + | * Defined by - каким программным объектом реализуется задание. Возможные значения: | ||
| + | * Bean - задание реализуется методом бина Spring. Дополнительные атрибуты: | ||
| + | * Bean name - имя бина. Бин отображается в списке и доступен для выбора, | ||
| + | * Method name - метод интерфейса бина для выполнения. Метод должен либо не иметь параметров, | ||
| + | * Method parameters - параметры выбранного метода. Поддерживаются только параметры типа String. | ||
| + | * Class - задание представляет собой класс, реализующий интерфейс java.util.concurrent.Callable. Класс должен иметь открытый конструктор без параметров. Дополнительные атрибуты: | ||
| + | * Class name - имя класса | ||
| + | * Script - задание представляет собой скрипт Groovy. Скрипт выполняется через Scripting.runGroovyScript(). Дополнительные атрибуты: | ||
| + | * Script name - имя скрипта. | ||
| + | * User name - имя пользователя, | ||
| + | * Singleton - признак, | ||
| + | * Scheduling type - способ планирования задачи: | ||
| + | * Cron - с помощью Cron-выражения, | ||
| + | * секунда, | ||
| + | |||
| + | <code -> | ||
| + | 0 0 * * * * - начало каждого часа каждого дня. | ||
| + | */10 * * * * * - каждые 10 секунд. | ||
| + | 0 0 8-10 * * * - в 8, 9 и 10 часов каждого дня. | ||
| + | 0 0/30 8-10 * * * - 8:00, 8:30, 9:00, 9:30 и 10 часов каждого дня. | ||
| + | 0 0 9-17 * * MON-FRI - каждый час с 9 до 17 по рабочим дням. | ||
| + | 0 0 0 7 1 ? - каждое Рождество в полночь. | ||
| + | </ | ||
| + | |||
| + | * Period - с помощью интервала между выполнениями. | ||
| + | * Fixed Delay - задача будет запускаться с указанной в Period задержкой после окончания предыдущего выполнения. | ||
| + | * Period - период или задержка запуска задания в секундах если Scheduling type установлен в Period или Fixed Delay. | ||
| + | * Start date - дата/ | ||
| + | |||
| + | Start date имеет смысл указывать только для " | ||
| + | |||
| + | * Timeout - время в секундах, | ||
| + | |||
| + | Для Singleton-задач в кластерном деплойменте рекомендуется всегда устанавливать таймаут в реалистичное значение. Если останавливается узел кластера, | ||
| + | |||
| + | * Time frame - в случае заданного Start date или Cron expression определяет временное окно в секундах, | ||
| + | |||
| + | Если Start date не указано, | ||
| + | |||
| + | * Start delay - задержка выполнения в секундах после запуска сервера и активации выполнения задач. Используйте данный параметр для тяжелых задач, если вы считаете что они тормозят запуск сервера. | ||
| + | * Permitted servers - список перечисленных через запятую идентификаторов серверов, | ||
| + | |||
| + | Для синглтон-заданий порядок перечисления серверов указывает их приоритет - первый имеет больший приоритет чем последний. Сервер с большим приоритетом перехватит выполнение синглтона следующим образом: | ||
| + | |||
| + | * Log start - признак регистрации факта запуска задания в таблице SYS_SCHEDULED_EXECUTION, | ||
| + | |||
| + | Если задание является синглтоном, | ||
| + | |||
| + | * Log finish - признак регистрации факта завершения задания в таблице SYS_SCHEDULED_EXECUTION, | ||
| + | |||
| + | Если задание является синглтоном, | ||
| + | |||
| + | * Description - произвольное текстовое описание задания. | ||
| + | |||
| + | Задание также имеет признак активности, | ||
| + | |||
| + | |||
| + | |||
| + | ===== Добавление ролей ===== | ||
| + | |||
| + | |||
| + | В приложении доступны два типа ролей: \\ 1. **Системные роли** | ||
| + | |||
| + | * Создаются автоматически при инициализации системы (например, | ||
| + | |||
| + | 2. **Настраиваемые роли** | ||
| + | |||
| + | * Создаются администратором вручную. | ||
| + | * Позволяют гибко настраивать права доступа для пользователей. | ||
| + | * Включают // | ||
| + | |||
| + | == Структура настройки роли == | ||
| + | |||
| + | При открытии роли в интерфейсе отображаются 5 вкладок: | ||
| + | |||
| + | 1. **Экраны** (Screens) \\ Управляет доступом к: | ||
| + | |||
| + | * Экранам приложения (например, | ||
| + | * Пунктам основного меню. | ||
| + | * Дочерним экранам, | ||
| + | |||
| + | 2. **Сущности** (Entities) \\ Определяет разрешения на операции с объектами системы (документы, | ||
| + | |||
| + | * Создание (Create) | ||
| + | * Чтение (Read) | ||
| + | * Изменение (Update) | ||
| + | * Удаление (Delete) | ||
| + | |||
| + | Не рекомендуется давать права на удаление (Delete) без необходимости, | ||
| + | |||
| + | 3.** Атрибуты** (Entity Attributes) \\ Управляет доступом к полям сущностей (например, | ||
| + | |||
| + | * Просмотр (Read) — разрешает просмотр поля. | ||
| + | * Изменение (Modify) — разрешает редактирование. | ||
| + | |||
| + | 4. **Специальные права** (Specific Permissions) \\ Настройка дополнительных разрешений, | ||
| + | |||
| + | * Доступ к REST API. | ||
| + | * Администрирование системных настроек. | ||
| + | * Запуск произвольных SQL-запросов. | ||
| + | |||
| + | 5 **Интерфейс** \\ Разрешения на этом экране позволяют ограничивать доступ к любому компоненту экрана, | ||
| + | |||
| + | === Редактирование существующих ролей === | ||
| + | |||
| + | Для упрощения редактирования ролей доступны фильтры, | ||
| + | |||
| + | * На вкладке «Экран» установите отметку «Отобразить разрешенные». После фильтрации будут отображены экраны, | ||
| + | * На вкладке «Сущности» установите отметку «Только назначенные», | ||
| + | * На вкладке «Атрибуты» установите отметку «Только назначенные», | ||
| + | |||
| + | После фильтрации выберите необходимое и произведите настройку. | ||
| + | |||
| + | === Добавление ролей === | ||
| + | |||
| + | Для добавления роли нажмите пункт меню «Администрирование», | ||
| + | |||
| + | Или можете создать роль с " | ||
| + | |||
| + | * Введите название роли. | ||
| + | * Добавьте локальное наименование роли | ||
| + | * Укажите назначение роли в поле " | ||
| + | |||
| + | == Вкладка " | ||
| + | |||
| + | Далее перейдите к настройке экранов на вкладке " | ||
| + | |||
| + | Вкладка содержит два корневых раздела: | ||
| + | |||
| + | * Главное меню - раздел позволяет открыть доступ к пунктам меню. Доступ только на чтение. Содержит список экранов типа " | ||
| + | * Все экраны - раздел позволяет расширить доступ к экранам для редактирования. Доступ на редактирование. Содержит список экранов типа " | ||
| + | |||
| + | Настройте непосредственно доступ к пунктам меню. \\ | ||
| + | |||
| + | * Разверните раздел " | ||
| + | * Выберите пункт меню и установите отметку " | ||
| + | |||
| + | Обратите внимание, | ||
| + | |||
| + | Если требуется редактирование для открытого ранее пункта меню, то введите название экрана в фильтр " | ||
| + | |||
| + | == Вкладка " | ||
| + | |||
| + | Настройка разрешений для сущностей.\\ | ||
| + | |||
| + | * На вкладке выберите сущность из списка. | ||
| + | * В поле " | ||
| + | * Создание (Create) | ||
| + | * Чтение (Read) | ||
| + | * Изменение (Update) | ||
| + | * Удаление (Delete) | ||
| + | * Сохраните изменение кнопкой " | ||
| + | |||
| + | == Вкладка " | ||
| + | |||
| + | Настройка атрибутов сущности: | ||
| + | |||
| + | * На вкладке " | ||
| + | * В поле " | ||
| + | * Просмотр (Read) — разрешает просмотр поля. | ||
| + | * Изменение (Modify) — разрешает редактирование. | ||
| + | * Сохраните изменение кнопкой " | ||
| + | |||
| + | Для вступления изменений в силу, пользователю, | ||
| + | |||
| + | === Описание системных ролей === | ||
| + | |||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экран: Помощь: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * R: " | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * RU: «Версия документа», | ||
| + | * CRU: «Информация о печатях». Позволяет обрабатывать запросы на перепечать документов. (подтверждать свои запросы нельзя) | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * CRU: «Файл», | ||
| + | * R: «Группа документов». | ||
| + | * RU: «Версия документа». | ||
| + | * U: «Проверка тестов» | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * CRUD: «Отдел», | ||
| + | * CRU: «Файл», | ||
| + | * RU: «Resume document development». | ||
| + | * R: «Пользователь» | ||
| + | * '' | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * WebDAV documents role – | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * R: «Отчёт», | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * CRUD: « Папка поиска», | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * CRUD: «Фильтр» | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * R: «Файл» | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * R: Файл | ||
| + | * '' | ||
| + | * Экран: Администрирование: | ||
| + | * Сущность: | ||
| + | * CRUD: «Файл» | ||
| + | * '' | ||
| + | * Экран: Администрирование: | ||
| + | * Сущность» | ||
| + | * R: «odgassist5_OdgAssistUser» | ||
| + | * '' | ||
| + | * Экран: Администрирование: | ||
| + | * Сущность: | ||
| + | * R: «Сообщение» | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * R: «Категория», | ||
| + | * '' | ||
| + | * Экран: Администрирование: | ||
| + | * Сущности: | ||
| + | * CRUD: « Категория», | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * CRU: « Файл», «Связка изменения действия», | ||
| + | * '' | ||
| + | * Экраны: | ||
| + | * Сущности: | ||
| + | * '' | ||
| + | |||
| + | === Описание и доступы роли " | ||
| + | |||
| + | Эта роль даёт **особые возможности**, | ||
| + | |||
| + | ===== 1. Реестр «Информация о печатях» — кнопка «Отметить» ===== | ||
| + | |||
| + | **Где:** раздел «Информация о печатях» | ||
| + | |||
| + | **Без роли:** кнопка **«Отметить»** полностью скрыта. Пользователь видит только таблицу в режиме просмотра. | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | * **Отметить утерянным** — меняет статус записи на Утерян | ||
| + | * **Отметить возвращённым** — меняет статус на Полностью возвращено | ||
| + | * **Отметить распечатанным** — меняет статус на Распечатано(активна только если у записи заполнена дата печати и статус Утерян или Полностью возвращено) | ||
| + | |||
| + | При попытке нажать эти кнопки без роли (если кнопка всё же доступна через другой путь) — система показывает уведомление: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 2. Реестр «Задания на разработку» — фильтр и видимость всех заданий ===== | ||
| + | |||
| + | **Где:** раздел «Задания на разработку документов» | ||
| + | |||
| + | **Без роли:** Пользователь без такой роли в реестре видит только те задания на разработку, | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 3. Реестр «Задания на разработку» — кнопка «Отменить разработку документа» ===== | ||
| + | |||
| + | **Где:** та же таблица заданий на разработку, | ||
| + | |||
| + | **Без роли:** кнопка **«Отменить разработку документа»** скрыта. | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 4. Редактор задания — файл разработки на финальном этапе ===== | ||
| + | |||
| + | **Где:** редактор задания на разработку, | ||
| + | |||
| + | **Без роли:** поле загрузки разработанного файла (WebDAV) недоступно — пользователь видит файл только в режиме просмотра. | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 5. Редактор задания — кнопка «Возобновить разработку» ===== | ||
| + | |||
| + | **Где:** редактор задания в статусе '' | ||
| + | |||
| + | **Без роли:** кнопка внизу редактора называется **«Сохранить»** и просто сохраняет данные без каких-либо действий с процессом. | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 6. Редактор версии документа — поле файла ===== | ||
| + | |||
| + | **Где:** редактор версии документа | ||
| + | |||
| + | **Без роли:** поле загрузки файла документа **скрыто**, | ||
| + | |||
| + | **С ролью: | ||
| + | |||
| + | |||
| + | ===== Добавление пользователя ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Добавление пользователей осуществляется через пункт меню //" | ||
| + | |||
| + | В реестре пользователей нажмите //" | ||
| + | |||
| + | //" | ||
| + | |||
| + | //" | ||
| + | |||
| + | Для корректной работы приложения поле " | ||
| + | |||
| + | В случае использования доменной авторизации по средством AD убедиться, | ||
| + | |||
| + | //" | ||
| + | |||
| + | !В карточке пользователя есть два разных реквизита, | ||
| + | |||
| + | - **Поле «Должность»** — текстовое поле, одно значение; | ||
| + | - **Таблица «Должности»** — справочный список, | ||
| + | |||
| + | При формировании итоговой таблицы на последнем листе документа (колонка «Должность» рядом с ФИО, действием, | ||
| + | |||
| + | Если поле «Должность» у пользователя не заполнено, | ||
| + | |||
| + | **Как работают остальные процессы системы** | ||
| + | |||
| + | Остальные функциональные блоки — назначение и распределение обучения и ознакомлений, | ||
| + | |||
| + | Таким образом, | ||
| + | |||
| + | //" | ||
| + | |||
| + | //" | ||
| + | |||
| + | <color white> -- </ | ||
| + | |||
| + | |||
| + | ===== Подразделения и должности ===== | ||
| + | |||
| + | Подразделение и должность пользователя влияют на работу системы: | ||
| + | |||
| + | * распределение документов по подразделениям и должностям; | ||
| + | * назначение программ обучения (программы обучения привязываются к должности); | ||
| + | * определение руководителя подразделения; | ||
| + | * рассылку уведомлений об ознакомлениях. | ||
| + | |||
| + | Поэтому справочники «Подразделения» и «Должности» должны быть заполнены **до** создания пользователей. | ||
| + | |||
| + | ==== Справочник «Подразделения» ==== | ||
| + | |||
| + | Расположение: | ||
| + | |||
| + | Для создания подразделения нажмите кнопку **«Создать»** и заполните поля: | ||
| + | |||
| + | ^ Поле ^ Описание ^ | ||
| + | | Название | Наименование подразделения. Обязательное поле | | ||
| + | | Входит в подразделение | Вышестоящее подразделение. Позволяет выстроить иерархию. Для подразделения верхнего уровня поле оставляется пустым | | ||
| + | | Руководитель подразделения | Пользователь, | ||
| + | | Сотрудники подразделения | Список сотрудников. Заполняется автоматически при указании подразделения в карточке пользователя | | ||
| + | | Получать уведомления об ознакомлениях | Если отметка установлена, | ||
| + | |||
| + | Сохраните изменения кнопкой **«ОК»**. | ||
| + | |||
| + | Для изменения существующего подразделения выделите его в списке и нажмите **«Изменить»**. | ||
| + | |||
| + | <note important> | ||
| + | |||
| + | Не удаляйте подразделения, | ||
| + | |||
| + | </ | ||
| + | |||
| + | ==== Справочник «Должности» ==== | ||
| + | |||
| + | Расположение: | ||
| + | |||
| + | Для создания должности нажмите кнопку **«Создать»** и заполните поля: | ||
| + | |||
| + | ^ Вкладка ^ Описание ^ | ||
| + | | Главная (поле Название) | Наименование должности. Обязательное поле | | ||
| + | | Сотрудники (добавление сорудников происходит через кнопку Добавить) | Список сотрудников с данной должностью. Заполняется автоматически из карточек пользователей | | ||
| + | |||
| + | Сохраните изменения кнопкой **«ОК»**. | ||
| + | |||
| + | ===== Добавление пользователю подразделения и должности ===== | ||
| + | |||
| + | ==== Порядок действий ==== | ||
| + | |||
| + | - Откройте пункт меню **«Администрирование»** → **«Пользователи»**. | ||
| + | - Найдите нужного пользователя в списке. Для поиска воспользуйтесь фильтром. | ||
| + | - Выделите пользователя и нажмите кнопку **«Изменить»**. | ||
| + | - В поле **«Подразделение»** нажмите кнопку выбора и укажите подразделение из справочника. | ||
| + | - В таблице **«Должности»** нажмите кнопку **«Добавить»**, | ||
| + | - Нажмите кнопку **«ОК»** для сохранения карточки. | ||
| + | |||
| + | < | ||
| + | |||
| + | Подразделение у пользователя может быть только одно, а должностей — несколько. Если сотрудник совмещает должности, | ||
| + | |||
| + | </ | ||
| + | |||
| + | ==== Изменение и исключение должности ==== | ||
| + | |||
| + | Чтобы убрать должность у пользователя, | ||
| + | |||
| + | <note important> | ||
| + | |||
| + | Кнопка | ||
| + | |||
| + | **«Исключить»** убирает должность только у данного пользователя — сама должность в справочнике сохраняется. Не используйте для этой цели удаление записи из справочника «Должности». | ||
| + | |||
| + | </ | ||
| + | |||
| + | Чтобы сменить должность, | ||
| + | |||
| + | |||
| + | ===== Электронная простая подпись ===== | ||
| + | |||
| + | При разработке документа формируется лист с участниками разработки документа у каждого участника проставляется электронная подпись. | ||
| + | |||
| + | Подпись - это ID пользователя. Формируется автоматически. | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Посмотреть ID можно в модуле Администрирование, | ||
| + | |||
| + | Выбрать Пользователя и нажать правую кнопку мыши. Выбрать Системная информация | ||
| + | |||
| + | {{: | ||
| + | |||
| + | В окне Системная информация найти параметр ID | ||
| + | |||
| + | {{: | ||
| + | |||
| + | === Замещение пользователей === | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Администратор системы может дать возможность пользователю замещать другого пользователя. При этом у замещающего пользователя сессия не меняется, | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Если пользователь имеет замещаемых | ||
| + | |||
| + | Окно настройки " | ||
| + | |||
| + | //" | ||
| + | |||
| + | //" | ||
| + | |||
| + | //" | ||
| + | |||
| + | <color white> -- </ | ||
| + | |||
| + | ==== Назначенные задания ==== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Пункт меню " | ||
| + | |||
| + | === Отправка оповещений о новых задачах. === | ||
| + | |||
| + | ---- | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | Нажмите пункт меню " | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Пример содержимого письма: | ||
| + | |||
| + | === Отправка оповещений назначенным по задачам === | ||
| + | |||
| + | ---- | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | Пример содержимого письма: | ||
| + | |||
| + | {{: | ||
| + | |||
| + | * **Всего задач** – все активные задачи из бизнес-процессов, | ||
| + | * **Близкие к крайнему сроку** – отбираются задачи, | ||
| + | * крайний срок ('' | ||
| + | * и крайний срок **≤ сегодня + N дней** (N = '' | ||
| + | * **Просроченные** – задачи, | ||
| + | * **Всего действий** – берутся все отчёты о выполнении действий (не Действия!), | ||
| + | * статус «В работе», | ||
| + | * текущий пользователь – ответственный в действии (Action). | ||
| + | * **Близкие к крайнему сроку** – отбираются из " | ||
| + | * крайний срок у действия (Action) **не раньше сегодня** (то есть будущий или сегодняшний), | ||
| + | * и **сегодня > крайний срок** у действия (Action) **− N** (то есть дедлайн наступит раньше, | ||
| + | * **Просроченные** – отбираются из " | ||
| + | * крайний срок у действия (Action) не задан ('' | ||
| + | * крайний срок у действия (Action) уже прошёл (строго раньше сегодня). | ||
| + | |||
| + | Как настроить крайний срок задачи (TaskData): | ||
| + | |||
| + | - В диаграмме процесса (BProc - Process Definition) нажать на пользовательскую задачу | ||
| + | - В поле "Due date" справа указать значение | ||
| + | |||
| + | Крайний срок будет рассчитываться как дата и время создания этой задачи (когда она назначается пользователю) + значение, | ||
| + | |||
| + | Доступные значения для поля "Due date": | ||
| + | |||
| + | - **'' | ||
| + | - **'' | ||
| + | - **'' | ||
| + | - **'' | ||
| + | - **'' | ||
| + | - **'' | ||
| + | |||
| + | Каждый символ имеет строгое значение: | ||
| + | |||
| + | * **'' | ||
| + | * **'' | ||
| + | |||
| + | Остальные буквы обозначают конкретные единицы времени и ставятся **после** соответствующего числа: | ||
| + | |||
| + | В секции даты (до буквы '' | ||
| + | |||
| + | * **'' | ||
| + | * **'' | ||
| + | * **'' | ||
| + | * **'' | ||
| + | |||
| + | В секции времени (после буквы '' | ||
| + | |||
| + | * **'' | ||
| + | * **'' | ||
| + | * **'' | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | {{: | ||
| + | |||
| + | === Отправка оповещений по действиям === | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | * крайний срок выполнения сегодня | ||
| + | * крайний срок выполнения наступит через '' | ||
| + | * просроченные действия | ||
| + | |||
| + | '' | ||
| + | |||
| + | {{: | ||
| + | |||
| + | <color brown> | ||
| + | |||
| + | {{: | ||
| + | |||
| + | === Отправка оповещений " | ||
| + | |||
| + | Описание: | ||
| + | |||
| + | * Рутина, | ||
| + | * Рутина отправляет почтовые уведомления " | ||
| + | * Почтовые уведомления содержат список сотрудников и список документов, | ||
| + | |||
| + | == Настройка оповещения == | ||
| + | |||
| + | Нажмите пункт пеню " | ||
| + | |||
| + | * Defined By - '' | ||
| + | * Bean Name - '' | ||
| + | * Method Name - '' | ||
| + | * Method parameters - '' | ||
| + | * Scheduling Typr - '' | ||
| + | * Cron Expression - '' | ||
| + | * Description - '' | ||
| + | |||
| + | {{: | ||
| + | |||
| + | После добавления задания необходимо не забыть его активировать. | ||
| + | |||
| + | == Настройка подразделений для оповещений == | ||
| + | |||
| + | Руководители отмеченных подразделений будут получать рассылку. | ||
| + | |||
| + | " | ||
| + | |||
| + | Установить отметку в чекбоксе " | ||
| + | |||
| + | {{: | ||
| + | |||
| + | === Описание полей формы настройки " | ||
| + | |||
| + | * Defined by - каким программным объектом реализуется задание. Возможные значения: | ||
| + | * Bean - задание реализуется методом бина Spring. Дополнительные атрибуты: | ||
| + | * Bean name - имя бина. Бин отображается в списке и доступен для выбора, | ||
| + | * Method name - метод интерфейса бина для выполнения. Метод должен либо не иметь параметров, | ||
| + | * Method parameters - параметры выбранного метода. Поддерживаются только параметры типа String. | ||
| + | * Class - задание представляет собой класс, реализующий интерфейс java.util.concurrent.Callable. Класс должен иметь открытый конструктор без параметров. Дополнительные атрибуты: | ||
| + | * Class name - имя класса | ||
| + | * Script - задание представляет собой скрипт Groovy. Скрипт выполняется через Scripting.runGroovyScript(). Дополнительные атрибуты: | ||
| + | * Script name - имя скрипта. | ||
| + | * User name - имя пользователя, | ||
| + | * Singleton - признак, | ||
| + | * Scheduling type - способ планирования задачи: | ||
| + | * Cron - с помощью Cron-выражения, | ||
| + | * секунда, | ||
| + | |||
| + | <code -> | ||
| + | 0 0 * * * * - начало каждого часа каждого дня. | ||
| + | */10 * * * * * - каждые 10 секунд. | ||
| + | 0 0 8-10 * * * - в 8, 9 и 10 часов каждого дня. | ||
| + | 0 0/30 8-10 * * * - 8:00, 8:30, 9:00, 9:30 и 10 часов каждого дня. | ||
| + | 0 0 9-17 * * MON-FRI - каждый час с 9 до 17 по рабочим дням. | ||
| + | 0 0 0 7 1 ? - каждое Рождество в полночь. | ||
| + | </ | ||
| + | |||
| + | * Period - с помощью интервала между выполнениями. | ||
| + | * Fixed Delay - задача будет запускаться с указанной в Period задержкой после окончания предыдущего выполнения. | ||
| + | * Period - период или задержка запуска задания в секундах если Scheduling type установлен в Period или Fixed Delay. | ||
| + | * Start date - дата/ | ||
| + | |||
| + | Start date имеет смысл указывать только для " | ||
| + | |||
| + | * Timeout - время в секундах, | ||
| + | |||
| + | Для Singleton-задач в кластерном деплойменте рекомендуется всегда устанавливать таймаут в реалистичное значение. Если останавливается узел кластера, | ||
| + | |||
| + | * Time frame - в случае заданного Start date или Cron expression определяет временное окно в секундах, | ||
| + | |||
| + | Если Start date не указано, | ||
| + | |||
| + | * Start delay - задержка выполнения в секундах после запуска сервера и активации выполнения задач. Используйте данный параметр для тяжелых задач, если вы считаете что они тормозят запуск сервера. | ||
| + | * Permitted servers - список перечисленных через запятую идентификаторов серверов, | ||
| + | |||
| + | Для синглтон-заданий порядок перечисления серверов указывает их приоритет - первый имеет больший приоритет чем последний. Сервер с большим приоритетом перехватит выполнение синглтона следующим образом: | ||
| + | |||
| + | * Log start - признак регистрации факта запуска задания в таблице SYS_SCHEDULED_EXECUTION, | ||
| + | |||
| + | Если задание является синглтоном, | ||
| + | |||
| + | * Log finish - признак регистрации факта завершения задания в таблице SYS_SCHEDULED_EXECUTION, | ||
| + | |||
| + | Если задание является синглтоном, | ||
| + | |||
| + | * Description - произвольное текстовое описание задания. | ||
| + | |||
| + | Задание также имеет признак активности, | ||
| + | |||
| + | === Настройка времени жизни пользовательской сессии === | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | <color brown> Настройка: | ||
| + | |||
| + | * 0 - включено | ||
| + | * 1 - отключено | ||
| + | |||
| + | === Блокировка пользователя, | ||
| + | |||
| + | <color brown> Описание: | ||
| + | |||
| + | <color brown> Настройка: | ||
| + | |||
| + | * bruteForceProtection.maxLoginAttemptsNumber - в свойстве указывается количество попыток | ||
| + | * cuba.bruteForceProtection.blockIntervalSec - здесь указывается время в секундах, | ||
| + | * cuba.bruteForceProtection.enabled - это свойство для включения или отключения защиты от перебора паролей. | ||
| + | |||
| + | === Настройки требований сложности пароля, | ||
| + | |||
| + | <color brown> Описание </ | ||
| + | |||
| + | <color brown> Настройка </ | ||
| + | |||
| + | Для настройки сложности пароля используется свойство " | ||
| + | |||
| + | * true - включено | ||
| + | * false - выключено | ||
| + | |||
| + | Для настройки времени интервала смены пароля используется свойство " | ||
| + | |||
| + | <color white> End article </ | ||
| + | |||
| + | === Проверка сроков актуальности документов === | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Рутина по проверке сроков актуальности версий документов. \\ Выполняется по крону каждый день в 1:30. (время можно изменить).\\ | ||
| + | |||
| + | // | ||
| + | |||
| + | Если у документа не было текущей версии. Рутина установит " | ||
| + | |||
| + | // | ||
| + | |||
| + | Нажмите пункт меню «Администрирование», | ||
| + | |||
| + | | **Название поля** | ||
| + | | Defined by | Bean | User Name | | | ||
| + | | Bean Name | odgassist5_DocumentService | ||
| + | | Method Name | checkActualDocumentVersion() | ||
| + | | Scheduling Type | Cron | Log Start | | | ||
| + | | Cron Expression | ||
| + | | Timeout, sec | | Description | ||
| + | | Time Frame, sec | | ||
| + | | Start Delay, sec | | ||
| + | |||
| + | Сверьте и отредактируйте при необходимости заполненные параметры согласно изображению выше. Если запись отсутствует, | ||
| + | |||
| + | ===== Просмотр пользовательских сессий ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Нажмите пункт меню " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | После добавления фильтра выберите тип: \\ | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | Реестр отобразит все сессии. Далее для отображения только активных добавьте фильтр " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | Также измените тип фильтра " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | ===== Создание системного пользователя ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Логин системного пользователя указывается в local.app.properties Ключ cuba.jmxUserLogin. По умолчанию значение admin | ||
| + | |||
| + | Порядок действий | ||
| + | |||
| + | - В запущенном приложении перейти в меню Администрирование - Консоль JMX | ||
| + | - В поле Поиск по ObjectName ввести demo и нажать просмотреть MBean | ||
| + | - Найти метод createSystemUser() | ||
| + | - Нажать запустить | ||
| + | - Перейти в Администрирование - Пользователи | ||
| + | - Убедиться, | ||
| + | - Сбросить пользователю пароль на 00000, чтобы создалась запись WebDavCridentials | ||
| + | - Теперь необходимо изменить свойство cuba.jmxUserLogin в файле который находится на сервере. Установит значение system. | ||
| + | - Перезапустить | ||
| + | - Чтобы проверить достаточно, | ||
| + | - cuba.jmxUserLogin = system | ||
| + | |||
| + | ==== Проверка времени приложения ==== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Создайте тестовую группу, | ||
| + | |||
| + | <code -> | ||
| + | |||
| + | command=java -Xms3G -Xmx3G -jar -XX: | ||
| + | </ | ||
| + | |||
| + | ===== Блокировки карточек ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Блокировка в UI проверялась только в " | ||
| + | |||
| + | Настройка блокировки на запись Ссылка на документацию cuba: | ||
| + | |||
| + | Рассмотрим блокировку на примере разработки документов. | ||
| + | |||
| + | Перейти в меню " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | Нажать кнопку " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | Заполнить поля | ||
| + | |||
| + | - Тип блокировки - Сущности | ||
| + | - Наименование - Задача на разработку документа (odgassist5_DocumentDevelopmentTask) - поле поддерживает поиск | ||
| + | - Таймаут. сек - время которое сущность будет недоступна для редактирование через UI. | ||
| + | |||
| + | Пример заполнения: | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | Нажать кнопку " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | После сообщения о перезагрузки конфигурации необходимо проверить сработала ли настройка. Для этого необходимо открыть задачу на разработку документа 2мя пользователями одновременно. | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | ===== Делегирование ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Версия приложения 2024.02 и выше. \\ Делегирования активных задач и замещение отвтетственных пользователей в процессах разработки\\ | ||
| + | |||
| + | - Задачи пользователей\\ | ||
| + | - Мои задачи | ||
| + | |||
| + | Доступность функционала определяется свойством ru.od.enable_reassignation. \\ Так же необходимо открыть доступ к экрану в нужной роли: | ||
| + | |||
| + | Как работает: | ||
| + | |||
| + | - Выбираем запись в реестре | ||
| + | - Нажимаем на кнопку " | ||
| + | - Отобразится редактор переназначение \\ {{: | ||
| + | - Формируется список из пользователей которые есть в карточке | ||
| + | - Заполняем поле С пользователя | ||
| + | - Заполняем поле На пользователя | ||
| + | - Заполняем поле Причина | ||
| + | - Пример заполнения \\ {{: | ||
| + | - Нажимаем кнопку Переназначить | ||
| + | |||
| + | Система выполнит поиск всех полей с типами **Пользователь** \\ Если значение поля равно "С пользователя", | ||
| + | |||
| + | **Список пользователей** \\ Если элемент списка равен "С пользователя", | ||
| + | |||
| + | ===== Документ пользователя ===== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | Меню: Документы-Документы пользователей \\ Содержит в себе ссылку на пользователя и документ, | ||
| + | |||
| + | Теперь при любом сохранении версии документа со статусом Согласован: | ||
| + | |||
| + | - Среди найденных записей будут найдены те, пользователям которых ознакомление не отправилось на предыдущем этапе и для которых установлен признак создания ознакомлений. | ||
| + | - При создании ознакомления, | ||
| + | |||
| + | В любом случае, | ||
| + | |||
| + | ==== Редактирование переменных процесса ==== | ||
| + | |||
| + | ---- | ||
| + | |||
| + | //Для чего может понадобиться этот функционал// | ||
| + | |||
| + | // | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | 2. Перейдите на вкладку " | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | 3. На вкладке статус в закладке Variables выберите переменную для корректировки. В примере это исполнитель задач начальника ООК.\\ | ||
| + | |||
| + | | {{: | ||
| + | |||
| + | 4. Откроется окно редактирования значений. Нажмите на иконку " | ||
| + | |||
| + | | {{: | ||
| + | | {{: | ||
| + | | {{: | ||
| + | | {{: | ||
| + | |||
| + | ===== WebDAV → Просмотр документов ===== | ||
| + | |||
| + | 1. Назначение Экран «Просмотрщик документов WebDAV» — служебный (администраторский) реестр всех файлов, | ||
| + | |||
| + | Экран позволяет: | ||
| + | |||
| + | найти любой WebDAV-документ в системе; | ||
| + | |||
| + | 2. Как открыть | ||
| + | |||
| + | Администирование → WebDAV → Просмотр документов. | ||
| + | |||
| + | Откроется вкладка «Просмотрщик документов WebDAV». | ||
| + | |||
| + | Если пункт меню не отображается — у вашей роли нет прав на этот экран. | ||
| + | |||
| + | 3. Из чего состоит экран | ||
| + | |||
| + | 3.1. Панель фильтра Верхний блок «Фильтр» — стандартный поисковый фильтр системы: | ||
| + | |||
| + | 3.2. Панель кнопок | ||
| + | |||
| + | Загрузить — загрузить файл с компьютера; | ||
| + | |||
| + | Скачать — скачать выбранный файл; | ||
| + | |||
| + | Управление версиями — открыть окно версий выбранного документа; | ||
| + | |||
| + | Удалить — удалить выбранный WebDAV-документ; | ||
| + | |||
| + | Разблокировать — снять блокировку с выбранного документа; | ||
| + | |||
| + | Включить версионность / Отключить версионность — управление ведением версий файла. | ||
| + | |||
| + | 3.3. Колонки таблицы | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Документ** | Имя файла (ссылка). Рядом полужирным может стоять метка версии — '' | ||
| + | | **Состояние блокировки** | Заполняется, | ||
| + | | **Версионность** | Флажок: | ||
| + | |||
| + | Имена вида '' | ||
| + | |||
| + | 4. Типовые операции | ||
| + | |||
| + | 4.1. Найти документ | ||
| + | |||
| + | При необходимости нажмите Добавить условие поиска и добавьте поля. | ||
| + | |||
| + | 4.2. Скачать файл | ||
| + | |||
| + | Выделите строку в таблице. | ||
| + | |||
| + | Нажмите Скачать. Файл сохранится средствами браузера. | ||
| + | |||
| + | Открыть файл на просмотр можно также щелчком по его имени в колонке Документ. | ||
| + | |||
| + | 4.3. Загрузить файл | ||
| + | |||
| + | Нажмите Загрузить. | ||
| + | |||
| + | Выберите файл на компьютере. | ||
| + | |||
| + | Если для документа ведутся версии, | ||
| + | |||
| + | Загрузка файла через этот экран не запускает маршрут согласования и не меняет статус документа в системе. Для штатной работы с содержимым документа пользуйтесь карточкой задачи на разработку документа. | ||
| + | |||
| + | Файл, загруженный кнопкой **Загрузить** на этом экране, | ||
| + | |||
| + | С таким файлом доступны только операции самого просмотрщика | ||
| + | |||
| + | Загрузка через этот экран предназначена для проверки и отладки работы WebDAV (открывается ли файл в Office, работают ли блокировка и версионирование) и для разовых служебных задач. Рабочие документы загружайте из карточки задачи на разработку документа — только так файл попадёт в бизнес-процесс. | ||
| + | |||
| + | 4.4. Посмотреть и восстановить версии | ||
| + | |||
| + | - Выделите строку. | ||
| + | - Нажмите **Управление версиями** — откроется окно **«Управление версиями документов»**. | ||
| + | - В окне доступны: | ||
| + | * список версий с колонками **Имя**, **Версия**, | ||
| + | * **Открыть документ** — открыть выбранную версию; | ||
| + | * **Скачать** — скачать выбранную версию; | ||
| + | * **Копировать в текущую версию** — сделать содержимое выбранной старой версии актуальным (история версий при этом сохраняется); | ||
| + | * **Загрузить** — добавить новую версию из файла; | ||
| + | * **Обновить**, | ||
| + | - Индикатор блокировки в окне показывает состояние: | ||
| + | |||
| + | 4.5. Снять блокировку | ||
| + | |||
| + | Файл блокируется, | ||
| + | |||
| + | Порядок действий: | ||
| + | |||
| + | - Найдите документ и посмотрите в колонке **Состояние блокировки**, | ||
| + | - **Свяжитесь с этим пользователем** и убедитесь, | ||
| + | - Выделите строку и нажмите **Разблокировать**. | ||
| + | |||
| + | > | ||
| + | |||
| + | Кнопка **Разблокировать** доступна только пользователям с правом //WebDav → Разблокировать документы// | ||
| + | |||
| + | 4.6. Включить или отключить версионность | ||
| + | |||
| + | - Выделите строку. | ||
| + | - Нажмите **Включить версионность** или **Отключить версионность**. | ||
| + | - Результат отразится флажком в колонке **Версионность**. | ||
| + | |||
| + | При включённой версионности каждое сохранение файла создаёт новую версию, | ||
| + | |||
| + | > | ||
| + | |||
| + | 4.7. Удалить документ | ||
| + | |||
| + | - Выделите строку. | ||
| + | - Нажмите **Удалить** и подтвердите действие. | ||
| + | |||
| + | > | ||
| + | |||
| + | 5. Права доступа | ||
| + | |||
| + | * Доступ к пункту меню и экрану выдаётся ролью; по умолчанию экран предназначен для администраторов и ответственных за систему. | ||
| + | |||
| + | ===== Свойства приложения ===== | ||
| + | |||
| + | === 1. Назначение === | ||
| + | |||
| + | Экран **«Свойства приложения»** — единая точка настройки поведения системы. Свойство (параметр) — это именованная настройка вида '' | ||
| + | |||
| + | На экране можно: | ||
| + | |||
| + | * найти нужное свойство по имени, описанию или модулю системы; | ||
| + | * посмотреть его текущее значение, | ||
| + | * изменить значение — изменения вступают в силу без перезапуска приложения; | ||
| + | * увидеть, | ||
| + | * выгрузить выбранные свойства в виде SQL-скрипта для переноса на другой стенд. | ||
| + | |||
| + | > | ||
| + | |||
| + | > | ||
| + | |||
| + | === 2. Как открыть === | ||
| + | |||
| + | === Главное меню → Администрирование → Свойства приложения. === | ||
| + | |||
| + | Если пункт меню не отображается — у вашей роли нет прав на экран. | ||
| + | |||
| + | === 3. Из чего состоит экран === | ||
| + | |||
| + | == Панель поиска == | ||
| + | |||
| + | ^ **Элемент** ^ **Назначение** ^ | ||
| + | | **Поиск по имени свойства** | Отбор по части имени, например '' | ||
| + | | **Поиск по описанию** | Отбор по части текста описания, | ||
| + | | **Модуль** | Отбор по функциональному блоку системы (см. п. 6) | | ||
| + | | Кнопка обновления | Перечитать значения свойств | | ||
| + | | Кнопка редактирования | Открыть окно изменения выбранного свойства | | ||
| + | | Кнопка выгрузки (значок со стрелкой вниз) | Выгрузить выбранные свойства SQL-скриптом | | ||
| + | |||
| + | Поиск срабатывает по мере ввода, дерево при этом раскрывается автоматически. Условия можно комбинировать: | ||
| + | |||
| + | Отбор по описанию и по модулю работает только для свойств самой системы odgAssist — у платформенных свойств ('' | ||
| + | |||
| + | == Таблица свойств == | ||
| + | |||
| + | Свойства показаны деревом: | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Имя** | Часть имени свойства (для ветки) или имя свойства (для строки-значения) | | ||
| + | | **Текущее значение** | Значение, | ||
| + | | **Когда обновлено** | Дата и время последнего изменения через этот экран | | ||
| + | | **Кем обновлено** | Логин пользователя, | ||
| + | | **Описание** | Назначение свойства (в таблице текст обрезан, | ||
| + | |||
| + | Кнопки редактирования и выгрузки становятся активными, | ||
| + | |||
| + | === 4. Как изменить значение свойства === | ||
| + | |||
| + | - Найдите свойство поиском. | ||
| + | - Выделите строку и нажмите кнопку редактирования (или дважды щёлкните по строке) — откроется окно **«Свойство приложения»**. | ||
| + | - В окне отображаются: | ||
| + | * **Имя** — только для чтения; | ||
| + | * **Значение по умолчанию** — заводское значение, | ||
| + | * **Текущее значение** — редактируемое поле. Вид поля зависит от типа свойства: | ||
| + | * **Описание** — полный текст назначения свойства. | ||
| + | - Введите новое значение и нажмите **ОК** (или Ctrl+Enter). | ||
| + | |||
| + | Значение сохраняется в базе данных сразу и начинает действовать без перезапуска приложения. В таблице обновятся колонки **Когда обновлено** и **Кем обновлено**. | ||
| + | |||
| + | Чтобы вернуть заводское поведение, | ||
| + | |||
| + | ==== Если значение изменить нельзя ==== | ||
| + | |||
| + | Если свойство задано на уровне сервера приложения, | ||
| + | |||
| + | >// | ||
| + | |||
| + | Такие свойства меняет администратор в конфигурационном файле сервера, | ||
| + | |||
| + | === 5. Выгрузка свойств (перенос настроек) === | ||
| + | |||
| + | - Отметьте одно или несколько свойств (множественный выбор — с Ctrl или Shift). | ||
| + | - Нажмите кнопку выгрузки. | ||
| + | - Откроется окно **«Экспорт свойств»** с готовым SQL-скриптом — его можно скопировать и выполнить на другом стенде, | ||
| + | |||
| + | Ветки дерева в выгрузку не попадают — экспортируются только сами свойства. | ||
| + | |||
| + | === 6. Модули === | ||
| + | |||
| + | Фильтр **Модуль** соответствует функциональным блокам системы: | ||
| + | |||
| + | ^ **Модуль** ^ **Что настраивает** ^ | ||
| + | | Приложение | Общие настройки системы, | ||
| + | | Контроль печати | Контролируемая печать: | ||
| + | | Обучение | Обучение и ознакомление с документами | | ||
| + | | Разработка документов | Процесс разработки, | ||
| + | | Отклонения и события качества | Регистрация и расследование отклонений | | ||
| + | | CAPA и планы действий | Планы действий и корректирующие/ | ||
| + | | Управление изменениями | Процессы управления изменениями | | ||
| + | | Управление рисками | Анализ и оценка рисков | | ||
| + | | Пользователи | Настройки, | ||
| + | | Компьютерное зрение | Модуль распознавания | | ||
| + | | Уведомление по электронной почте | Какие события рассылать по почте | | ||
| + | |||
| + | === 7. Примеры часто используемых свойств === | ||
| + | |||
| + | ^ **Свойство** ^ **Модуль** ^ **Назначение** ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | Полный список с описаниями всегда доступен на самом экране — пользуйтесь поиском по описанию. | ||
| + | |||
| + | === 8. Меры предосторожности === | ||
| + | |||
| + | * Перед изменением прочитайте описание свойства целиком в окне редактирования — формулировка в таблице обрезана. | ||
| + | * Записывайте прежнее значение: | ||
| + | * Не меняйте свойства с ключами бизнес-процессов ('' | ||
| + | * Секретные свойства (пароли, | ||
| + | * После изменения проверьте работу затронутой функции: | ||
| + | |||
| + | === 9. Что делать, | ||
| + | |||
| + | ^ **Ситуация** ^ **Действие** ^ | ||
| + | | Свойство не находится поиском | Проверьте, | ||
| + | | Поле «Текущее значение» недоступно | Свойство задано на уровне сервера приложения — обратитесь к администратору (п. 4) | | ||
| + | | Значение изменили, | ||
| + | | Нужно перенести настройки на другой стенд | Выделите свойства и воспользуйтесь выгрузкой SQL-скрипта (п. 5) | | ||
| + | | Непонятно, | ||
| + | |||
| + | ====== Журнал изменений сущностей (просмотр) ====== | ||
| + | |||
| + | ===== 1. Назначение ===== | ||
| + | |||
| + | **Журнал изменений сущностей** — системный журнал аудита. Он отвечает на вопрос «кто, когда и что именно изменил» в данных системы: | ||
| + | |||
| + | Журнал используется, | ||
| + | |||
| + | * разобраться, | ||
| + | * установить, | ||
| + | * посмотреть, | ||
| + | * предъявить подтверждение изменений при внутреннем или внешнем аудите. | ||
| + | |||
| + | Журнал доступен **только для чтения**: | ||
| + | |||
| + | ===== 2. Как открыть ===== | ||
| + | |||
| + | Главное меню → **Администрирование** → **Журнал изменений сущностей**. | ||
| + | |||
| + | Экран состоит из двух вкладок: | ||
| + | |||
| + | ^ **Вкладка** ^ **Доступ** ^ | ||
| + | | **Просмотр** | Рабочая вкладка — поиск и просмотр записей журнала. Описана в этой инструкции | | ||
| + | | **Настройка** | Определяет, | ||
| + | |||
| + | Чтобы включить протоколирование нового объекта или дополнительных реквизитов, | ||
| + | |||
| + | ===== 3. Важно: при открытии журнал пуст ===== | ||
| + | |||
| + | Сразу после открытия вкладки **Просмотр** таблица пустая и показывает «0 строк». Это нормально: | ||
| + | |||
| + | Чтобы увидеть записи, | ||
| + | |||
| + | - заполнить **хотя бы один** фильтр; | ||
| + | - нажать **Поиск**. | ||
| + | |||
| + | ===== 4. Фильтры поиска ===== | ||
| + | |||
| + | ^ **Фильтр** ^ **Как работает** ^ | ||
| + | | **Пользователь** | Выбор из списка пользователей системы — показать действия конкретного сотрудника | | ||
| + | | **Тип изменения** | Создание, | ||
| + | | **Сущность** | Тип объекта системы (документ, | ||
| + | | **Экземпляр сущности** | Конкретный объект. Поле становится доступным **только после выбора сущности**. Кнопка с многоточием открывает список объектов этого типа для выбора, | ||
| + | | **От** / **До** | Период: | ||
| + | | **Поиск** | Выполнить запрос и загрузить записи | | ||
| + | | **Очистить** | Сбросить все фильтры и очистить таблицу | | ||
| + | |||
| + | Фильтры работают совместно: | ||
| + | |||
| + | Поля **От** и **До** содержат отдельно дату и время — чтобы расширить поиск на несколько дней или месяцев, | ||
| + | |||
| + | ===== 5. Как читать результаты ===== | ||
| + | |||
| + | ==== 5.1. Левая таблица — список изменений ==== | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Когда** | Дата и время изменения с точностью до секунды | | ||
| + | | **Пользователь** | Кто выполнил изменение | | ||
| + | | **Тип изменения** | Создание, | ||
| + | | **Сущность** | Тип объекта | | ||
| + | | **Id** | Внутренний идентификатор объекта (нужен при обращении в поддержку) | | ||
| + | | **Имя экземпляра сущности** | Название объекта в понятном виде | | ||
| + | |||
| + | Записи выводятся в хронологическом порядке — от более ранних к более поздним. Вверху таблицы отображается счётчик найденных строк. | ||
| + | |||
| + | ==== 5.2. Правая таблица — что именно изменилось ==== | ||
| + | |||
| + | Выделите строку в левой таблице — справа появится расшифровка по реквизитам: | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Атрибут** | Название изменённого реквизита | | ||
| + | | **Новое значение** | Значение после изменения | | ||
| + | | **Новый Id** | Идентификатор нового значения, | ||
| + | | **Старое значение** | Значение до изменения | | ||
| + | | **Старый Id** | Идентификатор прежнего значения-ссылки | | ||
| + | |||
| + | Для записей типа // | ||
| + | |||
| + | Текст в обеих таблицах можно выделить мышью и скопировать | ||
| + | |||
| + | ==== 5.3. Дополнительный фильтр ==== | ||
| + | |||
| + | Свёрнутая строка **«Фильтр: | ||
| + | |||
| + | ===== 6. Типовые сценарии ===== | ||
| + | |||
| + | ==== Кто и когда изменил конкретный объект ==== | ||
| + | |||
| + | - **Сущность** — выберите тип объекта (например, | ||
| + | - **Экземпляр сущности** — нажмите многоточие и выберите нужный объект. | ||
| + | - **От** / **До** — задайте период, | ||
| + | - **Поиск**. | ||
| + | - Просматривайте строки слева и расшифровку справа. | ||
| + | |||
| + | ==== Что делал пользователь за период ==== | ||
| + | |||
| + | - **Пользователь** — выберите сотрудника. | ||
| + | - **От** / **До** — задайте период. | ||
| + | - **Поиск**. | ||
| + | |||
| + | ==== Кто удалил запись ==== | ||
| + | |||
| + | - **Тип изменения** — // | ||
| + | - При необходимости укажите **Сущность** и период. | ||
| + | - **Поиск** — в колонке **Пользователь** будет видно, кто выполнил удаление. | ||
| + | |||
| + | ==== Проверить, | ||
| + | |||
| + | Откройте вкладку **Просмотр** (период «вчера — завтра» уже подставлен), | ||
| + | |||
| + | ===== 7. Ограничения, | ||
| + | |||
| + | * В журнал попадают **только те объекты и реквизиты, | ||
| + | * Изменения, | ||
| + | * Служебные реквизиты (внутренние отметки о создании и обновлении записи, | ||
| + | * Журнал не заменяет историю согласования и утверждения документа — маршрут и подписи смотрите в карточке документа. | ||
| + | * Записи журнала нельзя изменить или удалить из интерфейса. | ||
| + | |||
| + | ===== 8. Что делать, | ||
| + | |||
| + | ^ **Ситуация** ^ **Действие** ^ | ||
| + | | Таблица пустая, | ||
| + | | Поле **Экземпляр сущности** недоступно | Сначала выберите значение в поле **Сущность** | | ||
| + | | Найдено слишком много записей, | ||
| + | | Нужно включить протоколирование нового объекта или реквизита | Направьте запрос администратору системы или в техническую поддержку: | ||
| + | | Нужно передать сведения в поддержку | Скопируйте из таблицы значения колонок **Когда**, | ||
| + | |||
| + | ====== Неудачные попытки входа ====== | ||
| + | |||
| + | ===== 1. Назначение ===== | ||
| + | |||
| + | Реестр **«Неудачные попытки входа»** фиксирует каждую неуспешную попытку входа в систему: | ||
| + | |||
| + | Реестр используется, | ||
| + | |||
| + | * разобрать обращение пользователя «не могу войти в систему» и понять, | ||
| + | * выявить признаки подбора пароля (много неудачных попыток за короткое время); | ||
| + | * контролировать попытки входа под учётными записями уволенных сотрудников; | ||
| + | * предоставить сведения службе информационной безопасности и при аудите. | ||
| + | |||
| + | Реестр доступен **только для чтения**: | ||
| + | |||
| + | ===== 2. Как открыть ===== | ||
| + | |||
| + | Главное меню → **Администрирование** → **Неудачные попытки входа** (пункт расположен в конце раздела). | ||
| + | |||
| + | ===== 3. Что попадает в реестр ===== | ||
| + | |||
| + | Запись создаётся автоматически при **каждой неуспешной** попытке аутентификации — как в веб-интерфейсе, | ||
| + | |||
| + | Успешные входы в этот реестр **не попадают** — сведения о состоявшихся сеансах работы смотрите в разделе **Администрирование → Журнал пользовательских сессий**. | ||
| + | |||
| + | ===== 4. Колонки реестра ===== | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Логин** | Текст, который был введён в поле логина — именно в том виде, как его набрал человек. Поэтому в реестре встречаются и настоящие логины ('' | ||
| + | | **Проблема** | Причина отказа, | ||
| + | | **Дата и время события** | Когда произошла попытка | | ||
| + | |||
| + | Щелчок по заголовку колонки сортирует список по этой колонке. | ||
| + | |||
| + | ===== 5. Как читать колонку «Проблема» ===== | ||
| + | |||
| + | ^ **Значение** ^ **Что означает** ^ **Типичные причины** ^ | ||
| + | | **Неверный пароль** | Пользователь с таким логином в системе **есть**, | ||
| + | | **Неверные учетные данные** | Пользователя с таким логином в системе **нет** | Опечатка в логине; | ||
| + | |||
| + | Практический вывод: если сотрудник жалуется на невозможность входа, посмотрите его последние записи: | ||
| + | |||
| + | * «Неверный пароль» — проблема в пароле, | ||
| + | * «Неверные учетные данные» — сотрудник вводит не тот логин; сообщите ему точный логин учётной записи. | ||
| + | |||
| + | ===== 6. Работа с реестром ===== | ||
| + | |||
| + | ==== 6.1. Поиск ==== | ||
| + | |||
| + | * **Добавить условие поиска** — добавить в фильтр поле (логин, | ||
| + | * **Обновить** (зелёная кнопка в блоке «Фильтр») — применить условия и перечитать данные. | ||
| + | * Кнопка **Обновить** над таблицей — перечитать список без изменения условий. | ||
| + | |||
| + | ==== 6.2. Отображение ==== | ||
| + | |||
| + | * **Показывать строк** — количество записей на странице (по умолчанию 50). | ||
| + | * Стрелки справа — переход к следующим страницам; | ||
| + | |||
| + | ==== 6.3. Выгрузка в Excel ==== | ||
| + | |||
| + | Кнопка **Excel** выгружает содержимое таблицы в файл для отчёта или дальнейшего анализа. Выгружаются колонки в том виде, как они отображаются на экране, | ||
| + | |||
| + | ===== 7. Типовые сценарии ===== | ||
| + | |||
| + | ==== Разобрать обращение «не могу войти» ==== | ||
| + | |||
| + | - Добавьте условие поиска по логину и укажите логин сотрудника (или его вариант с опечаткой). | ||
| + | - При необходимости задайте период по колонке даты и времени. | ||
| + | - Нажмите **Обновить** и посмотрите значения в колонке **Проблема** (п. 5). | ||
| + | |||
| + | ==== Проверить признаки подбора пароля ==== | ||
| + | |||
| + | - Задайте период (например, | ||
| + | - Отсортируйте список по дате и времени. | ||
| + | - Обратите внимание на: | ||
| + | * серию попыток по одному логину с интервалом в секунды-минуты; | ||
| + | * множество разных несуществующих логинов подряд; | ||
| + | * попытки в нерабочее время. | ||
| + | - При подозрении на подбор выгрузите выборку в **Excel** и передайте службе информационной безопасности. | ||
| + | |||
| + | ===== 8. Ограничения, | ||
| + | |||
| + | * В реестре только **неудачные** попытки; | ||
| + | * Пароли в реестре **не сохраняются** — фиксируется только введённый логин. | ||
| + | * IP-адрес и наименование рабочей станции в этом реестре не фиксируются. | ||
| + | * Реестр только регистрирует события и **сам по себе не блокирует** учётные записи. | ||
| + | * Записи нельзя изменить или удалить через интерфейс — это обеспечивает их доказательность. | ||
| + | |||
| + | ===== 9. Что делать, | ||
| + | |||
| + | ^ **Ситуация** ^ **Действие** ^ | ||
| + | | Сотрудник не может войти, в реестре — «Неверный пароль» | Сбросьте пароль учётной записи (раздел «Пользователи») или передайте заявку администратору | | ||
| + | | Сотрудник не может войти, в реестре — «Неверные учетные данные» | Сообщите сотруднику точный логин: он вводит несуществующее имя учётной записи | | ||
| + | | Записей по сотруднику нет вообще | Попытки входа до системы не доходили: | ||
| + | | Видны массовые попытки с незнакомыми логинами | Выгрузите выборку в Excel и передайте службе информационной безопасности и администратору системы | | ||
| + | | Записей слишком много | Сузьте период и добавьте условие по логину; | ||
| + | |||
| + | ====== Журнал пользовательских сессий ====== | ||
| + | |||
| + | ===== 1. Назначение ===== | ||
| + | |||
| + | **Журнал пользовательских сессий** показывает, | ||
| + | |||
| + | Журнал используется, | ||
| + | |||
| + | * подтвердить, | ||
| + | * посмотреть, | ||
| + | * увидеть сеансы, | ||
| + | * предоставить сведения службе информационной безопасности и при аудите. | ||
| + | |||
| + | Записи создаёт сама система; | ||
| + | |||
| + | ===== 2. Как открыть ===== | ||
| + | |||
| + | Главное меню → **Администрирование** → **Журнал пользовательских сессий**. | ||
| + | |||
| + | ===== 3. Как формируются записи ===== | ||
| + | |||
| + | * При **входе** пользователя создаётся запись: | ||
| + | * При **завершении** сеанса та же запись дополняется: | ||
| + | |||
| + | ===== 4. Колонки журнала ===== | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **ID сессии** | Внутренний идентификатор сеанса. Позволяет собрать вместе все записи одного сеанса работы | | ||
| + | | **Пользователь** | Учётная запись, | ||
| + | | **От имени пользователя** | Заполняется только при замещении — сотрудник, | ||
| + | | **Последнее действие** | Текущее состояние сеанса или способ его завершения (см. п. 5) | | ||
| + | | **IP Адрес** | Адрес, с которого выполнен вход | | ||
| + | | **Тип клиента** | Каким способом выполнен вход (например, | ||
| + | | **Сервер** | Узел приложения, | ||
| + | | **Начата** | Дата и время начала сеанса (или момента замещения) | | ||
| + | | **Завершена** | Дата и время окончания. **Пустое значение — сеанс ещё не завершён** | | ||
| + | | **Информация о клиенте** | Браузер и операционная система рабочего места; для записей о замещении — «Замещение пользователя …» | | ||
| + | |||
| + | Щелчок по заголовку колонки сортирует список. По умолчанию записи отсортированы от новых к старым. | ||
| + | |||
| + | ===== 5. Значения колонки «Последнее действие» ===== | ||
| + | |||
| + | ^ **Значение** ^ **Что означает** ^ | ||
| + | | **Логин** | Вход выполнен. Если колонка **Завершена** пустая — сеанс активен в настоящий момент | | ||
| + | | **Выход** | Пользователь сам вышел из системы | | ||
| + | | **Истечение срока** | Сеанс завершён системой по неактивности. Этим же значением закрываются сеансы, | ||
| + | | **Прервана** | Сеанс принудительно завершён (например, | ||
| + | | **Подмена пользователя** | Запись о замещении: | ||
| + | |||
| + | ===== 6. Работа с журналом ===== | ||
| + | |||
| + | ==== 6.1. Поиск ==== | ||
| + | |||
| + | * **Добавить условие поиска** — добавить поле для отбора: | ||
| + | * **Обновить** (зелёная кнопка в блоке «Фильтр») — применить условия и перечитать данные. | ||
| + | |||
| + | ==== 6.2. Отображение ==== | ||
| + | |||
| + | * **Показывать строк** — количество записей на странице. | ||
| + | * Стрелки справа и счётчик — переход по страницам и общее количество найденных записей. | ||
| + | * Текст в таблице можно выделить мышью и скопировать. | ||
| + | |||
| + | ==== 6.3. Выгрузка в Excel ==== | ||
| + | |||
| + | Кнопка **Excel** выгружает текущую выборку в файл | ||
| + | |||
| + | ===== 7. Кнопка «Запретить журналирование» — будьте внимательны ===== | ||
| + | |||
| + | Синяя кнопка слева переключает ведение журнала **для всей системы**: | ||
| + | |||
| + | * надпись **«Запретить журналирование»** означает, | ||
| + | * после остановки надпись сменится на **«Разрешить журналирование»**, | ||
| + | |||
| + | > | ||
| + | |||
| + | Настройка сохраняется в системе и действует после перезапуска приложения. | ||
| + | |||
| + | ===== 8. Типовые сценарии ===== | ||
| + | |||
| + | ==== Кто работал в системе в определённый момент ==== | ||
| + | |||
| + | - Добавьте условия по колонкам **Начата** и **Завершена**, | ||
| + | - Нажмите **Обновить**. | ||
| + | - Обратите внимание на колонку **От имени пользователя**: | ||
| + | |||
| + | ==== Посмотреть все сеансы сотрудника за период ==== | ||
| + | |||
| + | - Добавьте условие по полю **Пользователь** и выберите сотрудника. | ||
| + | - Задайте период по колонке **Начата**. | ||
| + | - **Обновить**, | ||
| + | |||
| + | ==== Какие сеансы активны сейчас ==== | ||
| + | |||
| + | Добавьте условие **Последнее действие = Логин** и обновите список: | ||
| + | |||
| + | ==== Проконтролировать замещения ==== | ||
| + | |||
| + | Добавьте условие **Последнее действие = Подмена пользователя** (или условие «От имени пользователя заполнено») и задайте период. В колонке **Информация о клиенте** будет указано, | ||
| + | |||
| + | ===== 9. Ограничения, | ||
| + | |||
| + | * Журнал показывает **факты входа и выхода**, | ||
| + | * **Неудачные** попытки входа в этот журнал не попадают — они в реестре **Неудачные попытки входа**. | ||
| + | * Записи ведутся только за период, | ||
| + | * IP-адрес соответствует адресу, | ||
| + | * Сеансы, | ||
| + | |||
| + | ===== 10. Что делать, | ||
| + | |||
| + | ^ **Ситуация** ^ **Действие** ^ | ||
| + | | Нужно подтвердить, | ||
| + | | Колонка **Завершена** пустая у старых записей | Сеанс не был завершён штатно (обрыв связи, закрытие браузера) — он закроется по истечении срока или при следующем запуске сервера | | ||
| + | | Один ID сессии повторяется много раз | Это нормально: | ||
| + | | Журнал перестал пополняться | Проверьте надпись на кнопке слева: если она гласит «Разрешить журналирование», | ||
| + | | Нужны сведения о попытках входа с неверным паролем | Откройте реестр **Неудачные попытки входа** | | ||
| + | | Нужно передать выборку аудитору | Задайте условия, | ||
| + | |||
| + | ====== Раздел BProc: Modeler, Process Definitions, | ||
| + | |||
| + | ===== 1. Что такое BProc ===== | ||
| + | |||
| + | **BProc** — встроенный движок бизнес-процессов. По схемам BPMN, опубликованным в этом разделе, | ||
| + | |||
| + | Раздел **служебный**: | ||
| + | |||
| + | Раздел содержит три пункта: | ||
| + | |||
| + | ^ **Пункт меню** ^ **Назначение** ^ | ||
| + | | **Process Definitions** | Реестр опубликованных схем процессов: | ||
| + | | **Modeler** | Графический редактор схем BPMN | | ||
| + | | **User Tasks** | Все текущие задачи всех пользователей: | ||
| + | |||
| + | > | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 2. Process Definitions — реестр процессов ===== | ||
| + | |||
| + | ==== 2.1. Что показывает ==== | ||
| + | |||
| + | Таблица опубликованных схем: | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Название** | Понятное имя процесса («Расследование отклонения», | ||
| + | | **Ключ** | Технический идентификатор ('' | ||
| + | | **Версия** | Номер версии схемы. Например, | ||
| + | |||
| + | ==== 2.2. Фильтр ==== | ||
| + | |||
| + | * **Name contains** — часть названия; | ||
| + | * **Key contains** — часть ключа; | ||
| + | * **Last version only** — включён по умолчанию, | ||
| + | * **Применить** — выполнить отбор. | ||
| + | |||
| + | ==== 2.3. Кнопки ==== | ||
| + | |||
| + | ^ **Кнопка** ^ **Действие** ^ | ||
| + | | **Open in modeler** | Открыть схему выбранного процесса в редакторе (см. п. 3) | | ||
| + | | **View details** | Карточка процесса: | ||
| + | | **Start process** | Запустить процесс вручную — **в рабочей системе не использовать**, | ||
| + | | **Upload BPMN XML** | Загрузить файл схемы с диска и **сразу опубликовать** его | | ||
| + | |||
| + | ==== 2.4. Карточка процесса (View details) ==== | ||
| + | |||
| + | **Вкладка General:** | ||
| + | |||
| + | * реквизиты: | ||
| + | * список экземпляров процесса с колонками Идентификатор, | ||
| + | * счётчики: | ||
| + | * кнопки **Suspend** (приостановить), | ||
| + | |||
| + | **Вкладка BPMN XML** — исходный текст схемы, только для чтения. Удобно скопировать и передать в поддержку. | ||
| + | |||
| + | > | ||
| + | |||
| + | ==== 2.5. Как работают версии ==== | ||
| + | |||
| + | Повторная публикация схемы **не перезаписывает** существующую, | ||
| + | |||
| + | * уже запущенные экземпляры продолжают идти по **своей** версии схемы; | ||
| + | * новые экземпляры запускаются по **последней** версии. | ||
| + | |||
| + | Поэтому после изменения процесса ранее начатые документы и отклонения доигрывают по прежним правилам — это нормально и ожидаемо. | ||
| + | |||
| + | ==== 2.6. Почему нельзя запускать процесс кнопкой Start process ==== | ||
| + | |||
| + | Штатно система запускает процесс сама и передаёт в него **бизнес-ключ** (идентификатор документа, | ||
| + | |||
| + | Кнопка предназначена для отладки на тестовом стенде. В рабочей системе процессы запускаются только из карточек объектов. | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 3. Modeler — редактор схем ===== | ||
| + | |||
| + | ==== 3.1. Как открыть ==== | ||
| + | |||
| + | * **BProc → Modeler** — открывается новая пустая схема (Process id = '' | ||
| + | * **Process Definitions → Open in modeler** — открывается схема выбранного процесса. | ||
| + | |||
| + | ==== 3.2. Из чего состоит экран ==== | ||
| + | |||
| + | * **слева** — палитра элементов BPMN (события, | ||
| + | * **в центре** — холст с диаграммой; | ||
| + | * **справа** — панель свойств. Когда ничего не выделено, | ||
| + | |||
| + | ==== 3.3. Кнопки над панелью свойств (слева направо) ==== | ||
| + | |||
| + | ^ **Значок** ^ **Действие** ^ | ||
| + | | Облако со стрелкой | **Deploy process** — опубликовать схему в систему | | ||
| + | | Папка | **Open draft** — открыть ранее сохранённый черновик модели | | ||
| + | | Дискета | **Save draft** — сохранить черновик в системе | | ||
| + | | Стрелка вверх | **Upload BPMN XML** — загрузить схему из файла на диске | | ||
| + | | Стрелка вниз | **Download BPMN XML** — скачать текущую схему файлом | | ||
| + | | Крестик | **Close modeler** — закрыть редактор | | ||
| + | |||
| + | **Черновик (draft)** — это сохранённая в системе незавершённая модель. Черновики **не влияют** на работу системы: | ||
| + | |||
| + | ==== 3.4. Публикация (Deploy process) ==== | ||
| + | |||
| + | При нажатии система спросит подтверждение: | ||
| + | |||
| + | * если процесса с таким ключом ещё нет — «опубликовать новое определение процесса»; | ||
| + | * если процесс с таким ключом уже существует — «опубликовать новую версию процесса». | ||
| + | |||
| + | После подтверждения новая версия сразу становится действующей для **новых** экземпляров. | ||
| + | |||
| + | > | ||
| + | |||
| + | ==== 3.5. Практические правила работы в редакторе ==== | ||
| + | |||
| + | - Перед любой правкой скачайте текущую схему (**Download BPMN XML**) — это ваша точка отката. | ||
| + | - Изменения отрабатывайте на тестовом стенде, | ||
| + | - Не удаляйте и не переименовывайте элементы, | ||
| + | - После публикации проверьте работу на одном тестовом объекте, | ||
| + | |||
| + | ==== 3.6. Панель свойств элемента (на примере пользовательской задачи) ==== | ||
| + | |||
| + | Когда на схеме выделен элемент, | ||
| + | |||
| + | === General — общие === | ||
| + | |||
| + | ^ **Поле** ^ **Значение** ^ | ||
| + | | **Id** | Технический идентификатор элемента в схеме. На него ссылаются условия переходов и настройки системы. **Менять нельзя** — сломаются связи внутри схемы | | ||
| + | | **Name** | Название этапа, которое пользователь видит в списке задач («Разработка документа») | | ||
| + | | **Due date** | Срок выполнения. Задаётся длительностью в формате ISO-8601: '' | ||
| + | |||
| + | === Assignee — кто выполняет задачу === | ||
| + | |||
| + | ^ **Поле** ^ **Значение** ^ | ||
| + | | **Assignee source** | Способ определения исполнителя: | ||
| + | | **Expression** | Само выражение, | ||
| + | | **Candidate groups** | Группы пользователей-кандидатов: | ||
| + | | **Candidate users** | То же, но перечислением конкретных пользователей | | ||
| + | |||
| + | Если заполнен **Assignee**, | ||
| + | |||
| + | === Form — форма задачи === | ||
| + | |||
| + | ^ **Поле** ^ **Значение** ^ | ||
| + | | **Form type** | Чем открывается задача: | ||
| + | | **Open mode** | Как открывается форма: **New tab** (новая вкладка), | ||
| + | | **Screen id** | Идентификатор экрана системы, | ||
| + | | **Form params** | Параметры, | ||
| + | |||
| + | === Outcomes — результаты выполнения === | ||
| + | |||
| + | Список кнопок-исходов, | ||
| + | |||
| + | В примере заданы '' | ||
| + | |||
| + | === Output variables — выходные переменные === | ||
| + | |||
| + | Переменные, | ||
| + | |||
| + | === Multi instance — размножение задачи === | ||
| + | |||
| + | Определяет, | ||
| + | |||
| + | ^ **Поле** ^ **Значение** ^ | ||
| + | | **Multi instance type** | **None** — одна задача; | ||
| + | | **Collection source** | Откуда берётся список, | ||
| + | | **Process variable** | Имя переменной со списком. В примере '' | ||
| + | | **Element variable** | Имя переменной для текущего элемента списка. В примере '' | ||
| + | | **Completion condition** | Условие досрочного завершения, | ||
| + | | **Cardinality** | Фиксированное количество экземпляров, | ||
| + | |||
| + | Связка из примера читается так: «создать параллельно по одной задаче на каждого разработчика из списка '' | ||
| + | |||
| + | === Task listeners — обработчики событий задачи === | ||
| + | |||
| + | Программный код, который выполняется в определённый момент жизни задачи: | ||
| + | |||
| + | === Execution listeners — обработчики хода выполнения === | ||
| + | |||
| + | То же, но для событий потока: | ||
| + | |||
| + | >Обе таблицы слушателей — это точки подключения программного кода. Добавление, | ||
| + | |||
| + | === Extension properties — дополнительные свойства === | ||
| + | |||
| + | Произвольные пары **Name** / **Value**, которые читает код системы (например, | ||
| + | |||
| + | === Other → Documentation === | ||
| + | |||
| + | Текстовое описание этапа. В системе оно показывается пользователю как пояснение к заданию — в примере: | ||
| + | |||
| + | Это **единственное поле панели, | ||
| + | |||
| + | === Свойства других элементов === | ||
| + | |||
| + | У остальных типов элементов набор полей отличается, | ||
| + | |||
| + | * **Процесс** (щелчок по пустому месту холста) — Process id, Name, Starter candidates (кто вправе запускать), | ||
| + | * **Переход (стрелка)** — Id, Name, Condition expression: условие, | ||
| + | * **Служебная задача (Service task)** — Java-класс или выражение, | ||
| + | * **Таймер** — Date / Duration / Cycle: момент, | ||
| + | * **Подпроцесс и Call activity** — ключ вызываемого процесса и правила передачи переменных. | ||
| + | |||
| + | ---- | ||
| + | |||
| + | |||
| + | ===== 4. User Tasks — все задачи пользователей ===== | ||
| + | |||
| + | ==== 4.1. Что показывает ==== | ||
| + | |||
| + | Экран показывает **задачи всех пользователей**, | ||
| + | |||
| + | ==== 4.2. Таблица пустая при открытии — это нормально ==== | ||
| + | |||
| + | Список формируется по запросу. Задайте условия в фильтре (или оставьте их пустыми, | ||
| + | |||
| + | ==== 4.3. Фильтр ==== | ||
| + | |||
| + | ^ **Поле** ^ **Назначение** ^ | ||
| + | | **Process definition** | Процесс, | ||
| + | | **Assignee** | Текущий исполнитель задачи | | ||
| + | | **Candidate user** | Пользователь-кандидат: | ||
| + | | **Candidate group** | Группа пользователей-кандидатов | | ||
| + | |||
| + | ==== 4.4. Колонки ==== | ||
| + | |||
| + | ^ **Колонка** ^ **Что показывает** ^ | ||
| + | | **Task name** | Название этапа («Согласование документа», | ||
| + | | **Process definition name** | Процесс, | ||
| + | | **Process definition version** | Версия схемы, по которой идёт экземпляр | | ||
| + | | **Время создания** | Когда задача появилась | | ||
| + | | **Время окончания** | Когда завершена (у активных задач пусто) | | ||
| + | | **Исполнитель** | Кто должен выполнить задачу | | ||
| + | | **Крайний срок** | Срок выполнения, | ||
| + | | **Идентификатор** | Технический идентификатор задачи — пригодится при обращении в поддержку | | ||
| + | |||
| + | Задачи отсортированы по времени создания, | ||
| + | |||
| + | ==== 4.5. Кнопки ==== | ||
| + | |||
| + | * **Reassign task** — открывает окно **Task reassignment**: | ||
| + | * **Open process instance** — открывает экземпляр процесса, | ||
| + | |||
| + | ==== 4.6. Типовые сценарии ==== | ||
| + | |||
| + | **Задача «зависла» на отсутствующем сотруднике** (отпуск, | ||
| + | |||
| + | - Отфильтруйте по **Assignee** — выберите этого сотрудника, | ||
| + | - Выделите задачу → **Reassign task** → укажите нового исполнителя. | ||
| + | |||
| + | **Выяснить, | ||
| + | |||
| + | - Отфильтруйте по **Process definition** (например, | ||
| + | - Найдите задачу по названию этапа и посмотрите колонку **Исполнитель**. | ||
| + | |||
| + | **Разобраться в состоянии заявки: | ||
| + | |||
| + | > | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 5. Ограничения и меры предосторожности ===== | ||
| + | |||
| + | * Все действия раздела выполняются **в обход бизнес-логики** системы: | ||
| + | * Доступ к разделу выдавайте ограниченному кругу сотрудников (администратор системы, | ||
| + | * Публикация, | ||
| + | * Перед обращением в поддержку соберите: | ||
| + | |||