TrainingMaterials 4 4 1 Introduction

RunaWFE. Практикум. Вводное занятие

Версия 4.5.0

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

 

Где скачать исходные файлы системы RunaWFE

Варианты распространения RunaWFE Free:

• Готовые специализированные дистрибутивы (для ОС Windows):

для 64-разрядной ОС Windows | для 32-разрядной ОС Windows
Запуск на выполнение этого файла запустит на компьютере диалог установки системы.

• Вариант распространение в виде исполнимых файлов java-машины (ОС Windows, Linux, Macintosh) (Загрузить). В этом случае надо обратиться к документации RunaWFE Free и установить на компьютер непосредственно исполняемые файлы java.

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

 

Установка системы RunaWFE для операционной системы Windows

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

Компоненты дистрибутива, относящиеся к клиентской части системы:

• Клиент (web-интерфейс)
• Среда разработки
• Симулятор бизнес-процессов
• Клиент-оповещатель о поступивших заданиях.

Компоненты дистрибутива, относящиеся к серверной части системы:

• RunaWFE – сервер
• Бот-станция.

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

Замечание. В следующем разделе описан порядок установки системы в случае ОС Windows, но для системного администратора, устанавливающего систему в компьютерном классе, есть более подробная инструкция Универсальная инструкция по установке дистрибутивов RunaWFE в ОС Windows (Файл:Admin instruction ver2.doc)

Порядок установки системы в случае ОС Windows

Запустите на выполнение файл RunaWFE-Installer.exe. Появится экран мастера установки системы:

Рисунок 2.01. Экран мастера установки системы

Нажмите «Установить». В следующем мастере установки появится текст свободной лицензии LGPL (Лицензия LGPL разрешает свободное использование, изменение кода и распространение программного продукта. На использование кода программы под LGPL лицензией разработчиками программного обеспечения в других коммерческих проприетарных программах налагаются некоторые ограничения), под которой распространяется система RunaWFE. В настоящее время не существует официального перевода лицензии LGPL на русский язык, поэтому текст лицензии представлен в оригинале - на английском языке.

Рисунок 2.02. Лицензионное соглашение

После утвердительного ответа на вопрос о принятии условий лицензии появится выбор – установить на компьютер клиентские или серверные компоненты RunaWFE

Рисунок 2.03. Выбор вариантов установочного пакета системы

Выберите клиентские приложения и нажмите «Далее»

Появится страница выбора конкретных клиентских компонентов.

Рисунок 2.04. Выбор компонентов системы

Отметьте все компоненты кроме компонента «Интернет ссылка» и нажмите «Далее».

Рисунок 2.05. Выбор папки для установки

Выберите папку для установки RunaWFE и нажмите «Далее».

В появившемся окне мастера установите самую верхнюю галочку:

Рисунок 2.06. Дополнительные параметры мастера установки

Нажмите «Далее».

Рисунок 2.07. Мастер настройки точек доступа

В следующем окне мастера оставьте настройки, появившиеся по умолчанию, и нажмите «Далее». – Начнется процесс копирования файлов системы. После того, как система будет установлена, появится следующее окно мастера:

Рисунок 2.08. Завершение установки

Нажмите «Готово». Процесс установки будет завершен.

Замечание. В случае отсутствия в системе java 8, инсталлятор предложит установить, кроме того будет предложено установить переменную среды JAVA_HOME.

 

Начало работы с системой RunaWFE

Работать с системой можно через системное меню ( Пуск / Программы / RunaWFE)

Рисунок 3.01. Запуск программы

или через расположенные на рабочем столе иконки.

Для начала работы с системой RunaWFE:

1. Запустите RunaWFE Симулятор. Это можно сделать, например, командой меню Пуск / Программы / RunaWFE / Start Simulation. При запуске Симулятора появится консольное окно: Рисунок 3.02. Запуск сервера JBoss

   Строка WFLYSRV0010: Deployed "runawfe.ear" (runtime-name : "runawfe.ear") означает, что Симулятор запущен.

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

