式を演算子で検証

UiPath.Testing.Activities.VerifyExpressionWithOperator

説明

演算子を使用して、指定した式と比較してアサートすることにより、式を検証します。このアクティビティでテストされる式は、対応するプロパティ フィールドに挿入する必要があります。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows - レガシでの設定

デザイナー パネル

• 最初の式 - 検証プロセスの最初の式です。

• 演算子 - 2 つの式を検証するために使用可能なすべての数学演算子を含むドロップダウン リスト。次のオプションを使用できます。

  • 等値
  • 非等値
  • GreaterThan
  • 以上
  • 未満
  • LessThanOrEqual
    • 2 番目の式 - 検証プロセスの 2 番目の式です。
    • 失敗時にスクリーンショットを作成 - True に設定すると、検証に失敗した場合に対象プロセスのスクリーンショットを作成します。
    • 成功時にスクリーンショットを作成 - True に設定すると、検証に成功した場合に対象プロセスのスクリーンショットを作成します。

プロパティ パネル

共通

• 表示名 - アクティビティの表示名です。

入力

• 失敗時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 ([True]、[False]) のみがサポートされています。既定値は [True] です。エラーの発生に関係なくプロジェクトの実行は継続されます。値を False に設定した場合、エラーが発生するとプロジェクトの実行が停止します。
  注: このアクティビティが [トライ キャッチ] に含まれていて、[失敗時に実行を継続] プロパティの値が True の場合、プロジェクトが実行されたときにエラーは発生しません。
• 最初の式 - 検証プロセスの最初の式です。

• 演算子 - 2 つの式を検証するために使用可能なすべての数学演算子を含むドロップダウン リスト。次のオプションを使用できます。

  • 等値
  • 非等値
  • GreaterThan
  • 以上
  • 未満

  • LessThanOrEqual

    • 2 番目の式 - 検証プロセスの 2 番目の式です。
    • 失敗時にスクリーンショットを作成 - True に設定すると、検証に失敗した場合に対象プロセスのスクリーンショットを作成します。
    • 成功時にスクリーンショットを作成 - True に設定すると、検証に成功した場合に対象プロセスのスクリーンショットを作成します。

Messages

• 代替の検証タイトル - 代替表示名を指定します。このプロパティは、既定の DisplayName つまり Orchestrator に表示される検証アクティビティの名前をオーバーライドします。
• 出力メッセージの書式 - 出力メッセージの書式を指定します。グローバル出力メッセージの書式の設定方法については、「プロジェクト設定」をご覧ください。

  詳しくは、「出力メッセージの書式を設定する」をご覧ください。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 結果 - 検証アクティビティのステートを表します。通知を送信したり、失敗した検証のレポートを作成したりするときに使用できます。

Windows、クロスプラットフォームでの設定

• 最初の式 - 検証プロセスの最初の式です。

• 演算子 - 2 つの式を検証するために使用可能なすべての数学演算子を含むドロップダウン リスト。次のオプションを使用できます。

  • 等値
  • 非等値
  • GreaterThan
  • 以上
  • 未満
  • LessThanOrEqual

• 2 番目の式 - 検証プロセスの 2 番目の式です。

  • 失敗時にスクリーンショットを作成 - True に設定すると、検証に失敗した場合に対象プロセスのスクリーンショットを作成します。
  • 成功時にスクリーンショットを作成 - True に設定すると、検証に成功した場合に対象プロセスのスクリーンショットを作成します。

詳細オプション

入力

• 失敗時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみサポートされています。既定値は False です。その結果、フィールドが空白の場合にエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
• 失敗時にスクリーンショットを作成 - True に設定すると、検証に失敗した場合に対象プロセスのスクリーンショットを作成します。
• 成功時にスクリーンショットを作成 - True に設定すると、検証に成功した場合に対象プロセスのスクリーンショットを作成します。

Messages

• 代替の検証タイトル - 代替表示名を指定します。このプロパティは、既定の DisplayName つまり Orchestrator に表示される検証アクティビティの名前をオーバーライドします。
• 出力メッセージの書式 - 出力メッセージの書式を指定します。グローバル出力メッセージの書式の設定方法については、「プロジェクト設定」をご覧ください。

出力

• 結果 - 検証アクティビティのステートを表します。通知を送信したり、失敗した検証のレポートを作成したりするときに使用できます。

ワイルドカード文字

String 型の変数を検証する場合は、ワイルドカード文字を使用して不明な値または任意の値を照合します。ワイルドカード文字は、文字列の先頭、中央、または末尾に連結できます (例: "abc?" = "abc*")。

条件

• ワイルドカード文字をリテラル文字として照合するためには、エスケープする必要があります。
• ワイルドカード文字は 2 つ目の式でのみ使用できます。

サポートされているワイルドカード

ワイルドカード文字	説明
# (番号記号)	単一の文字を照合します (例: `[0-9]{1)。
? (疑問符)	単一の英数字を照合します。
* (アスタリスク)	0 個以上の英数字を照合します。

ユース ケース シナリオ

次の例では、1 つ目の式に含まれる既知の値を照合するために、ワイルドカード記号「#」と「*」が使用されています。

出力メッセージの書式を設定する

[出力メッセージの書式] プロパティは、検証操作で使用される値のプレースホルダーとして機能する、サポートされている引数を使用して設定できます。これらのプレースホルダーには、実行時にアクティビティを呼び出すときに定義した変数または値が自動的に入力されます。

[式を演算子で検証] アクティビティでは、出力メッセージの作成時にサポートされる以下の引数を実装できます。

• {LeftExpression}: [最初の式] プロパティに指定した最初の式の値を表します。
• {LeftExpressionTextName}: [最初の式] プロパティに挿入した最初の式のテキストを表します。
• {RightExpression}: [2 番目の式] プロパティに指定した 2 番目の式の値を表します。
• {RightExpressionText}: [2 番目の式] プロパティに挿入した 2 番目の式のテキストを表します。
• {Result}: 検証結果であるアクティビティの出力値を表します。
• {Operator}: [演算子] プロパティで設定される、検証で使用される演算子を表します。

[式を演算子で検証] アクティビティの出力メッセージは、次のように設定します: "{LeftExpression} {Operator} the {RightExpression}, so the verification is {Result}."。

この例では、中括弧内のプレースホルダーが実行時に対応する変数名とその値に置き換えられ、カスタマイズされた出力メッセージが提供されます。