TrainingMaterials 4 4 1 InternalStorage

Материал из RunaWFE
Перейти к навигации Перейти к поиску

RunaWFE. Практикум. Внутреннее хранилище данных.

Версия 4.4.2

© 2015-2021, ООО "Процессные технологии", материалы этого документа распространяются свободно на условиях лицензии GNU FDL. RunaWFE Free является системой с открытым кодом и распространяется в соответствии с LGPL лицензией (http://www.gnu.org/licenses/lgpl.html).


Введение

Практическое занятие "Разработка бизнес-процесса "Заказ автотранспорта"

Цель занятия

Целью занятия является изучение работы с внутренним хранилищем данных, представленным в виде Excel таблиц.

Теоретические сведения

"Внутреннее хранилище данных" - аналог таблиц базы данных, представленных в виде Excel файлов. Предназначено для централизованного хранения переменных бизнес-процесса.

Для работы с внутренним хранилищем в RunaWFE Free используется специальный элемент палитры - "Хранилище данных", связанный с задачей сценарий. Выбор обработчика в задаче сценария выполняется автоматически. Установка конфигурации обработчика выполняется в зависимости от способа связи с иконкой базы данных в нотации BPMN. При связи “обработчик -> иконка” в конфигурации доступны 3 операции: insert, delete, update. При связи “иконка -> обработчик” в конфигурации доступна только операция select. Таблице Excel соответствует используемый тип переменной с установленным признаком "Таблица БД".

Подробности использования обработчика, его параметры и возможные действия над хранилищем будут рассмотрены на практическом занятии при разработке бизнес-процесса "Заказ автотранспорта"

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

В данной работе рассматривается разработка упрощенного варианта бизнес-процесса заказа автотранспорта для организации располагающей собственным автопарком.


Описание бизнес-процесса.

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

Диспетчер автопарка получает из внутреннего хранилища все необработанные заявки и выполняет отбор тех, которые будут удовлетворены. Заявки отображаются в виде таблицы с информацией от кого поступила заявка и с возможностью сортировки по полям. Благодаря этому диспетчер может в первую очередь удовлетворить более приоритетные заявки.

После удовлетворения, заявка переносится в архив, заказчик получает задачу "Ознакомиться с запланированной заявкой", а "Гараж" должен отчитаться о выполненном рейсе.


Разработка бизнес-процесса.

  1. Запустите RunaWFE симулятор, для этого дважды кликните по ярлыку «Start Simulation» на рабочем столе, или выполните команду меню Пуск / Программы / RunaWFE Free/ Start Simulation. (Подробнее см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 1)
  2. Войдите в web-интерфейс системы RunaWFE Free под пользователем Administrator. (см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 2, Рис. 5.2) Замечание. По умолчанию пароль пользователя Administrator - "wf".
  3. Создайте следующих пользователей: (см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункты 10 - 11, Рис. 5.10 - 5.11)
  4. Замечание. Если данные пользователи уже существуют в системе т.е. были созданы в предыдущих работах, то данный пункт можно пропустить
    • Жуков Иван Ильич
    • Андреев Николай Викторович
    • Паучков Петр Петрович
    • Иванов Иван Иванович
    • Гусеницын Михаил Васильевич
    • Личинкин Василий Федорович
    • Сергеев Николай Иванович
    • Сверчков Иван Иванович
    При создании, введите пароль для каждого пользователя (например - 123), знать старый пароль пользователя при этом не требуется (см. Практическое занятие "Изучение перспективы ресурсов", Порядок выполнения работы, Пункты 4 - 5, Рис. 3.1, 3.2).
  5. Создайте группы (см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункты 4 - 6, Рис. 5.5, 5.6)
    • Гараж
    • Канцелярия
    • Диспетчеры
    • Сотрудники
  6. Добавьте пользователей в группы
  7. группа "Гараж":
    • Иванов Иван Иванович
    группа "Канцелярия":
    • Гусеницын Михаил Васильевич
    • Личинкин Василий Федорович
    группа "Диспетчеры":
    • Сергеев Николай Иванович
    при этом все пользователи должны входить в группу "Сотрудники":
    • Жуков Иван Ильич
    • Андреев Николай Викторович
    • Паучков Петр Петрович
    • Иванов Иван Иванович
    • Гусеницын Михаил Васильевич
    • Личинкин Василий Федорович
    • Сергеев Николай Иванович
    • Сверчков Иван Иванович
  8. Дайте полномочия группе "Сотрудники" на вход в систему (см. "Практикум. Вводное занятие", пункты 7-9, Рис. 5.7 - 5.9 )
  9. Перейдите к пункту меню "Отношения" по ссылке «Отношения» в левой части экрана (см. раздел "Стандарты и концепции, связанные с СУБПиАР", пункт "Использование бинарных отношений для упрощения инициализации ролей")
  10. Кликните по ссылке "Создать отношение"
  11. Zak 1.png
    Рисунок 2.1 Команда создания отношения


  12. В появившейся форме введите имя отношения ("Руководитель организации") и необязательное описание. После этого кликните на "Создать"
  13. Zak 2 st.png
    Рисунок 2.2 Ввод названия отношения


  14. Кликните на имени появившейся записи
  15. Zak 3.png
    Рисунок 2.3 Редактирование отношения


  16. В появившейся форме кликните на "Создать пару". В левой части пары выберите пользователя "Сверчков", в правой части пары выберите группу "Сотрудники".
  17. Это будет означать, что пользователь Сверчков является руководителем для всех пользователей входящих в группу Сотрудники.
    Zak 4.png
    Рисунок 2.4 Создание пары (Сверчков-Сотрудники)


  18. Откройте среду разработки
  19. Создайте новый проект "Занятие 11"
  20. Для реализации задачи заказа автотранспорта, потребуется разработать два бизнес-процесса.
    • "Заявка" - процесс, предназначенный непосредственно для подачи заявки на авто
    • "Планирование" - процесс, с помощью которого диспетчер будет обрабатывать поданные заявки
    Бизнес-процесс "Заявка"
  21. Создайте новый процесс "Заявка"
  22. Добавьте элементы на схему бизнес-процесса в соответствии с рисунком 2.5
  23. Zak 5 441.png
    Рисунок 2.5 Схема бизнес-процесса "Заявка"


    В бизнес-процессе используется следующие элементы: Начало, Действие, Задача сценария, Хранилище данных, Переход, Пунктирный переход, Таймер, Исключающий шлюз, Параллельный шлюз, Аннотация, Окончание.

    Для элемента "Задача сценария" используйте опцию компактный вид (см. пункт 1 раздела "Практическое занятие "Работа с Word-ботом". Порядок выполнения работы.",Замечание. рис. 2.2)

    Для изменения названий по умолчанию, выделите элемент, кликнув по нему, перейдите в свойства и введите новое значение в поле "Название".

    Для связи задачи сценария с иконкой хранилища данных используется специальный пунктирный переход.


  24. Создайте роли (См. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 21, Рис 5.21)
  25. В разрабатываемом процессе используются следующие Роли:
    • Заказчик
    • Канцелярия
    • Гараж
    • Руководитель
  26. Инициализируйте роли
  27. Роль "Заказчик" будет инициализирована пользователем, запустившим процесс, не требует инициализатора. Роли "Канцелярия" и "Гараж" должны быть проинициализирована группами "Канцелярия" и "Гараж" соответственно. Выделите созданную роль, нажмите "Изменить", перейдите на вкладку "Группы и пользователи WF". Здесь необходимо выполнить синхронизацию с сервером, после чего "Выбрать" из списка нужную группу (см. Рис. 2.6). Для проверки и ввода параметров соединения с сервером воспользуйтесь ссылкой "Настройки соединения" (см. Практическое занятие "Изучение перспективы ресурсов", Пункт 26, Рис. 3.16-3.18)
    Zak 6.png
    Рисунок 2.6 Инициализатор роли "Канцелярия"

    Инициализируйте роль "Руководитель" отношением "Руководитель организации", примененным к роли "Заказчик":

    Для этого выделите "Руководитель" в списке ролей на вкладке "Роли" и кликните "Изменить"

    В появившейся форме перейдите на вкладку "Задать роль с помощью отношения". Нажмите на "Синхронизация", затем "Выбрать" (См. Рис 2.7)

    Zak 7.png
    Рисунок 2.7 Инициализация с помощью отношения

    В списке будут отображаться импортированные с сервера отношения, выберите "Руководитель организации" и нажмите "ОК" (См. Рис. 2.8)

    Zak 8.png
    Рисунок 2.8 Окно выбора отношения

    Откройте список для поля "Параметр отношения" и выберите роль "Заказчик" (См. Рис. 2.9). Нажмите "ОК"

    Zak 9.png
    Рисунок 2.9 Инициализация роли Руководитель с помощью отношения


  28. Свяжите роли с узлами на графе
  29. Роль «Заказчик» с узлами "Начало", "Ознакомиться с отказом" и "Ознакомиться с запланированной заявкой" (Подробнее см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 22). Остальные роли свяжите с узлами в соответствии с рисунком 2.5
  30. Создайте новый тип данных
  31. Заявка будет состоять из следующего набора данных:
    • "id" - идентификатор заявки (Строка)
    • "ФИО заказчика" (Строка)
    • "Тип авто" (Строка)
    • "Количество мест" (Целое число)
    • "С" - Дата/время подачи авто (Дата/Время)
    • "По" - Дата/время окончания рейса (Дата/Время)
    • "Статус" (Строка)
    Эти данные удобно использовать в виде полей переменной пользовательского типа. Перейдите на вкладку "Типы данных", нажмите "Создать" в области "Типы данных" В появившемся окне введите название типа - "Заявка", а также установите опцию "Таблица БД", нажмите "OK" Таким образом тип "Заявка" может быть использован в обработчике внутреннего хранилища.
    Zak 10 441.png
    Рисунок 2.10 Создание нового типа


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


    Zak 11.png
    Рисунок 2.11 Добавление атрибута


    В появившемся окне введите название атрибута и нажмите "OK". Форма создания атрибута не отличается от формы создания переменной.

    Создайте все атрибуты заявки:


    Zak 12.png
    Рисунок 2.12 Атрибуты заявки

    По заданию, заявка после обработки должна быть помещена в архив. Таким образом потребуется создать еще один тип данных с признаком таблицы БД - "Архивная заявка". Выделите тип данных "Заявка" и нажмите "Копировать", затем "Вставить". В появившемся окне введите название переменной "Архивная заявка", и также установите признак "Таблица БД"

    Zak 12 2 441.png
    Рисунок 2.13 Копирование типа данных


  32. Создайте переменные
    • "Заявка" - переменная пользовательского типа "Заявка"
    • "Архивная заявка" - переменная пользовательского типа "Заявка"
    • "Заявки" - переменная формата Список(Заявка)
    • "Комментарий заказчика" - переменная формата "Текст"
    • "Комментарий руководителя" - переменная формата "Текст"
    • "Комментарий канцелярии" - переменная формата "Текст"
    Zak 13 441.png
    Рисунок 2.14 Переменные процесса Заявка

    Для создания переменной перейдите на вкладку "Переменные" и нажмите "Создать". В появившейся форме введите название переменной, нажмите "Далее" и выберите ее формат (Подробнее см. "Практикум.Перспективы исполнимых бизнес-процессов", Практическое занятие "Изучение перспективы данных", Порядок выполнения работы, Пункт 5).


  33. Создайте графические формы
  34. Замечание. По умолчанию в качестве редактора форм используется CKEditor4, но в случае если у вас в системе установлен браузер Microsoft Internet Explorer устаревшей версии - 6 (IE6) или 7 (IE7), то с формами могут возникнуть проблемы. Поэтому следует переключить редактор на FCKEditor2 (как переключить редактор см. в Практическое занятие "Изучение перспективы данных", Порядок выполнения работы, Пункт 6, Рис. 4.9, 4.10) Стартовая форма На данной форме заказчик вводит данные заявки Выделите узел «Начало» графа процесса "Заявка" правой кнопкой мыши и выберите команду «Форма» > «Создать форму» (Подробнее см. Практическое занятие "Изучение перспективы данных", Порядок выполнения работы, Пункт 6, Замечание, Рис. 4.11-4.12). На данной форме заказчик вводит данные заявки на автотранспорт. Добавьте на форму текст "Введите данные заявки". Нажмите на иконку вставки в форму таблицы (см. рис. 2.15), используйте 2 столбца и 4 строки (см. рис. 2.16). Расположите таблицу под текстом "Введите данные заявки".
    Zak 14.png
    Рисунок 2.15 Вставка таблицы на форму


    Zak 15.png
    Рисунок 2.16 Свойства таблицы


    Заполните колонки таблицы как показано на рисунке 2.17. Во втором столбце используйте компонент формы "Ввод переменной". Для этого перейдите на вкладку "Компоненты форм", выделите необходимый компонент, в данном случае это "Ввод переменной" и с помощью мыши перетащите его на форму (Подробнее см. Практическое занятие "Изучение перспективы операций", Порядок выполнения работы, Пункт 14, Рис. 5.17, 5.18).


    Замечание. Альтернативным способом добавления на форму может быть двойной клик левой клавишей мыши по компоненту, после чего он будет добавлен в текущее положение курсора на форме.


    Для вызова свойств добавленного на форму компонента используйте двойной клик левой клавишей мыши или пункт "Параметры компонента" контекстного меню (вызывается правой клавишей мыши).

    В качестве параметра "Название переменной" задайте соответствующие поля переменной пользовательского формата "Заявка" (см. рис. 2.18)


    Zak 16 st.png
    Рисунок 2.17 Заполненная таблица ввода данных заявки


    Zak 17.png
    Рисунок 2.18 Ввод полей пользовательской переменной "Заявка"


    Расположите под таблицей компонент для ввода переменной "Комментарий заказчика"


    Zak 18 st.png
    Рисунок 2.19 Стартовая форма процесса "Заявка"


    Сохраните и закройте форму.


    Задайте валидацию для переменных стартовой формы


    Для этого кликните на стартовой форме правой клавишей мыши и выберите пункт "Форма > Проверка переменных формы", в появившейся форме выделяйте переменные и устанавливайте необходимые валидаторы. (Подробнее см. Практическое занятие "Изучение перспективы операций", Пункт 15, рис. 5.27, 5.28).

    Для "Заявка.Тип авто" добавьте валидатор "Обязательное поле". В поле "Сообщение об ошибке" введите - "Обязательное поле".

    Для "Заявка.Количество мест" добавьте валидатор "Обязательное поле", а также "Диапазон числа" установив минимальное значение в "1" включительно (см. Рис. 2.20), при этом в поле "Сообщение об ошибке" введите - "Должно быть задано минимум одно место"

    Для "Заявка.С" добавьте валидатор "Обязательное поле", а также "Диапазон даты относительно текущей" установив параметр "Сдвиг в прошлое" в значение "0" (см. Рис. 2.21), при этом в поле "Сообщение об ошибке" введите - "Дата подачи авто не может быть в прошлом"

    Для "Заявка.По" используйте такие же валидаторы как и для "Заявка.С"


    Zak 19 st.png
    Рисунок 2.20 Валидатор "Диапазон числа" для "Заявка.Количество мест"


    Zak 20 st.png
    Рисунок 2.21 Валидатор "Диапазон даты относительно текущей" для "Заявка.С"


    Кроме того, необходимо добавить глобальный валидатор для проверки условия "Дата/время окончания рейса должны быть позже даты/времени подачи авто". Для этого перейдите на вкладку "Глобальные валидаторы", затем "Добавить". В поле сообщение об ошибке введите "Дата/время окончания рейса должны быть позже даты/времени подачи авто", а в конфигураторе задайте

    Заявка.По позже Заявка.С
    


    Zak 21 st a.png
    (а)
    Zak 21 st b.png
    (б)
    Zak 21 st c.png
    (в)
    Рисунок 2.22 а). переход б). добавление в). конфигуратор глобального валидатора


    Форма узла "Одобрить заявку"


    Создайте форму для узла "Одобрить заявку"

    Здесь руководитель просматривает заявку и вводит комментарий.


    Zak 21 st.png
    Рисунок 2.23 Форма "Одобрить заявку"


    Используйте компонент "Отобразить переменную" для вывода значений переменных "Заявка" и "Комментарий заказчика". В качестве вида отображения используйте "Как неактивный компонент ввода"


    Zak 22.png
    Рисунок 2.24 Компонент "Отобразить переменную"


    Создайте аналогичным образом остальные формы.


    Zak 23.png
    Рисунок 2.25 Форма "Принять заявку"


    Zak 24.png
    Рисунок 2.26 Форма "Ознакомиться с отказом"


    Zak 25.png
    Рисунок 2.27 Форма "Ознакомиться с запланированной заявкой"


  35. Выберите класс обработчиков и задайте конфигурации
  36. Задача сценария "Получить ФИО заказчика" Необходима для получения ФИО заказчика. Выделите задачу сценария (см. рис. 2.28), введите в свойство "Название" - "Получить ФИО заказчика"
    Zak 26.png
    Рисунок 2.28 Задача сценария "Получить ФИО заказчика"


    Выберите в качестве класса обработчика - "Получить информацию об исполнителе" (см. Рис. 2.29).


    Zak 27.png
    Рисунок 2.29 Выбор класса обработчика для задачи "Получить ФИО заказчика"


    Вызовите конфигуратор обработчика. Для этого нажмите на выбор конфигурации в свойствах задачи сценария. И введите параметры как показано на рисунке 2.30


    Zak 28.png
    Рисунок 2.30 Конфигурация задачи сценария "Получить ФИО заказчика"


    Задача сценария "Сформировать id заявки"

    Задача предназначена для формирования id подаваемой заявки. Данный идентификатор является уникальным и фактически равен id запущенного экземпляра процесса "Заявка". Кроме того, в данной задаче инициализируется статус заявки ("Не обработана").

    Выберите в качестве класса обработчика - "Выполнить формулу" (см. Рис. 2.31).


    Zak 29.png
    Рисунок 2.31 Выбор класса обработчика для задачи "Сформировать id заявки"


    Задайте конфигурацию:

    Заявка.id=get_process_id()
    Заявка.Статус="Не обработана"
    


    Zak 30.png
    Рисунок 2.32 Конфигурация задачи "Сформировать id заявки"


    Задача сценария "Получить заявку из списка"

    После подачи заявка записывается во внутреннее хранилище данных (Excel файл) со статусом "Не обработана", далее выполняется периодическое ее считывание из внутреннего хранилища для проверки статуса, зная ее id. При этом результат считывания из внутреннего хранилища всегда является списком (даже если считывается одна конкретная заявка по ее id). Поэтому дополнительно используется специальный обработчик для получения элемента списка, в данном случае заявки из списка заявок.

    Выделите задачу сценария как показано на рисунке 2.33 и перейдите в ее свойство. Здесь выберите в качестве класса обработчика - "Получить элемент списка". Задайте конфигурацию как показано на рисунке 2.34.


    Zak 31 441.png
    Рисунок 2.33 Свойства задачи "Получить заявку из списка"


    Zak 32.png
    Рисунок 2.34 Конфигурация задачи "Получить заявку из списка"


    Задача сценария "Копирование переменной Заявка в Архивная заявка"

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

    Zak 33 2 441.png
    Рисунок 2.35 Конфигурация задачи "Копирование переменной Заявка в Архивная заявка"


    В остальных задачах сценария используется обработчик для работы с внутренним хранилищем. Подробная работа с внутренним хранилищем будет описана в последующих пунктах.


  37. Задайте задержку для Таймера
  38. В процессе "Заявка" используется таймер для установки периода считывания заявки из внутреннего хранилища. Кликните по таймеру правой клавишей мыши и выберите пункт "Задержка"
    Zak 34 441.png
    Рисунок 2.36 Вызов контекстного меню на элементе Таймер


    Настройте задержку Таймера в соответствии с рисунком 2.37


    Zak 35.png
    Рисунок 2.37 Задержка таймера


  39. Добавьте конфигурацию исключающего шлюза
  40. В цикле опроса заявки с проверкой на предмет изменения ее статуса используется исключающий шлюз. Вызовите конструктор. Для этого кликните правой клавишей мыши по элементу и выберите пункт "Конфигурация". Это же можно сделать и через свойства элемента.
    Zak 36 441.png
    Рисунок 2.38 Вызов конструктора конфигурации исключающего шлюза


    Задайте путь по умолчанию "Считать заявку", а условием выхода из цикла по переходу "заявка обработана" будет изменение статуса заявки.

    "Заявка.Статус" не равно "Не обработана"
    


    Zak 37.png
    Рисунок 2.39 Конфигурация исключающего шлюза


    Остальные элементы бизнес-процесса "Заявка" будут описаны в последующих пунктах данной части практикума.


    Бизнес-процесс "Планирование"


  41. Создайте новый процесс "Планирование"
  42. Добавьте элементы на схему бизнес-процесса в соответствии с рисунком 2.40
  43. Zak 38 441.png
    Рисунок 2.40 Схема бизнес-процесса "Планирование"


    Данный процесс запускает диспетчер. Выполняется считывание из внутреннего хранилища всех заявок со статусом "Не обработана". Если такие есть, то они отображаются для диспетчера в виде таблицы с возможностью выбора тех, которые он желает запланировать. Информация по запланированным заявкам обновляется во внутреннем хранилище. Далее цикл считывания необработанных заявок повторяется.

    Здесь используется тот же набор элементов что и для процесса "Заявка".

  44. Создайте роли (См. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 21, Рис 5.21)
  45. В разрабатываемом процессе используются следующие Роли:
    • Диспетчер
    Роль "Диспетчер" будет инициализирована пользователем, запустившим процесс, не требует инициализатора.
  46. Свяжите роли с узлами на графе в соответствии с рисунком 2.40
  47. Подробнее см. "Практикум. Вводное занятие", Порядок выполнения работы, Пункт 22
  48. Создайте переменные
  49. Откройте процесс "Заявка", перейдите на вкладку "Переменные", выделите переменную "Заявка" и нажмите кнопку "Копировать" (см. Рис. 2.41)
    Zak 39.png
    Рисунок 2.41 Копирование переменной


    Вернитесь в разрабатываемый процесс "Планирование", перейдите на вкладку "Переменные" и нажмите "Вставить" (см. Рис. 2.42)


    Zak 40.png
    Рисунок 2.42 Вставка переменной


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


    Создайте остальные переменные:

    • "Все заявки" - переменная формата Список(Заявка), будет содержать считанные из внутреннего хранилища необработанные заявки
    • "Отобранные заявки" - переменная формата Список(Заявка), будет содержать отобранные диспетчером заявки
    • "Количество заявок" - переменная формата "Целое число", хранит количество заявок
    • "индекс заявки" - переменная формата "Целое число", используется для хранения индекса обрабатываемой заявки


    Zak 41.png
    Рисунок 2.43 Переменные процесса "Планирование"


  50. Создайте графические формы
  51. Замечание. По умолчанию в качестве редактора форм используется CKEditor4, но в случае если у вас в системе установлен браузер Microsoft Internet Explorer устаревшей версии - 6 (IE6) или 7 (IE7), то с формами могут возникнуть проблемы. Поэтому следует переключить редактор на FCKEditor2 (как переключить редактор см. в Практическое занятие "Изучение перспективы данных", Порядок выполнения работы, Пункт 6, Рис. 4.9, 4.10) Отобрать заявки На данной форме заказчик отбирает заявки которые будут запланированы. Выделите узел «Отобрать заявки» графа процесса "Планирование" правой кнопкой мыши и выберите команду «Форма» > «Создать форму» (Подробнее см. Практическое занятие "Изучение перспективы данных", Порядок выполнения работы, Пункт 6, Замечание, Рис. 4.11-4.12). Добавьте на форму текст "Выберите заявки для обработки:", под которым расположите компонент "Множественный выбор из списка пользовательских переменных" Для этого перейдите в панель "Компоненты форм", выделите компонент "Множественный выбор из списка пользовательских переменных" и с помощью мыши перетащите его на форму (Подробнее см. Практическое занятие "Изучение перспективы операций", Порядок выполнения работы, Пункт 14, Рис. 5.17, 5.18). Замечание. Альтернативным способом добавления на форму может быть двойной клик левой клавишей мыши по компоненту, после чего он будет добавлен в текущее положение курсора на форме. Замечание. Существует два компонента для множественного выбора. Один используется для списка простых переменных, другой для списка пользовательских переменных. В данном случае необходим множественный выбор из списка именно пользовательских переменных.
    Zak 42.png
    Рисунок 2.44 Форма узла "Отобрать заявки"


    Для вызова свойств добавленного на форму компонента используйте двойной клик левой клавишей мыши или пункт "Параметры компонента" контекстного меню (вызывается правой клавишей мыши).

    Заполните параметры компонента как показано на рисунке 2.45

    Замечание. Набор параметров компонента может отличаться в зависимости от используемой версии RunaWFE Free.


    а. Zak 43.png


    б. Zak 43 b.png
    Рисунок 2.45 Параметры множественного выбора из списка пользовательских переменных: а - версия 4.2.1- и ниже; б - версия 4.3.0+;


    Описание параметров:

    • "Входные данные" - это список из элементов которого выполняется отбор. В данном случае это все необработанные заявки - переменная "Все заявки"
    • "Название переменной" - это список в который будут сохранены отобранные элементы списка, указанного в параметре "Входные данные"
    • "Форма отображения" - используйте вариант отображения - "Двумерная таблица" (в версии RunaWFE Free 4.2.1 и ниже)

    Замечание. В версии RunaWFE Free 4.3.0 данный параметр поменял свое назначение, теперь это не форма таблицы (используется классическая двумерная таблица), а вид отображения значений. Предлагается выбрать между "Как неактивный компонент ввода" и "Как строка".

    • "Поле используемое для сортировки" (параметр отсутствует в версии RunaWFE Free 4.3.0) - критерий для предварительной сортировки таблицы. Используйте сортировку по "ФИО заказчика"

    Замечание. В новой версии компонента (RunaWFE Free 4.3.0) появилась возможность выбора полей для отображения в таблице и их позицию. Нажмите кнопку "..." в строке "Атрибуты" (см. рисунок 2.44б). В появившемся окне выделите все поля кроме "id" (диспетчеру не обязательно знать id заявки, поэтому выводить значение этого поля не обязательно), нажмите "Добавить".


    В веб интерфейсе компонент будет представлен в виде двумерной таблицы с отображением списка заявок. Диспетчер отбирает заявки проставляя галочки напротив соответствующей строки таблицы.


    Запланировать заявки


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


    Zak 44.png
    Рисунок 2.46 Форма узла "Запланировать заявки"


    Двойным кликом мыши или с помощью контекстного меню перейдите в параметры компонента и заполните их как показано на рисунке 2.47. Используйте вариант "а" в случае версии RunaWFE Free 4.2.1 и ниже, или вариант "б" в случае версии RunaWFE Free 4.3.0


    а. Zak 45.png
    б. Zak 45 b.png
    Рисунок 2.47 Параметры компонента "Отобразить список пользовательских переменных": а - версия 4.2.1- и ниже; б - версия 4.3.0+;


    В web интерфейсе данный компонент будет представлен в виде двумерной таблицы, содержащей отобранные диспетчером заявки.


    Обрабатывать еще заявки?


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


    Zak 46.png
    Рисунок 2.48 Узел "Обрабатывать еще заявки?"


    Zak 47.png
    Рисунок 2.49 Форма узла "Обрабатывать еще заявки?"


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


  52. Выберите класс обработчиков и задайте конфигурации
  53. Задача сценария "Определить количество заявок" Необходима для определения количества необработанных заявок, считанных из внутреннего хранилища. Выделите задачу сценария (см. рис. 2.50), введите в свойство "Название" - "Определить количество заявок" Выберите в качестве класса обработчика - "Агрегатная функция над списком" (см. Рис. 2.50).
    Zak 49 441.png
    Рисунок 2.50 Задача сценария "Определить количество заявок"


    Вызовите конфигуратор обработчика. Для этого нажмите на выбор конфигурации в свойствах задачи сценария. И введите параметры как показано на рисунке 2.51


    Zak 49.png
    Рисунок 2.51 Конфигурация обработчика задачи сценария "Определить количество заявок"


    Для определения количества элементов в списке используется функция "COUNT".


    Задача сценария "Определить количество отобранных заявок"

    Аналогичным образом выберите класс обработчика и добавьте конфигурацию для задачи сценария "Определить количество отобранных заявок". Но в данном случае определяется количество элементов в списке "Отобранные заявки"


    Zak 50.png
    Рисунок 2.52 Конфигурация обработчика задачи сценария "Определить количество отобранных заявок"


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


    Задача "Инициализация индекса заявки"

    Используется перед началом цикла, устанавливает индекс на последний элемент списка (обход заявок в обратном порядке). Выберите "Выполнить формулу" в качестве класса обработчика. Задайте конфигурацию:

    'индекс заявки'='Количество заявок';
    


    Zak 51.png
    Рисунок 2.53 Задача сценария "Инициализация индекса заявки"

    Используйте переменные "индекс заявки" и "Количество заявок"


    Задача "Получить заявку из списка отобранных"

    Используется для получения заявки по индексу из списка отобранных заявок.

    Класс обработчика - "Получить элемент списка".


    Zak 52.png
    Рисунок 2.54 Задача сценария "Получить заявку из списка отобранных"


    Задача сценария "Изменить статус заявки"

    Предназначена для изменения статуса отобранной заявки с "Не обработана" на "Запланирована".

    Класс обработчика "Выполнить формулу", конфигурация:

    Заявка.Статус="Запланирована"
    


    Zak 53 441.png
    Рисунок 2.55 Задача сценария "Изменить статус заявки"


    Задача сценария "Индекс следующей заявки"

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

    Класс обработчика "Выполнить формулу", конфигурация:

    'индекс заявки'='индекс заявки'-1;
    


    Zak 54 441.png
    Рисунок 2.56 Задача сценария "Индекс следующей заявки"


  54. Задайте задержку для Таймера
  55. В процессе "Планирование" используется таймер для установки периода считывания необработанных заявок из внутреннего хранилища. Кликните по таймеру правой клавишей мыши и выберите пункт "Задержка". Установите задержу равной 10 секунд от даты прихода управления в состояние.
    Zak 55 441.png
    Рисунок 2.57 Настройка задержки таймера в процессе "Планирование"


  56. Добавьте конфигурацию для исключающих шлюзов
  57. Первый исключающий шлюз используется для проверки количества необработанных заявок, если их 0, то управление возвращается в задачу "Считать необработанные заявки", иначе идет по переходу "Отобрать заявки". Конфигурация шлюза представлена на рисунке 2.58
    Zak 56 441.png
    Рисунок 2.58 Конфигурация исключающего шлюза 1


    Второй исключающий шлюз используется для проверки количества отобранных диспетчером заявок, если диспетчер не отобрал ни одной заявки, то управление переходит в задачу "Обрабатывать еще заявки", иначе идет по переходу "Отобраны".

    Конфигурация шлюза представлена на рисунке 2.59


    Zak 57.png
    Рисунок 2.59 Конфигурация исключающего шлюза 2


    Третий исключающий шлюз используется в цикле обновления статуса запланированных заявок.

    Если индекс обрабатываемой заявки достиг нуля, то статус всех отобранных заявок обновлен и цикл завершается, управление идет по переходу "все заявки обновлены".

    Конфигурация шлюза представлена на рисунке 2.60


    Zak 58 441.png
    Рисунок 2.60 Конфигурация исключающего шлюза 3


    Остальные элементы бизнес-процесса "Планирование" будут описаны в последующих пунктах данной части практикума.




    Внутреннее хранилище данных.


    В качестве внутреннего хранилища данных о заявках используются Excel файлы. Строки соответствуют заявкам, а столбцы атрибутам заявки (id, Тип авто, Статус и т.д.).

    Например, на рисунке 2.61 представлен Excel файл с данными по четырем заявкам.


    Zak 59.png
    Рисунок 2.61 Пример содержимого файла внутреннего хранилища


    Для работы с данным хранилищем используется специальный обработчик, позволяющий выполнять простейшие действия с данными:


    Действие INSERT

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


    Действие SELECT

    Предназначено для чтения данных из хранилища, может быть использована с условием. Например, для выборки заявок с определенным статусом.

    Замечание. В качестве результата всегда возвращает список, даже если был получен только один элемент. Именно поэтому в процессе "Заявка", после чтения заявки по ее id, дополнительно используется обработчик "Получить элемент списка".


    Действие UPDATE

    Предназначено для обновления переменной в хранилище. Обязательно использование условия для определения переменной, которую требуется обновить (иначе будут обновлены все переменные во внутреннем хранилище).

    Например, в разрабатываемом процессе используется для обновления заявки после изменения ее статуса с "Не обработана" на "Запланирована", зная ее id.


    Действие DELETE

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

    Например, в разрабатываемом процессе используется для удаления заявки из основного внутреннего хранилища после ее переноса в архивное внутреннее хранилище.


    Замечания:

    • в момент выполнения обработчика, использующего одно из действий INSERT, DELETE, UPDATE, файлы внутреннего хранилища данных не должны быть открыты в системе, иначе действие не будет выполнено
    • во избежание проблем с форматом запрещается самостоятельно добавлять данные во внутреннее хранилище. Если есть необходимость использовать заранее заполненное хранилище, создайте для этого отдельный процесс, использующий соответствующий обработчик с действием (insert)
    • во время отладки БП рекомендуется останавливать ранее запущенные экземпляры процессов работающих с внутренним хранилищем,
    • во время отладки БП рекомендуется чистить файлы хранилища в случае изменения набора атрибутов или их имен в пользовательском типе используемом во внутреннем хранилище


    Каждому типу переменной с установленной опцией "Таблица БД", соответствует отдельный Excel файл, совпадающий с именем типа.

    По умолчанию файлы внутреннего хранилища данных сохраняются в директорию C:\Users\<Пользователь>\AppData\Roaming\runawfe\excelstorage, но путь можно изменить. Для этого нужно импортировать в среду разработки источник InternalStorage


    Zak int db 1.png
    Рисунок 2.62 Импорт источника внутреннего хранилища в Developer Studio


    Zak int db 2.png
    Рисунок 2.63 Выбор источника InternalStorage


    изменить путь


    Zak int db 3.png
    Рисунок 2.64 Изменение пути к директории с внутренним хранилищем


    и экспортировать его обратно.


    Zak int db 4.png
    Рисунок 2.65 Вызов диалога экспорта источника данных


    Zak int db 5.png
    Рисунок 2.66 Экспорт источника внутреннего хранилища на сервер


    В web интерфейсе RunaWFE Free есть возможность

    • посмотреть путь используемый для хранения файлов внутреннего хранилища,
    • отобразить файлы внутреннего хранилища,
    • скачать excel файлы внутреннего хранилища


    Для этого необходимо перейти в меню "Внутреннее хранилище" (доступен только пользователям входящим в группу Administrators)


    Zak int db 6.png
    Рисунок 2.67 Просмотр внутреннего хранилища в веб интерфейсе RunaWFE Free


    Как видно из рисунка 2.67, файлы внутреннего хранилища располагаются по пути C:\Users\ROMA\AppData\Roaming\runawfe\excelstorage, в хранилище расположены файлы "Заявка", "Архивная заявка". По клику на название файла, будет открыта страница с просмотром его содержимого в виде таблицы


    Zak int db 7.png
    Рисунок 2.68 Просмотр файла внутреннего хранилища


    По клику на имени файла в заголовке таблицы, есть возможность его загрузить.


  58. Откройте среду разработки
  59. Вернемся к использованию элемента внутреннего хранилища в среде разработки. Для использования внутреннего хранилища в БП необходимо расположить на графе элементы "Задача сценария" и "Хранилище данных", после чего соединить их с помощью специального пунктирного перехода в зависимости от необходимого действия.
    Zak int db 8.png


    Рисунок 2.69 Использование внутреннего хранилища для действий Insert/Update/Delete


    Zak int db 9.png


    Рисунок 2.70 Использование внутреннего хранилища для действия Select


    Задача "Добавить заявку в хранилище" в БП "Заявка"

    Данная задача предназначена для добавления заявки во внутреннее хранилище. Разместите на графе задачу сценария и иконку БД "Хранилище данных" соединив их пунктирным переходом (из задачи в иконку БД). Это приведет к автоматическому выбору необходимого обработчика. В конфигурации обработчика используйте действие - "Insert", тип данных - "Заявка", переменная с данными для вставки - "Заявка".


    Zak int db 10.png


    Рисунок 2.71 Конфигурация задачи "Добавить заявку в хранилище"


    Задача "Считать заявку из хранилища" в БП "Заявка"

    Данная задача предназначена для считывания заявки из хранилища данных по ее id (уникальному идентификатору). Разместите на графе задачу сценария и соедините ее с иконкой хранилища данных с помощью пунктирного перехода (из иконки БД в задачу). Это приведет к автоматическому выбору необходимого обработчика. В конфигурации обработчика будет доступно единственное действие - "Select". В качестве типа данных выберите тип "Заявка", а в результирующую переменную - переменную формата список - "Заявки".

    Замечание. Действие SELECT в качестве результата всегда возвращает список, даже если предполагается получить только один экземпляр пользовательской переменной (например заявку по ее уникальному идентификатору), поэтому тип результирующей переменной должен быть "Список".

    В данной задаче требуется получить из хранилища заявку по ее уникальному идентификатору, поэтому также необходимо добавить условие выборки: поле "id" таблицы должно соответствовать полю id переменной "Заявка"


    Zak int db 11.png


    Рисунок 2.71 Конфигурация задачи "Считать заявку из хранилище"


    Задача "Добавить заявку в хранилище архивных заявок" в БП "Заявка"

    Задача выполняет добавление заявки в архивное внутреннее хранилище. Процесс создания данной задачи аналогичен созданию задачи "Добавить заявку в хранилище". Отличие только в использовании другого типа данных - "Архивная заявка" и переменной для вставки - "Архивная заявка".


    Zak int db 12.png


    Рисунок 2.72 Конфигурация задачи "Добавить заявку в хранилище архивных заявок"


    Задача "Удалить обработанную заявку из хранилища" в БП "Заявка"

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

    Создайте конфигурацию задачи. Используйте действие DELETE с условием удаления заявки по ее идентификатору.


    Zak int db 13.png


    Рисунок 2.73 Конфигурация задачи "Удалить обработанную заявку из хранилища"


    Задача "Считать из хранилища необработанные заявки" в БП "Планирование"

    В бизнес процессе "Планирование" требуется считывать заявки со статусом "Не обработана". В конфигурации задачи используйте действие "Select", тип данных - "Заявка", результирующая переменная формата список - "Все заявки". В качестве условия используйте совпадение поля "Статус" в таблице хранилища с переменной "Статус", проинициализированной значением - "Не обработана".

    Zak int db 14.png


    Рисунок 2.74 Конфигурация задачи "Считать из хранилища необработанные заявки"


    Задача "Обновить заявку" в БП "Планирование"

    В процессе "Планирование" требуется обновить заявки в хранилище после обработки и изменения их статусов. Используйте действие "UPDATE" с условием - обновить заявку зная ее идентификатор.


    Zak int db 15.png


    Рисунок 2.75 Конфигурация задачи "Обновить заявку"


  60. Сохраните процессы и экспортируйте их на сервер WFE (Подробнее см. Практическое занятие "Изучение перспективы потока управления", Порядок выполнения работы, Пункты 11-14)
  61. Выполнение процессов: Замечание. Разработанные бизнес-процессы заказа автотранспорта могут выполняться некорректно в устаревших версиях браузера Internet Explorer (IE7 и ниже). Рекомендуется использовать актуальные версии современных браузеров.
  62. Откройте web интерфейс системы RunaWFE Free
  63. Войдите под пользователем Administrator, пароль – wf
  64. Дайте права на запуск процесса "Заявка" для группы "Сотрудники"
  65. Откройте "Запустить процесс", и перейдите в свойства определения бизнес-процесса "Заявка"
    Zak 86.png
    Рисунок 2.76 Переход в свойства определения бизнес-процесса


    Нажмите на ссылку "Обладатели полномочий".

    Дайте право на чтение и запуск процесса "Заявка" для группы "Сотрудники"


    Zak st 87 441.png
    Рисунок 2.77 Право на запуск бизнес-процесса для группы "Сотрудники"


  66. Дайте права на запуск, чтение, чтение экземпляра, а также остановку процесса "Планирование" для группы "Диспетчеры"
  67. Zak st 88 441.png
    Рисунок 2.78 Обладатели полномочий на бизнес-процесс "Планирование"


  68. Войдите в систему под пользователем Сергеев, входящим в группу "Диспетчеры"
  69. Запустите процесс "Планирование"
  70. Перейдите в "Запущенные процессы" и откройте только что запущенный экземпляр процесса "Планирование"
  71. Zak 91 441.png
    Рисунок 2.79 Цикл считывания необработанных заявок в экземпляре процесса "Планирование"


    Как видите, управление пришло в цикл считывания необработанных заявок и будет находиться здесь пока во внутреннее хранилище не добавят хотя бы одну заявку.


  72. Войдите в систему под пользователем входящим в группу "Сотрудники", например Жуков
  73. Запустите новый экземпляр процесса "Заявка"
  74. Введите данные заявки заказа автотранспорта и нажмите "Запустить"
  75. Zak 92.png
    Рисунок 2.80 Подача заявки на автотранспорт от Жукова


  76. Подайте еще пару заявок, например под пользователями Андреев и Паучков
  77. Zak 93.png
    Рисунок 2.81 Подача заявки на автотранспорт от Андреева


    Zak 94.png
    Рисунок 2.82 Подача заявки на автотранспорт от Паучкова


    Все заявки поступят руководителю организации.


  78. Войдите под пользователем Сверчков, являющимся руководителем организации
  79. Zak 95.png
    Рисунок 2.83 Поступившие на рассмотрение к руководителю организации заявки


  80. Откройте каждое из заданий, и одобрите заявки
  81. Zak 96.png
    Рисунок 2.84 Одобрение заявки руководителем


    Каждой заявке присвоен уникальный идентификатор id (равный id соответствующего экземпляра процесса "Заявка") и статус "Не обработана".

    Заявки будут направлены в канцелярию.


  82. Войдите под пользователем Гусеницын, входящим в группу "Канцелярия"
  83. Примите все заявки
  84. Zak 97.png
    Рисунок 2.85 Принятие заявки канцелярией


  85. Войдите на сервер WFE под пользователем Administrator (пароль wf)
  86. Откройте один из экземпляров процесса "Заявка"
  87. Zak 98 441.png
    Рисунок 2.86 Выполнение задачи добавления заявки на обработку


    Как видно, задача добавления заявки на обработку успешно выполнена.

    Управление пришло в цикл опроса статуса заявки.


  88. Откройте внутреннее хранилище данных "Заявка"
  89. Для этого перейдите в меню "Внутреннее хранилище" и выберите хранилище "Заявка"
    Zak 99 441.png
    Рисунок 2.87 Заявки во внутреннем хранилище


    Все три поданные заявки добавлены в хранилище.


  90. Войдите под диспетчером "Сергеев"
  91. Откройте задание "Отобрать заявки"
  92. Zak 100.png
    Рисунок 2.88 Задание "Отобрать заявки"


    Замечание. Периодичность проверки хранилища на предмет присутствия в нем необработанных заявок равна 10 секунд, первые 2 заявки были поданы как раз в течении этих 10 секунд, а 3-я позже. Именно поэтому, как видно из рисунка 2.106, диспетчеру отображаются только 2 заявки.


  93. Выберите обе заявки
  94. Для этого поставьте галочку напротив каждой из заявок и выполните задание.
    Zak 101.png
    Рисунок 2.89 Множественный выбор заявок


  95. Откройте полученное задание "Запланировать заявки"
  96. Нажмите "Запланировать заявки"
    Zak 102.png
    Рисунок 2.90 Задание "Запланировать отобранные заявки"


  97. Войдите под пользователем "Administrator"
  98. Откройте те экземпляры процесса "Заявка", заявки которых были отобраны и запланированы
  99. Проверьте, что управление вышло из цикла опроса статуса заявки и была выполнена задача переноса заявки в архив.
    Zak 104 441.png
    Рисунок 2.91 Выполнена задача переноса заявки в архив


  100. Откройте основное и архивное хранилище данных (Меню "Внутреннее хранилище данных")
  101. Убедитесь, что все запланированные заявки были перенесены из основного хранилища в архив.
    Zak 105 441.png
    Рисунок 2.92 Основное хранилище данных "Заявка"


    Zak 106 441.png
    Рисунок 2.93 Архив


    В основном хранилище должны остаться только те заявки, которые еще не запланированы диспетчером.


  102. Выполните активные задачи заказчиков и гаража: "Ознакомиться с запланированной заявкой", "Отчитаться о рейсе"
  103. Войдите под диспетчером "Сергеев" и выполните задачу "Обрабатывать еще заявки?", выбрав "Да"
  104. Zak 107.png
    Рисунок 2.94 Продолжить обработку заявок


    Если в основном хранилище к этому моменту еще остались заявки, то диспетчер получит соответствующие задания.

  105. Запланируйте оставшиеся заявки (если такие есть)

