管理 CSV 文件中的自定义角色

上次更新日期： 2022年8月3日

集成管理员可以通过 CSV 在其账户中批量添加多个自定义角色，并可将相应的角色分配给不同的用户。此方法可以自动创建相关自定义角色。

您可以通过 Adobe Learning Manager FTP 和 Box 连接器来配置角色。

在登录 Box 或 ExaVault 存储账户后，集成管理员可以在账户中添加以下 csv：

要开始使用，请下载 csv 并根据您的要求更改相应的值。

role.csv

下载

获取文件

示例文件 - role.csv

获取文件

示例文件 - user_role.csv

列名称	描述	示例值
名称	确定在 CSV 中将要分配给用户的角色。	销售作者
<Entity>	确定每个实体类型（如课程、目录等）的访问类型（“完全”、“写入”、“注册”、“报告”、“无”等）。	完全无写入 \| 报告列名称将与实体类型名称对应，例如目录、课程、学习计划等。在 CSV 中，每种实体类型均对应一列。未授予许可的实体应包含在内，其值为“无”(NONE)
目录范围说明符	单个目录名称或者采用竖线 (\|) 分隔的“目录名称”列表，用于确定角色的范围。	销售目录 \| 总目录
用户组范围说明符	“用户组属性”名称和值用于确定此角色用户的范围。请参阅下面的部分了解范围。	位置=伦敦
描述	（可选）用户友好型描述有助于了解角色的用途，方便日后参考。	对销售目录中的学习对象拥有完全作者访问权限

注意:

除“描述”之外的所有列都必填。

定义用户组的范围

您可以通过以下方式为各类用户组指定相应的范围：

user_role.csv

列名称	描述	评论
ID	将对其分配可配置角色的用户的电子邮件 ID。	如果该用户已分配了可配置角色，则该角色将被替换为 CSV 中指定的新角色。没有报告错误。
CustomRole	将要分配给用户的可配置角色的名称	该角色名称必须是 CSV 中指定的现有角色。由管理员通过用户界面创建的角色也可在此处使用。

注意:

完全范围功能

为以下任何功能（帐户级功能）分配完全权限时，“用户组范围”和“目录范围”将自动设为“完全”，因为用户对这些功能的访问权限不能受限。

如果 CSV 中提供了任何“目录”名称或“用户组”名称，这些名称会被“完全”权限替代。

在 Box 帐户中，选择“导入 > 用户 > 内部”，然后上传文件 role.csv 和 user_role.csv。

两个 CSV 文件均必须通过 Box 或 FTP 上传，不得通过用户界面上传。

注意：用户 CSV 文件是必需的，但自定义角色 CSV 是可选的。所有存在的文件均会处理，其他文件则予以跳过。

通过 csv 文件创建的自定义角色对用户界面中的管理员不可见。这些角色与通过用户界面创建的（或稍后创建的）角色没有关系，也不受其影响。

通过 csv 创建的自定义角色完全可通过该 csv 进行管理。这包括添加、修改和删除角色。

从 user_role csv 删除分配条目即可撤销已分配的角色。但通过管理员用户界面完成的分配不受此影响。

要分配和撤销某个自定义角色，请更新 csv 文件。

在集成管理员将基于角色的 CSV 上传到连接器的存储空间后，管理员可以启用与 CSV 同步。每次在 CSV 中更新、添加或删除任何自定义角色时，管理员都可以同步文件中的信息并使角色列表保持为最新版本。

在管理员面板上的“开始使用”页面，单击“设置 > 数据源”。

在“同步设置”部分中，启用选项“启用自动同步“ 。

选中此项后，您即可在“同步时间”字段中指定确切时间，安排同步时间。如果指定的同步时间为上午 12:00，自定义角色即会在每天指定的时间准时进行更新。

如果要按需同步数据，单击“立即同步”。

在任何帐户中，角色名称必须唯一。因此，通过用户界面或 CSV 创建的角色名称不得与由用户界面或 CSV 创建的其他角色同名。

同样，在管理员用户界面上，无法为用户分配由 CSV 创建的可配置角色，因为这些角色不可用。

然而，用户分配 CSV 可以分配由用户界面创建的角色。

新用户？