3.6.1.2 Groups

This section describes the following items.

Select “Group” under “User Management” in the navigation area to manage groups.
Clicking on a group displayed in the configuration area will take you to the “Group details” window.
The types of operation buttons in the “Group” window are as follows.

(Table) Types of operation buttons in the “Group” window

Item Description
Add Adds a group.
Becomes inactive when the checkbox is checked.
Delete Deletes a group.
Becomes inactive when the checkbox is not checked.

The “global” group is registered by default. This group is a reserved group that is required for the management of Ops I, so please do not edit or delete it. When a new user is newly registered, they are registered as belonging to the “global” group by default.

(1) Adding groups

Click the [Add] button to add a new group. Click the [Add] button to open the add group window. Click the [Save] button after entering the group information to add a group.
For information on the characters allowed for each item, see “Notes on characters that can be entered”.
When a group is added, a group with the same name is automatically created on GitLab. Also, when users are assigned to a group, they will also be automatically registered as members of the group on GitLab. Please note, if you add an group, the group will not appear in the document application container until your next login. However, a group is immediately reflected in GitLab when it is added.

A description of the contents displayed in the add group window is shown below.

(Table) Types of content displayed in the add group window

Item Required Description
Name Yes Group name
E-mail No E-mail
Description No Detailed description

Assignment of users and roles to a group is performed in the related resources area.
Use the tabs to switch between views, and click the edit button to display the corresponding assignment dialog box. For details about the assignment procedure, see “Assigning users and roles”. For details about how to set related groups, see “Setting related groups”.
The tab types are as follows.

(Table) Related resources area tabs when adding a group

Item Description
Users Displays a list of members belonging to the group.
The displayed columns are as follows.
  • User Name: Username
  • Groups: Groups assigned to the user
Related Groups Displays a list of groups related to the group.
The displayed columns are as follows.
  • Name: Related group name
  • Description: Description of the related group
  • E-mail: E-mail address of the related group
  • Relation Type: Management relationship between groups
Assigned Roles Displays a list of roles assigned to the group.
The displayed columns are as follows.
  • Name: Role name
  • Description: Description of the role
  • Type: Type of role


[Assigning users and roles]

You can assign users and roles to a group as follows:

  1. In the related resources area, select the [Users] or [Assigned Roles] tab.
  2. Depending on the selected tab, click the [Edit Users] or [Edit Roles] button to open the assignment dialog box.
  3. From the list, select the checkboxes for the users or roles to be assigned.
    TipsTips
    • You can narrow down the information in the list by specifying conditions using the filterFilter.
    • In "Rows per page", you can change the number of users or roles displayed per page. If the number of users or roles exceeds the display limit, you can navigate between pages by clicking "<" or ">".
  4. Assigned users or roles are displayed as green chips, as shown below.
    Example:

    To remove assigned users or roles, click the "×" on the right side of the chip, or clear the checkbox.
    TipsTips
    If the content displayed spans multiple lines, click the Triangle icon to view all assigned items.
  5. Click the [OK] button to close the dialog box.

[Setting related groups]

You can set management relationships between groups as follows:

  1. In the related resources area, select the [Related Groups] tab.
  2. Click the [Edit Groups] button to open the related group settings dialog box.
  3. For [Relation Type], select either "Manage" or "Managed".
  4. From the list, select the checkboxes for the groups to be set.
    TipsTips
    • You can narrow down the information in the list by specifying conditions using the filterFilter.
    • In "Rows per page", you can change the number of users or roles displayed per page. If the number of users or roles exceeds the display limit, you can navigate between pages by clicking "<" or ">".
  5. Configured groups are displayed as green chips, as shown below.
    Example:

    To remove configured groups, click the "×" on the right of the chip, or clear the checkbox.
    TipsTips
    If the content displayed spans multiple lines, click the Triangle icon to view all configured groups.
  6. If necessary, return to step 1 and select another relation type to configure groups.
  7. Click the [OK] button to close the dialog box.



(2) Viewing group details

The "Group details" window is used to edit detailed information of a group.
Clicking on the name of a group displayed in the list of groups in the "Group" window will take you to the "Group details" window. In the "Group details" window, the group information area and the related resources area are displayed separately, one above the other. Edit buttons are also provided in each area.

The types of operation buttons available in the group information area are as follows.

(Table) Types of operation buttons in the group information area

Item Description
Edit Edits group information.
After modifying the group information, click the [Save] button to apply the changes to the registered group information.
Delete Deletes the group.

The tabs displayed in the related resource area in the group details window are as follows.

(Table) Related resources area tabs in the group details window

