Referencing Source Metadata

Accessing Import Connector Metadata

Import connectors expose various standard and custom metadata fields that can be utilized within Umango’s merge fields. These metadata fields are accessible using specific syntax and can be referenced individually or iterated through when dealing with multiple values. Below are the two primary ways to reference metadata from an import connector:

Referencing a Metadata Field Directly

To access a specific metadata field provided by the import connector, use the following format:

<<ImportConnectorName.Data[KeyName]>>

For example, if the metadata field DocumentTitle is available, you can access it like this:

<<DropBox.Data[DocumentTitle]>>

Referencing Arrays or Collections in Metadata

Some metadata fields may contain multiple values (e.g., line items, tags, or other collections). These can be accessed in two ways:

Referencing a Specific Value

To retrieve a specific value from a collection, reference its position in the array using a one-based index. For example:

<<DropBox.Data.Name[1]>>

This returns the Name of the metadata in location 1 in the collection.

<<DropBox.Data.Value[1]>>

This returns the Value of the metadata in location 1 in the collection.

Iterating Through a Collection

When dealing with collections, you can iterate over all the values using the iteration syntax. For example:

<<Iterate(<<DropBox.Data.Count>>)>>
Field <<Iteration>> Name: <<DropBox.Data.Name[*]>>
Field <<Iteration>> Value: <<DropBox.Data.Value[*]>>
<<IterateEnd>>

This outputs all available metadata provided by the import connector (in the example above, DropBox), one by one.