【Activiti EL式】EL式内での変数の存在確認方法
${execution.getVariable('X') != null ? 存在する場合の式 : 存在しない場合の式 }
【Activitiはまりポイント】デフォルトフローの仕様
【Activiti入門】並行ルートの作成
概要
前回の入門記事では条件分岐のルートを紹介しましたが、今回は並行ルートを扱います。 並行ルートとは、同時に異なるユーザタスクが割り当てられるルートのことです。
ステップ
並行ルートを実現するには、「ParallelGateway」のアイコンを利用します。
「Gateway」カテゴリにある「ParallelGateway」を利用することで、並行なルートを引くことが可能です。
「ParallelGateway」から各「UserTask」へのシーケンスを引くことで、各「UserTask」ごとに並列にプロセスが動作します。
各「UserTask」から「ParallelGateway」へシーケンスを引くことで、並行に実行されていたプロセスが結合します。各プロセスが完了するまで待ち合わせを行います。
フローの作成
では、実際に並行ルートを実現するフローを作成していきます。
Activiti Diagramを作成し、フローのデザイナー画面を表示します。
以下のアイコンを配置します。
以下のように線を引きます。
- 「StartEvent」から「ParallelGateway」へ線を引きます。
- 「ParallelGateway」から2つの「UserTask」へそれぞれ線を引きます。
- 2つの「UserTask」からそれぞれ「ParallelGateway」へ線を引きます。
- 「ParallelGateway」から「EndEvent」へ線を引きます。
起票者を設定します。
- デザイナー上のアイコン以外の箇所をクリックします。
- Propertiesタブの「Candidate start users」に「fozzie」を設定します。
処理対象者を設定します。
- デザイナー上のユーザタスクの1つ目をクリックします。
- Propertiesタブの「Main config」-「Assignee」に「kermit」を設定します。
- デザイナー上のユーザタスクの2つ目をクリックします。
- Propertiesタブの「Main config」-「Assignee」に「gonzo」を設定します。
フローを保存・ビルドし、出力されたbarファイルをActiviti Explorerにデプロイします。
フローの実行
fozzie/fozzieでActiviti Explorerへログインします。
「プロセス」からデプロイしたフローを選択します。
「プロセスの開始」を押下し、プロセスを開始します。
kermit/kermitでActiviti Explorerへログインします。
「ケース」-「受信トレイ」にタスクがあります。
「タスクの完了」を押下し、タスクを完了させます。
「ケース」-「受信トレイ」にタスクがあります。
「タスクの完了」を押下し、タスクを完了させます。
fozzie/fozzieでActiviti Explorerへログインします。
「プロセス」-「マイ・インスタンス」から開始したフローが完了していることを確認します。
注意
- ParallelGatewayに接続されるシーケンスの条件は、評価されません。条件の設定は、無視されます。
[追記]
この記事では、並列に動作しているプロセスをParallelGatewayで再度結合し待ち合わせを行っていますが、結合しない場合は各プロセスが終了まで並列に動作します。
【Activiti入門】変数
概要
Activitiのプロセスでは、変数を利用してプロセスに関する入力データを扱う。
変数はデータベース(テーブル ACT_RU_VARIABLE)にて管理される。
ただし、変数の値にJava beanなどが格納された場合は、バイナリデータとしてACT_GE_BYTEARRAYテーブルに格納される。
変数には、スコープが存在する。
参考
Process Variables
プロセス全体で有効となる変数。
レコードとしては、テーブル ACT_RU_VARIABLEのカラムproc_inst_idとカラムexecution_idが一致するもの。
Execution
アクティブなExecution内でのみ有効な変数。
説明が難しいが、Activitiでは、プロセスインスタンス上で現在アクティブな箇所をExecutionと定義している。 例えば、以下のような並行ルートの場合は、並行ルートの処理中に3つのアクティブなExecutionが存在する。 1つ目はプロセスインスタンス全体のExecution、2,3つ目はそれぞれの並行ルートのExecutionである。
Executionスコープの変数とは、プロセスインスタンスのExecutionではない、個々のExecution内で有効となる変数である。
レコードとしては、テーブル ACT_RU_VARIABLEのカラムproc_inst_idとカラムexecution_idが一致しないもの。
UserTask Variables
ユーザタスク内でのみ有効な変数。
レコードとしては、テーブル ACT_RU_VARIABLEのカラムtask_id_が空でないもの。
履歴
- 変数の履歴は、テーブル ACT_HI_VARINSTに格納される。
Activiti 公開情報
Activitiに関して公開されている情報源をまとめました。
Document
Activiti User Guide
無料で公開されている公式ドキュメント。
Activiti EngineからActiviti Explorer・Activiti RESTまで薄く広く解説している。
Activiti 5.x Business Process Management Beginner's Guide
Activiti Explorerをベースにして各アイコン・機能の解説をしている。
Activiti Explorer・Activiti Designerだけの利用であれば、この1冊で十分事足ります。
Activiti 5.x Business Process Management Beginner's Guide
- 作者: Dr. Zakir Laliwala,Irshad Mansuri
- 出版社/メーカー: Packt Publishing
- 発売日: 2014/03/26
- メディア: Kindle版
- この商品を含むブログを見る
Activiti in Action: Executable Business Processes in BPMN 2.0
Activiti EngineのAPI・内部仕様の解説書。
Activiti Engineを組み込んだWebアプリケーションを開発する場合は参考になります。
Activiti in Action: Executable Business Processes in BPMN 2.0
- 作者: Tijs Rademakers,Tom Baeyens,Joram Barrez
- 出版社/メーカー: Manning Pubns Co
- 発売日: 2012/07/23
- メディア: ペーパーバック
- この商品を含むブログを見る
Download
Activiti Designer
Activiti Explorer
Activiti Explorerのwarファイルが含まれたzipがダウンロードできます。 http://activiti.org/download.html
リリース情報
JIRA
各バージョンごとの不具合修正・機能追加情報がまとまっています。
私はやったことはないですが、issueを報告することもできるようです。
無料ですが、アカウントを作成する必要があります。
Q&A
フォーラム
困った場合は、こちらで質問できるようです。
感覚ですが、GitHubのissueよりは活発な感じがします。
[2016/12/14 追記]フォーラムのサイトが以下に変更になったようです。 https://community.alfresco.com/community/bpm/content
Github Issues
その他
Jenkins(各プラットフォームごとのテストケース実行環境)
http://ec2-54-217-5-246.eu-west-1.compute.amazonaws.com:8080/jenkins/
【Activiti入門】条件分岐ルートの作成
概要
前回の入門記事では直線のルートを紹介しましたが、今回はもう少し業務プロセスらしい、条件分岐のルートを扱います。 条件分岐ルートとは、入力値に応じて、異なるユーザタスクが割り当てられるルートのことです。
ステップ
条件判定の対象となる入力項目を用意します。
前回の入門記事で紹介したActiviti Explorerを利用する場合、form属性を設定することで「StartEvent」・「UserTask」に入力項目を設定できます。
form属性は、フィールドの名称・データ型・変数名などを設定することで「StartEvent」・「UserTask」を処理する画面に入力項目を設定できる機能です。
Activiti Designerにて「StartEvent」・「UserTask」のpropertiesタブから設定します。
条件分岐を行うには、「ExclusiveGateway」のアイコンを利用します。
「Gateway」カテゴリにある「ExclusiveGateway」を利用することで、各「UserTask」へ分岐させることが可能です。
「ExclusiveGateway」から各「UserTask」へのシーケンスに対して、それぞれの到達条件を設定します。
1で設置したフィールドは、変数として到達条件の条件式で利用できます。
フローの作成
では、実際に条件分岐を行うフローを作成していきます。
Activiti Diagramを作成し、フローのデザイナー画面を表示します。
以下のアイコンを配置します。
- 「Start Event」カテゴリから「StartEvent」を配置します。
- 「Gateway」カテゴリから「ExclusiveGateway」を配置します。
- 「Task」カテゴリから「UserTask」を2つ配置します。
- 「End Event」カテゴリから「EndEvent」を配置します。
以下のように線を引きます。
- 「StartEvent」から「ExclusiveGateway」へ線を引きます。
- 「ExclusiveGateway」から2つの「UserTask」へそれぞれ線を引きます。
- 2つの「UserTask」からそれぞれ「EndEvent」へ線を引きます。
「StartEvent」にフィールドを設置します。
- 「StartEvent」を押下します。
- Propertiesタブを選択し、FormのNewを押下します。
表示されたダイアログに以下のように入力します。
id name type Variable Readable Writeable Required price Price long price true true true
「UserTask」にフィールドを設定します。
- 「UserTask」を押下します。
- Propertiesタブを選択し、FormのNewを押下します。
表示されたダイアログに以下のように入力します。
id name type Variable Readable Writeable Required price Price long price true false false
条件分岐を設定します。
「ExclusiveGateway」から1つ目の「UserTask」へのシーケンスを押下します。
表示されたpropertiesタブMain configのcondition属性に「${price>1000}」を入力します。
「ExclusiveGateway」から2つ目の「UserTask」へのシーケンスを押下します。
表示されたpropertiesタブMain configのcondition属性に「${price<=1000}」を入力します。
フローを保存・ビルドし、出力されたbarファイルをActiviti Explorerにデプロイします。
フローの実行
fozzie/fozzieでActiviti Explorerへログインします。
「プロセス」からデプロイしたフローを選択します。
「プロセスの開始」を押下すると、入力画面が表示されます。
「Price」に100を入力し、プロセスを開始します。
「プロセス」の「マイ・インスタンス」から開始したフローの状態を確認します。
条件分岐が判定され、2つ目の「UserTask」が割り当てられたことを確認します。
kermit/kermitでActiviti Explorerへログインします。
「ケース」-「受信トレイ」にタスクがあります。
タスクを選択し、Priceが100であることを確認します。
「タスクの完了」を押下することで、プロセスが完了します。
