Summary

< All Topics

Summary

The BLAM Interpolator can be used to insert Asset, Asset File, User, and Work Order metadata into a BLidget’s input arguments. For example, adding {{ASSET_ID}}_example_file.mxf to the output filename field in the Copy BLidget will instruct the interpolator to insert the input BLAM Asset Id into the output filename when copying a file to a new location. The BLAM Interpolator is also used extensively by the Excel Report Writer BLidget to output BLAM metadata into cells and tables.

Usage

The general form of an interpolator function is as follows:

{{ FUNCTION_NAME(argument1, argument2) }}

All functions must be first encapsulated by a set of double curly braces. This lets the interpolator know to attempt an interpolator function call. White space can be optionally included immediately after the opening braces and before the closing braces without issue to aid user readability:

{{ASSET_ID}}    or    {{ ASSET_ID }}

Some functions can be provided additional arguments that can modify or format the output in a specific way. The CURRENT_DATETIME function can optionally take an argument which describes the format of the Date / DateTime that is returned:

{{ CURRENT_DATETIME(dd/MM/yyyy hh:mm:ss) }}    =>    13/05/2020 15:06:32

In addition, multiple function alternatives can be provided by separating each function call with two question marks ??. The interpolator evaluates the function calls in order until one returns a result. A default value can be provided by passing a string enclosed in double quotation marks. A typical use case for this is when interpolating metadata values which could potentially have no value set:

{{ metadata_field_name ?? “Default Value” }}

All function calls are case sensitive unless otherwise specified.