Identifiers
NEW FUNCTIONALITY - COMING SOON!
CONTENTS
How to leverage identifiers in a rule
How to leverage identifiers in a piping expression
What are identifiers?
Task identifiers act as unique nicknames for tasks, display component rows, or display component cells. They can be referenced in advanced logic rules and piping expressions rather than abbreviating the task, row, or cell number numerically. Identifiers must be unique and cannot match the naming convention of any other object in the Mission.
How to create an identifier
To create a task identifier:
- Navigate to the mission build tab and click on a task. The task configuration panel will appear with a box labeled Task Identifier:
- Enter a unique value that does not match the name of another GSC object (e.g., ‘Mission’ is not a valid identifier). The use of underscores can ensure the identifier value is unique. Spaces and punctuation characters will make the identifier invalid.
Valid vs invalid task identifier values
To create a row identifier:
- Add a display text or table component to your mission. Click on an individual row and add a unique identifier in the Row Identifier box:
To create a cell identifier:
- Add a display table component to your mission. Click on an individual cell in the table and add a unique identifier in the Cell identifier box:
How to leverage identifiers in a rule
To leverage a task, row, or cell identifier in an advanced logic rule:
- Navigate to the mission builder logic tab. Identifiers are listed in the structure panel for easy reference.
- Use the identifier in a rule. In this example, oranges_count and SA.T1 have the same meaning. SA.T2 should only be answered if the oranges_count is greater than 20. This rule automatically sets ‘N/A’ as the response to SA.T2 if the oranges count is less than 20.
In this rule, oranges_count and SA.T1 can be used interchangeably. Identifiers are meant to provide a shorthand reference for tasks, rows, or cells that can be easier to identify than their assigned numeric order. Rules must include a condition, action, and event.
| Condition | Action | Event |
| IF oranges_count < 20 | THEN SET VALUE SA.T2 TO ‘N/A’ | ON RESPONSE |
For more information on advanced logic rule syntax, click here.
How to leverage identifiers in a piping expression
Identifiers can also be used to pipe a value into mission fields like titles, descriptions, and instructions.
To use an identifier in a piping expression:
- Give a task, row, or cell a unique identifier
- Add this identifier to a mission field between curly brackets {}. In this example, the identifier will be piped into a subsequent task’s title. This provides the respondent with the task response given for “What else is on display?” and clarifies the count they are expected to provide.
For more information on piping expressions, click here.