Задание для самостоятельной работы

Разработайте учебный вариант бизнес-процесса "Заказ канцтоваров" по следующему описанию.


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

  • "Экономный сотрудник" - товары, которые нужны для работы практически всем (ручка, карандаш, бумага и т.п.)
  • "Сотрудник" - товары, которые могут потребоваться сотруднику, но это происходит относительно редко (бокс для CD, булавки, калькулятор "Citizen" и т.п.)
  • "Отдел" - товары, которые предназначены не одному сотруднику, а сразу отделу (зарядное устройство для аккумуляторов, аккумуляторы пальчиковые, батарейки пальчиковые и т.п.)
  • "Фирменные материалы" - специальные товары, содержащие символику компании (блокнот А5 фирменный, конверт фирменный A4, конверт фирменный A5, пакет полиэтиленовый фирменный большой, портфель фирменный, ручка фирменная и т.п.)

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

По предоставленной информации работник склада решает - скомплектовать или отказать заказ.

В случае отказа:

  • работник склада должен ввести комментарий, содержащий причину отказа
  • товар должен быть удален из заказанных товаров
  • сотрудник, который заказывал товар должен получить задание "Ознакомиться с отказом" с отображением причины отказа

В случае решения скомплектовать заказ:

  • товары переносятся из хранилища "Заказанные товары" в новое хранилище представленное в виде Excel файла с названием "Архив скомплектованных заказов", на вкладку "Архив скомплектованных заказов"
  • на складе обновляются остатки по товарам, которые были скомплектованы
  • работник склада получает задание "Выдать товар"
  • сотрудник, который заказывал товар, получает задания "Ознакомиться - заказ скомплектован" и "Получить товар"

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

