Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

English

The userview Permission Menu allows you to configure category permissions for user-defined groups at run-time.

...

This feature eliminates the need for app designers to go into the userview builder to manually set the permission for every menu category.

Get Started

The easiest way to see how the Manage Permission menu works is to download the attached demo app, import, publish and run the app in your Joget platform:

Steps

...

Screens (Click to view)

...

Image Removed

Figure 1

Image Removed

Figure 2

Image Removed

Figure 3

Image Removed

Figure 4

Image Removed

Figure 1: Permission Menu in Userview

Image Removed

:


  1. Manage permission menu basically allows you to configure the userview menu category permissions from the run time screens. In this example (Figure 1), there are four menu categories you can assign the view permission.

Image Added

Figure 1

2. The Configure button (Figure 2) will present you with the following permission options:

  • Is Admin
  • Is Anonymous
  • Bean Shell Script
  • Department
  • Group
  • Logged In User
  • Organization
  • Is Sub Level Userview
  • User

Image Added

Figure 2

3. In Userview Builder, the Manage Permission menu property is shown in Figure 3 (More details are provided below). 

Image Added

Figure 3

4. Each menu category permission property (Figure 4) is tagged as "Permission Type = Controlled By Manage Permission Menu" and given a "Permission Key" name. You then map the respective "Permission Key" names into the "Manage Permission > Permissions" grid (Figure 3).

Image Added

Figure 4Figure 2: Configuring permission - Add User - Permission Menu in Userview

Manage Permission Properties

Configure Manage Permission Menu

...

Image Added

...

Figure 5

Custom ID

Item link slug. Optional field

.

(Figure 5)

Info
titleUnique field

Value defined here must be unique to the rest of the Userview Menus as the first matching name will be called upon.

Image Removed

Figure 1

LabelMenu label. Mandatory field.
Page TitlePage title on Permission Menu page. You can use HTML tags, for example <b></b> to bold the title.
Permissions
Permission Key

Id to match against userview categories

.See Figure 3 & 7 for reference

(Figure 4).

Permission LabelPermission list name
. See
(Figure
1 &
3
for reference
).
Category

Optional Group label. Category to group similar permission labels under.

See Figure 1 & 3 for reference.

Optional Field.

Enable Refined Controls (Requires Admin User Role)?

Allows administrators to implement intricate user permission configurations per group.

Info
titleUsing LDAP / External Directory Manager?

If you are using external directory manager such as the LDAP Directory Manager, you must enable this option to use this Manage Permission menu.

Warning
titleImportant Note

Once this feature is enabled, only users with administrative access can manage the permission.

As opposed to Figure 2, when configuring permission, you will be brought to the following screen for finer permission control.

Image Added

Advanced

Image Added

Figure 6 

Name

Description

Custom HeaderCustom Header in HTML to show (Figure 6). 
Custom FooterCustom Footer in HTML to show.

Image Removed

Figure 4: Enabled Refined Controls

Performance & Offline

Cache Settings

Image Added

Figure 7

Name

Description

Scope

Caching options are (Figure 7):

  • None: No caching.
  • Application: Cache content by application where all users will see the same content.
  • User: Cache by username.
Duration (s)Duration in seconds to cache content, defaults to 20 seconds if applicable.
Panel
borderColorpurple
bgColor#fefaff
borderWidth1
titleBGColor#ddccff
borderStylesolid

Read more at Performance Improvement with Userview Caching.

PWA Offline Settings

Note: PWA Offline support is dependent on the theme used.

Name

Description

Enable cache for offline supportCheck this to enable caching for offline support, usually set for use on mobile browsers.

Read Progressive Web Application (PWA) for more information.


4. After setting up the Permission Menu, remember to configure all the respective userview categories.

Note

 Note that, multiple categories can use the same permission key. Setting up as such will grant multiple categories to a permission group.

Info
titleHow to use this permission plugin in a userview category

In the userview category that you wish to manage its permission via this plugin, edit the category's permission as shown in figure 5.

Image Removed

Figure 5: Adding permission to an userview category

Image Removed

Figure 6: Change "Permission Type" to grant permission to Permission Menu

Image Removed

Figure 7: Assigning "Permission Key" to Category to match against in Permission Menu

Info


Download Demo App

...

...