使用Valance REST API修改Desire2Learn组

Question

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

根据文档， “名称，代码和描述” 更新需要，但获取组块仅返回 “群体，名称，描述和注册”. 。如果在获取中未返回组代码，则如果我们只想更新名称，我们应该在更新块中使用什么值？由于提供了描述，所以我可以将其反馈，但是我应该如何处理代码...丢失该数据？

也许有一种方法发送更新，该更新将仅更新更新块中的特定字段？当我从更新块中省略字段时，我当前会收到一个错误（即，在我只想更新名称的情况下）。

Answer 1

这 Code 例如，组的属性是该组的“ ORG定义的代码”（对于课程提供，通常称为“课程代码”），例如，该组织可能出现在组织的SIS系统中。

因为Desire2Learn的学习套件中的组被视为“组织单位”，所以当您创建一个单位时，您需要为其提供适当的org定义代码（Code） - 如果您的组织不使用ORG定义的组代码，那么您可以决定系统地使用惯例（姓名，描述性字符串等）的其他类型的数据。您是正确的，这对 拿来 GroupData结构的形式不为您提供此值，但是通过组织结构路由来呼叫者可以访问该值（因为新创建的组只是一种特殊的组织单位）。

在Learning Suite v10.2（LP API v1.3+）中，您可以使用 单个获取呼叫以获取组织单位的属性. 。在v10.2之前的版本中，您需要获取该小组的父母列表以获取父级单位ID，或者如果您已经知道拥有该组的课程的ORG单位ID，则可以使用该组； 然后 您使用该组织单位ID获取其儿童列表：您的小组将在该列表中。这 OrgUnit 和 OrgUnitProperties 结构都包含 Code 您需要的属性。