ワークフローに関するアクティビティ

最終更新日時 2024年12月20日

テキストの一致を確認

UiPath.Core.Activities.IsMatch

説明

指定した正規表現と、指定した一致オプションを使用して、指定した入力文字列の中で一致が見つかったかどうかを示します。このアクティビティには、正規表現ビルダー ウィザードが含まれています。このウィザードの設定については、こちらをご覧ください。

プロジェクトの対応 OS

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

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

検索対象のテキスト - 一致を検索する文字列です。
Pattern - 一致させる正規表現パターンです。

その他のプロパティ

パターンのオプション - 一致のためのオプションを指定する列挙値のビット単位の組み合わせです。
結果 - 正規表現で一致するものが見つかった場合は True、そうでない場合は False に設定されるブール変数です。

Windows - レガシ、Windows での設定

デザイナーパネル

正規表現を設定... - 正規表現ビルダー ウィザードが開き、一致させる正規表現パターンを指定できます。

プロパティパネル

共通

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

入力

Pattern - 一致させる正規表現パターンです。
パターンのオプション - 一致のためのオプションを指定する列挙値のビット単位の組み合わせです。
検索対象のテキスト - 一致を検索する文字列です。
タイムアウト (ミリ秒) - パターンマッチング操作を実行可能な最大時間 (ミリ秒単位)。この時間を超えると操作が終了します。このプロパティは、複雑なパターンや非効率的なパターンを処理するときにアプリが低速化したりフリーズしたりするのを防ぐために不可欠です。パターンマッチが設定された時間内に完了しない場合、例外がスローされ、アプリケーションは応答可能な状態が維持され、アプリケーションを過負荷にしようとする攻撃からも保護されます。

重要:
アプリケーションの安定性とセキュリティを向上させるために、タイムアウト値を設定することを強くお勧めします。

その他

プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
結果 - 正規表現で一致するものが見つかった場合は True、そうでない場合は False に設定されるブール変数です。

[テキストの一致を確認] アクティビティの使用例

このワークフローでは、[テキストの一致を確認] アクティビティをカスタムの正規表現と組み合わせることで、メールアドレスの妥当性を検証する方法について説明します。

サンプルと同等のオートメーションプロセスは以下のように構築できます。

Studio を開いて、新しいプロセスを作成します。
ワークフローデザイナーに [シーケンス] コンテナーをドラッグします。

次の変数を作成します。

変数名	変数の型	既定値
`EmailToCheck`	文字列	John.Doe@server.org
`IsMatch`	Boolean

[シーケンス] コンテナーに、[テキストの一致を確認] アクティビティをドラッグします。
[プロパティ] パネルの [検索対象のテキスト] フィールドに変数 EmailToCheck を追加します。
Result (値) フィールドに変数 IsMatch を追加します。
[正規表現を設定] ボタンをクリックして、正規表現をカスタマイズします。この例では、[値] フィールドに式 ^([\w\.-]+@[\w\.-]+\.\w{2,4})$ を追加します。

注: 正規表現のカスタマイズ方法や設定方法の詳細は、こちらをご覧ください。
[テキストの一致を確認] アクティビティの下に [条件分岐 (if)] アクティビティをドラッグします。
[条件] フィールドに変数 IsMatch を追加します。
[条件分岐 (if)] アクティビティの [Then] フィールドに [メッセージボックス] アクティビティをドラッグします。
式 String.Format("{0} is a valid email addess", EmailToCheck) を [テキスト] フィールドに追加します。
[条件分岐 (if)] アクティビティの [Else] フィールドに [メッセージボックス] アクティビティをドラッグします。
式 String.Format("{0} is not a valid email addess!", EmailToCheck) を [テキスト] フィールドに追加します。
プロセスを実行します。入力として追加したメールアドレスが検証され、結果がメッセージボックスに表示されます。

サンプルをダウンロードする