Requiring Electronic Signatures in the web client

For compliance purposes, your organization might require users to provide electronic signatures at specific points during the workflow of a work item. You can configure this requirement by adding the Electronic Signature attribute, presentation, and precondition to a work item type.


Restriction: If your Jazz Authorization Server is configured to use SCIM (System for Cross-domain Identity Management), you are not able to use the Electronic signatures features in IBM® Engineering Workflow Management.
To configure a work item type to require that users provide electronic signatures when they change work item approvals:

  1. In the Eclipse client, in the Team Artifacts view, right-click the project area and select Open.
  2. In the Project Area editor, click the Process Configuration tab. Expand Project Configuration > Configuration Data > Work Items. Click Types and Attributes.
  3. Select the work item type category, such as Defect.
  4. In the Attributes section, click Add. Enter a name for the electronic signature attribute, such as E-Sig.
  5. In the Type field, select Electronic Signature, and click OK.
  6. Click Save to save the project area.
  7. Click Editor Presentations. In the Editor Presentations list, expand Approvals. Select Approvals (layout slot: <None>). Click Add Presentation.
    If a Locked Section window opens, then the selected section is shared with other editor presentations, and if you make changes to it (for example, add a presentation), those changes will also appear in all presentations that share this section. You can select Unlock this section and make the changes, impacting other editor presentations, or you can select Replace these instances of the shared section and tab with unshared duplicates to make a copy of the section to use in this context. If you then make changes to the copied section, they do not impact other editor presentations.
  8. In the Attribute field, select the attribute you just created, such as E-Sig; in the Kind field, select Electronic Signature, and click OK. Click Save to save the project area.
  9. Expand Team Configuration and select Operation Behavior. In the Operations grid, click the cell in the Save Work Item row for the role for which you want the electronic signature requirement to apply. In the Preconditions section, click Add. Select Electronic Signature and click OK.
  10. In the Actions table, select the work item type, such as Defect, that contains the electronic signature attribute. Click Edit. Select the approval type, such Approval, Review, or Verification, for which you want to apply the Electronic Signature precondition. Click Save to save the project area.


The work item type is configured so that when users save work items that have modified approvals, they must enter their passwords in the E-Signature field on the Approvals page of the work items. For example, when users attempt to save a work item after they change an approval status from Pending to Approved, they must enter a password.