Authorware类和函数:authorware7.0函数教学文章连载--CMI类(2)

cmiiscompleted

语法：completed:= cmiiscompleted（）

说明：如果cmi系统指出当前任务已经完成，则函数返回true，否则返回false。

cmiisfailed

语法：bool:=cmiisfailed（）

说明：如果cmi系统指出学生在当前任务中已经失败，则函数返回true，否则返回

false。

cmiisobjcompleted

语法：bool:=cmiisobjcompleted（index）

说明：判断由目标索引指定的目标是否已经完成，参数index的取值范围为1~cmiobjcount。如果指定目标已经完成，则该函数返回true，否则返回false。

cmiisobjfailed

语法：bool:=cmiisobjfailed（index）

说明：判断由目标索引指定的目标是否已经失败，参数index的取值范围为1~cmiobjcount。如果指定目标已经失败，则该函数返回true，否则返回false。

cmiisobjpassed

语法：bool:=cmiisobjpassed（index）

说明：判断由目标索引指定的目标是否已经通过，参数index的取值范围为1~cmiobjcount。如果指定目标已经通过，则该函数返回true，否则返回false。

cmiisobjstarted

语法：bool:=cmiisobjstarted（index）

说明：判断由目标索引指定的目标是否已经开始，参数index的取值范围为1~cmiobjcount。如果指定目标已经开始，则该函数返回true，否则返回false。

cmiispassed

语法：bool:=cmiispassed（）

说明：判断学生是否通过当前任务。如果cmi系统指出学生通过了当前任务，则该函数返回true，否则返回false。

cmiisstarted

语法：completed:=cmiisstarted（）

说明：如果cmi系统指出当前任务已经开始但并未完成，则该函数返回true，否则返回false。

cmilogin

语法：bool:=cmilogin（sign-on name，password，lesson id，cgi url）

说明：该函数通过登录名和密码，将学生登录到基于web的cmi服务器上。其中，lesson id是任务的惟一标识，cgi url是cgi脚本的位置。函数执行成功，则返回true，否则返回false。

cmilogout

语法：bool:=cmilogout（）

说明：该函数使学生从当前任务中退出。如果没有执行函数cmifinish（），所有的跟踪数据将被发送到服务器。函数执行成功，则返回true，否则返回false。该函数仅适用于通过web访问cmi系统。

cmireadcomplete

语法：cmireadcomplete（）

说明：在从cmi系统获得所有信息之后，应该调用此函数。该函数删除临时的cmi数据文件。该函数不能用于通过web访问cmi系统。

cmisetcompleted

语法：cmisetcompleted（）

说明：将当前任务设置为“completed”状态。

cmisetcustomfield

语法：cmisetcustomfield（"table name "，"field name "，"data "）

说明：用于设置指定的自定义字段的值。"table name"是包含有自定义字段的表的名称，可以是enroll或者progress，分别对应当前学生的课程注册表或课程进程表；"field name"是用于存储数据data的自定义字段的名称。

cmisetdata

语法：cmisetdata（data）

说明：用于将各种任务数据传递给cmi系统，该任务数据对学生而言是惟一的。

cmisetfailed

语法：cmisetfailed（）

说明：将当前任务设置为失败。

cmisetlocation

语法：cmisetlocation（"location "）

说明：设置学生最终退出当前任务的位置，"location"的值不应超过10个字符。

cmisetloggedout

语法：cmisetloggedout（）

说明：将当前任务设置为退出状态。

cmisetobj

语法：cmisetobj（index，id，score，status，started，completed，passed，failed）

说明：将一个目标的特定信息传递给cmi系统。参数index的取值范围为1~cmiobjcount。

cmisetpassed

语法：cmisetpassed（）

说明：将当前任务设置为通过状态。

cmisetscore

语法：cmisetscore（score）

说明：将任务的成绩数值传递给cmi系统。

cmisetstarted

语法：cmisetstarted（）

说明：将当前任务设置为开始状态。

cmisetstatus

语法：cmisetstatus（status）

说明：将指定的任务状态传递给cmi系统。参数status的取值可能有：completed，

incomplete和not attempted。

cmisettime

语法：cmisettime（data）

说明：设置学生在任务上用去的总时间。

cmisettimedout

语法：cmisettimedout（）

说明：将当前任务设置为超时状态。

cmishowerrors

语法：cmishowerrors（show）

说明： 用于设置程序运行时是否根据出错情况自动显示cmi错误提示对话框。当参数show的值为true时（默认值），允许显示，否则不予显示。