チュートリアル（ワークフロー）

iPLAssのコマンドを呼び出すことができるタスクです。 ワークフロー内でロジカルな処理を行いたい場合に利用します。

設定したユーザーに対してタスクを割り当て、回答結果で処理を振り分けるタスクです。 ユーザーAを割り当て、結果に承認、差し戻しをセットすることで、本処理に到達した際に、ユーザーAが承認、もしくは差し戻しを実行することで後続処理を進める等の利用が可能です。

後述するVariableItemを指定し、対象Entityの更新を行えます。

MailTemplateを指定し、メール送信するタスクです。

定義済みのWorkflowをSubProcessとして呼び出すことが可能です。 なお、本チュートリアルでは扱いません。

ワークフローが起動した際に一番初めに実行されるイベントです。 このイベントが起動することでワークフローの状態が「ACTIVE」となります。 ワークフローには必ず１つだけ定義する必要があります。

ワークフローを終了させる為のイベントです。 Workflowの状態（ステータス）は「COMPLETED」になります。

ワークフロー履歴への出力用イベントです。 特にこのイベントによる処理は実行されず、続けて後続のフローに遷移します。

タイマー機能をもつイベントです。 後続イベントの実行日時や実行遅延時間を指定することができます。

ワークフローをキャンセルさせる為のイベントです。 EndEventとの違いは完了後のステータスとなります。 Terminateが実行されるとWorkflowの状態（ステータス）は「CANCELED」になります。

分岐処理で利用します。 後続の全てのSequenceFlowを実行します。

分岐処理で利用します。 後続のいずれかのSequenceFlowを実行します。 なお、本チュートリアルでは扱いません。

結合処理で利用します。 前段の処理のいずれかが到達した時点で後続処理を実施します。 前段の処理が到達するたびに実行されます。

結合処理で利用します。 前段の処理がすべて完了した時点で後続処理を実施します。

Activity（Task）、Event、Gatewayの各Itemを結び付ける為に利用します。 SequenceFlowで結んだ順番に処理が実行されます。 遷移元のItemの設定次第で、条件を加え、分岐処理が可能になります。

Workflow内で参照するオブジェクトを格納することができます。 Entityからワークフローを起動する場合、この変数を利用することで登録したEntityデータをワークフロー内で利用することができます。 また、Entityからワークフローを起動する際の、プロセス実行中のメッセージや、ボタンの表示可否を有効にする場合、この変数の設定が必須となります。

AdminConsoleを開き、他MetaData同様、Workflowで右クリックし、「Workflowを作成する」をクリックします。

作成するWorkflowの名前をName項目に設定し、 Save ボタンをクリックします。

作成したWorkflowをダブルクリックすると空のWorkflow設定画面が表示されます。

右上の赤枠のアイコンをクリックすると、水色のグリッド線が非表示となります。 もう一度クリックすると再表示されます。

画面左ペインからItemをドラッグ&ドロップしてWorkflowを組み立てていきます。 配置した各ItemをSequenceFlowで接続していきます。 SequenceFlowは接続対象Item付近にドラッグすることで吸着します。

対象Itemをクリックし選択状態にします。 選択したItemの設定項目が画面右側に表示されます。 右上の「×」アイコンをクリックすることで対象Itemの削除が行えます。 対象Itemを右クリックすることでも削除が可能です。

SequenceFlowを右クリックすると「Itemを削除する」以外に「Point数を変更する」が選択可能です。 3Pointにすると、SequenceFlowを折り曲げることが可能です。

ユーザーに割り当てられたタスク一覧をGEMのTop画面に表示するためのパーツが用意されています。 基本編、実践編ともに、ワークフロー終了やタスクの実行履歴を確認するにあたり、タスク一覧を利用します。 下記の手順に従い、タスク一覧を表示可能な状態にしておいてください。

デフォルトではタスク一覧は表示されません。 AdminConsoleのTopView設定を行う必要があります。

以下を参考に、ワークフローの承認を行うユーザを用意してください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。
次項からはWorkflowを実際に利用する為の準備となります。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

管理者アカウントでログインし、GEMのEntity登録画面から「BasicWorkflowEntity001」の検索画面を開き、 新規作成 ボタンを押して任意のデータを登録してください。 登録したEntityデータの詳細画面を開くと、単純承認ワークフロー起動 というボタンが表示されています。
このボタンはEntityViewで設定したボタン名となっています。 このボタンをクリックすることでワークフローが起動します。

ワークフローの開始メッセージと同時に、EntityViewで設定したプロセス実行中のメッセージが表示されます。

ユーザーID: authorizer@workflow でログインし、 トップ画面のタスク一覧を確認すると、WorkflowのassignRuleに基づいて割り当てがなされた状態になっています。

