快照 XML
配置用于课程创建的 SIS 集成 XML 语法
Blackboard 格式是 IMS 标准的一种风格,明确满足特定于 Blackboard 的对象的需求。本主题关注的是该格式中与使用 <group> 元素创建课程并将其与机构层次结构中的节点关联起来的方面。
在 Blackboard 格式中,
组元素用于表示两种对象:课程和节点。
关系元素是 Blackboard 方案的结缔组织:它们将节点链接到节点以形成机构层次结构,将课程链接到节点以创建课程关联。
创建课程组元素
以下是描述课程的 <group> 元素的 XML 片段。
<!-- create a course -->
<group recstatus="1">
<sourcedid>
<source>My Institution SIS</source>
<id>0390COMPSCI697CSec1-1164</id>
</sourcedid>
<grouptype>
<scheme>Blackboard</scheme>
<typevalue level = "20"/>
</grouptype>
<datasource>My Institution SIS</datasource>
<description>
<short>Comp697</short>
<long>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
</group>使用课程的详细信息编辑上述代码中的相关属性和值。
注意
您也可以使用此代码创建节点。
元素/属性 | 必需 | 描述 |
|---|---|---|
recstatus | 否 | 要对对象执行的操作的类型。数字用于语言独立性:1 = 添加,2 = 更新,3 = 删除。 如果没有提供 recstatus 属性,则在记录不存在时 API 将默认为 1(添加),在记录存在时默认为 2(更新)。 |
sourcedid | 是 | 由源元素和 id 元素组成的组对象的唯一标识符。 |
源 | 是 | 首先创建组对象的系统的唯一标识符。 |
id | 是 | 组对象的较低级别唯一标识符。 对于一门课程而言,它可以在原机构或系统中唯一标识具体的课程、学期等。对于节点,它唯一标识组织或系统中的部门、学校等。 |
grouptype | 是 | 组的类型。 |
方案 | 是 | 正在使用的组分类方案。
|
typevalue | 是 | 指定要添加的内容。此组表示的对象。Blackboard Enterprise 的 typevalue 应为以下值之一:
Vista Enterprise 的 typevalue 应为以下值之一:
|
描述 | 是 | 描述课程或节点。 |
short | 是 | 对于课程,标识课程标题的缩写版本。对于节点,标识节点名称。例如,Engineering。 |
long | 否 | 标识课程标题。 如果没有指定 <long> 值,则 <short> 值将变为课程标题。` |
full | 否 | 标识完整的课程或节点描述。 |
使用关系元素将课程关联到节点
<relationship>元素始终位于<group>元素中,并描述该元素与其他组的关系。下面是描述与节点的课程关联的<relationship>元素的 XML 片段。
<group recstatus="1">
<sourcedid>
<source>My Institution SIS</source>
<id>0390COMPSCI697CSec1-1164</id>
</sourcedid>
<grouptype>
<scheme>Blackboard</scheme>
<typevalue level = "20"/>
</grouptype>
<datasource>My Institution SIS</datasource>
<description>
<short>Comp697</short>
<long>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
<!-- primary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>CompSciDept</id>
</sourcedid>
<label/>
</relationship>
<!-- secondary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>EEDept</id>
</sourcedid>
<label/>
</relationship>
</group>当课程有多个关联时,指定这些关联的顺序至关重要。第一个被认为是主要关联;所有其他都是次要关联。课程必须确定要遵守哪个节点的工具设置时,将参照其主要关联。
注意
如果课程已存在(例如,这是对现有课程的更新),则上述指令会在创建新的节点关联之前清除课程当前的任何节点关联。
使用关联的详细信息编辑上述代码中的相关属性和值。
元素/属性 | 必需 | 描述 |
|---|---|---|
关系 | 否 | 指示要添加的课程或节点的父节点(学习上下文)。 注意:这将覆盖在管理设置界面中输入的命令行和默认设置。 |
关系 | 否 | 限定关系类型。该值应始终为 1。 |
relationship.sourcedid | 是 | 课程或节点应关联的父节点的 sourcedid。 |
label | 是 | 描述关系。 注意:虽然这是一个必填字段,但如果示例中没有 label 值,则可以使用空元素引用。 |