1

我对我们应该如何使用 Valence API 更新组有点困惑。

根据文档,更新需要"Name,Code & Description",但 FETCH 组块仅返回"GroupID,Name, Description and Enrollments"。如果在 fetch 中没有返回 Group Code,如果我们只想更新名称,我们应该在更新块中使用什么值?由于提供了描述,我可以将其反馈回来,但是我应该如何处理代码......只是丢失了这些数据?

也许有一种方法可以发送只更新更新块中的特定字段的更新?当我从更新块中省略字段时,我当前收到一个错误(即在我只想更新名称的情况下)。

4

1 回答 1

1

Groups的Code属性旨在成为组的“组织定义的代码”(对于课程设置,这通常称为“课程代码”),例如可能出现在组织的 SIS 系统中的代码。

因为 Desire2Learn 学习套件中的组被视为“组织单位”,所以当您创建一个组时,您需要为其提供适当的组织定义代码 ( Code) - 如果您的组织不使用组织定义的组代码,那么您可以决定按照惯例系统地使用一些其他类型的数据(名称、描述性字符串等)。您是正确的,GroupData 结构的Fetch形式不为您提供此值是不方便的,但是调用者可以通过组织结构路由访问该值(因为新创建的组只是一种特殊的组织单位)。

在 Learning Suite v10.2 (LP API v1.3+) 及更高版本中,您可以使用单个 GET 调用来取回组织单位的属性。在 v10.2 之前的版本中,您需要获取组的父级列表以获取父级组织单位 ID,或者如果您已经知道拥有该组的课程的组织单位 ID,则可以使用它;然后您使用该组织单位 ID 来获取其子级列表:您的组将在该列表中。OrgUnitOrgUnitProperties结构都包含Code您在此处需要的属性。

于 2013-11-11T14:09:39.230 回答