Approvals

On this page

An approval is organized in two kinds of record. An approval stage is one round of approval for a record, such as a ticket; see Tickets. An approval request is one approver's part in that round, so a stage has one approval request per approver. A record can have several stages, ordered by their rank.

For approving in the Self Service Portal, see Approve Requests.

What you can see and change

Approval stages and approval requests have permissions of their own, but they are only as visible as the record they approve:

  • You see an approval stage only if you may view the record it approves.
  • You see an approval request only if you may view records of the approved record's kind.
  • Changing or deleting a stage or a request also requires the right to edit the approved record.

See Permissions Reference.

Default Workflow scope

In a new database created with the Default Workflow, approvals are raised, voted on, and reassigned with workflow actions; see Default Workflow Configuration. An upgraded database need not have this content, and an administrator may have changed it. The procedures and approval outcomes on this page describe the supplied configuration.

Change requests, incidents, service requests, work orders, knowledge base articles, purchase orders, and contracts carry the actions Create Approval, Request Approval, Approve Request, and Reject Request. An approval stage carries its own Approve Request and Reject Request, and an approval request carries Approve Request, Reject Request, and Change Approver.

Approvals in the Web App

Request an approval

The steps use the actions of the supplied configuration described in The approval process. For how to find and run actions on a ticket, see Work on a Ticket. The forms named here are those of a change request; the other record types carry actions with the same names.

  1. On the record, run Create Approval. On a change request it is offered in Draft, Assigned, or In Progress, to the administrator roles and the Change Request Manager and Technician roles.
  2. Complete the form:
    • Reason for Approval Request, which is set to the change request's summary in the supplied configuration.
    • Create Approvals by: individuals, a group, or a position, with the matching Approvers, Approval Group, or Position and Position Type. It is set to "Choosing a Group", and Position to "Requester Manager", in the supplied configuration. The form's text includes "Choosing a Group: the members of that group will be automatically created as Approvers".
    • Type, which is set to Any Approved in the supplied configuration, and Category. The hint of Type explains each type, for example "Sequential Approval: Approvers approve/reject individually in order of rank."
    • Minimum Vote Percentage or Single Vote Timeframe, depending on the type. Minimum Vote Percentage is set to 30 in the supplied configuration.
    • Attachments.
  3. Run the action. It creates one approval stage with its approval requests and logs "Created Approval".
  4. Run Request Approval. On a change request it is offered in the statuses from Draft to Implemented, and only while the record has both a pending approval stage and a pending approval request.
  5. Enter the Approval Deadline, which is set to five days from now in the supplied configuration, Comments, time spent, and attachments.
  6. Run the action. The record is set to Pending Approval, its followers and collaborators are notified, and the pending approvers of the pending approval stage of lowest rank are e-mailed: by rank on a Sequential Approval stage, and all at once on a stage of any of the four other types.

Vote on an approval request

You can vote on the record awaiting approval, on its approval stage, or on your approval request.

  1. Open the record awaiting approval or its approval stage, or open your approval request from the record's Approvals tab or from the Approval Requests list.
  2. Run Approve Request or Reject Request.
    • On the record, the actions are offered only to a pending approver on a pending stage. On a change request, they are offered while it is in Pending Approval, and on a Sequential Approval stage only to the first pending approver by rank. The form asks for approval notes or a reason for rejection (on a change request, Approval Notes or Reason for Rejection), and optionally time spent and attachments.
    • On an approval request, the actions are offered while it is Pending, and only to the request's approver. The form asks for a Comment.
  3. Run the action. The stage's outcome is calculated from its type; see Approval types.

Change the approver

  1. Open the approval stage from the approved record's Approvals tab.
  2. On the General tab, in the Approval Requests grid, use Actions on the approval request and choose Change Approver. It is offered while the approval request is Pending, to the administrator roles and the Approval Manager role.
  3. In the Change Approver Information form, choose the approver and the approval stage and enter a Reason for Change. You can also change the type, the due date, and the rank.
  4. Run the action.

To add an approver to a stage, the supplied configuration has the New Approval Request action, offered while the approval stage is Pending. Its form, Create Approval Request, requires an approver and asks for a type and a rank.

The Approvals tab

Incidents, problems, change requests, service requests, work orders, knowledge base articles, contracts, and purchase orders have an Approvals tab. The tab is a tree: each top row is an approval stage, and the stage's approval requests are listed under it. A stage row shows the stage's name in the approver column. The columns are the approver, the decision date, the type, the status, and the rank. Open a row to open the approval stage or the approval request. The tab has an Actions button and offers no delete on its rows.

Approval stage records

Approval stages have no entry of their own in the main menu. Open a stage from the Approvals tab of the approved record; stages can also be found with advanced search.

