Loading

Working a Request from Its Progress Page

Each request has a progress page for the people who run the process: its stage history, what every approver recorded, every e-mail it has generated, and the corrective actions an administrator can take when a request is stuck.

Where to find it

Architect Panel → Forms:

  • User Input Views — View Requests on the view, then View Progress on a request

Admin Panel → Processes:

  • Expiring Soon — the Open button on a request

You need Read on the request's datastore to open the page, and Edit Existing to use the buttons that change a request.

What the page shows

  • A heading with the view name and the reference.
  • The progress bar, one step per stage. The stage the request is waiting at reads Current Stage; an application held in a closed-window queue reads Awaiting shortlisting instead, because nobody has been asked yet.
  • The request's details.
  • A Waiting for Information box when the requester has been asked something and has not answered, saying which stage asked and when.
  • A Flagged box when answer flags were raised, listing each flag, the answer that raised it, whether its notification failed, and whether it is holding the request.
  • Per-stage records: Approval Fields, Decline Fields and Stage Move Fields hold the answers approvers gave when they pressed a button, and any information requests and responses.
  • E-mail Correspondence: every e-mail the request has sent, with Recipients, Subject and Date/Time Sent, and the message itself.

The buttons

  • Action Request (with the waiting stage's name) opens the approver's decision page in a new tab. Whatever you press there is recorded as that stage's decision, so use it only when you are entitled to decide.
  • Edit Details opens the record for editing.
  • Rollback to Previous Stage removes the last stage decision and sends the request back. You must enter a Number of days to exclude from automatic timeout (1 to 365, default 7) so the request is not timed out the moment it returns. On a Verify Identity stage the button reads Reset Stage.
  • Close Information Request appears while the request waits on the requester. Record the information received, or why it is no longer needed; leave E-mail the approver ticked to send them a fresh link. The stage does not move and the decision stays with the approver.
  • Clear on a flag records that it has been reviewed; Release Hold and Notify Approver sends a held request on. See Answer Flags.
  • Forward / Re-send on an e-mail sends a copy to an address you enter.
  • Delete on an e-mail removes it from the correspondence list. Only architects see it.
  • Re-generate and Send E-mails appears when a request on a view with stages has no e-mails at all. It sends the requester's confirmation and the first approver's e-mail, for a submission that was saved but whose e-mails failed.

Choosing the right fix

  1. The approver says they never got the e-mail. Check E-mail Correspondence. If it is there, Forward / Re-send it to the right address. If the list is empty, use Re-generate and Send E-mails.
  2. The requester answered outside the form. Use Close Information Request rather than Rollback, which would lose the record that information was asked for.
  3. A stage was approved by mistake. Use Rollback to Previous Stage and choose enough days for the approver to act again.
  4. A field was entered wrongly. Use Edit Details.

Worked example

A supervisor rings to say they deleted the approval e-mail for application WX-2231. The co-ordinator opens Expiring Soon, sees the request has five days left, and presses Open. Under E-mail Correspondence they find the supervisor's e-mail and use Forward / Re-send to send it again. Two weeks later the student phones in the answer to a question the supervisor asked; they press Close Information Request, type the answer, and the supervisor receives a fresh link.

Recommendations

  • Read the correspondence first before changing anything.
  • Prefer Close Information Request to a rollback.
  • Give rollbacks enough days so the time-out does not undo your fix.
  • Use Action Request sparingly; it is recorded as the stage's own decision.