В отличие от практического занятия "Заказ автотранспорта", в данной работе требуется использовать не внутреннее, а внешнее хранилище данных.



Ниже представлены рекомендации по использованию внешнего хранилища.


"Внешнее хранилище данных" - аналог таблиц базы данных, представленных в виде Excel-листов. Предназначено для централизованного хранения данных бизнес-процесса. Для работы с внешним хранилищем в RunaWFE используется одноименный обработчик "Внешнее хранилище данных", который обеспечивает возможность выполнения простых действий: добавления, чтения, удаления и обновления данных.

Для работы с внешним хранилищем используйте отдельного бота "Бот работы с внешним хранилищем", с задачами использующими обработчик ru.runa.wfe.office.storage.handler.ExternalStorageHandler.


Возможные действия с внешним хранилище:


Действие INSERT

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


Действие SELECT

Предназначено для чтения данных из внешнего хранилища, может быть использована с условием. Например, для выборки заявок с определенным статусом.

Замечание. В качестве результата всегда возвращает список, даже если был получен только один элемент. Именно поэтому в процессе "Заявка", после чтения заявки по ее id, дополнительно используется обработчик "Получить элемент списка".


Действие UPDATE

Предназначено для обновления переменной пользовательского типа во внешнем хранилище. Обязательно использование условия для определения переменной, которую требуется обновить (иначе будут обновлены все переменные во внешнем хранилище).


