Skip to main content

Enterprise 1.1

在本部分中，详细了解如何使用 Enterprise 1.1 集成学生信息系统。

配置 Vista 学生信息系统 集成 XML 语法以创建课程

Vista 层次结构与 Blackboard 中的层次结构非常不同。Vista 层次结构的前四个级别（机构、部门、组和课程）将转换为 Blackboard 层次结构节点，并适当地相互链接。Vista层次结构的第五级（课程部分）将转换为黑板课程，并与其父节点相关联。

注意

Blackboard 不会为 Vista 层次结构的课程层生成节点，因此，从课程部分 Vista 元素创建的课程将与其父组相关联。

可以在集成设置中更改此行为。

下面是描述部门、组和课程及其关联的<group>和<relationship>元素的 XML 片段。

<enterprise xmlns:webct="http://www.webct.com/IMS">
<!-- division item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>DIVISION1</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="25"/>
  </grouptype>
  <description>
    <short>AAA Division IMS</short>
    <long>Test Division IMS</long>
    <full>This Division is for testing IMS imports by WebCT Support staff</full>
  </description>
  <datasource>TestDS</datasource>
  </group>
<!-- Group Item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>GROUPBABBLE_IMS4</id>
  </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="30"/>
  </grouptype>
  <description>
    <short>AAA Group IMS</short>
    <long>Test Group IMS</long>
    <full>This Group is for testing IMS imports by WebCT Support staff</full>
  </description>
  <relationship relation = "1">
    <sourcedid>
    <source>TestDS</source> <!-- *** DIVISION ID HERE *** -->
    <id>DIVISION1</id> <!-- *** DIVISION ID HERE *** -->
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
<!-- course item 1 -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>COURSEBABBLEONE_IMS4</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="80"/>
  </grouptype>
  <description>
    <short>AAA-101</short>
    <long>Introduction to Triple A</long>
    <full>This course introduces basic concepts of AAA, an important part of your life</full>
  </description>
  <relationship relation = "1">
    <sourcedid>
    <source>TestDS</source>
    <id>GROUPBABBLE_IMS4</id>
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
<!-- Section Item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>SECTIONBABBLEONE_IMS4</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="90"/>
  </grouptype>
  <description>
    <short>AAA-101-001</short>
    <long>Introduction to Triple A - Section 001</long>
    <full>This course introduces basic concepts of AAA, an important part of your life</full>
  </description>
  <relationship relation = "1"><!-- Parent Course -->
    <sourcedid>
    <source>TestDS</source>
    <id>COURSEBABBLEONE_IMS4</id>
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
</enterprise>

使用每个级别的详细信息编辑上述代码中的相关属性和值。

表 56. 关卡详情

元素/属性

必需

描述

recstatus

否

要对对象执行的操作的类型。数字用于语言独立性：1 = 添加，2 = 更新，3 = 删除。如果未提供 recstatus 属性，则如果记录尚不存在，则 API 将默认为 1（添加），如果记录存在，则 API 将默认为 2（更新）。

sourcedid

是

包含由源元素和 id 元素组成的组对象的唯一标识符。

源

是

首先创建组对象的系统的唯一标识符。

id

是

组对象的较低级别唯一标识符。对于课程，它唯一标识原始组织或系统中的特定课程、学期等。对于节点，它唯一标识组织或系统中的部门、学校等。

grouptype

是

组的类型。

方案

是

标识正在使用的组分类方案。Blackboard Enterprise 使用 <scheme>Blackboard</scheme><.span>。Vista Enterprise 使用<scheme>LEARNING_CONTEXT_V1</scheme>。

typevalue

是

指定要添加的内容。此组表示的对象。Blackboard Enterprise 的 type值应为以下值之一：

  • 10 - 表示机构层次结构中的一个节点。

  • 20 - 这代表一个 Blackboard 课程。

Vista Enterprise 的 typevalue 应为以下值之一：

  • 25 - 表示部门

  • 30 - 表示组

  • 60 - 表示学期

  • 80 - 表示课程

  • 90 - 表示区域

描述

是

描述课程或节点。

short

是

对于课程，标识课程标题的缩写版本。对于节点，标识节点名称。例如，Engineering。

long

否

课程名称。如果未指定 <long> 值，则

full

否

完整的课程或节点描述。

关系

否

要添加的课程或节点的父节点（学习上下文）。这将覆盖在管理设置界面中输入的命令行和默认设置。

关系

否

限定关系类型。该值应始终为 1。

关系。

sourcedid

是

课程或节点应关联的父节点的 sourcedid。

label

是

描述关系。尽管这是一个必填字段，但如果 label 没有值，则可以使用空元素引用，如示例所示。



IMS Enterprise 1.1 的 Blackboard 扩展

代码片段：

<extension>
     <inst_email>hl@duelm.com</inst_emal>
</extension>

元素/属性

必需

描述

自定义 JavaScript 字段映射

inst_email

否

用户的机构电子邮件地址。

inst_email可以设置为 NULL。

不会向inst_email发送电子邮件通信。

以下示例自定义脚本可用于使用 字段映射 在 IMS Enterprise 1.1 规范中填充机构电子邮件字段。

(function(){
     if(data.extension != null){
          return helper.getXPathString (data.extension, '/extension/inst_email');
     }
     return null;
}());

代词

否

用户的代词。

代词可以设置为 NULL。

发音

是

用户名的拼音或发音指南。