割り当てられたUserTaskを操作し、承認処理をしてみます。 タスク一覧にある「編集」リンクをクリックします。 下図が表示されます。 必要に応じてコメントを記入し、 承認 ボタンをクリックしてください。 この 承認 ボタンはWorkflowのtaskResultStatusで設定した値となります。

承認が完了すると、この画面がリロードされます。 各項目を確認してみましょう。承認処理が完了していることが分かります。

以上が単純な承認のWorkflowとなります。

以下を参考に、ワークフローの申請を行うユーザーを用意してください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。

単純な承認と同様にワークフローを確認してください。

ユーザーID: user001@workflow でログインしなおし、タスク処理の編集画面を表示してください。 申請可能となっていますので、 申請 ボタンをクリックします。

申請が終ったらユーザーID: authorizer@workflow でログインしなおしてください。 タスク一覧に先ほど申請されたタスクの承認依頼がきています。 編集リンクをクリックし、承認または差し戻しを行います。

今回は 承認 と 差し戻し の2つのボタンが表示されています。 タスク対象データを確認し、承認可能かどうかデータを確認するような利用法が想定されます。 ここで「差し戻し」をクリックします。

差し戻しが終わったらユーザーID: user001@workflow でログインしなおし、タスク一覧に先ほど差し戻されたタスクがあることを確認します。 編集リンクをクリックし、再度申請を行います。

再申請が終ったらユーザーID: authorizer@workflow でログインしなおしてください。 タスク一覧に先ほど申請されたタスクの承認依頼がきています。 編集リンクをクリックし、今度は承認してみましょう。

承認後ワークフロー履歴を確認すると下図のようになっていると思います。 処理結果が差し戻しになり、再申請が行われた後承認されたことが確認出来ます。

以上が差し戻しのWorkflowとなります。

「basic/SimpleWorkflow003」というMailTemplateを準備しておいてください。 件名、メッセージ等は任意の文字列を入力してください。

ローカルでメールの確認がしたい場合のみ「mtp-service-config.xml」の設定が必要になります。 下記の通りMailServiceのlistenerを有効にしてください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。

単純な承認と同様にワークフローを確認してください。

申請と送信 ボタンをクリックします。 ワークフローは完了状態になり、メールが送信されます。 ローカル環境ではEclipseのコンソールにメール内容がログ出力されます。

以上がメール送信処理を含むWorkflowとなります。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。

単純な承認と同様にワークフローを確認してください。

更新する前後のデータを「BasicWorkflowEntity004」の検索画面から検索して確認してみましょう。 承認して更新 ボタンをクリックすることにより、説明項目がupdateRuleで設定した値に更新されます。

ワークフロー完了後に更新されていることを確認しましょう。

以上がEntity操作を含むWorkflowとなります。

「basic/BasicWorkflowCommand005」というCommandを準備しておいてください。

コマンドの作成はAdminConsole画面で「Command」を選択し、右クリックメニューから「コマンドを作成する」を選択します。 下記の通りCommandを作成します。

作成したCommandを開き、 Edit ボタンから下記の内容を設定後、 Save ボタンをクリックして保存してください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWokflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。

単純な承認と同様にワークフローを確認してください。

承認してカスタム処理 ボタンをクリックします。

「BasicWorkflowEntity005」の検索画面から登録されているデータを検索し、 カスタムロジックによってデータが追加されていることを確認しましょう。

以上がカスタムロジック処理を含むWorkflowとなります。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。 起動と同時にメールが送信されることを確認してください。

単純な承認と同様にワークフローを確認してください。

申請 ボタンをクリックします。

分岐したすべてのフローが実行されているかワークフロー履歴から確認します。

以上がスプリットを含むWorkflowとなります。

mtp-service-config.xmlに設定が必要になります。 下記の通りuseQueueをtrueにして下さい。
設定変更を行った際はTomcatサーバの再起動が必要になります。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

以上でWorkflowの設定は完了です。 Save ボタンをクリックして保存してください。

ここからは今までの操作で作成したWorkflowを利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にワークフローを起動してください。

単純な承認と同様にワークフローを確認してください。

申請3分後にメール ボタンをクリックします。

3分後にメールが送信されることを確認します。

以上がタイマーを含むWorkflowとなります。

「practice.PracticeWorkflowEntity001」というEntityを作成してください。

以上でEntityの設定は完了です。 Save ボタンをクリックして保存してください。
この設定により、Entityへのデータ登録後に自動的にWorkflowが起動するようになります。

以下のユーザーを用意してください。 作成済のユーザーについては、改めて用意する必要はありません。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。記載のない項目名については設定不要です。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし、「practice.PracticeWorkflowEntity001」にデータを登録することでWorkflowが自動的に起動します。

