TrainingMaterials 4 4 ExternalStorage

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

Версия 4.6.0

© 2015-2023, ООО "Процессные технологии"

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

Цель занятия

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

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

Теоретические сведения по работе ботов изложены в первой части лабораторного практикума в пункте "Концепция ботов и бот-станций" раздела "Стандарты и концепции, связанные с СУБПиАР".

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

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

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

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

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

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

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

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

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

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

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




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




10. Кликните на имени появившейся записи
Рисунок 2.3 Редактирование отношения




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




12. Откройте среду разработки
13. Создайте новый проект "Занятие 11"
Для реализации задачи заказа автотранспорта, потребуется разработать два бизнес-процесса.
• "Заявка" - процесс, предназначенный непосредственно для подачи заявки на авто
• "Планирование" - процесс, с помощью которого диспетчер будет обрабатывать поданные заявки
Бизнес-процесс "Заявка"
14. Создайте новый процесс "Заявка"
15. Добавьте элементы на схему бизнес-процесса в соответствии с рисунком 2.5
Рисунок 2.5 Схема бизнес-процесса "Заявка"


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

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

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




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

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

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

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

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

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

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

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

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


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

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


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




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


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

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




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




20. Создайте переменные
• "Заявка" - переменная пользовательского типа "Заявка"
• "Заявки" - переменная формата Список(Заявка)
• "Комментарий заказчика" - переменная формата "Текст"
• "Комментарий руководителя" - переменная формата "Текст"
• "Комментарий канцелярии" - переменная формата "Текст"
Рисунок 2.13 Переменные процесса Заявка

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




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




Рисунок 2.15 Свойства таблицы


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


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


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

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




Рисунок 2.16 Заполненная таблица ввода данных заявки




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


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




Рисунок 2.18 Стартовая форма процесса "Заявка"


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


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


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

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

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

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

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




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




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


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

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




(а) (б) (в) Рисунок 2.21 а). переход б). добавление в). конфигуратор глобального валидатора


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


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

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




Рисунок 2.22 Форма "Одобрить заявку"


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




Рисунок 2.23 Компонент "Отобразить переменную"


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




Рисунок 2.24 Форма "Принять заявку"




Рисунок 2.25 Форма "Ознакомиться с отказом"




Рисунок 2.26 Форма "Ознакомиться с запланированной заявкой"




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


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




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


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




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




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

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

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




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


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

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




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


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

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

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




Рисунок 2.32 Свойства задачи "Получить заявку из списка"




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


Подробная работа с внешним хранилищем будет описана в последующих пунктах.




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


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




Рисунок 2.35 Задержка таймера




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


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

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




Рисунок 2.37 Конфигурация исключающего шлюза


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




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




25. Создайте новый процесс "Планирование"
26. Добавьте элементы на схему бизнес-процесса в соответствии с рисунком 2.38
Рисунок 2.38 Схема бизнес-процесса "Планирование"


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

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

27. Создайте роли (См. "Практикум. Введение", Вводное занятие, Порядок выполнения работы, Пункт 21, Рис 5.20)
В разрабатываемом процессе используются следующие Роли:
• Диспетчер
• бот
Роль "Диспетчер" будет инициализирована пользователем, запустившим процесс, не требует инициализатора. Замечание. Инициализация для роли "бот" будет описана в последующих пунктах данной части практикума.
28. Свяжите роли с узлами на графе в соответствии с рисунком 2.38
Подробнее см. "Практикум. Введение", Вводное занятие, Порядок выполнения работы, Пункт 22
29. Создайте переменные
Откройте процесс "Заявка", перейдите на вкладку "Переменные", выделите переменную "Заявка" и нажмите кнопку "Копировать" (см. Рис. 2.39) Рисунок 2.39 Копирование переменной


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




Рисунок 2.40 Вставка переменной


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


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

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




Рисунок 2.41 Переменные процесса "Планирование"




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


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

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

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




