Scorm标准学习——ScormRTEAPI与数据模型

Scorm标准学习——ScormRTEAPI与数据模型
目录[-]
Scorm RTE概述
API接口
API函数
错误码
Data Model
数据类型
数据模型元素
笔者在前一篇文章Scorm标准学习——基于Scorm1.2(一)中对LMS及Scorm标准体系结构做了介绍。

这里将对Scorm运行时环境(RTE)进行介绍，主要涉及RTE API和数据模型(Data Model)，仍基于Scorm1.2标准。

更为详细的信息可参考Scorm1.2标准的官方文档中关于RTE的论述。

Scorm RTE概述
Scorm标准的目的之一是使得课件与平台相独立，使得课件的复用和重组成为可能。

CAM定义了Scorm课件的组织结构规范，而RTE 则为课件与平台的交互提供了统一的标准。

Scorm RTE定义了通用的内容对象运行机制，包括Launch、API以及Data Model。

Launch:定义了内容对象的发布，描述了如何启动一个Scorm内容对象(Asset和SCO两种)，并确立了内容对象和LMS之间的通信机制。

API:定义了LMS与内容对象之间的通信API，使得内容对象在需要时通过API与LMS进行交互存取数据。

API会将获得的数据模型实例存储在用户端的内存中(如一个JavaScript对象)，并在需要时将该数据发送至LMS平台。

Data Model:描述了跟踪用户学习通用数据模型，即内容对象在与LMS进行通信时所依赖的数据结构，包括用户的学习时间、完成状
态、成绩等元素。

LMS需要对每个用户的每个内容对象维护一个Data Model数据结构。

API提供了内容对象与LMS通信的接口，而DM则描述了通信所使用的数据模型，API+DM使得内容对象在不同的LMS系统中具有了通用性。

API接口
API由LMS提供实现，向内容对象暴露接口。

内容对象(以SCO 为例)在需要与LMS交互时会主动调用LMS提供的API接口，LMS的API实现一般是以http的方式向LMS Server发出请求，最终由LMS 完成数据的存取。

因API暴露在前端，一般采用JavaScript脚本或Java Applet实现。

API函数
Scorm1.2中API函数可分为三类，如下表：
表1 Scorm API函数分类
如表1所示，Scorm标准中定义了8个API函数(Scorm2004稍有不同)，其具体功能如下：
LMSInitialize:初始化函数，负责在当前学习的内容对象和LMS 之间建立通信连接，并从LMS取得该当前用户关于当前内容对象的学习记录信息，即整个DM数据结构。

内容对象在载入时均会通过该方法获得初始运行时数据。

函数成功执行返回"true”(字符串，非布尔值，下同)，否则返回"false”。

LMSFinish:结束函数，结束一个内容对象与LMS的通信连接。

内容对象在退出前均会调用该方法。

通常实现时，该方法会调用
LMSCommit提交一次最近的数据。

当LMS平台在API实现时，选择HTTP协议进行无状态通信，则该函数本身将不产生数据通信，仅仅是调用LMSCommit提交一次数据。

成功执行返回"true”，否则返回"false”。

LMSSetValue:负责更新一个数据模型的属性值。

该方法原型为LMSSetValue(element, value)，参数element标识要设置的属性，value则是属性的值。

内容对象在需要更改DM的某一属性值时会调用该函数，如当用户完成学习一个内容对象后需将该内容对象的cmi.core.lesson_status更新为completed。

通常该函数只是更新客户端内存中该属性的值，而非直接提交至LMS平台。

函数成功执行返回"true”，否则返回"false”。

LMSGetValue:获取一个数据模型的属性值。

该方法有一个element参数，表示属性名。

通常该方法直接从客户端内存中取出所需的值。

成功执行则返回对应的属性值，否则返回空字符串。

LMSCommit:提交函数，负责将客户端内存中目前的RTE数据提交至LMS平台，由平台完成最后的分析写入工作。

采用JS实现的API可用AJAX进行数据提交。

成功返回"true”，否则返回"false”。

LMSGetLastError:获得错误码，当内容对象调用API时返回"false"或产生其他错误时，可调用该函数获得具体的错误代码，API实现中需要设置相应的错误码。

LMSGetErrorString:获得错误码对应的字符串说明，参数为错误码。

LMSGetDiagnostic:获得针对当前错误的诊断信息，参数为错误码。

错误码
Scorm1.2定义的错误码如表2(Scorm2004错误码定义更为详细)：
表2 Scorm1.2错误码
Data Model
Scorm1.2 RTE数据模型部分定义了跟踪内容对象的数据结构。

LMS平台需要为每个用户的每个内容单元维护一组数据模型实例，该实例数据记录了该用户对应于该内容对象的学习状态(如分数、进度、完成状态等)。

DM中所有的属性均以cmi开头，以”.“分隔。

同时数据模型中定了了三个关键字：version、children、_count，保留的关键字受LMS管理，且均为只读(如使用LMSSetValue设置_version属性，则会返回false，且API应在实现时将错误码置为402)。

version: 标识了LMS平台支持的数据模型版本，该属性不可用于数据模型元素上(即只能以cmi._version方式获取)
children:返回某一数据模型元素的所有子属性(元素)，以字符串形式返回，并以执行的分隔符分隔
_count:返回一个数据模型元素集合中包含的元素总数，仅用于集合类型的数据模型
数据类型
Scorm1.2为各种数据模型元素定义了如下类型：
表3 Scorm1.2数据类型
数据模型元素
数据模型元素可以分为9类，参见表4-表12。

cmi.core:核心数据，该组中元素属性LMS必须支持
cmi.suspend_data:暂存数据，存储内容对象在恢复时所需的特定数据
unch_data:内容对象运行时所需的数据
ments:关于内容对象的评论数据，一般来自用户评论ments_from_lms: LMS平台对内容对象的评论信息
cmi.objectives:针对内容对象的个人目标集合
cmi.student_data:基于用户偏好的内容对象自定义信息，如运行时间限制
cmi.student_preference:针对内容对象的用户偏好设置
cmi.interactions:用户交互信息
表4 cmi.core元素属性
表5 cmi.suspend_data元素属性
表6 unch_data元素属性
表7 ments元素属性
表8 ments_from_lms元素属性
表9 cmi.objectives元素属性
表10 cmi.student_data元素属性
表11 cmi.student_preference元素属性
表12 cmi.interactions元素属性。