Действие DELETE

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

Например, в разрабатываемом процессе используйте это действие для удаления товаров из заказанных товаров после их переноса в архив.


Для доступа к внешнему хранилищу, заведите новый Excel источник данных, который далее можно использовать в обработчике внешнего хранилища. Задайте путь к существующей директории, в которой будут храниться excel таблицы, например C:\runa_tmp\


Ext ds 1.png
Рисунок 2.95 Excel источник данных



Ниже представлены рекомендации по разработке БП.

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

Tov tab 1.png
Рисунок 2.96 Значок добавления вкладки


Каждое нажатие на данный значок приводит к добавлению новой вкладки на форму.

Tov tab 2.png
Рисунок 2.97 Добавленные на форму вкладки


Для редактирования названия вкладки:

  • кликните по вкладке
  • перейдите на страницу "Код"
  • измените необходимые названия
  • вернитесь на страницу "Дизайн" и сохраните форму
Tov tab 3.png
Рисунок 2.98 Вкладки с названиями по умолчанию
Tov tab 4.png
Рисунок 2.99 Редактирование названий вкладок

Используйте компонент "Редактирование списка пользовательских переменных". Выберите запрет на добавление и удаление элементов. Расположите компонент на каждой из вкладок соответствующей группы товаров. Отобразите остатки и заказанные товары на разных вкладках. Используйте компонент "Отобразить список пользовательских переменных".

