cmiaddcomment
语法:cmiaddcomment(index,"comment ")
说明:将一个任务说明添加到cmi课程中,参数index可以是任意数值。添加说明时如果使用了一个已用的index,则会替代原来的说明。
cmiaddinteraction
语法:cmiaddinteraction(date,time,interaction id,objective id,type,correct response,
student response,result,weight,latency)
说明:向cmi系统传递一个关于交互作用的特定信息,时间格式采用dd/mm/yy。该函数不支持自定义数据的传递,传递自定义数据需要使用函数cmiaddinteractionex。
cmiaddinteractionex
语法:cmiaddinteractionex(date,time,interactionid,objective id,type,correct response,
student response,result,weight,latency,custom data)
说明:向cmi系统传递一个关于交互作用的特定信息,时间格式采用dd/mm/yy。该函数支持自定义数据的传递。
cmifinish
语法:bool:=cmifinish()
说明:该函数将最终的跟踪数据传递给服务器,调用该函数后就不再允许对跟踪数据进行更新了。向服务器传递数据之后并不退出任务。该函数仅适用于通过web访问cmi系统。函数执行成功则返回true,否则返回false。
cmiflush
语法:bool:=cmiflush()
说明:该函数将当前跟踪数据传递给服务器,调用该函数后仍然允许对跟踪数据进行更新。该函数仅适用于通过web访问cmi系统,通常用于使服务器随时更新学生的跟踪数据。函数执行成功则返回true,否则返回false。
cmigetattempt
语法:attempt number:=cmigetattempt()
说明:从cmi系统返回学生尝试任务的次数。
cmigetattemptscore
语法:score:=cmigetattemptscore(attempt)
说明:返回任务尝试的成绩。参数attempt取值范围为1~cmiattemptcount。
cmigetattemptstatus
语法:status:=cmigetattemptstatus(attempt)
说明:返回一次尝试的状态。参数attempt取值范围为1~cmiattemptcount,可能的返回值有:completed,incomplete,not attempted。
cmigetconfig
语法:data:=cmigetconfig()
说明:返回在cmi系统中指定的任务配置数据。任务配置数据由cmi系统管理员进行设置。
cmigetcourseid
语法:cmigetcourseid()
说明:返回在cmi系统中指定的课程编号。
cmigetcustomfield
语法:data:=cmigetcustomfield("table name ","field name ")
说明:返回存储在由"table name"和"field name"指定的自定义字段中的数据。
"table name"是包含有自定义字段的表的名称,可以是enroll或者progress,分别对应当前学生的课程注册表或课程进程表。"field name"是自定义字段的名称。
cmigetdata
语法:data:=cmigetdata()
说明:返回由cmi系统指定的任务数据,任务数据由系统函数cmisetdata设置。该函数的返回值对应于当前的学生。
cmigetdemographics
语法:data:=cmigetdemographics(field name)**
说明:返回由field name指定的字段所表示的学生的统计信息。字段名是由cmi系统管理员设置的。
cmigetlasterror
语法:error:=cmigetlasterror()
说明:判断最后一个cmi操作是否有错误。返回0表示没有出错。
cmigetlocation
语法:location:=cmigetlocation()
说明:从cmi系统返回用户离开任务时最后所处的位置。位置是由程序使用系统函数cmisetlocation()定义和设置的。
cmigetmasteryscore
语法:score :=cmigetmasteryscore()
说明:返回cmi系统中为任务设置的必须的通过成绩。
cmigetobjcount
语法:count:=cmigetobjcount()
说明:返回与当前任务相关联的目标的数目。
cmigetobjid
语法:id:=cmigetobjid(index)
说明:返回由index指定的目标的惟一标识符。index取值范围为0~cmiobjcount,目标是在cmi系统中定义的。cmi系统为每个目标创建了一个惟一的id标识,可以通过在【交互作用】设计图标属性检查器的【cmi】选项卡中输入objective id来将该设计图标与cmi目标联系到一起。
cmigetobjscore
语法:score:=cmigetobjscore(index)
说明:返回由index指定的目标的当前成绩。index取值范围为0~cmiobjcount。
cmigetobjstatus
语法:status:=cmigetobjstatus(index)
说明:返回由index指定的目标的状态。参数index的取值范围为0~cmiobjcount,该函数可能的返回值有:completed,incomplete和not attempted。
cmigetpath
语法:path:=cmigetpath()
说明:从cmi系统中返回学生的私有目录的路径。该函数不能用于通过web访问cmi系统。
cmigetscore
语法:score:=cmigetscore()
说明:从cmi系统中返回任务的成绩值。
cmigetstatus
语法:status:=cmigetstatus()
说明:从cmi系统中返回当用户最终离开任务时,该任务的状态。该函数可能的返回值有:completed,incomplete和not attempted。
cmigettime
语法:seconds:=cmigettime()
说明:从cmi系统中返回用户在当前任务中用去的总时间,单位为秒。
cmigetuserid
语法:user id:=cmigetuserid()
说明:返回在cmi系统中设置的学生的惟一标识字符串。
cmigetusername
语法:username:=cmigetusername()
说明:返回学生在登录到cmi系统时所用的用户名。
cmiinitialize
语法:bool:=cmiinitialize()
说明:允许cmi系统在运行任务之前,执行任何必要的初始化工作。该函数必须在调用其他任意cmi函数或访问cmi变量之前被调用。函数执行成功则返回true,否则返回false。该函数仅用于通过web访问cmi系统。
cmiisattemptcompleted
语法:bool:=cmiisattemptcompleted(attempt)
说明:返回学生是否完成指定的尝试。参数attempt的取值范围为1~cmiattemptcount。如果指定尝试被完成,则函数返回true,否则返回false。
cmiisattemptfailed
语法:bool:=cmiisattemptfailed(attempt)
说明:返回学生是否没有完成指定的尝试。参数attempt的取值范围为1~cmiattemptcount。如果指定尝试没有完成,则函数返回true,否则返回false。
cmiisattemptpassed
语法:bool:=cmiisattemptpassed(attempt)
说明:返回学生是否通过指定的尝试。参数attempt的取值范围为1~cmiattemptcount。如果指定尝试已通过,则函数返回true,否则返回false。
cmiisattemptstarted
语法:bool:=cmiisattemptstarted(attempt)
说明:返回指定的尝试是否开始。参数attempt的取值范围为1~cmiattemptcount。如果指定尝试已经开始,则函数返回true,否则返回false。
新闻热点
疑难解答