Workflows

Create a New State

States represent the various stages of the data collection and review process (e.g. Create, Triage, Review, Investigate, Close, etc.). States allow you to narrow down your search results, control where an object is created or viewed in an application, which fields must be completed during certain stages, and which state the object will transition to by adding triggers to the state. When a new object type is created, a default workflow state is created with it (which includes the Creation, Draft, Active, and Archived states). These states can be deleted or supplemented with additional states as needed (except for the Creation state, which cannot be deleted and allows for only limited configuration).

Once created, the new state will appear in the workflow, which you can then select when creating new transitions on other states. You can also select states to create Relationship or Reference variables in formulas or workflow conditions, which can provide a count of the objects currently in the specified state or check if some or all of the objects are in that state and return a true or false result. You can select states from the object type's workflow or any assessment workflows related to the object type.

To mark certain fields, properties, or roles as required when the object is in a particular state, or to change the state’s name or color, see Edit or Delete a State. To add triggers, transitions, or actions to your new state, see Add a Trigger & Transition to a State

To create a new state:

  1. Click the icon in the top bar > Object Types in the Data Model section.
  2. Click the object type or enter the name of the object type in the Search field, then click it to display the Edit Object Type page.
  3. Click Configure Workflow on the Edit Object Type page. If there are multiple workflows saved to the object type, click one in the list.
  4. Click Add State.
  5. Enter the state name in the Name field.
  6. Click the Color dropdown menu to reveal the color picker and select a new color for the label. You can also type a hex color into this field to select a color.
  7. Select a state category from the State Category dropdown menu to classify the new state.
    Though the State Category field is required, full functionality of this feature will be available in an upcoming release.
  8. Click Create. Creating a new state. A new state. New states don't have any triggers or transitions saved to them, but new states can be selected on transitions on other states.

After clicking Create, your new state will appear in the workflow, below existing states. You can select this state when creating new transitions on other states. To add triggers, transitions, or actions to your new state, see Add a Trigger & Transition to a State.

Edit the Workflow Name or Description

To edit the workflow name or description:

  1. Click theicon in the top bar > Object Types in the Data Model section.
  2. Click the object type or enter the name of the object type in the Search field, then click it to display the Edit Object Type page.
  3. Click the  icon next the workflow name near the top of the page.
  4. Make your changes to the Name or Description fields as needed.
  5. Click Done when finished.

Add a Trigger & Transition to a State

To add a trigger and transition to a state:

  1. Click the icon in the top bar Data Model> Object Types section.
  2. Enter and/or select the object type’s name in the Search field, then click it to display the Edit Object Type page.
  3. Click Configure Workflow (if only one workflow exists) or select the appropriate workflow (if there are multiple).
  4. Click Add Trigger below the state to which you want to add the trigger.
  5. From the Type dropdown menu, select either Button, Timed, or Consume Orchestration Event.

Graphical user interface, text, application, email

Description automatically generatedThe Add Trigger palette.

  1. In the Name field, enter a name for the trigger.
    • If you select the Button type, users can click on it for configurable forms.
  1. Optional: In the Description field, describe the trigger or enter other relevant information (e.g., its destination state).
    • Button trigger type: a description appears when you click the icon next to the trigger in creating a configurable form. This will help you identify the trigger’s associated state and transition.
  1. Optional: Click the Color dropdown menu to reveal the color picker and select a new color for the button as it will appear on a form. 
    • You can also enter a hex color (e.g., #2C82C9) into this field to set a button color.
  1. Optional: In the Name field, enter a variable name.  
    • By default, the field or formula’s unique ID is automatically populated. 
If you selectedThen

Timed trigger type

  • Select Nightly from the Frequency dropdown menu.

Consume Orchestration Event trigger type

  • Select a previously created event action from the Orchestration Event dropdown menu.
    • If you have not yet created an event action, you can leave this field blank and edit the trigger once an event is created.
    • Options will appear in this dropdown, only if an event action has been previously created using a data definition with the object type, you're currently configuring.
    • Read more here: Add an Orchestration Event Action on a Transition
  1. Click Create.
  2. On the Edit Workflow page, click the new trigger below the relevant state to open the Edit Trigger palette.
  3. Click Add Transition.

Graphical user interface, text, application, email

Description automatically generatedThe Edit Trigger palette.

  1. In the Name field, enter a name for the transition.
  2. From the Destination State dropdown menu, select the state the object should move to.
  3. Optional: Click Bypass Required Fields to enable the transition, despite any required fields being empty.

Graphical user interface, text, application, email

Description automatically generatedThe Bypass Required Fields toggle.

Add a Condition to a Transition

Conditions allow you to control whether an object is moved to a certain state or if an action will be performed. This is done by using fields, formulas, and workflow states to create a formula with parameters that must be met before the transition or action can occur. For more information on formulas, see the following articles:

EXAMPLE
Your company has a policy that severe incidents must skip the typical review process and must be investigated immediately. As such, for the Incident object type workflow, you create a condition on the Submit for Review trigger that if the “ Severe” option has been chosen on the Incident Severity select list, the object is automatically transitioned to the Investigation Required state once the Submit for Review trigger is clicked on a form.


To add a condition on a transition:

Ensure the state, trigger, and transition you wish to add the condition to have already been created and configured prior to following the steps below.
  1. From the Edit Workflow page, click a trigger to open the Edit Trigger palette.
  2. Click the   icon next to the transition.
  3. Click Add Condition.
    The Edit Trigger palette where you can add conditions and actions.
  4. Optional: Enter a name for the condition in the Name field. Conditions are named Default Condition Formula by default.
  5. Click Add Variable.
  6. Select either Field, Relationship, or Reference from the Variable Type dropdown menu.
If you selectedThen
Field
  • Choose a field or formula from the Available Components dropdown menu. 
  • The options in this dropdown are fields or formulas added directly to the object type.
Relationship or Reference 
  • Select a relationship or reference saved to the object type from the Relationship or Reference dropdown menu. 
  • Select a field, formula, or workflow state from the Available Components dropdown menu. These are the fields, formulas, or states saved to the object type(s) in the relationship or reference.
  • Select a variable sub-type from the Sub Type dropdown menu to specify how the data from multiple objects will be compiled or calculated. See the Field & Formula Variables and/or Workflow State Variables sections of the Variables, Operators & Functions article for more information on the available sub-types.
  1. Optional: Enter a name for the variable in the Name field. By default, the unique ID of the field or formula is automatically populated.A new condition formula. 
Fields can be added to formulas only if they’ ve been added directly to the object type or if they’ re saved to an object type associated through a relationship or reference. Only numeric fields, date fields, and select lists with numeric values added to their options are accepted in formulas. See the Fields category for more information.


Naming a variable after a function will result in an error.
  1. Optional: Enter a description for the formula in the Description field.
  2. Optional: Select the Treat empty values as Null checkbox if objects with blank variables should not be assigned a zero (0) value. Read more here: Null Values in Formulas.
  3. Click Create.
  4. Continue adding variables by following steps 5-9 above. To remove a variable, click the icon beside the variable.
    An existing variable on a condition.
  5. Using the variable name(s), enter a formula, including any operators and/or functions, in the Formula field (e.g., INCIDENTSE==3)). Read more here: Variables, Operators & Functions.
    Creating a new formula using the variable name.
    You must use double equal signs (==) in condition formulas. See the Variables, Operators & Functions article for more information.
  6. Click Done.