デバッグの基本

ビルド キャンバスのフローでのデバッグ。実行の範囲、インシデント、失敗の検査、モック出力をカバーし、ワークフローを単独でテストする場合

フローでのデバッグは、ビルドしたキャンバスと同じキャンバスで行われます。個別のデバッグ ビューはありません。プロセスを実行して、実行パネルで結果を調べ、問題を発見したら変更を加えます。

デバッグ セッションを開始する

ツールバーの [デバッグ ] ボタン でプロセスを実行します。実行パネルは画面の下部に表示され、各ノードの実行に応じてスパンがリアルタイムで入力されます。

The Stop button ends the session explicitly. Any change to the process also exits the debug session automatically. Refer to The Canvas for a full overview of debug controls and the execution panel layout.

実行パネルを読み込む

[実行] パネルには 3 つのタブがあります。それぞれが異なる質問に答えます。

スパン

[ スパン ] タブには、実行トレースが表示されます。実行されたすべてのノードが、タイミング、成功または失敗インジケーターとともに順番に表示されます。スパンを選択すると、対応するノードがキャンバス上で強調表示されるため、実行がどこに到達したかを正確に確認しやすくなります。

インシデント

[ インシデント ] タブでは、実行中に発生したエラーがノードごとにグループ化されて収集されます。各グループは既定で展開されているため、グループ内のエラーや警告がすぐに表示されます。各インシデントでは、失敗したノードの名前とエラー メッセージが含まれます。プロセスが予期せず停止した場合は、まずここを確認してください。

変数

[ 変数 ] タブには、ランタイム変数の値が、 入力 (ワークフローに渡される値)、 出力 (ワークフローで生成された値)、 変数 (ワークフロー内の変数) の 3 つのセクションに分かれています。[ スパン ] タブでスパンを選択すると、[ 変数 ] タブが更新され、実行のその時点でのステートが表示されます。これを使用して、アップストリーム ノードが期待したデータを生成したことを確認します。

Each section has its own title and a search field for filtering values by name, and each keeps its own collapse or expand state independently of the others. You can also toggle a section from the keyboard — press Enter or Space on a focused section header without affecting its parent section.

失敗を特定する

デバッグの実行後、キャンバス上の各ノードに成功または失敗のインジケーターが表示されます。[ スパン ] タブで失敗したノードのスパンがキャンバス上で強調表示されます。[ インシデント] タブにエラー メッセージが表示されます。障害が発生したノードのプロパティ パネルの [出力] セクションにエラー オブジェクト全体が表示されます。

エラー オブジェクトには、 message フィールド (人間が判読できる説明) と detail フィールド (技術的原因) が含まれます。messageにはユーザーに表示される失敗の概要が含まれているため、 から始めます。

モック ノードを使用する

モック出力を使用すると、プロセスの一部を単独でテストできます。ノードにモック出力を設定すると、実際の実行はスキップされ、代わりにテスト データが下流に挿入されます。

これは、アップストリーム ノードの動作が遅い場合、ローカルで利用できない資格情報が必要な場合、または外部システムに依存している場合に便利です。ノードをダブルクリックすると展開ビューが開き、モック出力を下流のノードが期待する任意のデータに設定できます。

一度に複数のノードをモックすると、デバッグ セッションはプロセスの特定のセクションに集中できます。

ヒント

• スパンが最初、インシデントが 2 番目に増加します。スパンは、実行の全体像を示します。インシデントは、何が壊れたかのみを示します。
• 変数値によってデータの不一致が明らかになります。ノードが受信したデータと、次のノードが予期したデータを比較します。
• 外部の依存関係をモックすると、反復処理を高速化できます。API を呼び出したり、RPA プロセスをトリガーしたりするノードをモックすると、外部システムを待つことなくロジックをデバッグできます。
• 小規模な反復処理の方が高速です。デバッグ サイクルごとに 1 回の修正は、すべてを 1 回のパスで修正するよりも効率的です。
• ノード名をわかりやすくすると、トレースが読みやすくなります。スパンとインシデントはノード名を参照します。ノード名は、ノードの動作を説明する名前により、実行トレースをスキャンしやすくします。

関連ページ

• キャンバス — デバッグ コントロールと実行パネルの完全なリファレンス
• エラー処理 — ノードでエラー ブランチを設定する
• 変数とデータ フロー — ノード間で変数がどのように動作するか