Match 関数 (プレビュー)

MATCH 関数: Excel の MATCH 関数を使用して範囲内の値の相対位置を検索するワークブック アクティビティです。

UiPath.Excel.Activities.MatchFunction

説明

Excel の MATCH 関数を使用して、範囲内の値の相対位置を求めます。これは、Windows の [関数を一致 ] アクティビティと同等のクロスプラットフォーム アクティビティです。

注:

このアクティビティでは ファイルの .xls はサポートされていません。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

プロパティ

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

入力

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• シート名 - ブックのシートの名前です。
• 範囲 - 検索対象の範囲です。このフィールドは必須です。
• 検索値 - 検索する値です。このフィールドは必須です。
• 照合の種類 - ルックアップ値を範囲と照合する方法を選択します。既定値は 1 (一致する値以下の最大値) です。以下のオプションから選択できます。
  • 1 (一致する値以下の最大値) - ルックアップ値以下の最大値を検索します。範囲は昇順に並べ替える必要があります。
  • 0 (一致する値とちょうど等しい最初の値) - 検索値と等しい最初の値を検索します。範囲は任意の順序にすることができます。
  • -1 (一致する値以上の最小値) - 検索値以上最小値を検索します。範囲は降順に並べ替える必要があります。

オプション

• パスワード - ブックのパスワードです (必要な場合)。

出力

• 位置 - 範囲内の一致の位置を 1 から開始し、 Int32 変数として格納されます。アクティビティで一致が見つからない場合、この値は -1 されます。

ブックを使用する

• ブック - ファイル パスの代わりに使用する既存のブックです。

備考

• 位置 は、シートではなく範囲を基準にした相対位置です。たとえば、範囲の 3 番目のセルに一致すると、シート上で範囲が始まる場所であればどこでも 3が返されます。
• 範囲は [シート名] のシートを参照する必要があります。Sheet2!A2:A100などのシート名を含む範囲はサポートされていないため、エラーが発生します。
• A:Aなどの列全体または行全体の範囲は、シートで使用される範囲に制限されます。
• [ 範囲 ] が空の場合、または [ 検索値 ] が nullの場合、アクティビティはエラーで失敗します。