==== Диаграммы  BPMN ====

Диаграмма BPMN (Business Process Model and Notation) — это визуальный инструмент, который используется для моделирования и управления бизнес-процессами. В нашем приложении BPMN диаграммы служат основой для описания и оптимизации рабочих процессов, позволяя пользователям легко визуализировать последовательность действий, роли и взаимодействия между участниками.

Рассмотрим на примере процесса "Отбор проб готовой продукции". \\  {{:odg_assist_3.0:pasted:20250309-134726.png ?600}}

Первой задачей процесса будет "Отбор проб". По окончанию выполнения задачи будет доступна к выполнению следующая задача "Выполнение методик". Рассматриваемая диаграмма не имеет условий возврата к предыдущей задаче. Задачи выполняются последовательно. \\  Выполнение задач может быть последовательным как на диаграмме выше или иметь ветвления в зависимости от условий. \\  Все это настраивается во встроенном редакторе диаграмм процесса. \\

==== Настройка диаграммы процесса ====

Создадим процесс из двух задач. \\

=== Создание директории для хранения процесса === 

  * Перейдите в "Базовую иерархию". 
  * Выберите родительскую группу в дереве иерархии и нажмите "Добавить". 
  * В окне "Введите имя" заполните поля:
      * Имя - укажите название добавляемой группы. 
      * Тип элемента - выберите "Группа".
      * Подтвердить - сохранить результат.

{{:odg_assist_3.0:bpmn:pasted:20260218-060748.png}}

Далее добавим элементы процесса. 

=== Добавление элементов процесса ===

  * Выберите добавленную группу хранения и нажмите кнопку "Добавить". 
  * В окне "Введите имя" заполните поля:
      * Имя - введите название элемента "Задача 1" 
      * Тип элемента - укажите "Элемент процесса"
      * Подтвердить - сохраните результат.

{{:odg_assist_3.0:bpmn:pasted:20260218-061623.png}}

Аналогичным образом добавьте элемент процесса "Задача 2"

=== Настройка элементов процесса ===

== Настройте назначение исполнителя задачи == 

  * Выберите первый добавленный элемент.
  * В области конфигурации найдите поле "Назначение пользователя", выберите "Создатель процесса"
  * Сохраните внесенные изменения, нажмите кнопку "Сохранить"
 {{:odg_assist_3.0:bpmn:pasted:20260218-062357.png?500}}

Аналогичным образом настройте второй добавленный элмент.

=== Добавление параметров в элемент процесса ===

  * Выберите первый добавленный элемент.
  * Нажмите кнопку "Добавить".
  * Заполните поля формы "Введите имя".
    * Имя - введите имя параметра, например "Число" .
    * Тип точки - укажите "Число".
    * Подтвердить - сохранить результат.
{{:odg_assist_3.0:bpmn:pasted:20260218-063252.png}}

Аналогичным образом добавьте тип точки "Текст" во второй элемент процесса.

{{:odg_assist_3.0:bpmn:pasted:20260218-063416.png}}


=== Добавление шаблона процесса ===

Добавим шаблон процесса и настроим его. 
  * Выберите группу, в которую ранее добавляли элементы процесса
  * Нажмите "Добавить".
  * Заполните поля формы.
    * Имя - название шаблона процесса "Простой процесс".
    * Тип элемента - укажите "Элемент процесса".
    * Подтвердить - сохранить результат. 

{{:odg_assist_3.0:bpmn:pasted:20260218-064104.png}}

== Настройка шаблона процесса ==

  * Выберите добавленный шаблон процесса. 
  * В области конфигурации найдите поле "Элементы процесса".
  * Нажмите "Выбрать".
  * В открывшемся окне "Окно выбора" найдите группу, куда были добавлены элменты процесса и раскройте ее.
  * Выберите добавленные элементы процесса (для множественного выбора зажмите Ctrl и выделите оба элемента).
  * Закройте окно выбора.
  * Нажмите кнопку "Добавить".

{{:odg_assist_3.0:bpmn:pasted:20260218-064443.png}}

Выбранные элементы отобразятся в поле "Элемента процесса".

{{:odg_assist_3.0:bpmn:pasted:20260218-064741.png}}

=== Настройка диаграммы процесса ===

Настроим диаграмму процесса, выставим порядок выполнения задач.
  * В базовой иерархии выберите добавленный ранее шаблон процесса.
  * В области конфигурации найдите кнопку "Открыть редактор" и нажмите ее.
  * Отобразится окно "Редактор шаблона"
  * Нажмите "Загрузить из odg"
{{:odg_assist_3.0:bpmn:pasted:20260218-065156.png}}

Отобразится ненастроенная диаграмма. \\

{{:odg_assist_3.0:bpmn:pasted:20260218-065300.png}}

Расставьте задачи в правильном порядке.
  * Выберите на панели инструментов "Рука"
  * Переместите задачи друг за другом
{{:odg_assist_3.0:bpmn:pasted:20260218-065509.png}}

  * Далее нажмите на первый элемент диаграммы. 
  * Отобразится набор инструментов элемента. 
  * Выберите "Стрелку".
  * Соедините первый элемент процесса со вторым.
{{:odg_assist_3.0:bpmn:pasted:20260218-065812.png}}

Удалите элемент "Inclusive Gateway".
  *  Выберите элемент
  * В наборе его инструментов нажмите иконку "Корзина"
 {{:odg_assist_3.0:bpmn:pasted:20260218-070121.png}}

