Skip to main content
Skip table of contents

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

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

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

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

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

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.

CODE
"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.

CODE
"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:

CODE
"notifyEmailPassed": ["user1","user2"],
"notifyEmailTemplate":"Howdy _to.firstName_,<br/><br/>Guess what, _me.firstName_ passed the gate _body_ for<b>_link_ _title_</b>.<br/><br/>"

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.