Tov tab 5 b.png
Рисунок 2.100 Форма выбора товаров для заказа



Информация по заказанным товарам должна сохраняться во внешнем хранилище "Заказанные товары", и содержать следующие данные:

  • id экземпляра процесса заказа канцтоваров
  • название товара
  • количество

Информация о принадлежности к группе товаров в "Заказанные товары" - отсутствует.

Заказанными товарами являются только те товары, у которых значение в поле "Количество" больше "0".

Замечание. Т.к. состав данных "Склад" отличается от "Заказанные товары", то используйте два пользовательских типа "Товар" и "Заказанный товар" с соответствующим набором полей.

Замечание. Запрещается самостоятельно добавлять данные во внешнее хранилище, в случае необходимости, используйте для этого задачу бота с обработчиком "Внешнее хранилище данных", действие - insert.


На следующем рисунке изображена одна из возможных схем процесса заказа канцтоваров.

Tov sch.png
Рисунок 2.101 Схема бизнес-процесса "Заказ канцтоваров"


Поле "Количество" на форме выбора товаров для заказа должно быть по умолчанию равным 0, поэтому после считывания товаров со склада выполните обнуление. Оформите это в виде подпроцесса т.к. обнуление необходимо выполнить для всех групп товаров. Используйте подпроцесс для добавления группы заказанных товаров во внешнее хранилище.



