Workflows

You are here:

The Workflow module allows you to configure manual or automated processes that are defined through triggers and actions. 

Workflows

Add a new workflow

  1. Expand the “Configuration” menu on the sidebar navigation. 
  2. Select the “Workflows” menu.
  3. Select “Add” to add a workflow.
  4. Populate the fields.  Data fields with an asterisk (*) are required.
    • Name*: Enter the workflow name.   
    • Frequency*:  Select how often the workflow is evaluated.
    • Tags:  Enter keywords to quickly describe the workflow.  Tags are included in search results.  To enter multiple Tags, press Enter after each tag.
    • Comments: Enter a description of the workflow.
  5. Select “Save” upon completion.

View schedule

Select “View” to display the detailed workflow execution schedule.  The system will redirect you to the corresponding scheduled job and will provide the ability to edit or manually run the job.

Manage workflows

  1. Locate the workflow record.
  2. To the right of each record, under the Actions menu, you may:
    • View or edit the workflow.
    • Download the workflow definition for importing into another database. 
    • Copy this workflow as a new workflow.
    • Delete this workflow and all associated data.

Triggers

Add a trigger

  1. Locate the workflow.
  2. Select the “Add” button within the Trigger section.
  3. Populate the fields.  Data fields with an asterisk (*) are required.
    • Group*:  Select the group of the trigger.  Groups are used in conjunction with logical statements where the entire group evaluates to true or false.
    • Precedence*:​ Enter the order of this trigger in relation to the other triggers in the group.
    • Trigger Type*:  Select the type of trigger.
    • Logical*: Select the logical statement to define how this trigger relates to other triggers.
  4. There may be additional fields that appear depending upon the Trigger Type.
    • Aggregate: Select the aggregate function to apply to the telemetry; leave blank to use raw data.
    • Asset / Contact Attribute: Select the attribute for comparison.
    • Asset / Contact Property: Select the property field for comparison.
    • Earliest Date: Enter the earliest date for telemetry evaluation; leave blank for none.
    • Form Question: Select the form question for comparison.
    • Form Type: Enter the form type for comparison.
    • Latest Date:  Enter the latest date for telemetry evaluation; leave blank for none.
    • Operator: Select the operator used for comparison.
    • Rounding: Enter the number of decimals places to round the result
    • Telemetry Type: Select the type of telemetry for comparison.
    • Unit of Measure:  Select the unit of measure for comparison.
    • Value: Enter the value to use for comparison.
  5. Select “Save” upon completion.

Validate triggers

Select “Validate” to confirm that the triggers are valid and review the number of matched items.

Manage triggers

​Once triggers have been created, manage these records to maintain accurate information. 

  1. Locate the trigger record.
  2. To the right of each record, under the Actions menu, you may:
    • Edit the trigger.
    • Delete the trigger.

Actions

Actions are configured to be processed as a group when the triggers are met (“If these triggers are true then perform these actions”), in addition to as a group when triggers are not met (“Else perform these actions”). Specific actions are available based on the trigger(s) selected. 

Trigger / action matrix

The available actions are dependent upon which triggers are saved.

Trigger Action Matrix
Trigger Action Matrix

Create an action

  1. Locate the workflow record.
  2. Select the “Add” button within the Actions section.
  3. On the next page, populate the fields based on the action selected. Data fields with an asterisk (*) are required.
  4. Select “Save” upon completion.

Add or Remove Form Tag

Add a new form tag or removes an existing form tag when the rule triggers are met. If you are adding or removing multiple tags, please create a separate action for each tag.

The “Add / Remove Form Tag” action is allowed when applying a “Form Answer Comparison”, “Form Locked”, “Form Type Match”, or “Form Unlocked” trigger.

  • Action Type*: The type of action to perform. Select “Add Form Tag” or “Remove Form Tag”.
  • Value*: The value to use for this action.

Create or Update Task

The Create or Update Task action generates a task or updates an existing task when the rule triggers are met. The “Create/Update Task” action will generate a Task whose External Identifier is the Rule Action’s GUID. The “Create / Update Task” action is available in response to any trigger.

  • Action Type*: The type of action to perform. Select “Create Task” or “Update Task”.
  • Task Assignees*: The list of email addresses, contact identifiers, or form answers (that contain a contact as an answer) that will be assigned to the task (and that will receive task-related emails). Separate multiple recipients with a semicolon. You may append variables to create a dynamic recipients list.
  • Task Summary*: The summary to use for the task and for the subject line of any related emails. You may append variables to make the subject dynamic.
    • The Answer variable will format dates as YYYY-MM-DD HH:MM:SS.
  • Task Description*: The text to use for the task details and for the body of any related emails. You may append variables to make this information dynamic.
    • This field does not support bulleted lists.
    • The Answer variable will format dates as YYYY-MM-DD HH:MM:SS.
  • Task Type*: The type of task to create.
  • Task Priority*: The priority to set for the task.
  • Task Status*: The status to set for the task.
  • Due Date: The due date to set for the task. Leave blank for none. Use variables to make this date dynamic.
  • Start Date: The start date to set for the task. Leave blank for none. Use variables to make this date dynamic.
  • Close Date: The close date to set for the task. Leave blank for none. Use variables to make this date dynamic.
    • If updating a task to automatically set a close date, best practice is to set a close date equal to a date question within the form, rather than today’s date. This allows the task close date to reflect the date the work was completed.
  • Associated Assets: The list of asset identifiers, or form answers (that contain an asset as an answer) that are associated with this task. Separate multiple assets with a semicolon. Leave blank for none. Use variables to make the associated assets dynamic.
  • Asset Attribute for Recurring Tasks: The asset date attribute that controls recurring tasks for this action. 
  • Email on New Task: Toggle on to send an email to the assignees when a new task is created by this rule.
  • Email on Task Updates: Toggle on to send an email to the assignees when an existing task is updated by this rule.
  • Overwrite Values: Toggle on to replace existing values. Toggle off to only replace blank values on any update. This is commonly set to ‘false’ to retain existing data and only add missing data.
    • If updating a task, Overwrite Values must be set to ‘true’.

