D2L程序化用户组维护

Question

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

• 事先不知道团体人数或学生人数
• 没有自动创建组
• 不允许自动注册
• 不允许自我注册

Answer 1

您应该能够通过这些步骤完成此任务（我假设您的后端服务支持至少版本1.3和转发的LP API合同）：

1. Create a group category对于您希望将来构建的群组，就像这样。在您为此次调用提供的GroupCategoryData结构中，您可以使用以下属性设置：

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

   • 将EnrollmentQuantity设为null

   • 将AutoEnroll和RandomizeEnrollments设为false

   • 将MaxUsersPerGroup设为null

   • 将NumberOfGroups设置为您要在此群组类别中创建的群组数量：您可以创建1，然后在创建群组类别后将其删除。

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

2. 如果您想要create a group for the category，请提供POST路线上一步中的组类别ID以创建该组。

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

请注意，如果您的后端服务仅包含LP API的v1.2或更早版本，则这些说明会略有不同（请仔细阅读enrollment topic in the API reference）。