ワークフローアプリの動作確認方法

チェックリストの作成

設計したアプリは、様々なポイントをチェックして実際の業務で必要な動作が行えているかを確認する必要があります。アプリ設計時のエラーでは、表示されないエラーもあるため、すべての設定が適切に行われているかを確認する必要があります。主にチェックする項目は次のとおりです。

1. ノード（開始イベントから終了イベントまで順序よく接続されているかを確認）
   • フローが接続されていないノードがある場合は、エラー表示されます
2. ノードの設定
   • 工程内の必須項目が未記入の場合はアラートが表示され、設定が完了していないことを知らせます
   • リリース時にアプリが機能するように式やAPI接続の設定に抜け・漏れがないかを確認します
3. データ項目のフィールド名
   • ［フィールド名］は初期設定では空になっています。手動で［フィールド名］を設定してください
   • ［フィールド名］が空の場合は、データ項目にエラーが表示されます
   • ［フィールド名］は”q_” はじまりで、アルファベット、文字、アンダーバーのみ使用可能です
   • ［フィールド名］は重複しないように設定してください。コピーしたデータ項目の［フィールド名］はエラーとなります
4. スイムレーンの処理担当者設定
   • スイムレーンの処理担当者設定では、初期設定として当該アプリを新規作成したユーザが処理担当者として指定されています。タスクがスイムレーン内の各工程の処理担当者に適切に割り当てられるように「処理担当者」設定にて処理担当者を指定します
5. 分岐条件
   • フローの遷移先を選択し、ボタンラベルを設定します
   • 遷移先を決定する条件が正しく設定されているかを確認します
6. データ項目の［説明］欄
   • ［説明］欄にHtmlタグなどを設定して、業務効率を上げることができます

デバッグ実行機能とは？

開発中やリリース前のワークフローアプリの動作確認を行うための機能です。本機能によって実際に業務でアプリを利用する前に、ユーザが確認するポイントや、アプリの動作をアプリ設計者側で確認することができます。

実行方法

ワークフロー図上で開始イベントを選択します。開始イベントのプロパティを開くと、メモ欄の下に［ここからデバッグ用プロセスを開始する］ボタンがあります。クリックすると使用するプロファイルと［すべて自分が担当］オプションの選択画面が開きます。［プロセスの開始］ でデバッグプロセスが開始されます。

続く画面で［開始したプロセスを表示する］をクリックすると開始されたプロセスの詳細ページが新しいタブで開きます。通常のプロセスと同様に、タスクの処理を開始してデータ項目への入力/保存を行うことができます。処理を完了すると次の工程に進み、終了イベントに到達するまでフローが継続します。

通常の動作と異なるポイント

デバッグ実行で開始されたプロセスは通常のプロセスと同様の動作を行います。但し、［マイタスク］の一覧では デバッグ実行用のアイコンが表示されます。

アプリがリリースされると、当該アプリで実行されたデバッグプロセスは自動的に削除されます。

オプション

1. プロファイル
   • アプリ編集画面の［変数設定］で設定したプロファイルを選択します
   • プロファイルにはそれぞれに異なるメールアドレス等の属性を設定でき、選択したプロファイルに応じてプロセスの動作が変化します
2. 「すべてのタスクを自分が担当」設定
   • 「すべて自分が担当」にチェックを入れると、スイムレーンの処理担当者設定に関わらず、デバッグプロセスを実行しているユーザが全てのタスクを担当します
   • 「すべて自分が担当」オプションが選択されていない場合、スイムレーンの処理担当者設定で設定した処理担当者に割り当てられます
     • Questetra からの通知メールには、メール件名に「(Debug)」が含まれます

変数設定

アプリ編集画面の［変数設定］ではプロファイルを利用することで、アプリ内の工程の設定項目に指定される変数の値をまとめて変更することができます。

ドロップダウンメニュー横の「＋」（プラスボタン）をクリックし、オリジナルのプロファイル名を入力してプロファイルを作成します。

• 変数名はラベルとして自由に設定することができます（例：「メールアドレス」）
• 変数の値は、メールアドレスなど、工程内の設定項目に関係している値に設定する必要があります

変数を利用する場合は、フィールドに挿入する式は「${var[Variable Name]}」で表されます。（「Variable Name」の部分は変数設定で設定した変数名に置き換えられます）

例えば変数設定で、２つのプロファイル（「プロファイル１」、「プロファイル２」）を設定し、変数名を「メールアドレス」、値としてメールアドレスを設定します。（ プロファイル1：steve@questetra.com、プロファイル2：jane@questetra.com）「メッセージ送信中間イベント（メール）」が設置されているアプリでは、「メッセージ送信中間イベント（メール）」の宛先欄に、変数設定で設定した変数（${var[メールアドレス]} ）を挿入することができます。 変数設定として「プロファイル１」を選択した場合、「メッセージ送信中間イベント（メール）」では、「steve@questetra.com」宛にメールが自動的に送信されます。「プロファイル2」を選択した場合は、「jane@questetra.com」宛にメールが自動的に送信されます。

変数は、プロファイルを切り替えてそれぞれのフィールドに合った出力がされるように複数設定することができます。変数は、入力必須のフィールドで使用することができます。（ただし、ドロップダウンメニューやラジオボタンが含まれるフィールドには使用できません）

デバッグ実行プロセスの判定（Ver. 14.1〜）

分岐条件式やスクリプト工程にて、実行中のプロセスがデバッグ実行かどうかを判定できます。
例えば、デバッグ実行プロセスの場合、「メール送信」の工程をスキップするようにワークフローを定義できます。

• ゲートウェイの分岐条件式
  • 分岐条件にて、SpEL 式で「processInstanceDebug == true」を指定します
  • デバッグプロセスであると判定されると、指定された遷移先に処理が進みます
• スクリプトタスク
  • スクリプトに「if (processInstance.getProcessInstanceDebug() === true) { }」と記述します
  • デバッグプロセスであると判定されると、そのブロックが処理されます

注意点

• デバッグ実行機能は、通常のプロセスと同様の動作を行います。そのため、「メッセージ送信中間イベント（メール）」でメール送信をすると指定した受信者にメールが届きます。API接続も通常のプロセスと同じように行われます
• デバッグ実行機能は、通常の開始イベントが設置されているアプリにのみ起動することができます
  • 開始イベントはアプリがリリースされるとすぐに起動します（タイマーイベントでは指定時刻に新規プロセスが自動的に開始されます）
  • 「タイマー開始イベント」や「メッセージ開始イベント（メール）」などの自動開始イベントのみが設置されているアプリでデバッグを実行する際は、一時的に「開始イベント」を設置してください
  • デバッグ実行が完了したら、アプリリリース前に開始イベントを削除してください