2. Запустите web-интерфейс системы RunaWFE. Для этого надо выполнить команду Пуск / Программы / RunaWFE / Simulation Web Interface. Появится окно ввода логина и пароля пользователя. Рисунок 3.03. Окно ввода учётной записи

   В этом окне введите логин администратора «Administrator» (существенно, что с большой буквы) и пароль администратора – «wf».

 

Главное меню системы RunaWFE

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

Рисунок 4.01. Функциональное меню Simulation web interface

Дадим краткое описание пунктов меню системы RunaWFE.

Меню «Список заданий». При выполнении команды меню «Список заданий» открывается форма списка заданий для данного пользователя. Здесь пользователь может, щёлкнув на имя задания, открыть его форму, ввести в нее данные, а также отметить выполнение задания. Также в списке заданий пользователь может искать, фильтровать задания, выводить в строках задания значения переменных бизнес-процессов.

Меню «Запустить процесс». На странице, соответствующей пункту меню «Запустить процесс» находится список определений бизнес-процессов. Здесь пользователь может запустить бизнес-процесс, посмотреть схему и другие свойства бизнес-процесса, посмотреть описание бизнес-процесса. Если у пользователя есть соответствующие права, он может загрузить новый бизнес-процесс в систему или загрузить новую версию уже существующего процесса.

Меню «Запущенные процессы». На странице, соответствующей пункту меню «Запущенные процессы», находится список экземпляров бизнес-процессов, доступных для чтения данному пользователю. Здесь пользователь может посмотреть состояния выполняющихся экземпляров бизнес-процессов, в частности – положение текущих точек управления на схеме бизнес-процесса, текущие значения переменных и ролей экземпляра бизнес-процесса, а также историю событий экземпляра бизнес-процесса. Если у пользователя есть соответствующие права, он может остановить выполнение экземпляра бизнес-процесса. Также в списке экземпляров бизнес-процессов пользователь может искать, группировать, фильтровать экземпляры бизнес-процессов, выводить в строках значения переменных бизнес-процессов.

Меню «Исполнители». На странице, соответствующей пункту меню «Исполнители», находится список потенциальных исполнителей заданий (пользователей и групп пользователей), доступных для чтения данному пользователю. На этой странице можно завести или удалить исполнителя, завести или удалить группу исполнителей, включить (исключить) исполнителя или группу исполнителей в другую группу. Для исполнителя можно установить статус (Активен / Не активен) настроить список замещений. Также здесь задается список полномочий исполнителей на действия с системой, которые настраивает администратор.

Меню «Отношения». Отношения используются в системе RunaWFE при инициализации ролей бизнес-процесса, при порождении экземпляров мультиподпроцесса базовым процессом и в некоторых других случаях. При разработке бизнес-процесса создается роль и ставится в соответствие определенным узлам схемы. Инициализация роли – это назначение на роль конкретного исполнителя. Отношения соответствуют одному из используемых в системе RunaWFE способов инициализации ролей.

Меню «Бот станции». Боты в системе RunaWFE – это специальные компьютерные приложения, которые также как и люди могут быть исполнителями заданий. Бот-станция – это компьютерная среда, в которой функционируют боты. Находящиеся в бот-станции боты периодически опрашивают RunaWFE - сервер. Если выполняющиеся на сервере экземпляры бизнес-процессов содержат задачи для исполнителей - ботов, то боты выполняют эти задачи и возвращают результаты работы на RunaWFE - сервер. На странице, соответствующей пункту меню «Бот станции», находится список зарегистрированных бот-станций. Здесь пользователь может посмотреть свойства бот-станций состояния бот-станций, свойства входящих в бот-станцию ботов, а также задач, которые они могут выполнять. Также в меню «Бот станции» можно завести новую бот-станцию, изменить параметры бот-станции, запустить/остановить периодическую активацию бот-станции, а также изменять свойства входящих в бот-станцию ботов. В частности, можно добавить новое задание боту, или изменить/удалить уже существующее задание.

