Fallback Procedures (JA)

2.5 フォールバック手順

T-Plan Robot Enterprise バージョン 2.3 では、いわゆるフォールバック手続きが導入されました。これは予約された名前の手続きで、特定の条件(イベント)が満たされたときに自動的に呼び出されます。フォールバック手続きは、それ以外は標準的な手続きであり、一般的な手続き規則がすべて適用されます。above が適用される。要するに、(1)名前の大文字と小文字は区別されない。Include または Run (3)プロシージャは、それを呼び出すコードの前に定義されていなければならない。

DisconnectFallback と 呼ばれるプロシージャは、VNCサーバへの接続がクラッシュしたときに、initフェーズ（コマンドの内部）か、それ以降に呼び出されます。Connectコマンドの内部)、またはサーバが終了(kill)したときやネットワークエラーが発生したときなど、それ以降の任意のタイミングで呼び出されます。コマンドの呼び出しは Disconnect コマンドの呼び出しは、予期された接続の終了であるため、プロシージャを開始しません。Connectがフォールバック・プロシージャ本体で呼び出された場合、無限接続ループを防ぐために、失敗時にプロシージャを再度呼び出すことはありません。スクリプト実行中の通常操作フェーズで接続のクラッシュが検出されると、現在実行中のコマンドが終了した直後にプロシージャが呼び出されます。このような場合、サーバーに正しく転送されたデータの範囲が不明なため、プロシージャを安全なリカバリ（再接続とスクリプトの再開を意味する）に使用できない可能性があることに注意してください。これは、例えばテキスト入力の途中でクラッシュが発生し、接続に失敗する前に何文字が正常に入力されたかを判断できない場合に問題となります。
ComparisonFailureFallbackと 呼ばれるプロシージャが Compareto Command または Waitfor Command のマッチ/ミスマッチが失敗し、onfail または ontimeout パラメータで明示的なフェイル・アクションが指定されていない場合に、ComparisonFailureFallback と呼ばれるプロシージャが実行されます。プロシージャ本体内で"{1}"として取得できる最初のプロシージャ引数には、常に呼び出し元の比較コマンドの数値終了コードが含まれます。これは通常、オブジェクトが見つからない場合は "1"、1つ以上のテンプレート画像が見つからないか、読み取ることができない場合は "2 "となります。

次の例は、フォールバック手続きの使用方法を示しています。どちらも単に特定の終了コードでスクリプトを終了します。比較の方は、さらに、後でデバッグできるようにスクリーンショットを作成します。この例は、他の適切なアクションを実行するように簡単に拡張できる。Sendmail コマンドによる電子メールの送信や Pause.

Procedure DisconnectFallback {
Exit 3
}

Procedure ComparisonFailureFallback {
Screenshot comparison_failure.png
Exit {1}
}

// スクリプト本体
Connect localhost:1 password=welcome
Compareto button.png method=search
// ...

バージョン 7.2.4 では、BrowserFailureFallback プロシージャがサポートされました。スクリプトで定義すると、ブラウザのopen/find/closeコマンドが失敗するたびに呼び出されます。これは、3つの追加引数を公開します：

{1} はコマンドの数値終了コード、
{2} は操作を示します。これは、無関係な呼び出しを除外するために使用できます。

失敗したコマンドが "Browser open/close" の場合、"open" または "close" に設定される。
失敗したコマンドが "Browser find " で、"elaction" パラメータが指定されていない場合、引数は "find" に設定される。
そうでなければ、引数は失敗したエレメントアクションを指定します。"click"、"submit"、"clear"、"type"、"select" のいずれかです。

{3} はエラーメッセージで、通常は実行ログに記録されるものと同じです。

以下はその例です（Chromiumプラグインが必要です）：

Procedure BrowserFailureFallback
Log "Failed action: {2} (exit code: {1})"
Log "Reported error: {3}"
}

Browser open url="https://www.t-plan.com" browser=chromium

// このコマンドは、間違ったボタンテキストに対して失敗し、"BrowserFailureFallback "プロシージャを呼び出します。
Browser find class="elementor-button-text" text="Why T-Plans" timeout=5s