Department Management Function: Customizing the Management Screen
Overview¶
You can customize the columns shown on the department 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 "Depts_
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 "Description" on the list screen.
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 "Description" to the front on the list screen.
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 "Description" to "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 "Description" from the 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 department |
UpdateAccessControl | Changing an existing department (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 "Description"¶
Specifying ManageService for ReadAccessControl shows "Description" to no one. To show it again, remove the entry.
Making "Description" Read-Only¶
Specifying ManageService for CreateAccessControl and UpdateAccessControl prevents anyone from entering or changing "Description". If you specify only UpdateAccessControl, "Description" of an existing department cannot be changed, but it can be entered when creating a new department.
{
"Depts_Body": {
"CreateAccessControl": "ManageService",
"UpdateAccessControl": "ManageService"
}
}
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 ("Description"). If you specify it for the description field, the field changes to a single-line input field. The following example makes the Department code input field wide.
Changing the Display Format of the Description Field¶
For the description field ("Description"), 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.
Columns and Their Keys¶
The columns shown on the department 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 |
|---|---|---|---|---|
| Department ID | Depts_DeptId | Shown | Shown (read-only) | Not restricted |
| Department code | Depts_DeptCode | Shown | Shown | Not restricted |
| Department name | Depts_DeptName | Shown | Shown | Not restricted |
| Description | Depts_Body | Shown | Shown | Not restricted |
| Disabled | Depts_Disabled | Shown | Shown | Tenant managers |















