Problem
At some point, you might need to chain the setup of the Chain of Approval (COA). This might happen if your procedures change or if you decide to better optimize the approval workflow.
Changing the setup when the system is live might be risky and cause issues, so it is necessary to make sure it is done properly.
The changes might be various:
Adding a new chain segment to the COA.
Removing an existing chain segment from the COA.
Moving one chain segment to another approval level.
Modifying the options that affect the approval workflow.
The above changes require certain actions:
creating,
re-linking (moving),
editing,
deleting/ settings to passive.
We will not discuss all of the above actions, you can read about them in our documentation Chain of Approval . We will go through the main points that you need to consider when changing the COA segments that might cause issues if not done properly.
Solution
Step 1
Go to the Chain of Approval > Levels.
Create a new chain segment if needed.
Re-link the chain segments according to the new workflow.
If you don’t use the re-link function, then the documents liked to this level will loose it’s link and will be lost.
! Important:
If some of the chain segments should be removed from the COA, first re-link the documents that are linked to this chain segment. To relink the documents:
Go to the Chain of Approval > Documents Status > Documents in the system.
Search for the needed chain segment under the Current Node.
Click Re-link to link the documents to the new chain segment.
After the documents are re-linked, remove the unnecessary chain segment or set it to passive depending on the situation.
Step 2
Changing the COA setup might not be enough.
It is possible that you have a separate role and user group for the chain segment that you need to either remove or change since it gives access to the Co-worker's Travel Expenses. In such case you need to do the following:
Role
Go to Setup > Access Control > Roles.
Check if there is an existing role for this chain segment and delete it. If you don’t want to delete it, you can just remove the access to the Co-worker's Travel Expenses.
User Group
If you remove the role, then you need to also remove the user group it was linked to. If you don’t remove the role, then you can leave the User Group unchanged.
To remove the user group:
Go to Setup > Access Control > User Groups.
Check if there is an existing role for this chain segment and delete it.
Don’t forget to add the ranks belonging to this user group to some other group, so that they still have access to the Portal.
Example
To better understand how to change the existing Chain of Approval (COA) we will use the following example.
Imagine the following approval workflow:
Crew members create and submit their Travel Expenses by linking the document to a specific vessel.
Musters from the corresponding vessels review and approve the documents.
Crew Coordinators in the office then perform the final approval.
We need to remove Masters from the approval workflow due to the change in the internal procedures.
To make the change smooth and without any issues, we need to: