プロセスのデバッグ

ソリューションを開発する際に、プロセスをデバッグすることで、問題をより迅速に特定できます。

プロセスのデバッグ」を参照してください。

  1. [ワークフロー] > [ビジネス プロセス] に移動します。

    プロセスのリストが表示されます。

  2. デバッグするプロセスのコンテキスト メニューで、[デバッグ] をクリックします。または、プロセスを開き、プロセス モデリング バーの [デバッグ] をクリックします。

    [デバッグ] ページが開きます。ビジネス プロセスなどのプロセス タイプとプロセス名が表示されます。

  3. 初期値変数値を入力します。

    フォルダまたはドキュメントの初期化変数が使用されている場合は、以下のいずれかのオプションを選択して、ドキュメントをアップロードできます。

    • [新規]: [参照] をクリックし、使用する初期化変数 (ドキュメントまたはフォルダ) に応じて 1 つまたは複数のドキュメントを選択します。

      • ドキュメント変数を使用する場合は新しいドキュメント インスタンスが作成され、アップロードできるドキュメントは 1 つだけです。

      • フォルダ変数を使用する場合は、複数のドキュメントをアップロードできる新しいフォルダが作成されます。

    • [既存]: 既存のフォルダまたはドキュメントを使用してアップロードできます。たとえば、分類された複数のドキュメントと抽出されたデータが格納されたフォルダがある場合、そのフォルダをデバッグに使用できます。インスタンス ID (ドキュメントまたはフォルダ) を指定することも、空のままにすることもできます。(フォルダ: ドキュメントのない空のフォルダーが作成されます。ドキュメント: デフォルトの空のドキュメントを作成します)

    データ オブジェクト初期化変数が使用されている場合は、データ オブジェクト変数内のフィールドのコントロールが表示されます。初期化データの値を設定できます。

    TotalAgility では、デバッグ モードで次の変数タイプがサポートされません。

    • 複合

    • ダイナミック複合

    • チェックリスト

    • データ バックボーン

    • システム

  4. [開始] をクリックします。

    次に示すように、プロセス マップは新しいウィンドウでデバッグ モードで開かれます。プロセスのデバッグ

    ジョブの作成と表示は、TotalAgility Workspace でのジョブの表示の動作と同様に行われます。ビジネス ルールと同期プロセスに非同期ジョブが作成されます。

    デバッグ モードでは、ノードの色がシステム レベルまたはプロセス レベルで設定されている場合でも、ノードは常にデフォルトの色 (青) で表示されます。

    デバッグ ツール バーが表示されます。デバッグ ツールバー

    デバッグ ツールバーには、次のツールが含まれています。

    ツール 名前 説明

    移動

    プロセスをデバッグします。

    ジョブ履歴を表示

    ジョブ履歴を表示します。ノード名、ステータス、ジョブを実行したリソース、ジョブが実行された日付、作業時間、およびコストといった情報を使用して、プロセスが現在の状態に到達した履歴を確認できます。

    変数を表示

    ジョブのすべての変数を表示します。変数値を変更できます。

    埋め込みプロセスの場合、親プロセスと埋め込みプロセスの両方の変数を使用できます。サブジョブの場合、サブジョブ変数のみが使用可能です。

    各アクティビティの入力変数と出力変数を表示および更新することもできます。アクティビティをクリックして、[変数を表示] をクリックします。

    デバッグ モードのプロセスにスキャン キャプチャ アクティビティが含まれている場合、入力変数と出力変数を表示し、変数がドキュメント タイプかフォルダ タイプかに応じて 1 つ以上のドキュメントをアップロードできます。

    通過ポイントを表示

    プロセスに設定されている現在のすべての通過ポイントを表示します。通過ポイントのターゲット日/実際の日付を変更できます。

    状態を表示

    プロセスに定義されている現在のすべての状態を表示します。ジョブの現在の状態を変更できます。

    フラグメントをデバッグし、フラグメント内の状態を更新しようとすると、次のメッセージが表示されます。ケース定義の状態が正常に変更されました

    ケース定義の変更状態履歴で、更新された状態を確認できます。

    イベントを表示

    プロセスに定義されている現在のすべてのイベントを表示します。イベントを発生させることができます。

    [情報]

    次のようなジョブの概要を表示します。ジョブ ID、プライマリ マップ名、プライマリ マップ バージョン、ジョブを作成したリソース、ジョブの作成日、ジョブ ステータス、ジョブの終了時間。また、アクティビティ情報も表示します。たとえば、生成 AI アクティビティの場合は入力と応答が表示されるため、応答が正しいかどうかを判断できます。

    [スキンの再評価]

    [スキンの再評価] ダイアログ ボックスを開いて、変数値やライブ アクティビティを更新できます。

    [終了予定時間]

    [終了予定時間の編集] ダイアログ ボックスを開いて、ジョブを完了させる終了予定日時を表示します。必要に応じて、終了予定時間を更新することができます。

    [リソース]

    [変動ロール リソースの編集] ダイアログ ボックスを開いて、変動ロールのリストを表示します。

    [プロセス設計メモ]

    [プロセス設計メモの追加] ダイアログボックスを開いて、プロセスにメモを追加します。

    ズーム スライダー

    プロセス マップの拡大/縮小を行います。

    概要

    パネルにジョブの概要を表示します。特定のアクティビティに移動 (パンまたはズーム) できます。

    [サイズに合わせてズーム]

    画面上のプロセス全体を調整して、スクロールバーを使用しなくても全体が表示されるようにします。

    [方向]

    マップを垂直方向に表示します。

    [凡例]

    各ジョブ ステータスの色の凡例を表示します。

    [リフレッシュ]

    ページを更新します。

    [以前を表示]

    以前のプロセス マップを表示します。

  5. ブレークポイントを設定するには、アクティビティをクリックして[ブレークポイントを設定] を選択します。

    アクティビティ内の赤い四角マークは、ブレークポイントを示します。ブレークポイントを設定すると、[ブレークポイントを削除] オプションが利用可能になります。ブレークポイントを削除するには、アクティビティをクリックして、必要に応じてオプションを選択します。

    ブレークポイントを削除または再起動すると、最初のブレークポイントは無視され、アクティビティの実行は次のブレークポイントで停止します。

  6. をクリックして、プロセスをデバッグします。

    • 手動アクティビティとエクスポート アクティビティは、同期ノードとして実行されます。

    • ビジネス ルール アクティビティ、埋め込みプロセス、およびサブジョブが含まれる自動アクティビティは、通常モードの場合と同様に実行されます。ブレークポイントが設定されている次のノードで実行が停止し、「続行」をクリックすると、実行が継続されます。すべての依存先が満たされた場合にのみジョブが進行します。

    • SignDoc アクティビティおよび TCM アクティビティをデバッグする場合、それらにブレークポイントを設定して、強制的に実行する必要があります。そうしないと、同期ノードのように実行されます。ブレークポイントの設定によって、デバッグの実行を停止して、SignDoc サーバーおよび TCM サーバーからのコールバックを待機できます。

    • 生成 AI アクティビティをデバッグするときに、アクティビティが失敗し、追加情報がプロバイダーから返された場合は、入力と 応答を含む詳細が表示されます。実行時に、ジョブのメモに同じ詳細が表示されます。

  7. ブレークポイントが原因で実行が停止した場合は、アクティビティを操作してジョブを再起動します。ノードをクリックして、いずれかのオプションをクリックします。
    • [次を再起動]: 現在のノードを実行し、次のノードで停止します。

    • [ここから再起動]: ジョブを再起動します。

  8. [閉じる] をクリックして、デバッグ モードを閉じます。