Microsoft 365 OneDrive Output

This task can be found in the Plug-in Bar, under the Output tasks group.

Microsoft 365 OneDrive Output tasks allows to send files to any of the organization's Microsoft 365 OneDrive accounts.

This task uses the Microsoft Graph API.
For this task to function correctly, Workflow needs to be granted application permissions for Microsoft Graph in the organization’s Azure instance.
It needs read access to the Users category (User.Read.All) so that the task can identify the users in the organization.
In addition, the Files.ReadWrite.All permission is required.
For more information on setting application permissions for Microsoft Graph, see https://docs.microsoft.com/en-us/graph/auth-v2-service.

Input

Any data file.

Processing and output

The task uses the Microsoft Graph API to access OneDrive folders in the organization (subject to that organization's IT policies).

The file is saved in the location specified, as the file name specified.

When a communication error occurs while uploading a file to OneDrive, some temporary "~." files may remain on the server; however, these files will eventually be cleaned up automatically.

Note: The MS Graph REST API is limited to a certain number of requests within a certain period of time. This is called throttling. When throttling comes into play, the plugin receives HTTP response 429. The plugin will log the error and retry, but it exits with an error after 15 unsuccessful attempts.

Task properties

General Tab

General

  • Folder: Enter the path of the folder to which the files are to be saved. You can use any combination of text, variables and data selections; see Variable task properties.

  • File name: Enter the name of the output file generated by this task. To prevent new files from overwriting existing ones, consider using variable names. You can use any combination of text, variables and data selections; see Variable task properties.

Connection

  • Application ID: Enter the application ID provided by Azure for this specific application. This value is static and cannot contain variables, unless the Allow dynamic fields option is selected.

  • Application Password: Enter the client secret (key) for the Azure app. This value is static and cannot contain variables, unless the Allow dynamic fields option is selected.

  • Tenant ID: Enter the Tenant ID as specified in Azure. This value is static and cannot contain variables, unless the Allow dynamic fields option is selected.

  • User ID: This is the OneDrive user's ID. This value is dynamic. You can use any combination of text, variables and data selections; see Variable task properties. 

  • Use delegated permissions: Select this option to use delegated permissions instead of application permissions. Delegated permissions allow the application to log in as a standard registered user, and IT can grant that user account access to specific inboxes and specific OneDrive folders.
    Application permissions can be restricted to a strict minimum to ensure the plugin can perform its tasks, but no more. However, application permissions apply to all accounts in the organization: if the application has been granted permission to read emails, then that permission applies to all email accounts in the organization, and if it has access to OneDrive, it has access to all folders.

    • User Password: Option only becomes available if Use delegated permissions selected. Enter the password associated with the User.

  • Allow dynamic fields: Select to allow Dynamic Fields.