Microsoft 365 OneDrive Output

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

Note: Connection setting values cannot contain variables, unless the Allow dynamic fields option is selected.

  • Application ID: Enter the application ID provided by Azure for this specific application.

  • Application Password: Enter the client secret (key) for the Azure app.

  • Tenant ID: Enter the Tenant ID as specified in Azure.

  • User ID: This is the OneDrive user's ID.

  • 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.

  • Allow dynamic fields: With this option selected, you can use any combination of text, variables and data selections in all connection settings; see Variable task properties.

Advanced properties

To get access to the following properties tabs, right-click the plugin in the process and select Advanced Properties.

On Error Tab

For a description of the options on the On Error tab see Using the On Error tab.

Miscellaneous Tab

The Miscellaneous tab is common to all tasks.

It contains a text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button and are displayed in The Task Comments Pane.

Check the option Use as step description to display the text next to the icon of the plugin in the Process area.

The tab also provides an option to highlight the task in The Process area with the default color, set in the Preferences (see Colors), or the color selected or defined under Highlight color on this tab.
To revert the selected highlight color to the default color, open this tab, turn the Highlight option off and close the dialog with the OK button; then turn highlighting back on.
Highlighting can also be turned on and off via the task's contextual menu and with the Highlight button on the View ribbon.