Шевроны. Визуализация этапов процесса. Пример настройки

Введение

В Comindware Platform можно настроить визуальное отображение этапов процесса с помощью шевронов.

В этой статье представлен пример настройки приложения для отображения прогресса открытия магазина в виде цветных шевронов пройденных этапов.

Прикладная задача

Имеется процесс открытия магазина, состоящий из семи этапов.

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

Цвет шевронов должен зависеть от статуса прохождения этапа:

• этап пройден с задержкой — красный;
• этап пройден вовремя — зелёный;
• этап начат — оранжевый;
• этап не начат — серый.

Логика работы приложения

• Для реализации прикладной задачи мы создадим следующие сущности (см. «Исходные данные»):
  • шаблон записи «Магазины», в котором будут храниться сведения о магазинах;
  • справочник этапов открытия магазинов — шаблон записи, который будет хранить записи с названиями и номерами этапов;
  • шаблон записи «Этапы», в котором будут храниться данные о прогрессе открытия каждого магазина:
    • при запуске процесса «Открытие магазина»_магазина стандартный набор этапов открытия магазина заполняется автоматически с помощью процесса «Копирование этапов из справочника»_;
    • этапы открытия конкретного магазина можно переименовать, добавить или удалить.
  • шаблон процесса «Копирование этапов из справочника», который будет создавать запись в шаблоне «Этапы» и копировать в неё название и номер этапа из справочника этапов;
  • шаблон процесса «Открытие магазина», который будет вызывать процесс «Копирование этапов из справочника» для каждого этапа из справочника, чтобы скопировать названия и номера этапов в список этапов открытия конкретного магазина_._ Кроме того, в каждый этап открытия магазина процесс поместит ссылку на соответствующий этап в справочнике.
• На форме «Прогресс открытия магазина» в шаблоне «Магазины» мы разместим шевроны, связанные с шаблоном записи «Этапы».
• Пользователь может указать прогресс выполнения каждого этапа с помощью формы «Прогресс открытия магазина».
• Шевроны на форме «Прогресс открытия магазина» будут окрашиваться в соответствии с прогрессом выполнения соответствующих этапов.

Исходные данные

Создайте приложение «Управление магазинами» и настройте перечисленные ниже шаблоны.

Справочник этапов

1. Создайте шаблон записи «Справочник этапов» с системным именем Справочникэтапов.

2. Создайте следующие атрибуты в этом шаблоне:

   Название атрибута	Свойства
   Название этапа	Тип данных: текст Формат отображения: обычный текст Использовать как заголовок записей: флажок установлен
   Номер этапа	Тип данных: число Количество знаков после запятой: 0

3. В шаблоне создайте записи со следующими данными:

   Название этапа	Номер этапа
   Оценка	1
   ИК 1	2
   ИК 2	3
   Договор	4
   УФРС	5
   Предв. подготов. к откр.	6
   АПП	7

Шаблон записи «Этапы»

В этом вспомогательном шаблоне будут хранится скопированные из Справочника этапов данные об этапах для каждой записи в шаблоне «Магазины».

1. Создайте шаблон записи «Этапы».

2. Создайте в шаблоне _«Этапы»_следующие атрибуты:

   Название атрибута	Свойства
   Название этапа	Тип данных: текст Формат отображения: обычный текст Использовать как заголовок записей: флажок установлен
   Номер этапа	Тип данных: число Количество знаков после запятой: 0
   Этап начат	Тип данных: логический Системное имя: Этапначат
   Этап пройден	Тип данных: логический Системное имя: Этаппройден
   Этап пройден вовремя	Тип данных: логический Системное имя: Этаппройденвовремя
   Этап из справочника	Тип данных: запись Формат отображения: гиперссылка Связанный шаблон:Справочник этапов Хранить несколько значений: флажок снят Взаимная связь с атрибутом: не используется

Шаблон процесса «Копирование этапов из справочника»

Этот вспомогательный шаблон будет служить для передачи данных из шаблона «Этапы» в процесс «Открытие магазина».

1. Создайте шаблон процесса со следующими свойствами:

   • Название: Копирование этапов из справочника
   • Связь с шаблоном записи: с имеющимся
   • Связанный шаблон: Этапы

2. Откройте вкладку «Диаграмма»

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

4. В меню элемента начального события выберите пункт «Сценарий на выходе».

   

5. Отобразится конструктор сценария.

6. Внутри действия «Сменить контекст» добавьте действие «Изменить значения атрибутов». См. «Сценарии. Создание вложенных действий».

7. В свойствах действия «Изменить значения атрибутов» настройте таблицу изменения значений атрибутов следующим образом:

   Атрибут	Операция со значениями	Значение
   Название этапа	Заменить	Этапы → Название этапа
   Номер этапа	Заменить	Этапы → Номер этапа

8. Должен получиться сценарий, показанный на следующей иллюстрации:

   

9. Чтобы вернуться из конструктора сценария к конструктору диаграммы процесса, нажмите кнопку «Назад» в браузере.

10. Проверьте и опубликуйте диаграмму процесса «Копирование этапов из справочника».

Шаблон записи «Магазины»

1. Создайте шаблон записи «Магазины».