а.




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


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

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

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

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

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


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




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


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




Рисунок 2.44 Форма узла "Запланировать заявки"


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




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


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


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


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




Рисунок 2.46 Узел "Обрабатывать еще заявки?"




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


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




31. Выберите класс обработчиков и задайте конфигурации
Задача сценария "Определить количество заявок" Необходима для определения количества необработанных заявок, считанных из внешнего хранилища. Выделите задачу сценария (см. рис. 2.48), введите в свойство "Название" - "Определить количество заявок" Выберите в качестве класса обработчика - "Агрегатная функция над списком" (см. Рис. 2.48). Рисунок 2.48 Задача сценария "Определить количество заявок"


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




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


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


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

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




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




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




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

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

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




Рисунок 2.51 Задача сценария "Инициализация индекса заявки"

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




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

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

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




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


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

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

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

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




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


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

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

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

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




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




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




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


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

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




Рисунок 2.57 Конфигурация исключающего шлюза 2


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

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

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




Рисунок 2.58 Конфигурация исключающего шлюза 3


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




Внешнее хранилище данных. Бот работы с внешним хранилищем.


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

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




Рисунок 2.59 Пример внешнего хранилища







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


Действие INSERT

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


Действие SELECT

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

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


Действие UPDATE

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

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


Действие DELETE

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

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




Рекомендации для корректной работы с "Внешним хранилищем данных":


1). Один Excel-лист должен соответствовать одной таблице.

2). Обработчик, реализующий коннектор к Excel-файлу, необходимо использовать только в задаче бота. Это нужно для того, чтобы исключить одновременный доступ к хранилищу из разных экземпляров процессов, в результате чего могут быть потеряны данные. При этом бот-станция должна быть настроена на последовательное выполнение заданий бота в рамках одного потока, работающего с внешним хранилищем. Таким образом может быть получен простейший аналог транзакций системы управления БД.

3). Excel файл должен быть предварительно создан. Если в файле предполагается хранить более одной таблицы (расположенных на разных листах), то необходимо предварительно создать эти листы.

4). Таблица всегда должна располагаться начиная с 1-го столбца, поэтому в конфигурации обработчика "Внешнее хранилище данных" параметр "Столбец" всегда должен быть равным "1".

5). В момент выполнения обработчика, использующего одно из действий INSERT, DELETE, UPDATE, файлы внешнего хранилища данных не должны быть открыты, иначе действие не будет выполнено.

6). Во избежание проблем с форматом запрещается самостоятельно добавлять данные во внешнее хранилище. Если есть необходимость использовать заранее заполненное хранилище, создайте для этого отдельный процесс с задачей бота, использующей обработчик "Внешнее хранилище данных" с соответствующим действием (insert).




34. Откройте среду разработки
35. Перейдите на вкладку "Источники данных" (если данная вкладка отсутствует, откройте меню "Вид" и нажмите на "Восстановить компоновку редактора" )
Рисунок 2.60 Вкладка с источниками данных


Кликните правой клавишей мыши в окне источников данных и выберите "Добавить источник данных"

Рисунок 2.62 Добавление нового источника данных


В открывшемся окне

• выберите тип источника - Excel
• введите название источника "AVTO_DB_XLSX"
• укажите путь к каталогу, в котором будут находиться xlsx файлы источников, например "C:\runa_tmp\"
• введите имя файла - "DB.xlsx"
• нажмите "Сохранить"
Рисунок 2.63 Источник данных для заявок заказа автотранспорта


Создайте еще один Excel источник, для архивных заявок




Рисунок 2.64 Источник данных для заявок заказа автотранспорта
36. Экспортируйте созданные источники данных на сервер (выполняется аналогично экспорту бизнес-процессов)
Рисунок 2.65 Экспорт источника данных на сервер




