デバッグの基本

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

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

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

Run Debug (▶) in the bottom toolbar of the canvas starts a debug run, in every tool. If the trigger has inputs, a dialog asks for their values. In Studio Web, Debug at the top left of the toolbar does the same. The execution panel appears at the bottom of the screen and spans populate in real time as each node executes.

[ 停止 ] ボタンは、セッションを明示的に終了します。プロセスに変更を加えると、自動的にデバッグ セッションも終了します。デバッグ コントロールと実行パネルのレイアウトの完全な概要については、「 キャンバス 」をご覧ください。

実行パネルを読み込む

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

スパン

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

インシデント

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

変数

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

各セクションには専用のタイトルと、値を名前でフィルター処理するための検索フィールドがあり、各セクションには、他のセクションとは別に独自の折りたたみまたは展開状態が保持されます。キーボードからセクションを切り替えることもできます — フォーカスされているセクション ヘッダーで Enter キーまたはスペース キーを押します。親セクションには影響しません。

失敗を特定する

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

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

モック ノードを使用する

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

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

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

ヒント

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

関連ページ

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