Рассмотрим подробнее подпроцесс выполняющий обновление остатков товара на складе.

а.Tov 109 a.png
б.Tov 109 b.png
Рисунок 2.102 Схема подпроцесса "Обновление остатков товара на складе": а - цикл обхода скомплектованных товаров; б - внутренний подпроцесс-транзакция обновления остатков


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

Используйте обработчик "Агрегатная функция над списком" - COUNT для определения количества заказанных товаров.


Tov 110.png
Рисунок 2.103 Определение количества заказанных товаров


Далее организуйте цикл по товарам списка.

Заведите целочисленную переменную "индекс", определяющую индекс текущего обрабатываемого товара из списка заказанных товаров. Используйте для данной переменной значение по умолчанию "1".


Tov 111.png
Рисунок 2.104 Переменные подпроцесса "Обновить остатки на складе"


В цикле выполняются следующие действия:

  • с помощью обработчика "Получить элемент списка" по индексу выбирается очередной заказанный товар


Tov 112.png
Рисунок 2.105 Получение очередного товара из списка заказанных


  • вызывается внутренний подпроцесс-транзакция, в котором выполняется обновление остатков на складе
  • увеличивается индекс для выбора следующего товара


Условием выхода из цикла является обход всех заказанных товаров


Tov 121.png
Рисунок 2.106 Проверка условия "По всем ли заказанным товарам обновлены остатки на складе"


