如何使用Valence API创建学期或部门？

Question

我想创建一个SIS系统和D2L之间的集成使用Valence API。当在SIS中创建新学期或部门时，我希望在D2L中自动创建它们，以便在SIS中创建课程模板和课程时可以实时创建它们。

我在API参考文档中找不到用于创建组织单位的路由。看起来我所能做的就是重新排列组织单元结构或创建新的组织单元类型；然而，这并不是我想要完成的。是否可以使用Valence API创建组织单位？如果是，我应该使用什么路由？

另外，如果不能使用Valence API创建组织单位，那么通过API创建组织单位类型的使用场景是什么？对我来说，组织单元类型似乎是一次性设置，而不是以任何方式通常自动化的东西。

Answer 1

虽然在提出这个问题时，Valence Learning Framework API没有提供API调用来更改“高于”课程提供级别的组织结构(即:确实存在用于添加/删除/修改课程、部门和组的调用，但不存在用于添加/删除/修改部门、学期或自定义组织单元的调用)，此时(从D2L的Learning Suite v10.2.0开始)确实存在通过API操作组织结构的路由。

API现在提供了创建自定义组织单元以及修改为组织单元分配的父代和子代的路径，因此您现在可以有效地将新的组织单元插入到现有的组织结构中。这些路由是在LP产品组件的1.3版API (在Learning Suite 10.2.0中提供)中添加的。

此外，在LP v1.4API(在Learning Suite 10.3.0中提供)中，添加了API路由，以直接修改现有单个组织单元的一些属性，检索列表组织单元属性(并对列表进行过滤)，以及查找叶节点和分离的组织单元(无子节点和无父节点的组织单元)。

添加所有这些路由是为了使客户端管理团队更容易编写旨在帮助管理组织结构的场外脚本和服务，就像您在此处描述的用例一样。