単純な承認と同様にワークフローを確認してください。

担当者になっている任意のユーザー（user001@workflow 等）でログインし、 完了 ボタンをクリックします。

MYタスクには表示されなくなります。 「作成したタスク」を選択してください。 担当者が自分ではなくなっていることが確認できます。

担当者になっているユーザーでログインし、 承認 ボタンをクリックしてタスクを完了させます。

完了したタスクを確認すると、以下のようになっていると思います。

以上が問合せ管理Workflowとなります。

「practice.PracticeWorkflowEntity002」というEntityを準備しておいてください。

以上でEntityの設定は完了です。 Save ボタンをクリックして保存してください。
この設定により、Entityへのデータ登録後に自動的にWorkflowが起動するようになります。

今回はUserTaskQueueを利用します。 UserTaskQueueとは、ユーザーに直接タスクを割り当てずに、キューにタスクをプールする方法です。

以下の手順を実施し、事前にUserTaskQueueを利用するためのデータを登録しておきます。

以下のユーザーを用意してください。 作成済のユーザーについては、改めて用意する必要はありません。

以下の2つのMailTemplateを用意してください。

件名、メッセージ内容は任意に設定して下さい。

以下のコマンドを用意してください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。 記載のない項目名については設定不要です。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし、「practice.PracticeWorkflowEntity002」にデータを登録することでWorkflowが自動的に起動します。
メール送信確認のため、メールの項目には必ず値を設定してください。

登録と同時にメールが送信されます。

単純な承認と同様にワークフローを確認してください。

管理者アカウントのトップ画面から、作成したタスクを確認します。

今回は割り当てをユーザーではなくタスクキューにしている為、自動でMYタスクには入りません。
ユーザーID: user001@workflowでログインし、全てのタスクから対象タスクの割当を行います。

MYタスクをみると割り当て済みになってることが確認できます。

MYタスクの編集リンクをクリックし、タスク処理を実施します。

今回は 配送完了 ボタンをクリックします。 完了と同時にメールが送信されます。 なお、タスク処理において配送不可をクリックした場合は請求状況が配送不可として扱われます。

以上が配送管理Workflowとなります。

「practice.PracticeWorkflowEntity003」というEntityを準備しておいてください。

以上でEntityの設定は完了です。 Save ボタンをクリックして保存してください。

以下のユーザーを用意してください。 作成済のユーザーについては、改めて用意する必要はありません。

以下のMailTemplateを用意してください。

件名、メッセージ内容は任意に設定して下さい。

以下のコマンドを用意してください。

下記の通りWorkflowのMetaDataを作成します。

作成したワークフローを表示し、下図のワークフローを作成してください。 具体的な操作は操作方法を参考にして下さい。

各Itemの設定をしていきます。記載のない項目名については設定不要です。

ここからは今までの操作で作成したWorkflowを実施に利用するための準備となります。

ここまででWorkflow利用準備が完了しました。 次項からはWorkflowを利用してみましょう。

管理者アカウントでログインし単純な承認と同様にEntityに任意のデータを作成後、ワークフローを起動してください。
オブジェクト情報は後述の手順で追加するため、ここでは未設定の状態にしておきます。

単純な承認と同様にワークフローを確認してください。

ユーザーID: authorizer@workflow でログインし、 トップ画面のタスク一覧にあるuserTask1の「編集」リンクをクリックします。 表示された「タスク処理」の編集画面にある「タスク対象データ」内のリンクをクリックするとEntity詳細画面がダイアログ表示されるので、 編集 ボタンをクリックします。

表示された編集画面で、議事録に任意のファイル（docx、xlsx、txtなど）を登録して保存してください。 その後、「タスク処理」の編集画面で任意のコメントを入力し、 議事録提出 ボタンをクリックしてフローを進めてください。

議事録提出 ボタンをクリックした時点でメール通知がされます。

回覧先を登録し、回覧先セットを実施します。

ユーザーID: authorizer@workflowでログインし、 トップ画面のタスク一覧にあるuserTask2の「編集」リンクをクリックします。
議事録の登録時と同様に、Entityデータの編集画面にて以下の回覧先を選択して保存します。

ここでセットしたユーザーが承認/否認実施者となります。

その後、userTask2の編集画面で任意のコメントを入力し、 回覧先セット ボタンをクリックしてフローを進めてください。

回覧先セット ボタンをクリックした時点でメール通知がされます。

セットしたユーザーで承認するか、タイマーで設定した時間待機します。 承認判定が完了した時点でメール通知がされます。

ワークフローが完了したら、承認者リストが登録され、ロックされていることを確認します。

以上が議事録承認Workflowとなります。