1Reading the list #
- Progress is finished steps over all steps. It stops at 99% while anything is still open — a route is only 100% when nothing is waiting.
- Waiting at is the earliest step still open; Waiting on lists the people who have not answered it.
- Days waiting counts from the moment the open step opened - the number worth sorting by. It is empty when nothing is waiting: a document not yet submitted, or a route that has finished. A 0 means it opened today.
- A row in orange is past the step's due date (the step's expiry in days , set in Workflow Set-up).
- The list is scoped by your report option — all branches, your branch, or your group — exactly as reports are.
- Set the status and the dates , then press Apply filter — nothing is fetched while you are still choosing. The screen opens on Pending and Submitted — the documents somebody still has to act on. Pick Completed or Aborted as well to see finished routes, or press Clear for all four.
- The footer counts the documents listed, totals their value, and gives the longest wait among them — the filter decides what is counted.
- Drag the handle between the list and the route to give either one more room; the arrow keys move it too, and Home puts it back. Where you leave it is remembered on this browser. The route always keeps enough width to be read, however far the handle is pushed.
2The route, and what the colours mean #
- Green — completed or approved.
- Blue — started: it is open and waiting for people.
- Grey — pending: it has not opened yet, because the step before it has not finished.
- Red — rejected.
- Amber — cancelled or stopped by somebody on this screen.
Under each step are the people it was given to, in their own state, with their remarks on hover.
Diagram or Steps. The route is drawn by default: Start at the top, one box per step, End at the foot. An arrow is a step's starting rule — from Start, it opens on submit; from another step, it waits for that one (the step before it, or every parent its step name lists); a dashed arrow means it is started by hand. The box's edge is the colour above, and late (amber, glowing) is an open step past its due date. Click a box and that step's card — with every STEP and PEOPLE action — shows under the drawing. Drag the canvas to move around; zoom with the buttons, or Fit to see it whole. Steps shows every card as a list instead; the screen remembers which you chose.
A document that was rejected and sent round again has one pass per round : the diagram draws the latest, and a Round list appears to draw an earlier one. A step re-opened by a rejection says so in its box.
3What you can do, and what it does #
Everything sits on the thing it acts on — the document's verbs at the end of its row, the step's and its people's on the step itself. Nothing has to be selected first: pressing a button picks what it is on. The desktop hides the same list behind a right-click; here it is in the open, because a right-click has no keyboard and no touch screen. Hover any button for its name.
- At the end of a row — open and print the voucher; submit a route still Pending; abort one that is running; time analysis ; reports .
- On a step card, STEP — pause holds it where it is, complete settles it as if everybody had answered, cancel takes it out of the route (reason required). Start is for a PAUSED step only, and it asks everybody again : the engine opens a step by setting every assignment on it back to pending, so answers already given are erased. The dialog says how many before you press OK. Then: what it tells its approvers; its instruction document , which opens with the program that owns it (Word and Excel through their own scheme, anything the browser can show inline, everything else as a download); everything ever written against it; and compose mail — the desktop's Compose Message: a mail about the step, addressed to the people it still waits on, with the step's own subject and message filled in from the document. Pick the account it goes from, add people or files, and send; it is logged in Admin > Notification Log whether it went or not.
- On a step card, PEOPLE — add asks more people (they join as Manual, pending, beside the others). Approve , reject and escalate record a decision against that person , with your remarks. Cancel stops waiting for them. Back to pending undoes an answer given in error.
- Click a person's chip first to act on them by name; otherwise the dialog asks whose assignment it is, opening on the first one still to answer.
Every one of these goes through the workflow engine, exactly as an approval made on the voucher itself does — so the step settles, the next one opens and the document's status moves in the same way whoever did it. Two cautions worth knowing: Back to pending does not rewind a step the engine has already settled (Start the step first if it has to wait again), and an escalation never escalates onward .
4Cancelling a step or an assignment #
- Cancel step takes the whole step out of the route. The engine then settles the document as it would after any other decision — which may mean the next step opens, or the route ends.
- Cancel assignment takes ONE person out. The step stays; it is simply no longer waiting for them, and its policy is judged on the people who are left.
- A cancellation needs a reason , and it is written into the document's history beside everything else that happened to it.
- Neither is a delete. Nothing is removed — the step or the assignment is marked cancelled and stays readable.
5Health check - documents stuck part-way #
Health check on the toolbar looks at every document in a route and lists the ones that are stuck — in a state that no later answer will move on from. Most are documents that were already part-way through when the web and its workflow engine arrived; the desktop's own procedures could leave them behind. The check only reads.
- Each line says what is wrong and what to do , in red (the route cannot move), amber (it can, with a hand) or grey (information).
- Settle is offered only where the answers already given decide the matter — every step is done but the route was never marked complete, or a step's policy is met but the step is still open. The engine reads those answers again and does what it would have done then, and writes it into the document's history. It decides nothing a person has not already decided.
- Everything else needs you: Show lists every status, puts the document on the board with its step picked, and closes the check — then use the step's or the document's own buttons.
- Only documents you can see are named — the same report option and branch as the list. Findings elsewhere are counted, not named.
- F5 checks again. Settle is never on a key.
6Who may use this #
- Opening the screen needs User Can Run WorkflowManager — and the database enforces it inside the list itself, so an unpermitted user sees nothing here rather than a partial list.
- User can cancel Workflow Steps and User can cancel Workflow Assignments are separate rights: somebody can be allowed to watch without being allowed to intervene.
- All three sit in User Permissions under Preferences . Administrators hold them without a tick.
7If something does not work #
"Pick a step first." / "Pick a person first." / "Pick a document first."
- Why
- The action was asked for without the step, person or document it acts on - usually a row that was refreshed away while the dialog was open.
- What to do
- Refresh (F5), pick the row again and repeat the action.
"A step can be Started, Paused, Completed or Cancelled - not '...'." / "An assignment can be Approved, Rejected, Escalated, Cancelled or set back to Pending - not '...'."
- Why
- The screen sent a status the workflow does not know. It should not happen from the buttons.
- What to do
- Refresh the page (Ctrl+F5) - an old copy of the screen may still be loaded - and try again.
"This screen can submit a workflow or abort it, nothing else."
- Why
- Only Submit and Abort change a document's workflow status from here; everything else is done on its steps.
- What to do
- Use the step's own buttons for anything else.
"Pick whose assignment it is."
- Why
- Approve, reject, escalate or cancel act on ONE person's assignment, and none is picked.
- What to do
- Pick the person in Whose assignment, or click their chip on the step card first.
"Pick a voucher type."
- Why
- New voucher needs to know which kind of document to raise.
- What to do
- Pick one in the list and press OK (F5).
"The mail was not sent: ..."
- Why
- The compose window reached the server, but the mail account refused it or could not be reached - the reason follows the colon.
- What to do
- Pick another account in From, or have the account fixed in Settings > Mail Accounts. Every attempt is in Admin > Notification Log.
"That row does not carry enough to open the document."
- Why
- The row has no voucher type or number to open the document with - usually a document whose voucher type was removed.
- What to do
- Open the document from its own register instead.
"Tick at least one document marked Settle." / "Pick at least one document the check marked as repairable."
- Why
- Settle acts on the ticked documents, and none is ticked.
- What to do
- Tick the documents to settle, or close the check.
"That document is no longer on the board."
- Why
- Show lists every status and then looks for the document - it has been deleted, or is outside your report option.
- What to do
- Check again (F5) in the health check; if it is still listed, an administrator who can see it deals with it.
"Workflow Management is not licensed for this company. Contact your software vendor."
- Why
- Workflow Management (module WRKFLOW) is not in this company's licence. The sidebar hides the module, this page shows a cover, and the server refuses every workflow call - the licence is read by the server itself, not taken from the browser. Automatic escalation also stops for an unlicensed company.
- What to do
- Your software vendor adds Workflow Management to the licence. It takes effect within ten minutes, or at the next sign-in.
"The mail could not be prepared: ..."
- Why
- Compose mail reads the step, its people and the mail accounts first; that read failed, in the words after the colon.
- What to do
- Refresh (F5) and try again.
To is empty when Compose mail opens
- Why
- To starts with the people the step is still waiting on who have an e-mail address on their user account. Nobody is waiting, or nobody waiting has an address.
- What to do
- Type the addresses, or press Contacts to pick them.
"Give at least one recipient e-mail address." / "Give the mail a subject."
- Why
- A mail needs somebody to go to and a subject.
- What to do
- Fill in To and Subject and send again.
"The attachments together are ... MB - most mail servers refuse past 25 MB."
- Why
- Everything attached adds up past what a mail server normally accepts.
- What to do
- Remove a file, or send a link to it in Document Management instead.
"A document could not be attached: ..."
- Why
- A file picked from Document Management could not be read - usually your Download right on it.
- What to do
- Ask for Download on the file, or attach a copy from your own machine.
The mail was not sent, with the mail server's own words
- Why
- The account it went from refused it - wrong password, blocked sender, bad address. The window stays open with what you wrote.
- What to do
- Pick another account in From, or have the account fixed in Settings > Mail Accounts. Every attempt is in Admin > Notification Log.
A completed or aborted document is not in the list
- Why
- The screen opens on Pending and Submitted only - the documents somebody still has to act on.
- What to do
- Add Completed or Aborted to Workflow status and press Apply filter, or press Clear to list every status.
"You are not permitted to run the Workflow Manager."
- Why
- The preference User Can Run WorkflowManager is unticked for you. The database enforces this one inside the list itself, so nothing would load anyway.
- What to do
- An administrator ticks it in User Permissions > Preferences > User Can Run WorkflowManager. Administrators hold it without a tick.
"Workflow Management is not licensed for this company."
- Why
- The module (WRKFLOW) is not on this company's licence.
- What to do
- Ask your vendor about the Workflow Management module.
The list is empty although documents are in a workflow
- Why
- The list is scoped by your report option - all branches, your branch, or your group - and by whatever filter was last APPLIED.
- What to do
- Press Clear beside Apply filter, then Apply, and check which report option you signed in with.
Changing the status or the dates changed nothing
- Why
- The filter is read when Apply filter is pressed, not as it is typed - so a half-chosen date never sends a query.
- What to do
- Press Apply filter. The line under the button always says what is being asked for.
The footer's total is not the whole company's
- Why
- It totals exactly what is listed, which is what the filter asked for and what your report option allows you to see.
- What to do
- Widen the filter, or clear it, and apply again.
The progress bar says 99% and nothing is left to do
- Why
- It stops at 99% while any step is still open. A route only reads 100% when nothing is waiting.
- What to do
- Look at the route: a step in blue is still open, usually waiting on somebody who has not answered.
A document shows no "Waiting on" although it is not finished
- Why
- The step has opened but has no assignment left - everybody on it has answered, or their assignments were cancelled - and the engine has not settled it yet.
- What to do
- Refresh (F5). If it stays, the step's policy cannot be met by the people left on it; cancel the step to let the route move on.
A row is orange
- Why
- The step it is waiting at is past its due date - the step's Expiry In Days, counted from when it opened.
- What to do
- Nothing is broken. It is the queue to deal with first.
"Say why the step is being cancelled - it is written into the document's history."
- Why
- A cancellation is recorded against the document, and a record with no reason is no use to whoever reads it next.
- What to do
- Type the reason. Say why, not what - "supplier withdrew the quote", not "cancelled".
The buttons on a step card are greyed
- Why
- The route is finished, the step has already finished, or you do not hold that right - cancelling a step and cancelling an assignment are rights of their own.
- What to do
- A finished step cannot be cancelled: there is nothing left to stop. For the rights, see the two entries above.
Submit or Abort at the end of a row is greyed
- Why
- Submit is offered only while the route is still Pending, Abort only while it is running - a finished or already aborted route has neither.
- What to do
- Read the Workflow column of that row: it says which of the two, if either, applies.
Cancelling a step moved the document on by itself
- Why
- That is the engine doing its job: once a step is out of the way it settles the document, which may open the next step or end the route.
- What to do
- Nothing to fix. The document's own workflow panel shows what it decided and why.
"Everybody on this step has already answered." / "Nobody on this step has answered yet ..."
- Why
- The verb has nobody it can be applied to: every assignment is decided (so there is nothing to approve), or none is (so there is nothing to re-open).
- What to do
- Read the people on the card - each chip carries its own state. Add asks somebody new; Back to pending undoes an answer already given.
"Everybody named is already on the step."
- Why
- Nobody is put on a step twice - somebody who is already there, in any state but cancelled, is skipped.
- What to do
- Nothing to fix. If they should answer again, use Back to pending on their assignment instead of adding them.
"None of those are logins of this company."
- Why
- A name was sent that is not in UsersList - which normally means the list was stale and the login has since been removed.
- What to do
- Refresh (F5) and pick again.
"The step is already Completed, so nobody can be added to it." (or Cancelled, Stopped, Rejected)
- Why
- An assignment on a finished step would be waited for by nothing and answered by nobody.
- What to do
- If the step has to be answered again, Start it first, then add people.
"That assignment is already waiting to be answered."
- Why
- Back to pending only applies to an answer that was given - approved, refused, escalated or cancelled.
- What to do
- Nothing to fix. It is already waiting on that person.
"The step itself is Cancelled, so re-opening one answer on it would change nothing."
- Why
- Putting an answer back on a step that is out of the route leaves a row nothing will ever settle.
- What to do
- Deal with the step first: Start it, and then re-open the answer.
"Name at least one person to escalate to ..."
- Why
- Escalating closes that person's assignment, so an escalation to nobody would leave the step with no one on it.
- What to do
- Pick the people it passes to. They are added as By Escalation assignments, and an escalation never escalates onward.
Answers disappeared from a step after it was paused and started again
- Why
- STARTING A STEP ASKS EVERYBODY AGAIN. It is how the engine opens a step, so it sets every assignment on it back to pending - approvals, refusals and escalations alike. Pausing is safe; it is the start that clears them. (Measured: approve, pause - the approval survives - start, and it is pending again with the remarks stranded.)
- What to do
- There is no undo. Ask the approvers again, or record their decisions for them from PEOPLE on the step card. Start is now offered only on a PAUSED step, and the dialog says how many answers it would erase.
"Workflow instance is already in requesting status."
- Why
- A legacy guard refuses to start a step that is already started - and that refusal aborts the whole transaction.
- What to do
- Nothing to fix: the button is offered only on a paused step now. If you see this, refresh - the step was started by somebody else in the meantime.
Start is greyed on a step that is waiting
- Why
- A step that is already Started needs no starting, and one that has not opened yet starts itself when the step before it finishes. Start is for a step somebody PAUSED.
- What to do
- Hover the button: it says which of those it is.
Back to pending did not re-open the step
- Why
- Re-opening one answer is judged by the engine like any other change. A step that is still Started simply waits for that person again; a step the engine had already settled is NOT rewound, because the decisions after it have already happened.
- What to do
- Use Start on the step itself when it has to wait again, then re-open the answer.
Submit workflow is greyed
- Why
- Only a document whose workflow status is still Pending can be submitted - one already in the route cannot be submitted twice.
- What to do
- Check the Workflow column. Filter the list by Pending to see everything that has not been sent in yet.
Aborting left the document's status unchanged
- Why
- Abort ends the steps; what the document is left as is the route's own doing, and the legacy behaves the same way.
- What to do
- Set the document's status on the document itself if it has to change.
"No voucher type has a workflow attached yet." under New voucher
- Why
- The list is the voucher types that really carry a route (vchWorkFlowSettings), not the ones with a tick somewhere.
- What to do
- Attach the workflow to a voucher type in Voucher Manager. Every other voucher is raised from the menu as usual.
"No report is filed under the workflow report category (setting 157)."
- Why
- Reports lists whatever is filed under the category named in setting 157, Workflow Report Category.
- What to do
- File the reports under that category, or open the report catalogue and find them by name.
"Nothing was written in that period." in the Message log
- Why
- The message log is the workflow's own status log across every document you may see - if nothing happened in those dates, there is nothing to show.
- What to do
- Widen the dates, or clear both for everything (newest 2000 first).
"That step does not carry a step name from the master, so no document can be attached to it."
- Why
- The instruction DOCUMENT hangs off the step NAME's own master record, and this step was written without one.
- What to do
- Give the step a name from Workflow Steps in Workflow Set-up; the instructions and their attachment then belong to it.
The instruction document downloaded instead of opening
- Why
- The browser opens what it can show itself, and hands Word and Excel to the installed Office application through its own scheme. Anything else is downloaded, because a browser cannot launch a program directly.
- What to do
- Use the download bar's Open - it launches the file's associated program. If a Word or Excel file downloads too, Office is not installed on that machine.
"Document Management is not licensed for this company, so attachments cannot be opened."
- Why
- Attachments are a Document Management module feature, on this screen as everywhere else.
- What to do
- Ask your vendor about the Document Management module. The step's instructions TEXT is readable without it.
"Nothing is stuck among the ... document(s) you can see."
- Why
- Every document in a route is where its answers say it should be.
- What to do
- Nothing to fix.
"Marked completed with a step still open"
- Why
- The document's workflow status is 2, which means Completed - but one of its steps is still open. The desktop's procedures could leave this behind; the engine never does.
- What to do
- Decide what it really is. Show puts it on the board: complete or cancel the open step if the route really finished, or abort the workflow if it did not.
"Every step completed, never marked complete" / "A step's policy is met but the step is still open"
- Why
- The answers are all there and decide the matter - the document was simply never moved on, usually because the last answer was given before the engine was installed.
- What to do
- Tick it and press Settle. The engine reads the answers again and does what it would have done then: completes the step, opens the next one, or finishes the route - and writes it all into the document's history.
"Submitted, no step is open, and the workflow is not finished"
- Why
- Nothing is running, so nothing will ever move it: the next step never opened, or a step closed as rejected or stopped without the document being sent back.
- What to do
- Show it on the board and start or complete the next step, or abort the workflow and submit the document again.
"An open step with nobody left to answer" / "An open step waiting only on disabled users"
- Why
- The step is open, but either every assignment on it is gone, or the only people left cannot sign in any more.
- What to do
- Show it on the board, then Add people to the step, escalate, or complete or cancel it.
"Not submitted, but a step is running" / "Aborted, but a step is still running"
- Why
- A step is running on a document whose workflow is not running - left behind by the desktop's Revert or Abort.
- What to do
- Show it on the board and cancel the running step.
"A step whose definition was deleted"
- Why
- The step it waits on was removed from the workflow after the document entered it, so the engine cannot see that step at all.
- What to do
- Abort the workflow and submit the document again, so it takes the route as it is now.
"Running on a workflow that is now inactive"
- Why
- Only information: documents already in a route keep it when the workflow is made inactive; only new documents stop picking it.
- What to do
- Nothing to do, unless those documents should stop too - then abort them.
"Documents with findings outside what you may see (other branches)"
- Why
- The check reads the whole company, but lists only the documents your report option and branch let you see. The rest are counted, not named.
- What to do
- An administrator who can see those branches runs the check.
"This document is outside what you may see." after Settle
- Why
- A repair is refused for any document the manager's list does not show you.
- What to do
- An administrator who can see it settles it.
Settle reported "Not done" on a line
- Why
- The engine looked again and refused - in its own words on that line - or the document had moved on since the check. Each document is settled on its own, so the others still went through.
- What to do
- Press Check again (F5). If it is still listed, do what What to do says by hand.
This is the help InvoiceNET® ERP shows beside the Workflow Manager screen. Whether you have the screen depends on the modules of your licence and the rights your administrator has given you.
See this screen for yourself
The demo is the real product, with a company of your own.