有经验的工作API（XAPI）
本节将介绍如何使用XAPI网络学习规范的制定工作。这方面的经验API，被称为XAPI，使内容开发商收集基于其用户的学习经验数据。该部分包括有关如何与XAPI选项发布和理解XAPI经验语句的信息。有关最新的规格，文档和术语的解释，请访问官方网站XAPI（http://tincanapi.com/）。
与XAPI方案发布
您需要发布到XAPI启用自动和手动XAPI语句。按照中介绍的步骤发布到XAPI准备您的标题发布到XAPI。
大多数自动XAPI语句都是通过发布选项，当你发布一个标题XAPI控制。这些选项在上组合在一起XAPI选项标签您点击后发布：
| 一致性级别 |
此字段被禁用。
|
|
从LRS单独的窗口中启动过程
|
如果你想在一个新的窗口，要启动的发布标题选择此选项。当选择此选项，用户退出已发布的标题，该窗口将关闭，用户将被返回到LRS。
|
|
报告测试/调查问题相互作用LRS
|
选择此记录中包含的分级测试问题的交互数据提交给LRS。
交互数据包括每个等级的问题的以下信息：
-
用户的回答
-
无论用户的答案正确与否
-
时间问题得到回答
-
的时间量的用户花费在网页上包含答案
|
|
提示用户导航到最后查看的页面
|
选择此选项可启用发布的标题自动书签功能。当选择此选项，并且用户返回到LRS内发布的标题，用户可以选择跳过他或她发布的标题中最后查看的页面的选项。
|
|
活动ID
|
指定，因为它会在LRS中是已知的过程的ID。
|
|
活动名称
|
只要你想它的LRS内显示指定课程的称号。
|
|
活动描述
|
只要你想它的LRS内显示指定的课程的内容的说明。
|
完成的选项时，请考虑以下XAPI选项标签：
-
请注意，该活动ID，活动名称和活动描述的过程可在此设置。该选项用于为其他语句的上下文。在创建活动ID，一定要遵循一个IRI（国际资源标识符），规则如避免空格和特殊字符。
-
该选项追加时间戳互动创建一个唯一的ID总是禁用，这样一个问题始终报告与同一活动ID的答案。
-
一个尝试活动声明的过程中启动时自动发送。它被用于在指定的活动发送课程信息部（由指定的活动ID，活动名称，和活动描述的XAPI发布选项）。
-
当选项提示用户导航到最后查看的页面中选择，您发布的过程中可以用动词报告XAPI声明经历由学习者访问的每个页面。在这个活动是HTML页面的名称，它是URI编码的，因此它可以被用于Lectora在线 书签功能。
|
如果你想通过课程来跟踪进度，添加在标题水平这两个动作：
|
-
如果选项回答当测试或调查中的问题将被报告报告测试/调查问题相互作用的LRS被选中。问题文本和响应的XAPI声明入账。
测试必须进行分级，但它并不需要被纳入总分。
-
此外，ActivityContext -家长声明款被设置为它测试的活动。
发送或传递测试失败报表
通过或失败XAPI声明将自动为设置进行分级测试发送。该分数与动词一起设置通过或失败。对象显示名称是测试的名称。该ID是与添加到它的测试的名称活动的IRI。（见下文实施例）。
对于分钟至0的结果的分数属性和max 100由默认都被设置为0。的最低合格分数（％）字段（位于测试对结果，即使它被设置为0（在没有正确的情况下）选项卡）始终都应包括在内。
发送完成，通过或失败活动报告
当您设置AICC_Lesson_Status变量，XAPI语句发送。以下情况将决定发送什么类型的语句：
-
您可以使用修改变量的动作设定AICC_Lesson_Status来完成，通过或失败。如果这样做，当然会发送相应的已完成或已通过或失败的声明。
-
设置AICC_Lesson_Status以通过或完成将设置XAPI语句的result.completion为true，并且result.success至真。如果AICC_Lesson_Status完成，得分低于AU掌握得分，result.success将是错误的。
-
如果AICC_Lesson_Status设置为失败时，XAPI语句的result.completion设置为真，并result.success设置为假。
-
如果如果你有一个分级的存在，包括测试，或者如果你手动设置的分数应该包括在完成声明AICC_Score。
发送XAPI声明
您可以在使用过程中的任何位置发送XAPI声明。它会默认共同XAPI声明元素让你指定一个动词和对象。这可以在可用的行动很多触发一个被触发。如果您需要完全控制语句及其所有值见指定的动词和物体的下面。
指定动词和对象
Lectora在线使用的动词ADL定义。此外，任何动词名可以进入。进入动词名附加到ADL命名空间，以便未来ADL动词都可以使用，或者您可以使用自己独特的动词。（LRS将不会验证动词并允许您在其报告;因此允许使用该命名空间）
对于声明的对象部分，你可以使用任何采用了先进的编辑的动态变量，该变量的宏。您还可以使用文本上的任何活动报告。该目的字段将是活动标识符。为了确保这是一个有效的IRI，最小的替换字符的使用这个表达式来完成：
ActivityID （活动ID的位置）
请考虑使用条件的行为和行动组换做复杂的跟踪场景的能力。
指定附加声明值
ActivityContext值被自动设置。
发送XAPI声明和动态更新语句
使用运行JavaScript的动作，你可以自定义和动态的，当您浏览标题与学习者通过使用您的标题定义的变量更新XAPI声明。这使您可以轻松设置模板，将满足任何使用情况。
下面是JavaScript的一个简单而有效的例子，你可以执行使用操作..这个JavaScript将创建语句，然后发送给您创建的声明。
var stmt=
{
“动词”：{
“ID”：VarxAPIVerbID.getValue（）
“显示”：{
“UND”：VarxAPIVerbDisplay.getValue（）
}
}，
“对象”：{
“定义”：{
“名称”： {
“EN-US”： “xAPIandLODemo”
}
}，
“ID”： “http://uniqueurl.com/xAPIandLoDemo”
“的objectType”： “活动”
}，
“结果”：{
“得分了”： {
“缩放”：（parseInt函数（Test_1_Score.getValue（））/ 100）
}，
“完成”：真实，
“成功”：真
}
}
VAR tcAPI = window.parent.frames [ 'titlemgrframe'];
VAR tc_driver = tcAPI.tc_driver;
tcAPI.TinCanSendStatement（tc_driver，语句，函数（XHR）{}）;
上述声明包含一些函数调用获得的价值 Lectora在线变量。这些也可以是静态的字符串值，例如，如果你只是想指定语句中的动词和其他值。
下面是定制XAPI声明两种选择：
VarxAPIVerbID.getValue()
|
这将使用用户定义的变量xAPIVerbID。因为如果你是在所有其他行动引用变量使用相同的无功前缀。您可以将此变量设置为任何你想要的动词。确保你做双方的ID和显示。
在该示例中，ID是一个URI如http://adlnet.gov/expapi/verbs/answered
（对应的一个例子显示在回答。）
|
(parseInt(Test_1_Score.getValue()) / 100)
|
这里使用的预留可变Test_1_Score送他们对测试的分数。（这并不一定瓦尔前缀，因为它不是一个用户定义的变量。此外，当它被公布的无功自动预置到它）。 |
获取更多信息
有关XAPI声明规范的详细信息，请访问https://github.com/adlnet/xAPI-Spec/blob/master/xAPI.md。有关XAPI报表生成和测试的更多信息，请访问http://tincanapi.com/statement-generator/。
XAPI声明输出示例（从SCORM云）
2014-11-05T04：05：36.259
乔金通过“http://www.uniqueurl.com/xAPI%20Template”用50分
2014-11-05T04：05：36.256
乔金回答不正确“调查问题1”响应“真”
2014-11-05T04：05：36.254
乔金回答不正确“我的试题2”响应“假”
2014-11-05T04：05：36.251
乔金正确回答“我的试题1”响应“真”
2014-11-05T04：05：34.803
乔金派“定制XAPI-声明”
2014-11-05T04：05：34.047
乔金经历“XAPI措施Page”
2014-11-05T04：05：31.994
乔金经历了“后调查Page”
2014-11-05T04：05：27.433
乔金经历“最后的调查页面”
2014-11-05T04：05：25.582
乔金经历“测试1次失败”
2014-11-05T04：05：21.783
乔金失败“测试1”刻痕50
2014-11-05T04：05：17.391
乔金经历“最后的测试页面”
2014-11-05T04：05：12.855
乔金经历了“1”
2014-11-05T04：05：10.555
乔金经历了“1”
2014-11-05T04：05：09.837
乔金试图“http://www.uniqueurl.com/xAPI%20Template”
尝试课程表（自动）
2014-11-05T04：05：09.837
乔金试图“http://www.uniqueurl.com/xAPI%20Template”
{
“ID”： “3d26bd57-0558-4a02-934d-501c7d85d3b7”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/attempted”
“显示”：{
“EN-US”： “尝试”
}
}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：07.734Z”
“存储”： “2014-11-05T04：05：09.837Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“定义”：{
“名称”： {}，
“描述”：{}
}，
“的objectType”： “活动”
}
}
尝试课程表（自动）
2014-11-05T04：05：10.555
乔金经历了“1”
{
“ID”： “3ed638c0-a422-41e5-b7d7-42bf43e59b39”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/experienced”
“显示”：{
“EN-US”： “经历了”
}
}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
“亲本”：[
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：08.506Z”
“存储”： “2014-11-05T04：05：10.555Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template/a001_page_1.html”
“定义”：{
“名称”： {
“EN-US”： “1”
}
}，
“的objectType”： “活动”
}
}
通过/失败测试语句（自动）
2014-11-05T04：05：21.783
乔金失败“测试1”刻痕50
{
“ID”： “1820c7e8-6509-4c45-b672-af7ae301ec40”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/failed”
“显示”：{
“EN-US”： “失败”
}
}，
“结果”：{
“得分了”： {
“原始”：50，
“min” 是：0，
“最大”：100
}，
“成功”：假的，
“完成”：假的
}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
“亲本”：[
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：20.030Z”
“存储”： “2014-11-05T04：05：21.783Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template/Test%201”
“定义”：{
“名称”： {
“EN-US”： “测试1”
}
}，
“的objectType”： “活动”
}
}
回答过的问题的声明（自动）
2014-11-05T04：05：36.251
乔金正确回答“我的试题1”响应“真”
{
“ID”： “a8af22bf-8e38-447c-8e6a-500c3673f867”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/answered”
“显示”：{
“EN-US”： “回答”
}
}，
“结果”：{
“成功”：真实，
“回应”：“真”
}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
“亲本”：[
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：10.000Z”
“存储”： “2014-11-05T04：05：36.251Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template-Question_1_67_1415160320014”
“定义”：{
“描述”：{
“EN-US”： “我的测试问题1”
}，
“类型”：“http://adlnet.gov/expapi/activities/cmi.interaction”
“interactionType”：“真假”，
“correctResponsesPattern”：
“真正”
]
}，
“的objectType”： “活动”
}
}
从XAPI声明行动自XAPI声明
2014-11-05T04：05：34.803
乔金派“定制XAPI-声明”
{
“ID”： “6a108ff9-1bcc-4bb0-9021-732fb7bad775”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/sent”
“显示”：{
“EN-US”： “已发送”
}
}，
“结果”：{}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
“亲本”：[
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：32.376Z”
“存储”： “2014-11-05T04：05：34.803Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template/Custom-xAPI-Statement”
“定义”：{
“名称”： {
“EN-US”： “定制XAPI-声明”
}
}，
“的objectType”： “活动”
}
}
通过/ Compld /失败的课程表（自动）
2014-11-05T04：05：36.259
乔金通过“http://www.uniqueurl.com/xAPI%20Template”用50分
{
“ID”： “6e8c000e-47d0-4b8c-842B-d9573422ce1b”
“演员”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名称”：
“ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“动词”：{
“ID”： “http://adlnet.gov/expapi/verbs/passed”
“显示”：{
“EN-US”： “通过”
}
}，
“结果”：{
“得分了”： {
“原始”：50，
“min” 是：0，
“最大”：100
}，
“成功”：真实，
“完成”：真实，
“持续时间”： “PT25.97S”
}，
“上下文”：{
“登记”： “61d426da-436A-4b2a-8daa-ce94f6082f2f”，
“contextActivities”：{
“分组”：
{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
]
}
}，
“时间戳”： “2014-11-05T04：05：33.714Z”
“存储”： “2014-11-05T04：05：36.259Z”
“权威”：{
“名”：“乔王”，
“账”：{
“主页”：“http://cloud.scorm.com/”
“名”： “ZUASCUHYVJ|wieloch@trivantisboca.com”
}，
“的objectType”： “代理”
}，
“版本”： “1.0.0”，
“对象”：{
“ID”： “http://www.uniqueurl.com/xAPI%20Template”
“的objectType”： “活动”
}
}
技术支持 | 关于 Trivantis
© 版权 Trivantis 2017