Gates Control
Gate fields allow you to lock or unlock other fields in forms.
A gate is activated by approval of one or more users. The users or user groups which can approve a gate are configured as review lines
![Screenshot 2024-02-04 at 21.45.16.png](../__attachments/3142662120/Screenshot%202024-02-04%20at%2021.45.16.png?inst-v=66fdafcf-f549-49b8-84f3-eda11a4d918a)
There needs to be at least one line. If there’s more, all lines need to be approved to approve the whole gate. If a user group is chosen one user of the group needs to approve a line.
For each line it is possible to define the text to be shown depending on the state of the gate line (e.g. “Needs to be approved by”, “Has been approved by”, “Was rejected by””)
In case a gate has been approved several things can happen
![Screenshot 2024-02-04 at 21.41.48.png](../__attachments/3142662120/Screenshot%202024-02-04%20at%2021.41.48.png?inst-v=66fdafcf-f549-49b8-84f3-eda11a4d918a)
When passing a gate or rejecting a gate it is now indicated as tooltip who and when the change was done.
Gates can be required to request a password for the approval and allow only one signature per user (if the same user is mentioned/part of groups in multiple gate lines).
![Screenshot 2024-02-04 at 21.44.45.png](../__attachments/3142662120/Screenshot%202024-02-04%20at%2021.44.45.png?inst-v=66fdafcf-f549-49b8-84f3-eda11a4d918a)
Note: if the gate option "Hide approval details (legacy)" is disabled, you'll see the details directly in the gate as well. If it’s hidden, only the user/group name stays visible per line (no explanation, no text box, no date and time of approval etc)
Gates can be configured to reset if some fields change (fields name or ID can be entered)
![Screenshot 2024-02-04 at 21.46.30.png](../__attachments/3142662120/Screenshot%202024-02-04%20at%2021.46.30.png?inst-v=66fdafcf-f549-49b8-84f3-eda11a4d918a)
Printing:
It is possible to specify the text which is added to documents depending on the status of the gate. If no text is specified, nothing is printed.
![Screenshot 2024-02-04 at 21.46.57.png](../__attachments/3142662120/Screenshot%202024-02-04%20at%2021.46.57.png?inst-v=66fdafcf-f549-49b8-84f3-eda11a4d918a)
Searching:
it is possible to do a full text search to find items e.g.
_pass_tim_ - will find all items where tim approved a gate
_fail_tom_ - will find all items where tom did reject a gate
_todo_demo_ - will find all items where demo needs to review
_passed_ - will find approved gates
_failed_ - will find failed gates
_todo_ - will find all gates which need a review
This can be combined with our Miracle search function, MRQL, to seach in specific fields, e.g. mrql:"Gate 1"~"_failed_"
Other Advanced Settings:
You can add a notifyPassed property to the allPass property to define users who should get notified if a gate has passed.
"allPass": {
"notifyPassed": [ "user1", "user2" ],
You can add a notifyFirstReject property NEXT to the allPass property to define users who should get notified if a gate gets rejected.
"allPass": {....},
"notifyFirstReject":["user1","user2","user3"],
With version 2.4 and newer a notifyEmailTemplate: string has been added to the allPass object. There is no UI for that, you can only set it in the advancedConfig.
It allows you to specify a custom notification email when a gate has passed. It overrides the default canned mail config.
To configure it: Change the allPass setting to add these lines:
"notifyEmailPassed": ["user1","user2"],
"notifyEmailTemplate":"Howdy _to.firstName_,<br/><br/>Guess what, _me.firstName_ passed the gate _body_ for<b>_link_ _title_</b>.<br/><br/>"