{{task.count}}

{{task.count:DIGITS}}

Index of the current asset in the list of assets being processed by the currently running action.

Indexes start with zero.

If present, the DIGITS parameter specifies the minimum number of digits that are used to represent the index. If the number has fewer digits, then leading zeroes are added.

If not present, then no leading zeroes are added.

For the third asset being processed, {{task.count}} expands to

2

whereas {{task.count:3}}expands to

002

{{task.total}}

{{task.total:DIGITS}}

Total number of assets being processed by the currently running action.

If present, the DIGITS parameter specifies the minimum number of digits that are used to represent the number. If the number has fewer digits, then leading zeroes are added.

If not present, then no leading zeroes are added.

If five assets are being processed, {{task.total}} expands to

5

whereas {{task.total:3}}expands to

005

.

URL of the action or marker.

Can be used to uniquely identify the marker or action.

The format of the URL is intentionally unspecified. No assumptions should be made about the format of URLs. URLs should not be parsed or generated by third-party applications.

No requests should be made to these URLs, as they are not part of the official FotoWeb API.

Unique ID of the task that is currently running.

Whenever an action or marker action is run, a new unique ID is generated.

Can be used to identify assets that were processed in the same batch.

Value of a metadata field that was entered interactively by the user when running the action.

Interactive actions may be configured to show a metadata editor to the user. This tag expands to the value that the user entered for a specific metadata field.

If the metadata field can be specified per asset rather than per job, then this tag expands to the value that was entered by the user for the asset which is currently being processed.

The FIELD parameter must be the numeric ID of the metadata field. For a reference of standard field numbers, see the Fotoware default field code reference topic.

Human-readable name of the action or marker.

Do not use this programmatically as a unique ID. Use {{task.href}} or {{task.id}} instead.

{{asset.ext}}

{{asset.extension}}

{{asset.name}}

{{asset.filename}}

The format of the URL is intentionally unspecified. No assumptions should be made about the format of URLs. URLs should not be parsed or generated by third-party applications.

The URL can be used by an API client to query the asset representation of the asset.

For more information, see The FotoWeb REST API.

{{asset:FIELD}}

{{asset.metadata:FIELD}}

Value of a metadata field of the asset.

If the metadata field was changed interactively by the user entering a new value in an interactive metadata editor as part of running the action, then this tag expands to the latest modified value.

If multiple metadata macros are run as part of the action, and they modify the same metadata field, then this tag expands to the value of the field after applying all of the previous metadata macros in the order in which they are defined in the action configuration.

This means that the order of metadata macros matters.

The FIELD parameter must be the numeric ID of the metadata field. For a reference of standard field numbers, see the Fotoware default field code reference topic.

If the user entered the value foo for field 5 in an interactive editor, then

{{asset.metadata:5}}

if used in the first metadata macro expands to foo.

If the following metadata macro is used to set the value of field 120:

Title: {{asset.metadata:5}}

then in the next metadata macro, the tag

{{asset.metadata:120}}

expands to:

Title: foo