Page Comparison

In order to add additional approval routes or to change the existing approval routes in VERAVera, you must edit the Approval Policy file on the VERA Server. Follow the instructions below to add addition all new approval routes to VERA ( or update existing routes):

Add a New Approval Group

to Vera

1. See Managing Policy Files to access the Approval Policy .json file in the Policies directory of the VERA Server Installation Directoryfile that needs to be updated.

2. Edit the file and find the Approval Groups element near the top of the file:

   Image Removed

   Code Block
   language js title Approval Roles Code Snippet
   { "Approval Policy": { "Version": "Tricentis Standard 1.0.0.0", "Schema": { "ID": "http://tricentis.com/schemas/0/0/approval-policy.json", "Major": "0", "Minor": "0" }, "Approval Groups": [ "Business", "Quality", "Reviewer", "Technical", ] } }

   
   

3. Add the Approval Group to the list. Be sure to enclose the name of the group in plain double quotes and use a comma to separate it from other groups in the list.
4. Upload the policy file to the Policy Management page either as a new approval policy or as a revision to an existing one.
5. Vera will read the policy file and the approval roles will be available for assigning to users in the Vera Administration portal.
   1. To add users to the new Approval Role(s), see Assign Users to a Domain Role.

Add a New Approval Route

to Vera

1. See Managing Policy Files to access the Approval Policy .json file in the Policies directory of the VERA Server Installation Directoryfile that needs to be updated.
2. Edit the file and find the Route Templates section:Image Removed.

3. Add a new Route Template by copying one of the existing templates or creating your own. The route template must include the following elements and be valid JSON: Name, Rank, Record Types, and Levels. The template can also include a Constraints section, if needed.

   Code Block
   language yml title Example Route Template
   { "Name": "Dry Run qTest Test Case Approval", "Rank": "1", "Record Types": [ "qTest Test Case" ], "Levels": [ { "Name": "Level 1", "Approvers": [ "Digital Tester Reviewer" ] } ], "Constraints": [ { "Type": "Field Is One Of", "Name": "Project Name for Approval", "Values": ["Project Name"] }, { "Type": "Field Is One Of", "Name": "Test Level", "Values": ["Dry Run"] } ] },

   
   

   1. Name: Can be any string. This will be displayed in the Approval Route field in the target system and in VERAVera.
   2. Rank: Any integer from 1 to 9999. This is used to determine which route template to choose if a record matches more than one. The lower the number, the higher the rank (1 = highest).
   3. Record Types: A list of valid record types. These must match the record types defined in the Records Management Policy .json file.
   4. Levels: A list of approval levels. Each level consists of a name and a list of approvers. The approvers must be from the list of approval groups defined above in the Approval Groups element at the top of the file.

   5. Constraints: An optional element where constraints are defined that help match records with the appropriate route template. A list of commonly used constraints can be found here: https://github.com/Tx3-Services/VERA-Configuration-Cookbook/wiki/Index-of-Supported-VERA-at Vera Constraints

      Note
      Field constraints must match the field labels in qTest or Jira exactly and should be defined in the Records Management Policy.

      
      

Update an Approval Route in Vera

1. See Managing Policy Files to access the Approval Policy file that needs to be updated.
2. Edit the file and find the Approval Groups element near the top of the file
   1. Add the new Approval Group
   2. Optional: If replacing an Approval Group, remove the Approval Group that the new one is intending to replace.
3. In the Route Templates section, locate the Approval Task where the new group will be added
   1. Add the new Approval Group
   2. If replacing an Approval Group, update the Approval Task with the new group and remove the old one

4. Upload the policy file to the Policy Management page either as a new approval policy or as a revision to an existing one.

5. Vera will read the policy file and the approval roles will be available for assigning to users in the Vera Administration portal.

   1. To add users to the new Approval Role(s), see Assign Users to a Domain Role.

Deploy the Approval Policy

see See Managing Default PoliciesPolicy Files