Соедините все оставшиеся элементы \\
{{:odg_assist_3.0:bpmn:pasted:20260218-070142.png}}

Сохраните диаграмму. \\
{{:odg_assist_3.0:bpmn:pasted:20260218-070302.png}}

Сохраните шаблон процесса, нажмите кнопку "Сохранить".

{{:odg_assist_3.0:bpmn:pasted:20260218-070411.png}}

=== Проверка созданного процесса ===

Нажмите пункт меню "Запуск процессов" \\
{{:odg_assist_3.0:bpmn:pasted:20260218-070956.png}}

Перейдите в пункт меню "Мои задачи".

  * Найдите шаблон процесса и раскройте его. 
  * Выберите процесс. 
  * Отобразится панель управления процессом.
  * Первая задача активна и назначена на исполнителя

{{:odg_assist_3.0:bpmn:pasted:20260218-071658.png}}

Также можно посмотреть на состояние диаграммы процесса. 
  * Нажмите на панели управления процессом первую кнопку.
  * Из выпадающего меню выберите "Диаграмма процесса".
    * {{:odg_assist_3.0:bpmn:pasted:20260218-071824.png}}
  * Активная задача подсвечена оранжевым цветом в окне "Отображение процесса".
    * {{:odg_assist_3.0:bpmn:pasted:20260218-071904.png}}

  * Выполните все задачи процесса. 
  * По завершению задач процесс закроется.


==== Теги используемые в коде приложения ====

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

Тег для добавления кастомной этикетки. Добавляется в самом начале "clear_all_lines" \\  {{:start:odg3_администрирование:pasted:20251209-081246.png}}

| **Имя** | **тег для этикетки** | Пример готовой строки для этикетки | Данные предзаполняют поля задачи "Карточка ресурса" | Данные предзаполняют поля задачи "Карточка ресурса" | Данные предзаполняют поля задачи "Карточка ресурса" | Данные предзаполняют поля задачи "Карточка ресурса" |
|   |   |   | надтип "Исходный материал" | надтип "Приготовленный материал" | надтип "Готовая питательная среда" | надтип "Оборудование" |
|   ||| Системные теги | Системные теги | Системные теги |  Системные теги  |
| Вин номер | <{internalIdentifier}> | "Вин номер: " + <{internalIdentifier}> |   |   |   |   |
| Годен до | <{actualityDate}> | "Годен до: " + <{actualityDate}> | Да, тип точки "Только дата" | Да, тип точки "Только дата"  | Да, тип точки "Только дата"  | Да, тип точки "Только дата" |
| Дата квалификации | <{lastQualificationDate}> | "Дата квалификации: " + <{lastQualificationDate}> |   |   |   |   |
| Дата установки единицы ресурса(приемки) | <{installationDate}> | "Дата установки единицы ресурса(приемки): " + <{installationDate}> | Да, тип точик  "Дата" | Да, тип точик  "Дата"  | Да, тип точик  "Дата"  | Да, тип точик  "Дата" |
| Дата утилизации | <{removalDate}> | "Дата утилизации: " + <{removalDate}> |   |   |   |   |
| Добавил \ Ответственный \ Пользоваетль | используется пользователь добавивший установку (запустивший процесс), тег<{processCreator}> | "Добавил: " + <{processCreator}> | Да, тип точик  "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |
| Единицы измерения | <{dimensions}> | "Единицы измерения: " + <{dimensions}> | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст" / Ед. выбор по совпадению  |   |
| Заметки | <{notes}> | "Заметки: " + <{notes}> |   |   |   |   |
| Количество активного вещества | <{activeMaterial}> | "Количество активного вещества: " + <{activeMaterial}> |   |   |   |   |
| Место хранения | <{resourceStoragePosition}> | "Место хранения: " + <{resourceStoragePosition}> | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |
| Наименование типа ресурса | <{reourseType}> | "Тип ресурса: " + <{reourseType}> |   |   |   |   |
| Название установки ресурса | <{nameOfResource}> | "Название установки ресурса: " + <{nameOfResource}> | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |
| Порт для связи с конвертером | <{hardwareAddress}> | - |   |   |   |   |
| Конвертер для связи с оборудованием | <{hardwareConverterName}> | - |   |   |   |   |
| Производитель | <{developer}> | "Производитель: " + <{developer}> |   |   |   |   |
| Серийный номер | <{serialNumber}> | "Серийный номер: " + <{serialNumber}> |   |   |   |   |
| Содержание влаги | <{waterComponent}> | "Содержание влаги: " + <{waterComponent}> |   |   |   |   |
| Текущее количество | <{currentValue}> | "Текущее количество: " + <{currentValue}> | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  |   |
| Место хранения | место хранения берется из типа ресурса <{resourceStorageType}> | "Место хранения: "+<{resourceStorageType}> |   |   |   |   |
| Условия хранения | условия хранения берутся из типа ресурса <{storageCondition}> | - | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |
| Инструкция | Берется из типа ресурса <{instructionsText}> | - | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |
| Чистота | <{purity}> | "Чистота: " + <{purity}> |   |   |   |   |
| Доступен к использованию | <{enabled}>  |   |   |   |   |   |
| Тип ресурса | <{resourceType}> | - |   |   |   |   |
| Уникальный идентификатор установки ID | берется из таблицы установки ресурса <{installation_id}> | - | Да, тип точки "Текст" | Да, тип точки "Текст"  | Да, тип точки "Текст"  | Да, тип точки "Текст" |