Map fields

When using an Action step, you will need to map its fields. You can do this through the ‘cog’ icon on the step which gives access to the Step Setup functionality.

Field mapping example

The left most column is the Destination (the app you are connecting to). Some of these fields may be required.

The Source for these fields, shown to the right, can be any preceding step or a combination of steps.

An example of the Step Setup window where you can map fields.

Field mapping sources

Depending on the app you’re connecting to and the field you are using, only some of these source types will be available.

Source	Usage
Ignore	The field will be left blank and will not be included in the API call.
Variable	This is a ‘parameter’ that has been defined for the Template overall. The variable may then be used at various places in the Template design.
Type a Value	You can type in text or merge one or more values into the field.
Previous Step	First select any previous step. Cyclr will then display a searchable list of the available date from that step. If possible Cyclr will suggest a mapping.
Lookup	Cycler will connect to the Destination app to retrieve a list of possible mapping values. For example, a mailing lists in an email marketing platform.
Select a Value	There may be a pre-configured list of values from which you can choose a mapping.

User Configurable

Setting the field to be User Configurable means that this mapping will be finalised by the user when the Template in installed into an Account. For the purposes of testing a value may be provided but this value will NOT be copied over on Template installation.

System mergefields

You can use Cyclr system mergefields as the Source value in Field Mapping.

Merge Field	Usage
{{LastSuccessfulRunDate}}	The last successful run date of the current step. This is particularly useful if you only want to get the latest data.
{{Cyclr_Auth_ApiKey}}	The API key if the connector is using API key as the authentication type.
{{Cyclr_Auth_Username}}	The username if the connector is using username/password as the authentication type.
{{Cyclr_Auth_Password}}	The password if the connector is using username/password as the authentication type.

These Mergefields can be used to map fields directly and as part of the content within the Type a Value box. For example, to construct the sentence:

CODE

The last run was {{LastSuccessfulRunDate}}.