Skip to content

Group Management Function: Customizing the Management Screen

Overview

You can customize the columns shown on the group management screens (list screen and edit screen) with the Column.json settings file. You can change whether columns are shown, their order and labels, the filter, who can see them, whether they can be updated, and the width and display format of input fields.

For where to create Column.json and its file name, see Extended Column. Specify each column with the key "Groups_", and restart Pleasanter after editing. For the correspondence between screen columns and keys, see "Columns and Their Keys".

Choosing the Columns Shown on the List and Edit Screens

Use GridEnabled for the columns shown on the list screen and EditorEnabled for the columns shown on the edit screen. Each screen is switched separately. Specify "0" to hide a column and "1" to show it. The following example hides "Body" on the list screen.

{
    "Groups_Body": {
        "GridEnabled": "0"
    }
}

List screen with the "Body" column

List screen without the "Body" column

Changing the Column Order

Columns are arranged in ascending order of GridColumn on the list screen and EditorColumn on the edit screen. Changing the number changes the order. The following example moves "Body" to the front on the list screen.

{
    "Groups_Body": {
        "GridColumn": "1"
    }
}

List screen before "Body" is moved

List screen with "Body" moved to the front

Changing a Column Label

Specify the display name in LabelText. Specify the display name for each language with LabelText_en and so on. The English screen shows the value of LabelText_en. The following example changes the English display name "Body" to "Remarks".

{
    "Groups_Body": {
        "LabelText_en": "Remarks"
    }
}

List screen showing "Body"

List screen showing "Remarks"

Choosing the Columns Shown in the List Filter

Use FilterEnabled to switch the columns shown in the filter on the list screen. Specify "0" to hide a column and "1" to show it. The following example hides "Body" from the filter.

{
    "Groups_Body": {
        "FilterEnabled": "0"
    }
}

List screen with the "Body" filter

List screen without the "Body" filter

Restricting Who Can See and Enter a Column

You can restrict, for each column, which users can see it and which users can enter or change it. The following three settings are evaluated separately.

Setting Operation it restricts
ReadAccessControl Showing the column on the list screen and the edit screen
CreateAccessControl Entering a value when creating a new group
UpdateAccessControl Changing an existing group (the condition of ReadAccessControl must also be met)

The values you can specify are as follows.

Value Behavior
ManageTenant Allows tenant managers.
ManageService Allows no one (including tenant managers and privileged users).

Hiding "Body"

Specifying ManageService for ReadAccessControl shows "Body" to no one. To show it again, remove the entry.

{
    "Groups_Body": {
        "ReadAccessControl": "ManageService"
    }
}

Edit screen with "Body"

Edit screen without "Body"

Making "Body" Read-Only

Specifying ManageService for CreateAccessControl and UpdateAccessControl prevents anyone from entering or changing "Body". If you specify only UpdateAccessControl, "Body" of an existing group cannot be changed, but it can be entered when creating a new group.

{
    "Groups_Body": {
        "CreateAccessControl": "ManageService",
        "UpdateAccessControl": "ManageService"
    }
}

Edit screen where "Body" can be entered

Edit screen with "Body" read-only

Changing the Width of an Input Field

Use FieldCss to change the width of an input field. Specify field-normal (normal) or field-wide (wide). This setting is for columns other than the description field ("Body"). If you specify it for the description field, the field changes to a single-line input field. The following example makes the Group name input field normal width.

{
    "Groups_GroupName": {
        "FieldCss": "field-normal"
    }
}

Edit screen with Group name at wide width

Edit screen with Group name at normal width

Changing the Display Format of the Description Field

For the description field ("Body"), you can choose the display format with FieldCss. field-markdown is Markdown, and field-rte is the rich text editor. Markdown and rich text are settings for the description field. Do not specify them for other columns. The following example changes the description field to the rich text editor.

{
    "Groups_Body": {
        "FieldCss": "field-rte"
    }
}

Description field in Markdown

Description field changed to the rich text editor

Columns and Their Keys

The columns shown on the group management screens and the keys to specify in Column.json are as follows, in the order of the edit screen.

Column on the screen Key List screen Edit screen Shown to
Group ID Groups_GroupId Shown Shown (read-only) Not restricted
Group name Groups_GroupName Shown Shown Not restricted
Body Groups_Body Shown Shown Not restricted
Disabled Groups_Disabled Shown Shown Tenant managers
LDAP synchronization Groups_LdapSync Hidden Shown (read-only) Not restricted

LDAP synchronization is shown read-only on the edit screen even in environments that do not use LDAP.