An approval stage's General tab holds the Details (the name, the approved record, the requester, and the description), the Categorization (including the type and the category), and the Settings (the approval group, the start time, the deadline, the time for a single vote, and the minimum vote percentage). Beside them, the Approval Requests grid lists the stage's requests and has a New button for an Approval Request and an Actions button. The grid shows the flag, the number, the class, the creation date, the requester, the approver, the type, the stage, the status, the decision date, and the rank of each request. Unlike the Approvals tab, the grid's action menu and each row's own menu offer Delete. The stage's other tabs are Activity, Custom Data, Related Objects, Notes, History, and Attachments.

The Approval Requests list

Approval Requests is in the Service Desk group of the main menu. The list shows the flag, the number, the class, the approved record, the stage, the approver, the decision date, and the status of each approval request. To go to the record being approved, use the link in the approved record's column.

Approvals in the Mobile App

In the Alloy Navigator app, Approval Request is in the Service Desk group of the home screen, and a record's detail page can have an Approvals tab, depending on the kind of record. The app's Actions page lists the workflow actions available on the record, and runs the action's form. The approval actions are those of the supplied configuration described in The approval process, and their forms ask for the same information as in the Web App.

Request an approval

  1. Open the change request and go to its Actions page.
  2. Choose Create Approval, and complete and run the form.
  3. On the Actions page, choose Request Approval, and complete and run the form.

Vote on an approval request

  1. Open the record awaiting approval, or open your approval request from Approval Request in the Service Desk group.
  2. On the Actions page, choose Approve Request or Reject Request, and complete and run the form.

Change the approver

  1. Open the approval request from Approval Request in the Service Desk group.
  2. On the Actions page, choose Change Approver, and complete and run the form.

The approval process

A round of approval runs like this:

  1. Create Approval creates one approval stage for the record, and then one approval request per approver. The approvers are chosen in one of three ways:
    • a group: every active member of the group becomes an approver, and members who are Inactive or Disabled are skipped;
    • individuals: each person you choose becomes an approver;
    • a position: one approver is found from the record, such as, on an incident, the requester's manager or the service manager of the incident's service.
  2. Request Approval runs the approval stage's own request for approval, which e-mails the stage's pending approvers: by rank on a stage of the Sequential Approval type, and all of them at once on a stage of any of the four other types (see Approval types). On a change request, it is the action that sets the record to Pending Approval, and it runs the request on the pending stage of lowest rank.
  3. Each approver approves or rejects. After every vote the stage's outcome is calculated from its type.

Approval types

The type of an approval stage decides how its votes are counted. The supplied configuration has five types:

  • Any Approved: one approval approves the stage; the stage is rejected when all approvers reject.
  • Single Vote Rejection: one rejection rejects the stage; the stage is approved when all approvers approve.
  • Majority Decision: 51 percent decides the stage, either way.
  • Required Percentage: the votes are compared against the stage's minimum vote percentage.
  • Sequential Approval: approvers approve or reject individually in order of rank. One rejection rejects the stage, and the stage is approved when all approvers approve; until then, the next pending approver by rank is determined.

The outcome is calculated only for these five types; a stage with any other type has no outcome calculation.

When a stage is decided

When a stage is approved or rejected, its approval requests that are still pending are set to Not Required. An approved stage opens the stage of the next rank: that stage is set to Pending Approval, its start time is set to the current time, its deadline is shifted by the length of the first stage's window, and its approvers are e-mailed. A rejected stage opens no next stage.

The approved record's status follows the stage that was created last for the record:

  • When that stage is approved, a service request, change request, purchase order, incident, work order, or contract is set to Approved, and a knowledge base article is set to Approved and then Live and Public.
  • When that stage is rejected, the record is set to Rejected.

If an earlier stage is rejected while a stage created later is still pending, the record's status stays as it is.

The Cancel Approvals action is offered while a stage is Pending or Pending Approval. It sets those stages and their pending approval requests to Not Required and returns the record to In Progress (change requests, incidents, service requests, and work orders), Draft (knowledge base articles and purchase orders), or Pending (contracts).

Closing the approved record leaves its approval stages and approval requests as they are.

Approval record details

An approval stage holds the round's settings:

  • the record being approved, the person who asked for the approval, and the group the approvers were drawn from;
  • the start time and the deadline of the round;
  • the time allowed for a single vote;
  • the minimum vote percentage, the threshold that a percentage-based round compares against;
  • its rank among the record's stages, and its status, type, category, name, and description.

An approval request holds one approver's decision: the approver, the request's rank (the order of voting in a sequenced approval), its status and type, the date the vote is due and the date the decision was made, and the approver's notes.

A stage created without a rank gets the next rank after the record's highest one, and a request created without a rank gets the next rank within its stage. Adding a request writes "Approver added" to the stage's history. When a record is deleted, its approval stages are deleted with it.