Обновление остатков товара выполняется в несколько шагов:

  • считывание текущего количества товара из внешнего хранилища ("Чтение") в переменную
  • вычитание количества заказанного товара из полученного текущего количества ("Модификация")
  • обновление остатка во внешнем хранилище ("Запись")

Т.к. процесс обновления состоит из трёх операций - "чтение", "модификация", "запись", то необходимо гарантировать чтобы во время выполнения этих действий, не было изменено текущее количество обрабатываемого товара, пока не выполнится запись нового значения.

Это достигается с помощью выноса действий в отдельную композицию со свойством "Транзакционный=Да", что обеспечивает блокировку задач бота используемого внутри композиции (в нашем случае это бот работы с внешним хранилищем), пока все точки управления не выйдут из нее.


Tov sub tr.png
Рисунок 2.107 Установка свойства "Транзакционный" для композиции


Для считывания текущего количества товара из внешнего хранилища используется задача бота с обработчиком "Внешнее хранилище данных", действие - SELECT.

Замечание. В качестве результата всегда возвращает список, даже если был получен только один элемент.


Tov 113.png
Рисунок 2.108 Параметры задачи "Считать товар со склада по названию"


Tov114 ed st 1.png
Рисунок 2.109 Конфигурация задачи "Считать товар со склада по названию"

