Share this page

# Submit entities for approval

This topic covers how to submit entities for approval using the e-signature approval process.

In this topic:

## Submit an entity for approval

As an author, you create entities and submit them for approval.

To submit an entity for approval:

1. Import or create an entity.

2. Edit the entity as required and click Submit to add it.

3. Start the approval process.

   Client | Details
   --- | ---
   Web | Select the field value that triggers the approval process. For example, change Phase from Draft to Approve. If a controlled flow is configured for the transition, an approval badge is displayed next to the state. If you are not permitted to perform this action, you cannot change the field value.
   Desktop | In the toolbar, select the field that triggers the approval flow and set it to the required value. The field name depends on your approval settings. For example, if changing Transitions from Draft to Approved triggers approval, select Transitions and then select Approved. If a controlled flow is configured for the transition, (Approval Required) is displayed next to the state that triggers the approval flow. If you are not permitted to perform this action, you will not be able to change the field value.

4. When you choose a transition that is controlled by e-signature, the system opens the approval submission flow and selects the configured approval policy and levels automatically. Depending on permissions and policy configuration, you may be able to add extra approvers or levels before you submit.

   In the Submit Approval Request window, view the approval policy and levels. You can view the number of required approval levels and the individuals in each project team who are permitted to approve.

5. (Optional) Add additional configured approval levels or add additional project team members or individual approvers.

6. Add your comments and submit the request.
   The entity is updated to reflect that the approval process is underway, for example, Routed for Approval. The entity remains in that state until all required approvals have been completed.

7. When this is your first e-signature action in the session, you are prompted to confirm your credentials before the request is submitted.

8. The system initiates the approval flow automatically based on configured policies:

   - First approval level begins

   - Configured approvers receive notifications

   - Finalized fields become read-only. For details, see Locked fields and attachments.

   - If relevant, the entity progresses through all additional approval levels defined in the approval settings.

9. You receive an email notification when the entity is approved. If an approver rejects, cancels, or defers the request, update the entity and resubmit it for approval. The approval process then restarts. For details, see Handle rejections.

Note for Test Runs:
Depending on the approval policy set up by your project administrator, test run approval may use a special flow.

- After the test run is initiated, any state transition that triggers approval is allowed only after all design steps in the test run have been carried out by one or more testers. If all steps are not carried out, the state transition is not permitted.

- Before approvers are notified, approval notifications are sent to all testers who performed steps in the test run. After tester approvals are completed, the configured approval flow proceeds through its approval levels.

Back to top

## Track approvals

After submitting an entity for approval, you can view and track pending approval requests or view approval history. Approvals can be tracked at the level of an individual entity, or at a project level.

To view approval history of an individual entity:

1. In an open entity, select History > Approvals. Entity-level approval history shows the route and signature actions for the current entity.

2. Select an option:

   - Approval Route: View current progress and pending levels. Expand the item to view more details regarding the status of the approval request.

   - Approval History: View completed actions with approver, team, level, action, comment, timestamp, and signature purpose

To view the status of all your submitted requests and your approvals:

1. Go to the Approvals page.

   Client | Details
   --- | ---
   Web | In the left navigation panel, click the Approvals option .
   Desktop | In the navigation sidebar, click the Approvals option

My Approvals shows requests waiting for your action as an approver. For details on approving requests, see Review and approve requests. My Requests shows requests you submitted.

2. Click My Requests to view the submissions you have made.

3. View the request status summary or expand an item for detailed progress and approver information. You can filter requests by approval status. To withdraw one or more requests, select the items and click Withdraw. For more details, see Withdraw an approval request.

Project-level complete audit trails are available to project administrators for broader monitoring and reporting. For more details, see Audit Trails in Configure approval settings.

Back to top

## Audit log

Changes to an entity are tracked in the audit log of the entity.

To view the audit log for an entity:

- In an open entity, select History > Audit Log.

  View changes across all fields or filter by a specific field.

Back to top

## Locked fields and attachments

When an entity is submitted for approval, certain fields may become read-only (locked) as configured by your administrator. These finalized fields cannot be edited during or after the approval process.

Depending on the approval policy configuration, attachments may also be locked during the approval process. When Attachments are locked:

- You cannot add new attachments.

- You cannot delete existing attachments.

- You cannot modify attachment properties.

If you need to edit a locked field or make changes to an attachment, withdraw the approval request first. Make the changes and then resubmit.

Back to top

## Withdraw an approval request

If approval is in progress, the author can withdraw the request to make changes before resubmitting.

1. Open the entity with an active approval request.

2. Withdraw the approval request.

   Note: The withdraw option is displayed only for the author of the entity.

   Client | Details
   --- | ---
   Web | In the Details View, click Approval dropdown menu in the top corner and select Withdraw. To withdraw multiple requests, in the left-navigation panel, click the Approvals icon . In the My Requests tab, select the relevant items and click Withdraw.
   Desktop | In the Details View, click the Approval option in the toolbar and select Withdraw. To withdraw multiple requests, in the navigation sidebar , click the Approvals option . In the My Requests tab, select the relevant items and click Withdraw.

3. Enter a reason for withdrawing the request and click Submit. Re-authentication is required for security.

4. The approval is withdrawn.

   - The withdrawal action is recorded.

   - Any fields locked by the controlled flow become editable again.

   - You can modify the entity as needed

5. If relevant, resubmit the entity for approval.

To withdraw multiple requests, see Track approvals .

Back to top

## Handle rejections

If your submission is rejected during the approval process, you will be notified and can take corrective action.

After a request is rejected:

1. The entity is moved to the rejected state.

2. Review the rejection reason and comments from the Approver.

3. You can now edit the entity (locked fields are editable again).

4. Make the necessary corrections.

5. Resubmit the entity for approval.

Each resubmission starts a new approval cycle and creates a new sequence of entries in the approval and audit trail records.

## Revise an approved request

If your project administrator has set up the approval workflow to allow revision of an entity after approval, you can revise an approved entity. Revising an approved entity creates a new version of the entity and updates the entity to the configured initial state. The previous approved version remains available as a historical entry.

See also:

- Electronic signature

- Configure approval settings

- Review and approve requests

https://admhelp.microfocus.com Application Quality Management 8942
Tips to improve your search results... OpenText™ Application Quality Management Help Center OpenText™ Application Quality Management Help Center OpenText™ Application Quality Management Help 26.1 All View Local Help Center View Online Help Center Version: