Search Drive Items
Prerequisite Permissions: Search Drive Items step need the following permissions.
| Permission type | Permission (from least to most privileged) |
|---|---|
| Delegated (work or school account) | Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All |
| Delegated (personal Microsoft account) | Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All |
Description
This step searches for files and folders on OneDrive based on a search query. You provide the search text, and the step returns matching items. Use this step in workflows that locate specific files before downloading or processing, find documents by name or content, or discover items across your OneDrive storage.
Note:
- Support is provided for the Personal Drive, however, the displayed error message is not correct.
Reference: https://docs.microsoft.com/en-us/graph/api/driveitem-search?view=graph-rest-1.0&tabs=http
Configurations
| No. | Field Name | Description |
|---|---|---|
| Configuration: | ||
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | ||
| 2 | Client ID | Select the client ID for which you want to copy a file or folder. Note: This field is mandatory for personal accounts. |
| 3 | Checkbox: Accept value as variable/static | Leave checkbox unchecked to accept Refresh Token value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Refresh Token field to appear as Text box. |
| 4 | Refresh Token | Specify the Refresh Token provided by authorization grant flow. The data type is String. This field is mandatory. |
| 5 | Button: Test Connection | Verifies whether the connection is established or not. |
| Input Tab | ||
| Input Fields: | ||
| 1 | Query Text | Provide the query text to search the items present in OneDrive. It will work on the file name or folder name. Note: Wildcard search is not supported. The data type is String. This field is mandatory. |
| 2 | Order By | The order by table field is used to specify the sort order of the drive items. |
| 3 | Sort On | Specify the property name on basis of which you want to sort the result. For example: name desc The following request gets the drive items and sorts them by the name field in descending order. The data type is String. This field is mandatory. |
| 4 | Sort Type | Select the sorting order of the values in ascending or descending manner. Allowed values: asc, desc The default sorting order is, ascending, that is, asc. The data type is String. The field is mandatory. |
| Output Tab | ||
| 1 | JSONOutput | Define the output variable name in the field. Default output variable name: JSONOutput On successful execution, it holds the output of the plugin step in JSON format. |
Known Issues:
Sometimes, you may see a temporary error related to the internet connectivity and network issues. The issue arises when the hostname is unresolved and the local server does not receive a response from an authoritative server. For example, you may see any of the following messages:
- login.microsoftonline.com.
OR - This is usually a temporary error during hostname resolution and means that the local server did not receive a response from an authoritative server (login.microsoftonline.com)