Download File

The Download File activity downloads a file from Microsoft SharePoint and saves it to a specified local path. It also supports converting compatible files to PDF format.

Prerequisites

1. A valid Project Key must be configured in the Publish Console to publish workflows.
2. A Microsoft 365 account with access to the required SharePoint site and files is required.
3. A SharePoint connection must be configured and authenticated in Robility Manager’s App Integration.
4. The connected account must have permission to access and download the required files.

Configure SharePoint Connection

Before using the Download File activity, create and authenticate a SharePoint connection in Robility Manager’s App Integration.

Once the connection is successfully created and authenticated:

1. Open Robility Designer.
2. Add the Download File activity to the workflow.
3. Select the configured account from the SharePoint dropdown.
4. Select the file to download.
5. Configure the remaining activity properties as required.

The activity uses the selected SharePoint connection to authenticate and access SharePoint resources.

Limitations

1. Only files accessible to the authenticated Microsoft 365 account can be downloaded.
2. The download fails if the selected file is deleted, moved, or becomes inaccessible.
3. PDF conversion is supported only for compatible file types.
4. Download time depends on file size, network speed, and SharePoint response time.

Activity Details in Canvas

SharePoint*: Select the configured account from the available connections. The selected account is used to authenticate and access SharePoint.

File to Download: Select the SharePoint file to download from the available dropdown options.

Properties

Input

Convert to PDF Format: Specifies whether to convert the downloaded file to PDF format. This property accepts a Boolean value.
True: Converts the file to PDF format.
False: Downloads the file in its original format.

Destination Path: Specifies the local path where the downloaded file is saved. Enter the path directly or provide it through a variable.

If File Already Exists: Specifies how to handle an existing file with the same name in the destination folder.
Don’t Replace: Keeps the existing file without replacing it.
Auto Rename: Saves the downloaded file with a different name to avoid a naming conflict.
Replace: Replaces the existing file with the downloaded file.

MISC

DisplayName: Specifies the display name of the activity. Customize it to improve workflow readability and troubleshooting.

SkipOnError: Specifies whether workflow execution continues when the activity encounters an error.
True: Continues workflow execution even if an error occurs.
False: Stops workflow execution when an error occurs.
None: Uses the default value, False.

Version: Displays the current version of the activity.

Output

File: Stores the downloaded file in the specified output variable after successful execution. The variable can be used in subsequent workflow activities.

Result: Returns a Boolean value indicating the execution status of the activity.
True: The activity executed successfully.
False: The activity failed due to an error.

Example

Consider a SharePoint file named EmployeeDetails.docx that needs to be downloaded to the C:\Downloads folder and converted to PDF format.

Configure the Activity

To download and convert the file, configure the activity as follows:

1. SharePoint: Select the Microsoft 365 account that has access to the required SharePoint site and file.
2. File to Download: Select EmployeeDetails.docx from the available SharePoint files.
3. Convert to PDF Format: Set this property to True to convert the file to PDF format.
4. Destination Path: Enter C:\Downloads as the download location.
5. If File Already Exists: Select Auto Rename to generate a unique file name if a file with the same name already exists.

Result

After execution, EmployeeDetails.docx is downloaded from SharePoint and converted to EmployeeDetails.pdf in the specified destination folder. If a file with the same name already exists, a different file name is generated according to the Auto Rename option.

The File output stores the downloaded file, and the Result output returns True when the activity completes successfully.