Меню «Источники данных». В качестве источника может выступать база данных или Excel таблица. Источники данных могут быть использованы в обработчиках: "Внутреннее хранилище данных", "Внешнее хранилище данных" и "Выполнить запросы SQL". На этой странице можно загрузить новый источник, изменить пароль, или проверить возможность подключения к источнику.

Меню «Внутреннее хранилище». В качестве внутреннего хранилища в RunaWFE Free используются excel файлы. В данном пункте меню отображается путь к директории с excel файлами (по умолчанию C:\Users\<Пользователь>\AppData\Roaming\runawfe\jboss\wfe.excelstorage). Каждый файл можно скачать или просмотреть непосредственно в веб интерейсе в виде таблицы.

Меню «Система». На странице, соответствующей пункту меню «Система» находится список полномочий исполнителей на действия с системой, которые настраивает администратор. Также здесь имеется возможность экспорта и загрузки файла с данными, добавления критериев замещения, просмотра ошибок найденных в конфигурациях заданий ботов, и процессах. Начиная с версии 4.0, сюда был добавлен функционал работы со скриптами непосредственно в WFE.

Меню «Настройки». На странице отображаются пункты с настройками веб-интерфейса, основными настройки, настройками прав доступа, бот-станций и т.д..

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

 

Вводное занятие. Изучение интерфейса системы RunaWFE

Цель занятия

Целью занятия является ознакомление с Web-интерфейсом системы RunaWFE и средой разработки.

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

Вход в систему

1. Запустите RunaWFE Симулятор. Для этого дважды щёлкните по ярлыку «Start Simulation» на рабочем столе или выполните команду меню "Пуск / Программы / RunaWFE Free/ Start Simulation". Появится консольное окно (Рис.5.01).
Рисунок 5.01. Окно RunaWFE Симулятора

Строка … Deployed "runawfe.ear" означают, что Симулятор запущен.

2. После того, как RunaWFE Симулятор запустится, щёлкните по ярлыку «Simulation Web Interface» (Или выполните команду "Пуск / Программы / RunaWFE Free/ Simulation Web Interface"). Откроется окно браузера (Рис.5.02).
Рисунок 5.02. Форма аутентификации пользователя
3. В поле «Пользователь» введите Administrator, а в поле «Пароль» - wf и нажмите кнопку «Войти». Появится web-интерфейс системы RunaWFE (Рис.5.03).
Замечание: Web-интерфейс - это графический интерфейс пользователя, доступ к которому осуществляется через окно браузера.

Рисунок 5.03. Web-интерфейс системы RunaWFE


Замечание: В RunaWFE Free 4.4.1 для упрощения работы, по умолчанию проверка прав доступа отключена. Это означает что при доступе к объектам системы (исполнители, определения БП, экземпляры БП, отчеты, отношения, бот-станции, источники данных, действия с системой) права пользователя не проверяются. Но для изучения системы прав необходимо включить проверки. Для этого вам потребуется перевести в значение "true" параметры, расположенные на странице "Настройки" -> "Настройки прав доступа".

Рисунок 5.04. Включение проверки прав доступа к объектам системы RunaWFE




Учётные записи и работа с правами

4. Перейдите к списку исполнителей, щёлкнув по ссылке «Исполнители» в левой части экрана. Откроется список исполнителей (Рис.5.05).

Рисунок 5.05. Список исполнителей




5. Создайте группу пользователей «Сотрудники». Для этого выберите ссылку «Создать группу», откроется интерфейс создания группы (Рис.5.06).

Рисунок 5.06. Интерфейс создания группы пользователей




6. Введите в поле «Имя» слово «Сотрудники», также добавьте описание этой группы, после чего нажмите кнопку «Применить».
7. Откройте пункт «Система» в нижней части меню. Откроется интерфейс «Обладатели полномочий» (Рис.5.07).

Рисунок 5.07. Форма распределения полномочий




