Where work / assignment is updated by a workflow, a new group may be added to the Complete phase.  This group provides a history of the workflow/s and workflow steps triggered for the work / assignment, their status and detail any transfer between teams. 

Important: Displaying history in Capture requires Obzervr configuration.  Specifically, a new Group Fragment Template (Workflow History) must be configured, and Obzervr must configure a header (obz-show-workflow-history) within the workflow-engine webhook.

Workflow History

To display an assignment's Workflow History in Manager and Capture, the following must be completed in each tenant.

1. Open Tenant
2. Create a Group Fragment Template
3. Enter the following template details:
   
   1. Name = Workflow History
   2. Identifier = WF-HIST
4. Click ‘Confirm’.
   
5. With the Group selected, enter the following via the Group config side sheet.
   
   1. Group Display Name = Workflow History
   2. Group Identifier = WF-HIST
   3. Reoccurrences = true (toggled on)
   4. Number of Reoccurrences = 0
   5. Allow Uncomplete = true
   6. All other toggles = false
6. Click Apply, then Save.

1. Add a Section to the Group.
   
   1. Name = Details
   2. Section Identifier = WF-HIST-SEC
2. Click Apply, then Save.
   
3. Add / Configure the following Fields to the Section: -
   Field 1

1. 1. 1. Field Name = Workflow Name
      2. Field Identifier = WF-HIST-FLD-WFN
      3. Read Only = true
      4. Type = Notes
         1. Click Apply, then Save.

Field 2

1. 1. 1. 1. 1. Field Name = Workflow Step
            2. Field Identifier = WF-HIST-FLD-STP
            3. Read Only = true
            4. Type = Notes
               Click Apply, then Save. 

Field 3

1. 1. Field Name = Status
   2. Field Identifier = WF-HIST-FLD-STAT
   3. Read Only = true
   4. Type = Notes
      Click Apply, then Save.

Field 4

1. 1. Field Name = Date Executed
   2. Field Identifier = WF-HIST-FLD-DAT
   3. Read Only = true
   4. Type = Date
      Click Apply, then Save.

Field 5

1. 1. Field Name = Time Executed
   2. Field Identifier = WF-HIST-FLD-TIM
   3. Read Only = true
   4. Type = Time
      Click Apply, then Save.

Field 6

1. 1. Field Name = Team (Originating)
   2. Field Identifier = WF-HIST-FLD-TOR
   3. Read Only = true
   4. Type = Notes
      1. Click Apply, then Save.

Field 7

1. 1. Field Name = Team (Updated)
   2. Field Identifier = WF-HIST-FLD-TUP
   3. Read Only = true
   4. Type = Notes

Field 8

1. 1. Field Name = User
   2. Field Identifier = WF-HIST-FLD-USR
   3. Read Only = true
   4. Type = Note
   5. Click Apply, then Save.

Field 9

1. 1. Field Name = Comments
   2. Field Identifier = WF-HIST-FLD-COM
   3. Read Only = false
   4. Type = Notes

1. Verify Comments field is not read only (otherwise group will not appear in Manager).
2. Click Apply, Click Save

10. Verify the configuration is 1:1 with that described above for fields, section and group.
    
    12. Make any necessary changes, to align the config – then click apply, then save. Else proceed, to step 12.
11. Once verified, click Publish.
12. Verify Group Fragment Template is Published in tenant.
13. Open Manager, click Integrations, then Webhooks.
14. Locate the Webhook with a URL suffix of:
    
    1. workflow-engine-quality (in Quality environments)
    2. workflow-engine-production (in Production environments).
15. Click the Edit button for the webhook.
16. Add the following header:
    
    1. Key = obz-show-workflow-history
    2. Value = true
17. Click the + button to the right of the value field for the row.
18. Click Save.
    
19. Return to Manager.

The Workflow History will now be added to the Assignment when triggered. 

Note: it will be visible in the Complete phase of an Assignment, where workflow step triggers.
Note: each workflow step will result in a separate group instance.