トラブルシューティング

Maestro Automate で最も一般的なエラーの意味と、ワークフローで、または管理者の支援を受けてエラーを修正する方法

ほとんどのエラーはノードの設定方法に起因しており、エラーはキャンバス上で自分で修正できます。一部は会社の UiPath アカウントの設定方法に起因しており、管理者だけが修正できます。以下に表示されるメッセージを見つけます。

デバッグ モードでの実行が失敗すると、失敗したノードが赤に変わり、[ インシデント ] タブにメッセージが表示されます。「デバッグの基本」では、どこを探すべきかについて説明します。

ワークフローで修正する

ノードに黄色の警告アイコンが表示される

ノードの必須フィールドが空です。ワークフローをテストする前に、ノードを選択し、必須としてマークされたフィールドに入力します。

「プロセスには少なくとも 1 つのトリガー ノードが必要です」

このワークフローにトリガーがないため、何も開始できず、 デバッグ は利用できないままです。手動トリガーなどのトリガーを追加し、最初のノードに接続します。[トリガー] にオプションが一覧表示されます。

「アクティビティ入力の式を評価できませんでした」と「予期しないトークン」

[ 式 ] に設定されたフィールドには、引用符なしで URL などのプレーン テキストが格納されるため、コードとして読み取られます。次のいずれかの操作を行います。

• フィールドを [固定値] に切り替えます。
• テキストを引用符で囲みます (例: "https://dummyjson.com/products/" + $vars.newOrder.output.productId)。

式の構文では、 2 つのフィールド モードについて説明します。

「プロパティ 'X' は 型に存在しません。」

この式は、通常はタイプミスが原因で存在しないノードまたはフィールドを指します。一般的なケースは、名前を 2 回入力した場合です (例: productIdproductId:入力するとエディターによって名前が提案され、それも入力すると 2 つ目のコピーが追加されます)。ノード ID は、キャンバス上に表示されている名前と異なる場合があります (例: httpRequest1)。参照を入力する代わりに、フィールド ラベルの横にある [ 挿入 ] メニューから参照を選択すると、存在する値のみが一覧表示されます。

「Cannot read property 'length' of null」

この式は、空の値のフィールドを読み取ります。これは、たとえば、以前のノードが何も返さなかった場合に発生します。実行トレースで前のノードの出力を確認し、 が値を返すことを確認します。空の値を許可するには、任意のチェーンを使用します (例: $vars.getOrders.output?.length)。式の構文で 説明します。

「名前またはサービス不明」

メッセージ全体は次のとおりです。「Integration Service の操作に失敗しました。統合 HTTP 要求がステータス コード「502」で失敗しました。メッセージ: 名前またはサービスが不明です。」HTTP 要求ノードが URL のアドレスに到達できないのは、通常はホスト名が間違っていることが原因です。URL にタイプミスがないか確認し、ブラウザーで開いて応答することを確認します。デプロイ済みの実行で失敗が発生した場合は、URL を修正して再度デプロイしてから、「 リトライとキャンセル 」の説明に従って、失敗した実行をリトライまたはキャンセルします。[HTTP 要求 ] では、ノードのフィールドを記述します。

「ジョブに関連付けられたプロセスが見つかりませんでした」

ワークフローが、まだデプロイされていない API ワークフローを呼び出します。最初に API ワークフローをデプロイしてから、再度テストします。Maestro Automate または「API ワークフロー 」では、この 2 つがどのように連携するかについて説明します。

その他の式エラー

式の構文: よくあるエラー には、 undefined 値、予期しない動作を示す条件、ノードで使用できない値などのエラーが含まれます。

管理者に問い合わせる

一部の問題は、会社の UiPath アカウントの設定方法から生じます。管理者に正確なメッセージと、オンにする必要がある機能がリストされた [管理] へのリンクを送信します。

• プロジェクトを作成すると、Maestro Automate が表示されません。
• Slack や Gmail などのアプリにコネクションを追加することはできません。
• ワークフローを構築することはできますが、テストやデプロイはできません。
• ドキュメントや人間を必要とするノード ( クイック フォームなど) は使用できません。

自分で登録した場合は、アカウントを使用する準備が整っており、管理者は必要ありません。「登録」には、含まれる内容が記載されています。

VS Code の問題

VS Code に固有のサインイン、CLI、およびデプロイの問題については、「 VS Code 拡張機能: トラブルシューティング」で説明されています。

次のステップ

• デバッグの基本: ワークフローをテストし、結果を読みます。
• エラーを処理する: ワークフローが自律的に失敗から回復できるようにします。
• コミュニティ: 行き詰まったときは、他のビルダーに尋ねてください。