ファイル/フォルダーのリストを取得

UiPath.MicrosoftOffice365.Activities.Files.GetFileListConnections

説明

指定した OneDrive または SharePoint の場所からファイルまたはフォルダーのリストを取得します。

スコープ

このアクティビティには、次のスコープが必要です。

• Files.Read

OR

• Files.ReadWrite

OR

• Files.Read.All

OR

• Files.ReadWrite.All

OR

• Sites.Read.All

OR

• Sites.ReadWrite.All

プロジェクトの対応 OS

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

構成

• Microsoft OneDrive & SharePoint - アクティビティで使用する Microsoft 365 アカウント用のコネクションです。
• 検索場所 - ファイルやフォルダーを検索す場所です。取得するファイルまたはフォルダーの指定方法 ([[ID を入力]、[URL を入力] または [変数を使用]) です。
  • フォルダー ピッカーオプション - OneDrive または SharePoint のフォルダーを参照してファイルまたはフォルダーを選択します。このフィールドでは IResource 型の入力を使用できます。

  • [ID を入力] オプション:

    • ファイルまたはフォルダーの ID - ファイルまたはフォルダーの ID です。ID を取得するには、OneDrive Web でファイルを開き、その URL を取得します。URL 内の ID はエンコードされています。たとえば、URL が https://yourcompany.sharepoint.com/Doc.aspx?sourcedoc=%7BA1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85%7D&file=Merge_sheets.xlsx の場合、デコードされたファイル ID は A1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85、%7B、%7D となります。このプロパティでは、String 型の変数と文字列形式の値がサポートされています。
    • SharePoint サイト アドレス - ファイルまたはフォルダーを含む SharePoint サイトの URL です。ブラウザーで SharePoint サイトを開き、URL を取得します (例: https://yourCompany.sharepoint.com/sites/Marketing)。このプロパティでは、String 型変数と文字列形式の値がサポートされています。
    • SharePoint ドキュメント ライブラリ - ファイルまたはフォルダーを含む、指定した SharePoint サイト内のドキュメント ライブラリです。ブラウザーで SharePoint サイトを開き、[ドキュメント] タブに移動して URL を取得します (例: https://yourCompany.sharepoint.com/sites/Marketing/Shared%20Documents/Forms/AllItems.aspx)。このプロパティでは、 String 型変数と文字列形式の値がサポートされています。

  • [URL を入力] オプション:

    • File or folder Url - The URL of the file or folder. This property supports String variables and string formatted values. Retrieve the URL by opening the file in a browser.

  • Use the See more button menu to use a variable or select the Reload Folder Data option if you've modified your folders and need to retrieve the latest data.

その他のオプション

オプション

• 上限数 - 返されるファイルとフォルダーの最大数です。空白の場合、無制限になります。このフィールドでは、Int32 型変数と Int32 形式の値がサポートされています。
• 返す対象 - 返す対象を指定します。ドロップダウン メニューから、以下の利用可能なオプションのいずれかを選択します。
  • ファイル - ファイルを取得します。
  • ファイルとフォルダー - ファイルとフォルダーを名前順に取得します。
  • フォルダー - フォルダーを取得します。
• 重複を除外 - Boolean 値です。重複するファイルやフォルダーを検索結果から除外する場合は、True に設定します。
• Simple search - The query text used to search for files and folders across several fields (such as file name or file content). This property supports String variables and string formatted values. Use the See more button menu to switch to Advanced search, Free Text Filter, or Metadata search.

• 詳細検索 - ファイルとフォルダーをフィルター処理するために定義された詳細な検索条件です。[詳細検索] は、個人用の Microsoft アカウントを使用している場合はサポートされません。[詳細検索] では、フィルター ビルダーを使用して検索条件を設定します。

  • サブフォルダーを含む - Boolean 値です。True に設定すると、選択した場所にあるすべてのサブフォルダーが検索対象に含められます。
    Note: Filtering by File extension in the Filter builder might not work for extensions such as .avi, .svg, .gif, .ico, .jpeg, .jpg, .mov, .mp3, .mp4, .ogg, .png, .rtf, .tiff, .wav, .webm, .webp, or .wmv. Filtering by Last modified by or Shared with user might return incomplete results.
• Free text filter - Search for a list of files or folder by a free text. This field supports String type input.
• Metadata filter - Filter by item metadata. This field is dynamically populated if you select a SharePoint document library for the In location field.

出力

• ファイルまたはフォルダー - アクティビティが取得するファイルのリストです。自動的に生成される出力変数です。そのまま使用することも、別の名前で保存することもできます。他のアクティビティで使用できます。

例

以下の記事もご覧ください。

• ファイル アクティビティ

• 繰り返し (ファイル/フォルダー)
• ファイル/フォルダーを移動
• ファイル/フォルダーをコピー