Binary Retrieve

The Binary Retrieve component allows you to retrieve binaries from the Content Store.

The binaries are retrieved from the binaries.files and binaries.chunks collections.

It uses either the source.localReference or target.localReference value from the incoming data to retrieve a binary.

note

This component sends a message that contains a stream reference in the binary key of the output object. Additionally, the length of the stream is included in the length key. Because stream references can only be used once, you should connect only one component to the output of this component that uses the stream reference. If you connect multiple components to the output of this component, it will only send the message to the first component that was connected.

See how it works:
Binary Retrieve Explainer

note

Also covered in the Content Store overview video:
Watch video

Configuration

Connection string

A MongoDB connection string.

Example: mongodb://<username>:<password>@localhost:27017/<databaseName>

Here <databaseName> is the database to retrieve from.

Use TLS

Enables TLS for your mongoDB connection.

Allow Invalid Certificates

Checking this will disable certificate validation. Warning: specifying this option in a production environment makes your application insecure and potentially vulnerable to expired certificates and to foreign processes posing as valid client instances.

Certificate Authority File

One or more certificate authorities to trust when making a TLS connection.

Example: .\ca.pem

Retrieve reference

Source: Retrieve based on the source.localReference value.

Target: Retrieve based on the target.localReference value.

Inputs | Outputs

Binary Retrieve

Input

Output

Error

00 0 (ilysent6u)

The component takes a binary document as an input and it will look for the source.localReference and uses that to retrieve the binary from the binaries GridFS bucket since it references the _id field of the binary.

Example: Refer to the following page : Binary document schema