Lock or Unlock Form

The Lock / Unlock Form action locks and unlocks  the workflow to control edits when the rule triggers are met. The “Lock / Unlock Form” action is allowed when applying a “Form Answer Comparison”, “Form Locked”, “Form Type Match”, or “Form Unlocked” trigger.

  • Action Type*: The type of action to perform. Select “Lock Form” or “Unlock Form”.

Send Email

The Send Email action sends an email when the rule triggers are met. The “Send Email” action is available in response to any trigger.

  • Action Type*: The type of action to perform. Select “Send Email”. 
  • Email Recipients*: The list of email addresses, contact identifiers, or form answers (that contain a contact as an answer) that will receive the email. Separate multiple recipients with a semicolon (e.g., {FormAnswer:}; email2@company.com). You may append variables to create a dynamic recipients list.
  • Email Subject*: The subject to use for the email. You may append variables to make the subject dynamic.
  • Email Body: The body to use for the email, message, or task. You may append variables to make the body dynamic.
  • Report: The report data to attach to the email as an XLSX file.
  • Report Parameters: The report parameters to use when retrieving the data.
  • Summary Email: Toggle on to send one summary email for the workflow regardless of how many items are returned. Toggle off to create one email for each item matched.

Set Asset Attribute

The Set Asset Attribute action sets the answer to an existing asset attribute type when the rule triggers are met. This action will set the attribute for each asset associated to the workflow where the attribute type exists.

The “Set Asset Attribute” action is allowed when applying an “Asset Attribute Comparison”, “Asset Property Comparison”, “Form Answer Comparison”, “Form Locked”, “Form Type Match”, “Form Unlocked”, “Telemetry Aggregate”, and “Telemetry Comparison” trigger.

  • Action Type*: The type of action to perform. Select “Set Asset Attribute”.
  • Asset Attribute*: The asset attribute type where the answer will be set.
  • Value*: The value to set for the asset attribute type identified above. You may append variables to make the value dynamic.
    • If you use the {CurrentUser} variable to set an answer, the Data Type of the asset attribute type where the answer is being set needs to be a Dropdown List with the List specifying a Contact Selection List report. Otherwise, a 36-character GUID will display instead of the current user’s name.
    • The {EVALUATE:} function may be used in this field. See the Evaluate page for examples of how to use this function.

Set Form Answer

The Set Form Answer action sets the answer to an existing form question when the rule triggers are met. The “Set Form Answer” action is allowed when applying a “Form Answer Comparison”, “Form Locked”, “Form Type Match”, or “Form Unlocked” trigger.

  • Action Type*: The type of action to perform. Select “Set Answer”. 
  • Form Question*: The question where the answer will be set.
  • Value*: The value to set for the question identified above. You may append variables to make the value dynamic.
    • If you use the {CurrentUser} variable to set an answer, the Data Type of the question where the answer is being set needs to be a Dropdown List with the List specifying a Contact Selection List report. Otherwise, a 36-character GUID will display instead of the current user’s name.
    • The {EVALUATE:} function may be used in this field. See the Evaluate page for examples of how to use this function.
  • Overwrite Values: Toggle on to replace existing values. Toggle off to only replace blank values on an update. This is commonly set to false to retain existing data and only add missing data.

Set Telemetry

The Set Telemetry action sets telemetry values at the associated asset when the rule triggers are met. This action will set telemetry for each asset associated to the workflow. The “Set Telemetry” action is allowed when applying a “Form Answer Comparison”, “Form Locked”, “Form Type Match”, “Form Unlocked”, “Telemetry Aggregate”, or “Telemetry Comparison” trigger.

  • Action Type*: The type of action to perform. Select “Set Telemetry”.
  • Telemetry Type*: The telemetry type to use for the telemetry.
  • Unit of Measure*: The unit of measure to use for the telemetry.
  • Telemetry Tag: The asset’s telemetry tag identifier to use for the telemetry.
  • Active Date*: The active date to use for the telemetry.
  • Inactive Date: The inactive date to use for the telemetry.
  • Numeric Value: The numeric value to use for the telemetry.
  • Text Value: The text value to use for the telemetry.
  • Estimated: The estimated flag to use for the telemetry.
  • Invalid: The invalid flag to use for the telemetry.
  • Locked: The locked flag to use for the telemetry.
  • Collected Date: The collection date to use for the telemetry. If no date is set, the collected date will default to the date the form was submitted.
  • Comments: The comments to use for the telemetry.

Manage actions

​Once actions have been created, manage these records to maintain accurate information. 

  1. Locate the action record.
  2. To the right of each record, under the Actions menu, you may:
    • Edit the action.
    • Delete the action.
  1.  
Table of Contents