Manage IM Form Builder Workflows

The Initiative Management module allows multiple workflows at once (unlike the rest of Plutora, which only allows one workflow at a time).

Form Builder Workflows allow users to:

• Select a sequence of IM statuses for each workflow, from an initial status to completion.
• Assign the privilege of setting each IM status to User Roles or User Groups.
• Set a Transition Prerequisite so that a certain state is required before the workflow can move to a new IM status.

Location of Workflows and Statuses on a Form

If a form has workflows and statuses enabled:

• The workflow and status drop-down menus will appear on the top-right corner of that IM form.
  
• The status menu will only contain statuses from the selected workflow.
• Select a workflow by clicking the workflow drop-down menu and then the workflow radio button on the left-hand side.
  

If a form only has statuses enabled:

• All statuses will appear in the status drop-down menu.
• The workflow drop-down menu will be hidden.
  

If a form only has workflows enabled, or neither workflows or statuses enabled:

• Both the status and workflow drop-down menus will be hidden.
  

To create a workflow:

1. Create statuses.

2. Enable IM Workflows

To enable workflows and statuses on an IM form:

1. Go to Settings > Customization > Initiative Management (IM).
2. Click Form Builder.
3. Add or edit:
   1. To add a form:
      1. Click + New Form to open a new form in Form Designer.
         
   2. To edit a form:
      1. Click a Form Title to edit a form in Form Designer.
         
4. Click the Form Information menu button on the top-right corner of the form.
   
5. Click to select the Allow Status checkbox.
6. Click to select the Allow Workflow checkbox.

3. Manage Workflows

To manage workflows:

1. Click Select Workflow.
   
2. Add a workflow:
   1. Click + New Workflow.
      
   2. Type the workflow title.
   3. Click Update.
3. Edit a workflow title:
   1. Double-click the workflow title and edit the text.
   2. Click Update.
4. Delete a workflow:
   1. Click the delete button.
   2. Click Yes to confirm.

4. Edit a Workflow

To edit the workflow diagram:

1. Click Edit Workflow.
   
   
   You cannot currently copy workflows. If you click Copy To, the pop up that opens is broken. 
   
   
2. Create the workflow path by dragging and dropping statuses from the Available Statuses column.
   
3. Manage connections (the blue arrows):
   1. To make connections between status boxes:
      1. Click and drag the yellow button between status boxes to create an arrow.
         
      2. Release the mouse button when the connecting status turns red.
   2. To delete a connection:
      1. Double-click the connection.
      2. Click Yes to confirm.
4. Set Initial Status on one status box by clicking to select the triangular play button.
   
5. Set the order priority of the status boxes by typing a number in the bottom right corner.
   
6. Click Save.
7. Manage Settings and Transition Prerequisites:
   1. Click the cogwheel-shaped Settings button.
      
      
      Currently, the SLA Breach Times and colors do not appear anywhere.
   2. Select the User Groups and User Roles that are allowed to move the workflow to this status from Permissions User Groups / Roles.
   3. Manage Transition Prerequisites:
      
      Transition Prerequisites require a certain state of a workflow, a form, or a form field before the workflow can move to this status. For example, another form must be completed.
      1. Click the Transition Prerequisite tab.
      2. Enable transition prerequisites by selecting the Enable Transition Prerequisite checkbox.
      3. Type text into the Help Text field.
         
         This text can be seen when:
         1. The Enable Transition Prerequisites checkbox is selected.
         2. The user hovers their mouse cursor over the status in the workflow.
            
      4. Manage Rule Groups:
         1. Add a Rule Group:
            1. Click + New Rule Group.
            2. Type the rule group name.
            3. Click Update.
         2. Delete a Rule Group:
            1. Click the red delete button.
               
            2. Click Yes to confirm.
      5. Manage a Rule Group’s rules:
         Click Edit Rule Group and choose from one of the three tabs:
         
         1. Workflow Relationship Check tab: These rules check the status of the workflow of the parent, child, or same form.
            1. Click + new rule.
            2. Form Direction: Select one of the following from the drop-down menu:
               • This Form.
               • Parent.
               • Child.
            3. Form: Select the form to be validated from the drop-down menu.
            4. Workflow: Select a Workflow belonging to the form selected above.
            5. Condition: Select whether Equal or Not Equal.
            6. Value: Select the field item (if a drop-down menu) or Equal or Not Equal if the field contains a string.
            7. Click the pen icon beside Error Message, type the text of the error message, and click Save & Close.
            8. Click Save & Close.
            9. Click Save & Close again.
         2. Field Validation Check tab: These rules check the condition of a field of the parent, child, or the same form.
            1. Click + new rule.
            2. Form Direction: Select one of the following from the drop-down menu:
               • This Form.
               • Parent.
               • Child.
            3. Form: Select the form to be validated from the drop-down menu.
            4. Field Name: Select a field to be validated from the form selected above.
            5. Condition: Select whether Equal or Not Equal.
            6. Value: Select the field item (if a drop-down menu) or Equal or Not Equal if the field contains a string.
            7. Click the pen icon beside Error Message, type the text of the error message, and click Save & Close.
            8. Click Save & Close.
            9. Click Save & Close again.
         3. Related Form Check tab: Checks that a parent, child, or the same form has at least one entry.
            1. Click + new rule.
            2. Form Direction: Select one of the following from the drop-down menu:
               • This Form.
               • Parent.
               • Child.
            3. Form: Select the form to be validated from the drop-down menu.
            4. Condition: Select whether Equal or Not Equal.
            5. Click the pen icon beside Error Message, type the text of the error message, and click Save & Close.
            6. Click Save & Close.
            7. Click Save & Close again.
8. Click Save.
9. Close the workflow diagram pop up by clicking the X in the top right corner.