2. Создайте в шаблоне «Магазины» следующие атрибуты:

   Название атрибута	Свойства
   Название магазина	Тип данных: текст Формат отображения: обычный текст
   Этапы открытия магазина	Тип данных: запись Формат отображения: гиперссылка Связанный шаблон:Этапы Хранить несколько значений: флажок установлен Взаимная связь с атрибутом: с новым Свойства нового атрибута: - Название: Магазин - Хранить несколько значений: флажок снят

Шаблон процесса «Открытие магазина»

1. Создайте шаблон процесса со следующими свойствами:

   • Название: Открытие магазина
   • Связь с шаблоном записи: Связать с существующим
   • Связанный шаблон: Магазины

Настройка шаблона процесса «Открытие магазина»

Мы настроили заполнение данных по этапам, и теперь необходимо настроить вызов нашего процесса копирования

1. Откройте шаблон процесса «Открытие магазина».
2. Откройте вкладку «Диаграмма».
3. Перетащите на диаграмму элемент «Вызов процесса» (рекомендуется сразу после начального события).
4. В меню элемента выберите пункт «Свойства» ‌.
5. Отобразится окно «Свойства вызова процесса»

6. На вкладке «Основные» настройте параметры следующим образом:

   • Экспертные настройки: установите флажок
   • Шаблон для выборки объектов: Справочник этапов
   • Выражение для выборки объектов: from a in db->Справочникэтапов select a->id (выражение вернёт ID записей в справочнике этапов, по количеству которых будет запущен подпроцесс)
   • Режим выполнения: параллельный
   • Связь шаблона записи с процессом: через атрибут
   • Шаблон процесса: Копирование этапов из справочника
   • Записи, связанные с процессом: создавать новые
   • Атрибут связи: Этапы открытия магазина → Этап из справочника (в этот атрибут будет записываться ID этапа из справочника, возвращённый выражением для выборки объектов, для каждой созданной записи в шаблоне «Этапы»).

   

7. Выберите вкладку «Данные на входе».

8. Нажмите на кнопку «Добавить» и настройте сопоставление атрибутов подпроцесса и текущего процесса:

   • Атрибут шаблона записи подпроцесса: Магазин
   • Значение: ID

   В результате каждая запись, созданная процессом «Копирование этапов из справочника» будет связана с записью в шаблоне «Магазин», и благодаря взаимной связи в атрибуте «Этапы открытия магазина» будет записан набор идентификаторов записей из шаблона «Этапы».

9. Сохраните свойства элемента «Вызов процесса».

10. Проверьте и опубликуйте диаграмму процесса.

Настройка шевронов на форме «Прогресс открытия магазина»

1. Откройте шаблон «Магазины».
2. Выберите вкладку «Формы».
3. Откройте основную форму шаблона.
4. Присвойте области на форме название «Прогресс открытия магазина».
5. Перетащите атрибут «Этапы открытия магазина» в область «Прогресс открытия магазина».
6. На панели «Свойства поля» выберите представление «Шевроны».

7. Настройте свойства шевронов:

   • Упорядочивание: Номер этапа
   • Правила окраски записей: нажимайте «Создать» и настройте следующие правила:

   Цвет	Условие: формула
   Зелёный #31ff00	AND($Этапначат, $Этаппройденвовремя)
   Красный #ff0000	NOT($Этаппройденвовремя)
   Серый #c0c0c0	NOT($Этапначат)AND($Этапначат, $Этаппройденвовремя)
   Оранжевый #ff9800	AND($Этапначат, NOT($Этаппройден))

   Примечание

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

   • Следует помнить, что условие окрашивания шеврона вычисляется в контексте шаблона, связанного с текущим шаблоном посредством с атрибута типа «Запись». Поэтому обратиться к атрибутам текущего шаблона, на форме которого размещены шевроны, можно только посредством обратной ссылки. Например, к атрибуту «Название магазина» можно обратиться посредством атрибута «Магазин» из шаблона «Этапы»:

     $Magazin->Nazvaniemagazina 
     

8. Снова перетащите атрибут «Этапы открытия магазина» в область «Прогресс открытия магазина».

9. На панели «Свойства поля» выберите представление «Таблица».
10. В поле «Сортировка» на панели «Свойства таблицы» выберите атрибут «Номер этапа».

11. Вынесите в таблицу «Этапы открытия магазина» следующие атрибуты шаблона «Этапы» в качестве столбцов:

    • Магазин
    • Номер этапа
    • Название этапа
    • Этап начат
    • Этап пройден
    • Этап вовремя

12. Сохраните форму.

Проверка работы приложения

1. Откройте шаблон процесса «Открытие магазина».
2. Нажмите кнопку «Перейти к экземплярам».
3. Отобразится таблица «Все записи» со списком экземпляров процесса.
4. Создайте новый экземпляр процесса.
5. Подождите некоторое время, чтобы процесс выполнился.
6. Обновите список экземпляров, нажав кнопку «Обновить список» ‌.
7. Статус процесса должен смениться на «Завершен».
8. Из списка экземпляров процесса перейдите к связанной записи шаблона «Магазины» по ссылке в столбце «Запись».
9. Отобразится настроенная форма «Прогресс открытия магазина».
10. Расставьте флажки в таблице «Этапы открытия магазина».

11. Цвета шевронов должны меняться в зависимости от состояния флажков «Этап начат», «Этап пройден», «Этап пройден вовремя»:

    • серый цвет — установлен флажок «Этап начат»;
    • зелёный цвет — установлены все три флажка;
    • красный цвет — установлены флажки «Этап начат» и «Этап пройден».