Параметр "Входной файл" определяет Excel файл, выступающий в качестве внешнего хранилища. Выберите ранее созданный источник данных "PRODUCTS_XLS"

Под параметром "Выполняемое действие" расположено текстовое поле, предназначенное для ввода условия. Если его не задать, то SELECT выберет из внешнего хранилища все заявки.

Синтаксис условий следующий:

[имя атрибута] оператор значение
  • [имя атрибута] - это поле пользовательской переменной, заданной в параметре "Переменная" секции "Атрибут". Квадратные скобки у имени атрибута обязательны.
  • оператор - поддерживаются операторы < , > , <= , >= , != , == , like
  • значение - могут быть использованы как константное значение, например проверка статуса на равенство значению 'Не обработана', так и параметры используемые во входных параметрах задачи. Если используется параметр, то перед ним ставят символ @, например @id.

Кроме того, поддерживаются составные условия с применением скобок и логических операторов AND, OR.

Например, выполнить SELECT для заявок со статусом 'Не обработана', у которых 'Количество мест' больше или равно 10

[Статус] == 'Не обработана' AND [Количество мест] >= 10

Замечание. Важно соблюдать данный формат, включая наличие одинарных пробелов между операторами и атрибутами, значениями. Иначе условие не выполнится.


В данной задаче требуется получить со склада товары по их названию, поэтому используйте следующее условие:

[Название] == @название

где [Название] - это атрибут пользовательского типа "Заказанный товар", @название - это входной параметр задачи



С помощью агрегатной функции COUNT определяется количество элементов в полученном списке после выполнения SELECT


Tov 115.png
Рисунок 2.110 Определение количества элементов в списке считанных товаров по названию


Если count больше 0, т.е. на складе есть товар с таким названием, то выполняется выборка товара из списка


Tov 116.png
Рисунок 2.111 Конфигурация исключающего шлюза


Tov 117.png
Рисунок 2.112 Получение товара из списка товаров


Расчет нового значения поля "Количество" выполняется с помощью обработчика "Выполнить формулу"



Tov 118.png
Рисунок 2.113 Конфигурация обработчика "Выполнить формулу" для обновления количества товара на складе


Бот обновляет информацию по товару на складе


Tov 119.png
Рисунок 2.114 Параметры задачи бота "Обновить товар"


Tov120 ed st 1.png
Рисунок 2.115 Конфигурация задачи бота "Обновить товар"


Для правильной работы внутреннего подпроцесса-транзакции, на сервере должны быть выполнены следующие действия:


Замечание. Свойство "транзакционный" поддерживается, начиная с версии 4.4. Если у вас более ранняя версия, - пропустите установку этого свойства.


  • для бота "Бот работы с внешним хранилищем" должно быть установлено свойство "Транзакционный", "Таймаут привязки, минут - 1"
Tov bot tr.png
Рисунок 2.116 Установка свойства "Транзакционный"


  • "Бот работы с внешним хранилищем" должен обладать полномочиями "Читать" и "Читать экземпляры" БП "Заказ канцтоваров", а также БП "Обновить остатки на складе"
Tov def perm st.png
Рисунок 2.117 Добавление боту полномочий на БП

Требования к представлению результатов занятия

В результате выполнения лабораторной работы должны быть представлены преподавателю отчет, внешнее хранилище в виде Excel-листов, файл с данными archive.datafile (как получить файл данных), содержащий разработанные на занятии бизнес-процессы и бот для работ с внешним хранилищем.

В отчете должны содержаться следующие выходные данные:

1) Скриншоты основных действий, совершенных на занятии, с пояснениями

2) Скриншоты, содержащие маршруты точек управления для экземпляров бизнес-процессов, доведенных до завершения.

3) Описание возникших при выполнении задания проблем и найденных путей их решения (не обязательно, только если возникли проблемы при выполнении задания).

Контрольные вопросы

  1. Какие действия с внешним хранилищем можно выполнять с помощью обработчика "Внешнее хранилище данных" ?
  2. Почему работа с внешним хранилищем данных построена с помощью задач бота, а не задач сценариев? Объясните назначение опции бота - "Последовательное выполнение".
  3. Что такое внутренний подпроцесс-транзакция, в каком случае он используется?

Ссылки

  1. Документация Runa WFE [официальный сайт проекта]. URL: https://runawfe.ruДокументация