desire2learn - D2L 程序化用户组维护

Question

我们决定让一些用户组完全处于程序控制之下。创建组类别时使用哪些参数，以便：

• 事先不知道小组的数量和学生的数量
• 没有自动组创建
• 不允许自动注册
• 不允许自行报名

?

Answer 1

您应该能够通过以下步骤完成此操作（我假设您的后端服务支持至少 1.3 版及更高版本的 LP API 合同）：

1. 像这样为将来要建立的组创建一个组类别。在您提供给此调用的GroupCategoryData结构中，您可以使用以下属性设置：

   • 设置EnrollmentStyle为0或NumerOfGroupsNoEnrollment（原文如此：注意拼写错误）。

   • 设置EnrollmentQuantity为null

   • 设置AutoEnroll和RandomizeEnrollments_false

   • 设置MaxUsersPerGroup为null

   • 设置NumberOfGroups为要在此组类别中开始创建的组数：您可以1在组类别创建后创建然后删除它。

   您应该返回一个 GroupCategoryData fetch-form 结构，该结构包含在此组类别中创建的任何初始 Group 组织单位 ID 的数组，并包含GroupCategoryId此新类别的 。

2. 如果要为 category 创建组，请在 POST 路由中提供上一步中的组类别 ID 以创建组。

3. 要将用户注册到这些组中，您可以使用标准的 create-enrollment 调用并提供标准的EnrollmentData结构。您需要提供组的组织单位 ID、用户注册的用户 ID 以及您希望用户在组中拥有的角色的角色 ID。您还应该IsCascading在此处设置为 false。

请注意，如果您的后端服务只有 LP API 的 v1.2 或更早版本，那么这些说明会略有不同（请仔细阅读API 参考中的注册主题）。