37. Перейдите на вкладку "Боты" среды разработки (если данная вкладка не отображается, ее можно включить в меню "Окно" > "Боты").
38. ОБЯЗАТЕЛЬНО (!) удалите все ботстанции из среды разработки, иначе создание ботов и задач будет приводить к ошибкам и некорректной работе
Для этого выделите ботстанцию, кликните правой клавишей мыши, и выберите пункт "удалить" контекстного меню.
39. Импортируйте ботстанцию localbotstation с сервера WFE (Подробнее см. Практическое занятие "Работа с Word-ботом", Порядок выполнения работы, Пункт 18, Рис. 2.32-2.34)
Если на сервере отсутствует ботстанция localbotstation, то создайте ее (подробнее см. "Практическое занятие "Изучение перспективы операций", Порядок выполнения работы, Пункт 10, Рис. 5.3, Рис. 5.4)
40. Создайте в среде разработки нового бота "Бот работы с внешним хранилищем"
Рисунок 2.66 Создание нового бота




Рисунок 2.67 Ввод имени бота




41. Создайте задачи бота работы с внешним хранилищем
Для создания новой задачи бота: выделите бот, кликните правой клавишей мыши и выберите "Новая задача бота". Введите название задачи и нажмите "Готово". Рисунок 2.68 Создание задачи бота


Далее выберите класс обработчика "Внешнее хранилище данных"




Рисунок 2.69 Выбор класса обработчика задачи бота




Задача "Добавить заявку на обработку"

Данная задача бота предназначена для добавления заявки во внешнее хранилище.

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

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




Рисунок 2.70 Входной параметр для задачи "Добавить заявку на обработку"


Перейдите в секцию конфигурации задачи. Нажмите "Изменить"




Рисунок 2.71 Изменение конфигурации задачи


Будет открыт конструктор конфигурации задачи.




Рисунок 2.72 Конструктор конфигурации обработчика "Внешнее хранилище данных"


Выберите из списка действий - INSERT.

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

Нажмите "Добавить атрибут", в поле "Переменная" выберите входной параметр "Заявка".

Таблица с заявками будет располагаться на первой листе Excel, поэтому параметр "Страница по номеру" должен быть равен "1"

Параметр "Столбец" оставьте по умолчанию равными "1".


Замечание. Таблица всегда должна располагаться начиная с 1-го столбца, поэтому параметр "Столбец" всегда должен быть равным "1".


Таким образом, переменная связанная со входным параметром "Заявка" с помощью действия INSERT будет добавлена во внешнее хранилище, представленное файлом C:\runa_tmp\DB.xlsx.




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


Сохраните и закройте задачу бота.




Задача "Считать заявку"


Данная задача бота предназначена для считывания заявки из внешнего хранилища по ее id (уникальному идентификатору).

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

Добавьте входной параметр с названием "id" типа "Строка, Текст".

Добавьте выходной параметр с названием "Заявки" типа "Список".

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


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




Рисунок 2.74 Параметры задачи "Считать заявку"


Перейдите в секцию конфигурации и нажмите "Изменить". Будет вызван конструктор конфигурации.

Выберите выполняемое действие - SELECT.

Выберите в качестве входного файла ранее созданный источник "AVTO_DB_XLSX"

Добавьте атрибут - выходной параметр список "Заявки"

"Страница по номеру" - "1"

"Столбец" - "1"

Замечание. Таблица всегда должна располагаться начиная с 1-го столбца, поэтому параметр "Столбец" всегда должен быть равным "1".

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

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

[имя атрибута] оператор значение

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

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

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

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

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


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

[id] == @id

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




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




Задача "Добавить заявку в архив"

Задача выполняет добавление заявки в архивное внешнее хранилище.

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

Архивное внешнее хранилище (ранее созданный источник "AVTO_ARCH_XLSX") - excel файл C:\runa_tmp\Archiv.xlsx




Рисунок 2.76 Параметры задачи "Добавить заявку в архив"




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




Задача "Удалить заявку"

После добавления заявки в Архив, ее требуется удалить из основного хранилища.

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

Добавьте входные параметры:

• "id" типа "Строка, Текст"
• "Заявка" типа "Пользовательский тип данных"




Рисунок 2.78 Параметры задачи "Удалить заявку"


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

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

[id] == @id

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




Рисунок 2.79 Конфигурация задачи "Удалить заявку"




Задача "Считать необработанные заявки"

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

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

Добавьте выходной параметр "Заявки" типа "Список".




Рисунок 2.80 Выходные параметры задачи "Считать необработанные заявки"


Добавьте конфигурацию задачи.

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

Условие считывания необработанных заявок:

[Статус] == 'Не обработана'




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





Задача "Обновить заявку"

В процессе "Планирование" требуется обновить заявки после изменения их статуса.

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

Добавьте входные параметры "id" типа "Строка, Текст", "Заявка" типа "Пользовательский тип данных"




Рисунок 2.82 Входные параметры задачи "Обновить заявку"


Добавьте конфигурацию задачи.

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

Условие - обновить заявку зная ее идентификатор (передается во входном параметре задачи):

[id] == @id




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




42. Экспортируйте бота вместе с задачами на сервер WFE (Подробнее см. "Практическое занятие "Работа с Word-ботом", "Порядок выполнения работы", Пункт 20, рис. 2.54, 2.55)
43. Откройте процесс "Заявка"
44. Перейдите на вкладку "Роли"
45. Инициализируйте роль "бот"
Для этого выделите роль, нажмите "Изменить", в открывшемся окне выберите вкладку "Бот". В выпадающем списке "исполнитель по имени" должен быть доступен "Бот работы с внешним хранилищем", выберите его. Рисунок 2.84 Инициализатор роли ботом




46. Повторите инициализацию роли бот и в процессе "Планирование"
47. Выполните привязку задач ботов в процессе "Заявка"
Кликните правой клавишей мыши на узле "Добавить заявку на обработку" и выберите пункт "Задача бота" > "Привязать". В списке задач выберите "Добавить заявку на обработку" Рисунок 2.85 Список доступных для привязки задач


Нажмите ОК, будет открыта форма редактирования параметров задачи, выберите параметры в соответствии с рисунком 2.86




Рисунок 2.86 Редактирование параметров задачи "Добавить заявку на обработку"


Аналогично выполните привязку для остальных задач:


Узел "Считать заявку по id" - задача бота "Считать заявку":




Рисунок 2.87 Редактирование параметров задачи "Считать заявку по id"


Узел "Добавить заявку в архив" - задача бота "Добавить заявку в архив"




Рисунок 2.88 Редактирование параметров задачи "Добавить заявку в архив"


Узел "Удалить заявку из основного хранилища" - задача бота "Удалить заявку"




Рисунок 2.89 Редактирование параметров задачи "Удалить заявку из основного хранилища"




48. Выполните привязку задач ботов в процессе "Планирование"
Узел "Считать необработанные заявки" - задача бота "Считать необработанные заявки" Рисунок 2.90 Редактирование параметров задачи "Считать необработанные заявки"


Узел "Обновить заявку" - задача бота "Обновить заявку"




Рисунок 2.91 Редактирование параметров задачи "Обновить заявку"




49. Сохраните процессы и экспортируйте их на сервер WFE (Подробнее см. Практическое занятие "Изучение перспективы потока управления", Порядок выполнения работы, Пункты 11-14)
Выполнение процессов: Замечание. Разработанные бизнес-процессы заказа автотранспорта могут выполняться некорректно в устаревших версиях браузера Internet Explorer (IE7 и ниже). Рекомендуется использовать актуальные версии современных браузеров.
50. Откройте web интерфейс системы RunaWFE
51. Войдите под пользователем Administrator, пароль – wf
52. Дайте права на запуск процесса "Заявка" для группы "Сотрудники"
Откройте "Запустить процесс", и перейдите в свойства определения бизнес-процесса "Заявка" Рисунок 2.92 Переход в свойства определения бизнес-процесса


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

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




Рисунок 2.93 Право на запуск бизнес-процесса для группы "Сотрудники"




53. Дайте права на запуск, чтение, чтение экземпляра, а также остановку процесса "Планирование" для группы "Диспетчеры"
Рисунок 2.94 Обладатели полномочий на бизнес-процесс "Планирование"




54. Перейдите в меню "Бот станции"
55. Откройте ботстанцию localbotstation
56. Откройте бот работы с внешним хранилищем
Рисунок 2.95 Ботстанция localbotstation




57. Установите опцию последовательного выполнения задач бота и нажмите применить
Рисунок 2.96 Опция последовательного выполнения задач бота


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




58. Создайте в каталоге "C:\runa_tmp\" пустые Excel файлы "DB.xlsx" и "Archiv.xlsx", являющиеся файлами внешнего хранилища
59. Войдите в систему под пользователем Сергеев, входящим в группу "Диспетчеры"
60. Запустите процесс "Планирование"
61. Перейдите в "Запущенные процессы" и откройте только что запущенный экземпляр процесса "Планирование"
Замечание. По умолчанию запущенные процессы отсортированы по возрастанию номера экземпляра, что неудобно при необходимости просмотреть "недавно" запущенный экземпляр. Измените тип сортировки - по убыванию номера экземпляра процесса. Подробнее о том как это сделать см. Практическое занятие "Работа с Word-ботом", Порядок выполнения работы, Пункт 23, рис. 2.65 - 2.68 Рисунок 2.97 Цикл считывания необработанных заявок в экземпляре процесса "Планирование"


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




62. Войдите в систему под пользователем входящим в группу "Сотрудники", например Жуков
63. Запустите новый экземпляр процесса "Заявка"
64. Введите данные заявки заказа автотранспорта и нажмите "Запустить"
Рисунок 2.98 Подача заявки на автотранспорт от Жукова




65. Подайте еще пару заявок, например под пользователями Андреев и Паучков
Рисунок 2.99 Подача заявки на автотранспорт от Андреева




Рисунок 2.100 Подача заявки на автотранспорт от Паучкова


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




66. Войдите под пользователем Сверчков, являющимся руководителем организации
Рисунок 2.101 Поступившие на рассмотрение к руководителю организации заявки




67. Откройте каждое из заданий, и одобрите заявки
Рисунок 2.102 Одобрение заявки руководителем


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

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




68. Войдите под пользователем Гусеницын, входящим в группу "Канцелярия"
69. Примите все заявки
Рисунок 2.103 Принятие заявки канцелярией




70. Войдите на сервер WFE под пользователем Administrator (пароль wf)
71. Откройте один из экземпляров процесса "Заявка"
Рисунок 2.104 Бот выполнил задачу добавления заявки на обработку


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

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




72. Откройте файл внешнего хранилища данных - C:\runa_tmp\DB.xlsx
Рисунок 2.105 Заявки во внешнем хранилище


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




73. Закройте файл внешнего хранилища данных
74. Войдите под диспетчером "Сергеев"
75. Откройте задание "Отобрать заявки"
Рисунок 2.106 Задание "Отобрать заявки"


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




76. Отберите обе заявки
Для этого поставьте галочку напротив каждой из заявок и выполните задание. Рисунок 2.107 Множественный выбор заявок




77. Откройте полученное задание "Запланировать заявки"
Замечание. Убедитесь, что перед выполнением данного задания, файл DB.xlsx не открыт для просмотра, иначе бот не сможет вносить изменения во внешнее хранилище. Нажмите "Запланировать заявки" Рисунок 2.108 Задание "Запланировать отобранные заявки"




78. Откройте выполняемый экземпляр процесса "Планирование"
Убедитесь, что бот выполнил задачу "Обновить статус". Рисунок 2.109 Бот обновил статус отобранных заявок




79. Войдите под пользователем "Administrator"
80. Откройте те экземпляры процесса "Заявка", заявки которых были отобраны и запланированы
Проверьте, что управление вышло из цикла опроса статуса заявки и бот успешно выполнил задачи переноса заявки в архив. Рисунок 2.110 Бот выполнил задачи переноса заявки в архив




81. Откройте основное и внешнее хранилище данных (файлы C:\runa_tmp\DB.xlsx и C:\runa_tmp\Archiv.xlsx)
Убедитесь, что все запланированные заявки были перенесены из основного хранилища в архив. Рисунок 2.111 Основное хранилище данных




Рисунок 2.112 Архив


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




82. Выполните активные задачи заказчиков и гаража: "Ознакомиться с запланированной заявкой", "Отчитаться о рейсе"
83. Войдите под диспетчером "Сергеев" и выполните задачу "Обрабатывать еще заявки?", выбрав "Да"
Рисунок 2.113 Продолжить обработку заявок


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

84. Запланируйте оставшиеся заявки (если таковые имеются)
Замечание. Убедитесь, что перед выполнением данного задания, файлы DB.xlsx и Archiv.xlsx не открыты для просмотра, иначе бот не сможет вносить в них изменения.

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

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

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

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

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

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

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

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

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

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

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

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

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

Рисунок 2.114 Значок добавления вкладки

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

Рисунок 2.115 Добавленные на форму вкладки

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

• кликните по вкладке
• перейдите на страницу "Код"
• измените необходимые названия
• вернитесь на страницу "Дизайн" и сохраните форму

Рисунок 2.116 Вкладки с названиями по умолчанию Рисунок 2.117 Редактирование названий вкладок

Замечание. В случае версии RunaWFE 4.2.1 и ниже используйте компонент "Редактировать связанные списки", в случае RunaWFE 4.3.0 и выше - компонент "Редактирование списка пользовательских переменных". Выберите запрет на добавление и удаление элементов. Расположите компонент на каждой из вкладок соответствующей группы товаров. Отобразите остатки и заказанные товары на разных вкладках. Используйте компонент "Отобразить список пользовательских переменных".

а.

б. Рисунок 2.118 Форма выбора товаров для заказа: а - версия ^4.2.1- и ниже; б - версия ^4.3.0+;

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

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

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

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

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

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

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

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

Рисунок 2.119 Схема бизнес-процесса "Заказ канцтоваров"

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

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

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

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

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

Рисунок 2.121 Определение количества заказанных товаров

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

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

Рисунок 2.122 Переменные подпроцесса "Обновить остатки на складе"

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

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

Рисунок 2.123 Получение очередного товара из списка заказанных

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

• увеличивается индекс для выбора следующего товара

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

Рисунок 2.124 Проверка условия "По всем ли заказанным товарам обновлены остатки на складе"

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

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

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

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

Рисунок 2.125 Установка свойства "Транзакционный" для композиции

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

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

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

Рисунок 2.127 Конфигурация задачи "Считать товар со склада по названию"

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

Рисунок 2.128 Определение количества элементов в списке считанных товаров по названию

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

Рисунок 2.129 Конфигурация исключающего шлюза

Рисунок 2.130 Получение товара из списка товаров

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

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

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

Рисунок 2.132 Параметры задачи бота "Обновить товар"

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

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

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

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

Рисунок 2.134 Установка свойства "Транзакционный"

• "Бот работы с внешним хранилищем" должен обладать полномочиями "Читать" и "Читать экземпляры" БП "Заказ канцтоваров", а также БП "Обновить остатки на складе"

Рисунок 2.135 Добавление боту полномочий на БП

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

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

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

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

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

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

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

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

Ссылки

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