Tokens allow for the dynamic replacement of database field values at runtime. When the user runs a view in the browser, a WHERE clause filters and extracts the appropriate data. Any tokens in the WHERE clause are replaced with their corresponding field values.

For example, suppose you configure a feature action that invokes a workflow. You can use a token to replace the value of the feature at runtime.

To add a data source token:

1.In the left toolbar, click Data Sources, and then click Add Data Source.

2.Complete the field values as described above.

3.Click Add Token.

4.Configure the following required fields as follows:

•Token Name: Enter a name for the token (for example, Inspection Year).

•Token: Enter the token to be replaced with a value at runtime. This value must be enclosed in curly braces (for example, {year}).

•Token Value: Enter the default value used to replace the token if a value is not supplied by the user at runtime (for example, 2016).

•Token Field: Enter the data source field whose value will replace the token at runtime.

5.Configure the following optional fields as follows:

•Add Quotes: Enable this option if the value that is replacing the token must be enclosed in single quotes in the database WHERE clause. WHERE clauses in ArcGIS endpoints must receive Text field values inside single quotes.

•Value Display Name: Enter the display name of the lookup value. This will be seen by the user, so should be meaningful and reflect what the token value represents (for example, Inspection Year).

•Hint: Enter tooltip text that will help the user to select the appropriate token value.

6.(Optional) Configure one or more lookup values. Lookup values allow the user to select the value to be used in the WHERE clause that extracts the data for the view.

You can configure lookup values that correspond to fields in an existing data source (for example, the INSPECTIONYEAR field in another data source), or you can configure hard-coded values (for example, 2020 and 2010).

•Configure a data source lookup value:

•Datasource ID: Enter the ID of the data source that contains the lookup field. This must be an existing data source. You can copy the ID from the Data Source panel.

•Display Field Name: Enter the display name of the lookup field. This will be seen by the user, so should be meaningful.

•Value Field Name: Enter the name of the field to use for the lookup.

•Configure a hard-coded lookup value:

•Click Add Lookup Value and configure as follows:

•Name: Enter the name of the lookup value.

•Value: Enter the lookup value.

7.Click Save.