Item Description
Users Displays a list of members belonging to the group.
The same information is displayed as in the [Users] tab in the add group window.
Clicking the [Edit Users] button displays the [Assign User] dialog box.
Related Groups Displays a list of groups related to the group.
The same information is displayed as in the [Related Groups] tab in the add group window.
Clicking the [Edit Groups] button displays the [Relate Group] dialog box.
Assigned Roles Displays a list of roles assigned to the group.
The same information is displayed as in the [Assigned Roles] tab in the add group window.
Clicking the [Edit Roles] button displays the [Assign Role] dialog box.
Effective Roles Displays a list of enabled roles set for the group. If a role assigned to a group encompasses more than one role, all roles will be displayed in this tab.
The displayed columns are as follows.
  • Name: Role name
  • Description: Description of the role
  • Type: Type of role
Git Members Displays a list of members registered in the group on GitLab associated with the group.
The displayed columns are as follows.
  • Name: User name
  • Git Role: Displays the role for the group on GitLab (however, if the user has been deleted on GitLab, "No Access" is displayed).
Clicking the [Edit Git Roles] button displays the [Update Git Role] dialog box. Select a Git role from the options below and click the [Save] button. The default value is "Developer".
  • Owner
  • Maintainer
  • Developer
  • Reporter
  • Guest
The user's operation permissions are determined by the Git role. Confirm the following and select the required permissions.
  • Users registering YAML files should have Maintainer or higher permissions.
  • Users registering attachments from the workflow function or uploading files from the "Container" window should have a permission of "Developer" or higher.
  • Users accessing workflows that use attachments or downloading files from the "Container" window should have a permission of "Reporter" or higher.
  • For details of Git roles, see "https://archives.docs.gitlab.com/18.4/user/permissions/".


(3) Deleting groups

Clicking the [Delete] button in the “Group” window while a group is selected, or in the group details window, will display a confirmation dialog box. Click “OK” to delete the group.



(4) Editing groups

In the “Group details” window, the group information area and the related resources area are displayed separately, one above the other. Edit buttons are also provided in each area.

[Editing the group information area]

Clicking the [Edit] button in the “Group details” window allows you to edit the group information area. After making changes, click the [Save] button to apply the changes. For details about the displayed items and the information that can be entered, see “Adding groups”.

[Editing the related resources area]

For details about editing users belonging to a group or a role assigned to a group, see “Editing assigned users and roles”. For details about editing related groups, see “Editing related groups”. For details about editing Git members, see “Git members” in “(Table) Related resources area tabs in the group details window”.

■ Editing assigned users and roles

  1. In the related resources area, select the [Users] or [Assigned Roles] tab.
  2. Depending on the selected tab, click the [Edit Users] or [Edit Roles] button to open the assignment dialog box.
  3. From the list, select the checkboxes for the users or roles to be newly assigned. To remove assigned users or roles, clear the corresponding checkboxes or click the "×" on the right side of the chip.
    TipsTips
    • You can narrow down the information in the list by specifying conditions using the filterFilter.
    • In "Rows per page", you can change the number of users or roles displayed per page. If the number of users or roles exceeds the display limit, you can navigate between pages by clicking "<" or ">".
  4. Check the chips displayed at the top of the dialog box to confirm the assignment results. The meanings of the chip colors are as follows:
    • Green: Newly added assignment
    • Gray: Existing assignment
    • Red: Removed existing assignment (to cancel the removal, click the "+" on the right side.)
    Examples:

    TipsTips
    If the content displayed spans multiple lines, click the Triangle icon to view all assignment results.
  5. Clicking the [Save] button closes the dialog box and saves and applies the changes.

■ Editing related groups

  1. In the related resources area, select the [Related Groups] tab.
  2. Clicking the [Edit Groups] button opens the [Relate Group] dialog box.
  3. Select "Manage" or "Managed" for [Relation Type], and from the list, select the checkboxes for the groups to be newly set. To remove configured groups, clear the corresponding checkboxes or click the "×" on the right side of the chip.
    TipsTips
    • You can narrow down the information in the list by specifying conditions using the filterFilter.
    • In "Rows per page", you can change the number of users or roles displayed per page. If the number of users or roles exceeds the display limit, you can navigate between pages by clicking "<" or ">".
  4. Check the chips displayed at the top of the dialog box to confirm the configuration results. The meanings of the chip colors are as follows:
    • Green: Newly added groups
    • Gray: Existing groups
    • Red: Removed existing groups (to cancel the removal, click the "+" on the right side.)
    Example)

    TipsTips
    If the content displayed spans multiple lines, click the Triangle icon to view all configured groups.
  5. Clicking the [Save] button closes the dialog box and saves and applies the changes.