8. Добавьте созданную группу в список обладателей полномочий. Для этого щёлкните по ссылке «Добавить». Откроется список (Рис.5.08), в котором найдите группу «Сотрудники». Установите напротив этой группы галочку и нажмите «Добавить».
Рисунок 5.08. Форма добавления пользователей в список для установления полномочий
9. Теперь необходимо выдать группе полномочия. Для этого поставьте галочки в столбцах: «Читать», «Входить», «Загружать определение процесса», как показано на Рис.5.09, после чего нажмите кнопку «Применить».

Рисунок 5.09. Выдача полномочий на вход в систему группе «Сотрудники»




10. Далее создайте учетные записи пользователей «Сверчков» и «Паучков». Для создания учетной записи «Сверчков» откройте интерфейс «Исполнители» и щёлкните по надписи «Создать пользователя». Откроется форма для ввода данных пользователя. В поле «Имя» введите «Сверчков», в поле «Полное имя» введите «Сверчков Иван Иванович», остальные поля заполнять необязательно (Рис.5.10).
Рисунок 5.10. Форма создания учетной записи пользователя
11. По окончании заполнения полей формы нажмите кнопку «Применить». Для правки учетной записи откройте меню «Исполнители». Найдите исполнителя «Сверчков» и щёлкните по нему. Откроется интерфейс редактирования учетной записи (Рис.5.11).
Рисунок 5.11. Расширенная форма правки учетной записи пользователя

В разделе «Свойства исполнителя» содержится базовое описание пользователя.

В графе «Статус» устанавливается статус пользователя («Активен» или «Не активен»). Его изменяют в случае, если сотрудник должен быть на рабочем месте, либо не может на нем появиться в силу каких-либо обстоятельств.

В графе «Пароль» введите пароль для пользователя «Сверчков» (например - 123), знать старый пароль пользователя при этом не требуется. Затем нажмите «Применить». В разделе «Группы пользователя» щёлкните по надписи «Добавить» и в открывшемся списке поставьте галочку напротив группы «Сотрудники», после чего нажмите кнопку «Добавить».

12. Щёлкните на ссылку «Обладатели полномочий» в верхней части формы (Рис.5.12).
Рисунок 5.12. Ссылка «Обладатели полномочий»
13. Добавьте в список обладателей полномочий группу «Сотрудники» с правами только на чтение (Рис.5.13).
Рисунок 5.13. Установка прав на чтение группе «Сотрудники» на пользователя «Сверчков»

Настройка учетной записи пользователя «Сверчков» завершена.

14. Аналогичным образом создайте и настройте учетную запись «Паучков» (Паучков Петр Петрович).

 

Создание процесса в среде разработки

15. Запустите компонент системы RunaWFE - "Среда разработки". Для этого щёлкните ярлык "Developer Studio" на рабочем столе или выполните команду меню "Пуск / Программы / RunaWFE Free / Developer Studio". Появится окно среды разработки (Рис.5.14).
Рисунок 5.14. Среда разработки
16. Создайте новый проект - "Вводное занятие" (Рис.5.15).
Рисунок 5.15. Создание нового проекта
17. Создайте простейший бизнес-процесс (Рис.5.16).
Рисунок 5.16. Создание нового бизнес-процесса
18. Введите название процесса – Процесс1, в качестве языка выберите BPMN (Рис.5.17).
Рисунок 5.17. Форма создания нового процесса
19. Поместите на схему бизнес-процесса узел - начало бизнес-процесса, узел-действие и узел-окончание. Щёлкните элемент «Выбрать» в палитре. Будет установлен режим выбора. В этом режиме каждый узел надо поместить на схему при помощи щелчка по элементу, расположенному в палитре и последующего щелчка на место в схеме, в которое требуется поместить новый элемент (Рис.5.18).
Рисунок 5.18. Создание схемы бизнес-процесса

Для удобства расположения объектов можно использовать «сетку» (устанавливается в меню вид - показать сетку).

