In this article

Overview

You can use this Snap to download a file attached to a Salesforce object record automatically by passing an Attachment ID or Content Data ID.

Prerequisites

A valid Salesforce account with the required permissions.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Limitations and Known Issues

None.

Snap Views

View Type

View Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Document

Min: 0
Max: 1

Mapper
Salesforce Read or Salesforce SOQL Snap with Structure Snap to prepare a document stream of Attachment ID's.

A stream of documents which supply values to evaluate the ID expression.

Output

Document

Min: 1
Max: 1

Document to Binary
Binary to Document

Document data with a byte array value for the "content" key and also with a "ContentType" key/value pair.

Error

Document

Min: 1
Max: 1

N/A

The error view contains error, reason, resolution and stack trace. For more information, see Handling Errors with an Error Pipeline

Snap Settings

Field Name	Field Type	Description
Label*	String	Specify a unique and meaningful name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline. Default Value: Salesforce Download Example: Salesforce Download
Service Version*	String/Suggestion	Specify the version number associated with the Salesforce service that you want to connect to. Alternatively, click the Suggestion icon to fetch the list of versions and select the desired version. Default Value: 52.0 Example: 52.0
File Type*	String/Expression/Suggestion	Specify the type of file you want to download. Alternatively, click the Suggestion icon to fetch the list of associated files. You can also specify an (JavaScript) expression that will be evaluated into an attachment ID or content data ID, from each input document. The ID is found at the end of the URL of the file. The available options are: Attachment: Downloads the file as an attachment. Content Version: Downloads the version of the content. Document: Downloads the file as a document. Default Value: Attachment Example: Document
ID*	String/Expression	Specify the ID of the Salesforce object that you want to download. Default Value: N/A Example: $id
Snap Execution	Dropdown list	Select one of the three modes in which the Snap executes. Available options are: Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime. Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data. Disabled: Disables the Snap and all Snaps that are downstream from it. Default Value: Validate & Execute Example: Execute only

Troubleshooting

Error	Reason	Resolution
`404 Error:` The requested resource could not be found.	The external ID field does not exist or is not accessible.	The input data should be valid. Check if your input data is valid.

Example

Downloading a Document from Salesforce and Converting into Binary Format

We can download documents attached to Salesforce objects and convert them into binary format. This example demonstrates how we can use the Salesforce Download Snap to accomplish this task.