繰り返し (ファイル/フォルダー)

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

説明

Microsoft Graph の Microsoft Search API (詳細検索の場合) または Microsoft Graph の Search items API (簡易検索の場合) を使用して、フィルター条件に一致する各ファイル/フォルダーに対して 1 つまたは一連のアクティビティを実行します。

Microsoft Search API の実装の詳細については、以下のリソースをご覧ください。

• Microsoft Search API の概要
• OneDrive および SharePoint のコンテンツを検索するための Microsoft Search API
• 検索可能なサイト プロパティ

注:

このアクティビティでは永続性はサポートされていません。

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

デザイナー パネル

• 繰り返し - 反復処理内の現在のファイルを参照するときに使用する名前を入力します。フォルダー内のファイルの種類がわかる名前を使用すると、[繰り返し (ファイル/フォルダー)] 内に追加されたアクティビティを設定するときに、現在のファイルの識別と選択が容易になります。たとえば、レポートを含むフォルダーには、「Report」と入力できます。既定値は [DriveItemです。

プロパティ パネル

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• 詳細検索 - 取得するファイルやフォルダーを検索する、キーワード クエリ言語 (KQL) を使用したクエリです。
  注:

  このアクティビティは、[ファイル リポジトリ] で指定された場所と [フォルダー] パラメーターの値から作成された URL による documentLink プロパティ制限を使用します。[詳細検索] パラメーターの「documentLink:」または「path:」プロパティ制限は使用しないでください。

• 簡易検索 - ファイル名、メタデータ、ファイルの内容などの複数のフィールドで、ファイルとフォルダーを検索するのに使用するクエリ テキストです。このプロパティでは、 String 変数と文字列形式の値がサポートされています。
• 簡易検索を使用 - アクティブにすると、詳細検索ではなく簡易検索が使用されます。このオプションがアクティブな場合、[サブフォルダーを含む] パラメーターは無視されます。このフィールドでは、Boolean 値がサポートされています。
  注:

  [簡易検索を使用] を選択した場合、[ファイル リポジトリ] プロパティでは、[OneDrive]、[SharePoint]、および [特定の URL] のオプションのみがサポートされます。 このアクティビティが、[Microsoft Office 365 スコープ] アクティビティ内で使用されており、[簡易検索を使用] オプションがオンになっている場合は、個人用の Microsoft アカウントが使用でき、また認証の種類として [ApplicationIdAndSecret] と [ApplicationIdAndCertificate] が使用できます。

その他

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

オプション

• アカウント - OneDrive を所有するユーザーの ID またはユーザー プリンシパル名です。認証の種類が ApplicationIDandSecret と ApplicationIDAndCertificate の場合は、このパラメーターを設定する必要があります。このプロパティは、String 型変数と文字列形式の値をサポートします。
• フォルダー - 指定したファイル リポジトリ内の、検索対象のフォルダーのパスです (例: SomeFolder または SomeFolder/AnotherFolder)。空白の場合はルート フォルダーが検索されます。このプロパティは、[ファイル リポジトリ] が [All] に設定されている場合は考慮されません。このプロパティでは、String 型変数と文字列形式の値がサポートされています。
• サブフォルダーを含む - 選択したクラウド上の場所のすべてのサブフォルダーを検索対象に含めるかどうかを指定します。このフィールドでは、Boolean 値がサポートされています。
• 上限数 - 返されるファイルとフォルダーの最大数です。空白の場合、フィルター条件に一致するすべてのファイルとフォルダーを取得します。このフィールドでは整数および Int32 型の変数のみがサポートされています。既定値は 200 です。
• 重複を除外 - 重複するファイルまたはフォルダーの項目を、検索結果から除外するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は [False] です。
• 返す対象 - 返す対象として、ファイルのみ、フォルダーのみ、または両方のいずれかを選択します。
  • ファイルとフォルダー
  • ファイル
  • フォルダー

出力

• インデックス - 使用中のコレクションで繰り返し処理される要素を指定するゼロベースのインデックスです。このフィールドでは整数および Int32 型の変数のみがサポートされています。

リポジトリ

• ファイル リポジトリ - ファイルやフォルダーを検索する対象のファイル リポジトリです。[すべて]、[OneDrive]、[SharePoint]、[特定の URL] の 4 つのオプションのいずれかを選択します。既定値は [すべて] です。

• SharePoint ドキュメント ライブラリ - 指定された SharePoint サイト内のドキュメント ライブラリです。 このプロパティは、String 型変数と文字列形式の値をサポートします。

• SharePoint サイト URL - 検索対象の SharePoint サイトの URL です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

• 特定の URL - 検索する特定の場所の URL です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

  注:

  Microsoft Search API では、重複するファイルまたはフォルダー項目が返されることがあります。[重複を除外] オプションを選択すると、検索結果から重複が除外されます。

フィルター処理の例

次の表に、詳細検索のクエリ フィルター式の例を示します。これらの式は、簡易検索ではサポートされていません。

簡易検索で、ファイル名、メタデータ、およびファイルの内容で一致するフリーテキストの用語を入力します。たとえば、Excel ファイルと照合するには、「 .xlsx 」と入力します。fileextension:xlsx などのキーワード クエリ言語 (KQL) フィルターは、詳細検索でのみ機能します。

クエリ	フィルター式
指定した場所のすべての Excel ファイル	"fileextension:xlsx"
指定した場所のすべてのテキスト ファイルおよび Portable Document Format ファイル	"fileextension:txt OR fileextension:pdf"
次の名前のすべてのファイル: "Agenda Brief.xlsx"	"filename:""Agenda Brief.xlsx"""
ファイル名に "users" という単語を含むすべての Excel ファイル	"fileextension:xlsx AND filename:users"
2021 年 6 月 14 日に変更された、ファイル名に「 "users" 」という単語が含まれるすべての Excel ファイル	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
2021 年 6 月 14 日より前に変更された、ファイル名に「 "users" 」が含まれるすべての Excel ファイル	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
2021 年 6 月 12 日より前に "John Smith" によって作成されたすべてのファイルおよびフォルダー	"createdby:""John Smith"" AND created<06/12/2021"
次のユーザーと明示的に共有されているすべてのファイル: "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""