Controlled By Multiple Manage Permission Keys

Introduction

Controlled By Multiple Manage Permission Keys is a Permission Type extension of the standard Controlled By Manage Permission Menu feature in Joget DX9. While the standard option lets a UI category reference a single Permission Key from the Manage Permission Menu, this plugin allows a UI category to be matched against multiple Permission Keys at once, with a configurable Match Mode to control whether any key or all keys must match.

This is useful when a menu category's visibility should depend on a combination of permission groups rather than just one; for example, showing a category to users who belong to either a "Finance" or "HR" permission group, or only to users who belong to both.

Plugin Info

Plugins Available in the Bundle:

1. Controlled By Multiple Manage Permission Keys Plugin

This plugin bundle is compatible with Joget DX 9 and onwards.

Get started

Where to get the Plugin

You can download the Plugin from the Joget Marketplace.

How it Works

This plugin adds a new Permission Type, Controlled By Multiple Manage Permission Keys, to the Permission Setting of any UI category. Once selected, the category's Permission Type panel is displayed as follows: 

Instead of matching against a single Permission Key like the standard Controlled By Manage Permission Menu type, this plugin lets a category be matched against a list of Permission Keys, combined using a Match Mode. At runtime, Joget checks the logged-in user's permission groups against the configured Permission Keys using the selected Match Mode, and shows or hides the category accordingly.

Configure Controlled By Multiple Manage Permission Keys

Fields to Configure:

• Permission Keys: A repeatable grid used to list the Permission Key(s) this category should be matched against. Click Add to add another row, and enter each Permission Key value. Each key must already exist as a Permission Key configured in the Manage Permission Menu element.
• Match Mode: Determines how the listed Permission Keys are evaluated against the logged-in user's permission groups. Supported values include:
  • Any key (OR): The category is shown if the user matches at least one of the listed Permission Keys.
  • All keys (AND): The category is shown only if the user matches every listed Permission Keys.

Expected Outcome

When a UI category's Permission Type is set to Controlled By Multiple Manage Permission Keys, the plugin evaluates the logged-in user's permission groups against the configured Permission Keys using the selected Match Mode.

The category:

• Is shown if the user satisfies the Match Mode condition and matches at least one key (Any key (OR)) or matches all keys (All keys (AND)).
• Is hidden otherwise.
• Continues to rely on Permission Keys and Permission Labels defined in the Manage Permission Menu element. 

Additional Resources

For more details on setting up Permission Keys, Permission Labels, and the Manage Permission Menu element that this plugin relies on, refer to Manage Permission Menu.