Microsoft OneDrive modules
- Topics:
- Workfront Fusion
CREATED FOR:
- User
In an Adobe Workfront Fusion scenario, you can automate workflows that use OneDrive, as well as connect it to multiple third-party applications and services.
If you need instructions on creating a scenario, see Create a scenario in Adobe Workfront Fusion.
For information about modules, see Modules in Adobe Workfront Fusion.
Access requirements
You must have the following access to use the functionality in this article:
Current license requirement: No Workfront Fusion license requirement.
Or
Legacy license requirement: Workfront Fusion for Work Automation and Integration
Current product requirement: If you have the Select or Prime Adobe Workfront Plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.
Or
Legacy product requirement: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.
To find out what plan, license type, or access you have, contact your Workfront administrator.
For information on Adobe Workfront Fusion licenses, see Adobe Workfront Fusion licenses.
Prerequisites
To use OneDrive modules, you must have a Microsoft OneDrive account.
Connecting the OneDrive service to Workfront Fusion
For instructions about connecting your OneDrive account to Workfront Fusion, see Create a connection to Adobe Workfront Fusion - Basic instructions
Microsoft OneDrive modules and their fields
When you configure OneDrive modules, Workfront Fusion displays the fields listed below. Along with these, additional OneDrive fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.
If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in Adobe Workfront Fusion.
File/Folder
Watch Files/Folders
This trigger module starts a scenario when a file or folder is created or updated.
Select how you want to watch files or folders:
-
By Created Time
Watch for new files or folders.
-
By Updated Time
Watch for updated existing files or folders.
Select the location you want to watch:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that you want the module to watch.
-
No
Navigate to the folder that you want the module to watch. You can also enter a query to filter the returned results.
-
-
Shared With Me
The module watches files that have been shared with the owner of the drive.
-
Site's Drive
Select the SharePoint Site that you want the module to watch. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive you want the module to watch.
Select whether you want to watch files, folders, or both.
Note: You cannot watch for folders in a Shared With Me drive.
Search Files/Folders
This search module returns files and folders based on criteria you set.
Select the location you want to search:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that you want the module to search.
-
No
Navigate to the folder that you want the module to search. You can also enter a query to filter the returned results.
-
-
Shared With Me
The module searches files that have been shared with the owner of the drive.
-
Site's Drive
Select the SharePoint Site that you want the module to search. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive you want the module to search.
Select whether you want to search for files, folders, or both.
Note: You cannot search for folders in a Shared With Me drive.
Get a file
This action module gets the metadata of a specified file.
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location you want to search:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file you want to get.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file you want to get. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file you want to get.
If you selected Enter Manually, enter or map the file ID or path of the file you want to get.
If you selected Select from the list, select the file that you want to get.
Download a file
This action module downloads the specified file.
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location you want to that contains the file you want to download:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file you want to download.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file you want to download. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file you want to download.
If you selected Enter Manually, enter or map the file ID or path of the file you want to download.
If you selected Select from the list, select the file that you want to download.
Enable this option to convert the file to a PDF file. You can convert from the following file types:
table 0-row-3 layout-auto html-authored no-header | ||
---|---|---|
|
|
|
Upload a file
This action module uploads a file to the specified folder.
Select the location where you want to upload a file:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Select the drive that contains the file you want to get.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the folder where you want to upload a file. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the folder where you want to upload a file.
Create a Folder
This action module creates a new folder in the specified drive.
Select the location where you want to create a folder:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Select the drive where you want to create a folder.
-
No
-
-
Site's Drive
Select the SharePoint Site where you want to create a folder. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group that owns the drivewhere you want to create a folder.
Get a Share Link
This action module returns a share link for the specified file.
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location you want to retrieve a share link for:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file you want to retrieve a share link for.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file you want to retrieve a share link for. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file you want to retrieve a share link for.
If you selected Enter Manually, enter or map the file ID or path of the file you want to retrieve a share link for.
If you selected Select from the list, select the file that you want to retrieve a share link for.
Move a File/Folder
This action module moves a file or folder to a new folder location
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location that contains the file or folder that you want to move:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file or folder that you want to move.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file or folder that you want to move. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file or folder that you want to move.
File / File ID / File Path
Folder / Folder ID / Folder Path
If you selected Enter Manually, enter or map the ID or path of the file or folder that you want to move.
If you selected Select from the list, select the file or folder that you want to move.
Select how you want to enter the location that you want to move the file or folder to:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location where you want to move the file or folder:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive where you want to move the file or folder.
-
No
-
-
Site's Drive
Select the SharePoint Site where you want to move the file or folder. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group to whose drive you want to move the file or folder.
Select or map the drive that contains the folder that you want to move the file or folder to. This field is not available if you selected No in the Enable to Enter a Drive ID field.
If you leave this blank, the file or folder can only be moved within the same OneDrive.
You can move files and folders from My Drive to a Site's Drive or a Group's Drive.
You can move files from a Site's Drive only to the same drive in the same Site.
You can move files from a Group's Drive only to the same drive in the same Group.
Copy a File
This action module copies a file into a new folder location
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location that contains the file that you want to copy:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file or folder that you want to copy.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file that you want to move. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file that you want to copy.
If you selected Enter Manually, enter or map the ID or path of the file that you want to copy.
If you selected Select from the list, select the file that you want to copy.
Select how you want to enter the location that you want to copy the file or to:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available folder.
Select the location where you want to copy the filer. This option is available if you chose to select the new folder location from a list.
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive where you want to copy the file.
-
No
-
-
Site's Drive
Select the SharePoint Site where you want to copy the file. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group to whose drive you want to copy the file.
Select or map the drive that contains the folder that you want to copy the file to. This field is not available if you selected No in the Enable to Enter a Drive ID field.
If you leave this blank, the file or folder can only be copied within the same OneDrive.
You can copy files and folders from My Drive to a Site's Drive or a Group's Drive.
You can copy files from a Site's Drive only to the same drive in the same Site.
You can copy files from a Group's Drive only to the same drive in the same Group.
Enter or map a name for the new copy of the file. You can leave this blank if you do not want to change the original file name.
The name must include the file extension. Example: file.txt
Delete a File/Folder
This action module deletes the selected file.
Select how you want to enter the File ID or File Path:
-
Enter Manually
Select this option if you want to enter the ID or path directly, or map it from a previous module.
-
Select from a list
Select this option if you want to select from a list of available files or paths.
Select the location you want to search:
-
My Drive
Select whether to enable the module to enter a drive ID.
-
Yes
Enter the ID of the drive that contains the file or folder you want to delete.
-
No
-
-
Site's Drive
Select the SharePoint Site that contains the file or folder you want to delete. Available Sites are Sites followed by the signed-in user.
-
Group's Drive
Select the group whose drive contains the file or folder you want to delete.
If you selected Enter Manually, enter or map the file ID or path of the file you want to delete.
If you selected Select from the list, select the file that you want to delete.
Other
Make an API Call
This module performs a custom API call.
td>
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.
https://graph.microsoft.com
. Example: /v1.0/me/drive/root/children
Add the headers of the request in the form of a standard JSON object.
For example, {"Content-type":"application/json"}
Workfront Fusion adds the authorization headers for you.
Add the query for the API call in the form of a standard JSON object.
For example: {"name":"something-urgent"}
Add the body content for the API call in the form of a standard JSON object.
Note:
When using conditional statements such as if
in your JSON, put the quotation marks outside of the conditional statement.
If you are unable to upload or update a file
There are several possible issues when uploading or updating a file fails:
- The uploaded file is too big and exceeds the maximum file size limit for your OneDrive plan or you have used all of your OneDrive account’s storage quota. To get more storage space, delete existing files from OneDrive or upgrade your OneDrive account.
- OneDrive does not allow to upload two files with the same name to one single folder. If the target folder contains a file with the same name as the file being uploaded, the scenario run terminates with an error. The solution is to simply rename the file being uploaded. If your aim is to update a file, use the Update a file action.
- The previously selected folder, to which the file is being uploaded, no longer exists. The scenario stops and you will need to select the target folder again.