角色管理

角色是一组特定权限的集合。因此，通过给成员分配角色来赋予成员权限。角色只有属于一个层级，给角色分配权限时只能分配相同层级的权限。在一个层级中给成员分配角色时，只能分配相同层级的角色。

角色列表

列表字段：

角色名称：角色名称是根据角色权限的集合定义的。在角色分配中的角色列表里面显示的为角色名称。
角色编码：角色编码具有唯一性，是角色的标识。
角色层级:一个角色只能选择一个层级。一共有全局层、组织层、项目层三种层级可供选择。
角色来源：角色分为用户自定义角色和预置角色，所以角色来源有自定义和预定义两种。用户自定义角色是用户在角色管理界面所创建的角色。预置角色是系统内置的角色，只能查看预置角色，基于预置角色创建新的角色，不能编辑和停用预置角色。
启用状态：是否启用字段有’启用’和’停用’两种值。角色的是否启用字段的值为’启用’时，在角色分配中可以看到该角色，因而可以选择该角色；否则，为’停用’时，在角色分配中不可看到该角色，因而无法选择该角色。

可查询字段：

1.点击创建角色→创建一个角色；

2.输入角色名称、角色层级、角色编码、角色标签以及角色权限；

必填字段：

角色名称：角色的名称应该根据角色权限集合特征定义。
角色层级：角色层级分为全局层、组织层、项目层三种。一个角色只能属于一个层级。
角色编码：角色编码具有唯一性，是角色的标识。用户可自定义。角色创建成功后生成的角色编码为role/层级/custom/用户自定义角色编码，其中role和custom为常量，role表示角色这个大类，custom表示角色来源为用户自定义，即用户在界面创建的角色；层级和用户自定义编码为变量，层级为用户所选的角色层级，用户自定义角色编码为用户在角色编码输入框中所填写的值。
角色权限：权限层级与角色层级相同。创建角色时，至少要选择一个角色权限。
选填字段：
角色标签：用于定义角色的特定逻辑的功能，需与代码开发结合。
- project.owner：当用户创建项目时会自动为其分配拥有该角色标签的角色。如项目所有者。
- gitlab.owner：当给某用户在某项目下分配拥有该标签的角色后，平台会为该用户在gitlab对应的group下分配owner角色。
- gitlab.developer：当给某用户在某项目下分配拥有该标签的角色后，平台会为该用户在gitlab对应的group下分配developer的角色。
  3.点击创建完成角色的创建。

1.点击列表中的图标→ ，选中基于该角色创建；

2.输入角色名称、角色层级、角色编码、角色标签以及角色权限；

可以选择多个角色，基于这些选择的角色创建一个新的角色。但是多选时，选择的角色只能为同一层级，不能为不同的层级。

不可填字段：

角色层级：新角色的层级与所选角色的层级相同，不可更改。
必填字段：
角色名称：角色的名称应该根据角色权限集合特征定义。
角色编码：角色编码具有唯一性，是角色的标识。用户可自定义。角色创建成功后生成的角色编码为role/层级/custom/用户自定义角色编码，其中role和custom为常量，role表示角色这个大类，custom表示角色来源为用户自定义，即用户在界面创建的角色；层级和用户自定义编码为变量，层级为用户所选的角色层级，用户自定义角色编码为用户在角色编码输入框中所填写的值。
角色权限：新角色的角色权限为所选角色权限的并集。可以后继删除或添加权限，至少要有一个角色权限。
选填字段：
角色标签：用于定义角色的特定逻辑的功能，需与代码开发结合。
3.点击创建完成角色的创建。

1.点击列表中的图标→ ，选中修改；

2.输入角色名称、角色层级、角色编码、角色标签以及角色权限；

预定义角色不可编辑，只能编辑用户自定义的角色。

不可编辑字段：

角色层级：因为权限的层级是根据角色层级而定的，如果角色层级更改，则与之前已选权限的角色层级不同，这与系统的角色-权限关联规则矛盾，所以角色一旦创建成功，角色层级不可更改。
角色编码：因为角色编码具有唯一性，是角色的标识，所以角色一旦创建成功，角色编码不可更改。
可编辑字段：
角色名称：应该根据角色的权限特性进行命名，这样分配角色的时候可以直观的选择角色。
角色标签：用于定义角色的特定逻辑的功能，需与代码开发结合。
角色权限：可以增加或删除角色的权限。
3.点击保存完成角色的创建。

点击列表中的图标→ ，选中停用；

预定义角色不可停用，只能启用/停用用户自定义角色。

停用角色：只能停用用户自定义角色。停用角色后，角色状态变为’未启用’。赋予给该角色的权限将失效，即使这个角色已经被分配给了用户。并在角色分配中，不再显示该角色。
启用角色：用户自定义角色被停用后，可以再次启用。启用角色后，角色状态变为’启用’。赋予该角色的权限生效。并在角色分配中，显示该角色。

角色	角色编码	模块	权限
平台管理员	role/site/default/administrator	平台层所有模块	全部操作权限
平台开发者	role/site/default/developer	任务调度	全部操作权限
		全局事务	全部操作权限
		API管理	全部操作权限
		微服务管理	全部操作权限
组织管理员	role/organization/default/administrator	组织层所有模块	全部操作权限
组织成员	role/organization/default/organization-member	wiki管理	空间和页面的创建、编辑、删除、修改、查看、管理和权限分配，评论等。详情见知识管理
项目所有者	role/project/default/project-owner	项目层的所有模块	全部操作权限
项目成员	role/project/default/project-member	敏捷管理	不能进行版本管理、不能配置状态、不能管理模块、不能进行项目设置、不能删除看板和issue。除此之外其他权限都可以。详情见敏捷管理
		应用管理	仅能查看列表和阶段详情。详情见应用管理
		开发流水线	不能删除标记，其他均有权限。详情见开发流水线
		部署流水线	未分配此权限。详情见部署流水线
		测试管理	全部操作权限
		wiki管理	空间和页面的创建、编辑、删除、修改、查看、管理和权限分配，评论等。详情见知识管理
		报表	全部操作权限