20. Поместите на схему бизнес-процесса линии-переходы, соединяющие начало, узел-действие и окончание. Для этого надо щёлкнуть на элемент «Переход» в палитре. Будет установлен режим рисования переходов. В этом режиме создания каждого перехода надо сначала щёлкнуть на центр узла, в котором должен начаться переход, потом щёлкнуть на центр узла, в который должен закончиться переход (Рис.5.19).
Рисунок 5.19. Создание переходов

Замечание: Если требуется "изогнуть" линии-переходы, то надо в режиме «Выбрать» выделить щелчком мыши переход, найти в середине прямолинейного участка точку (на Рис.5.20 эти точки выделены овалами) и далее "тащить" ее мышкой в нужном направлении. Линия будет "изгибаться".

Рисунок 5.20. Изменение формы перехода

 

Создание и привязка ролей

21. Создайте роль (которая будет в дальнейшем связана с узлом-началом и узлом «Действие 1»). Для этого щёлкните вкладку роли, в появившемся окне выполните команду «Создать», далее в появившейся форме введите «Роль1». Нажмите «OK» (Рис.5.21).
Рисунок 5.21. Создание роли без инициализатора
22. Свяжите роль «Роль1» с узлом-началом и с узлом «Действие 1». Для этого щёлкните правой кнопкой мыши на каждый узел и выберите «Роли/Роль1» (Рис.5.22).
Рисунок 5.22. Связывание узла с ролью исполнителя задания
23. Простейший бизнес-процесс готов. Экспортируйте его в файл-архив командой "Файл/Экспорт процесса" (Рис.5.23) и поместите в папку «Рабочий стол».
Рисунок 5.23. Экспорт бизнес-процесса в файл-архив




Подготовка к исполнению процесса

24. Войдите в web-интерфейс (localhost:8080/wfe) системы RunaWFE под пользователем Administrator.

 

Загрузите разработанный бизнес-процесс на RunaWFE сервер:

25. Щёлкните по пункту меню "Запустить процесс", затем щёлкните по ссылке "Загрузить определение процесса" (Рис.5.24).
Рисунок 5.24. Команда "Загрузить определение процесса"
26. Щёлкните по ссылке "Загрузить файл" в появившейся форме и выберите файл "Процесс1.par", который был сохранен на рабочий стол. В поле "Создайте свой тип" введите "Занятие1" (Рис.5.25).
Рисунок 5.25. Окно команды "Загрузить определение процесса"
27. Щёлкните по ссылке "Загрузить определение процесса". Разработанный бизнес-процесс "Процесс1" будет загружен на RunaWFE сервер (Рис.5.26).
Рисунок 5.26. Бизнес-процесс загружен на RunaWFE сервер

Дайте пользователю "Паучков" права на чтение, запуск и чтение экземпляра, а группе "Сотрудники" только права на чтение на разработанный бизнес-процесс:

28. Щёлкните по полю "Свойства" в строке бизнес-процесса. В появившемся окне щёлкните ссылку "Обладатели полномочий" (Рис.5.27).
Рисунок 5.27. Форма свойств бизнес-процесса
29. Щёлкните по ссылке "Добавить" в появившемся окне обладателей полномочий на определение разработанного бизнес-процесса (Рис.5.28).
Рисунок 5.28. Окно обладателей полномочий на определение бизнес-процесса
30. В появившейся форме поставьте в списке исполнителей галочки рядом с пользователем "Паучков" и группой "Сотрудники" и щёлкните кнопку "Добавить" (Рис.5.29).
Рисунок 5.29. Окно добавления полномочий на определение бизнес-процесса
31. Расставьте галочки в появившемся окне обладателей полномочий (Рис.5.30).
Рисунок 5.30. Окно обладателей полномочий на определение бизнес-процесса
32. Щёлкните по кнопке "Применить".

 

Войдите на RunaWFE сервер под разными пользователями и исполните бизнес-процесс:

33. Щёлкните по ссылке "Выход" в правой верхней части экрана (Рис.5.31).
Рисунок 5.31. Ссылка "Выход"

Запуск и исполнение процесса в среде исполнения

