コントロールの属性を検証

UiPath.Testing.Activities.VerifyControlAttribute

説明

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

プロジェクトの対応 OS

Windows - レガシ | Windows

Windows - レガシ、Windows での設定

プロパティ パネル

共通

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

入力

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

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

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

Messages

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

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

その他

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

出力

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

ワイルドカード文字

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

条件

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

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

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

ユース ケース シナリオ

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

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

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

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

• {LeftExpression}: [式] プロパティに指定した式の値を表します。
• {Operator}: [演算子] プロパティで設定される、検証で使用される演算子を表します。
• {Result}: 検証結果であるアクティビティの出力値を表します。

[コントロールの属性を検証] アクティビティの出力メッセージは、次のように設定します: "The output value of {Result}: {LeftExpression} was {Operator} in comparison to the expected value."。

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