34. Войдите в систему как пользователь "Сверчков" (Рис.5.32).
Рисунок 5.32. Вход в систему
35. Щёлкните по пункту меню "Запустить процесс" (Рис.5.33).
Рисунок 5.33. Окно для работы с определениями процессов и запуска экземпляров процессов
36. Проверьте, что в появившейся форме содержится разработанный бизнес-процесс "Процесс1", который нельзя запустить (его иконка и ссылка в поле "Имя" неактивны), но можно посмотреть его свойства, щёлкнув по ссылке в поле "Свойства". Так происходит потому, что мы установили права на процесс "Процесс1" для группы "Сотрудники", в которую входит пользователь "Сверчков" только на чтение. Для самого пользователя "Сверчков" или для каких-то других содержащих его групп права на "Процесс1" не установлены.
37. Щёлкните ссылку выход. Войдите в систему под пользователем "Паучков" (Рис.5.34).
Рисунок 5.34. Вход в систему
38. Проверьте, что у пользователя "Паучков" есть права на запуск бизнес-процеса "Процесс1" (иконка процесса и ссылка в поле "Имя" активны).
39. Щёлкните по иконке бизнес-процесса. В верхней части экрана появится надпись "Экземпляр процесса запущен", рядом с которой будет находиться номер запущенного бизнес-процесса (Рис.5.35).
Рисунок 5.35. Запуск бизнес-процесса на исполнение
40. Щёлкните пункт меню "Запущенные процессы". Найдите в появившемся окне строку, соответствующую запущенному экземпляру бизнес-процесса - в ней число в поле номер должно совпадать с тем, которое было отображено в сообщении о запуске экземпляра процесса (Рис.5.36).
Рисунок 5.36. Незавершенный экземпляр бизнес-процесса (нет даты завершения)
41. Щёлкните в этой строке на номер бизнес-процесса. Откроется форма экземпляра бизнес-процесса. В этой форме будет показано, что в процессе есть единственная точка управления, которая находится в узле "Действие 1" и задание этого узла назначено пользователю "Паучков". Пользователь Паучков является исполнителем роли "Роль1". Также в форме находится схема экземпляра бизнес-процесса с отмеченными на ней маршрутами точек управления. Переходы и узлы, по которым прошли точки управления выделены зеленым, узлы-действия, в которых находятся текущие точки управления, выделены жирной рамкой (Рис.5.37).
Рисунок 5.37. Форма экземпляра бизнес-процесса
42. Щёлкните строку меню "Список заданий". В появившейся форме найдите задание "Действие 1" (Рис.5.38).
Рисунок 5.38. Список заданий
43. Щёлкните по названию задания "Действие 1" в поле "Имя". Появится форма, содержащая сообщение "Форма задания не определена" (что означает - "для узла Действие 1 не была определена графическая форма") (Рис.5.39).
Рисунок 5.39. Форма задания (в случае отсутствия формы, подготовленной в среде разработки)
44. Щёлкните по кнопке "Задание исполнено". В верхней части экрана появится сообщение "Задание выполнено". После этого точка управления перейдет в конечный узел бизнес-процесса и экземпляр бизнес-процесса будет завершен.
45. Войдите в меню "Запущенные процессы". Проверьте, что у экземпляра бизнес-процесса появилась дата завершения (Рис.5.40).
Рисунок 5.40. Завершенный экземпляр бизнес-процесса (есть дата завершения)
46. Войдите в форму экземпляра бизнес-процесса. Проверьте, что путь точки управления отмечен до узла-окончания бизнес-процесса.

Требования к содержанию и оформлению отчета

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

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

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

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

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

1. Из каких компонентов состоит система RunaWFE?
2. Что такое Web-интерфейс? Обладает ли компонент "Среда разработки" системы RunaWFE Web-интерфейсом?
3. Какие права нужны пользователю, чтобы он

   А) Мог запускать экземпляры данного бизнес-процесса?

   Б) Мог выполнять задания данного бизнес-процесса?

 

Ссылки

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