Para mais informações, visite estas observações relacionadas com o XAPI em nossa Comunidade Trivantis:
Esta seção descreve como trabalhar com a especificação elearning XAPI. Esta API Experience, conhecido como XAPI, permite que os desenvolvedores de conteúdo para coletar dados com base na experiência de aprendizagem de seus usuários. A seção inclui informações sobre como publicar com as opções XAPI e compreender as declarações de experiência XAPI. Para as especificações mais recentes, documentos e explicações de termos, visite o website oficial XAPI ( http://tincanapi.com/ ).
|
|
Para mais informações, visite estas observações relacionadas com o XAPI em nossa Comunidade Trivantis: |
Publicar com as opções XAPI
Você precisa publicar XAPI para permitir que as declarações XAPI automatizados e manuais. Siga os passos descritos na Publicação para XAPI para preparar a sua título para publicação em XAPI.
A maioria das declarações XAPI automáticas são controlados através das opções de publicação quando você publica um título para XAPI. Estas opções são agrupados na Opções XAPI guia após clicar em Publicar :
| Nível de conformidade |
Este campo está desativado. |
|
Lançar claro na janela separada de LRS |
Selecione esta opção se você deseja que o título publicado a ser lançado em uma nova janela. Quando esta opção for selecionada e o usuário sai do título publicado, a janela será fechada, eo usuário será devolvido aos LRS. |
|
Relatório de ensaio / pergunta da pesquisa interação para LRS |
Seleccione esta opção para gravar dados de interação para as perguntas contidas no teste graduado de ser submetido ao LRS. dados de interação inclui as seguintes informações para cada pergunta classificados:
|
|
Solicitar que o usuário navegue para a última página visualizada |
Seleccione esta opção para habilitar o recurso de bookmarking automático para o título publicado. Quando selecionado, eo usuário está retornando ao título publicado dentro dos LRS, o usuário terá a opção de pular para a página que ele ou ela último visto dentro do título publicado. |
|
ID atividade |
Especifique o ID do curso, uma vez que será conhecido dentro dos LRS. |
|
Nome atividade |
Especifique o título do curso que você quer que ele seja exibido dentro dos LRS. |
|
Descrição de Atividade |
Especifique a descrição do conteúdo do curso como você quer que ele seja exibido dentro dos LRS. |
Considere o seguinte ao completar as opções Opções XAPI guia:
Observe que o ID de Atividade , nome da atividade e Atividade Descrição para o curso pode ser definido aqui. As opções são usadas como o contexto para outras declarações. Ao criar o ID de Atividade , certifique-se de seguir as regras para um IRI (Resource Identifier International), como evitar espaços e caracteres especiais.
Uma declaração de actividade tentativa é enviado automaticamente quando o curso é iniciado. Ele é enviado para a atividade especificada no Informações sobre o Curso seção (especificado pelo ID de Atividade , nome da atividade e Atividade Descrição ) das opções de publicação XAPI.
Quando a opção Solicitar que o usuário navegue para a última página visualizada é selecionado, seu curso publicado pode relatar uma declaração XAPI com o verbo experientes para cada página visitada por um aluno. A actividade neste é o nome da página HTML e é URI codificado para que possa ser usado para a função de bookmarking Lectora.
|
|
Se você quiser acompanhar o progresso através do curso, adicione estas duas acções a nível de título:
|
Questões dentro de um teste ou pesquisa será relatado quando respondeu se a opção Relatório de teste / exame questão interação para os LRS está selecionado. O texto da pergunta e da resposta são apresentados na demonstração XAPI.
O teste deve ser classificado, mas não precisam ser incluídos na pontuação geral.
Além disso, o ActivityContext - Pai subseção declaração está definido para a atividade do seu teste.
O envio de declarações de teste passou ou falhou
Declarações XAPI passou ou não será automaticamente enviado para testes que estão definidos para serem classificados. A pontuação é definida juntamente com o verbo passou ou falhou . O nome do objeto de exibição é o nome do teste. A identificação é o IRI da actividade com o nome do teste adicionado a ele. (Ver os exemplos abaixo).
As propriedades de pontuação resultado para min a 0 e no máximo a 100 são todos definidos para 0 por padrão. O mais baixo Passing Score (%) campo (localizado na parte de teste Resultados guia) deve ser sempre incluído mesmo se ele estiver definido como 0 (no caso de nenhum correto).
Envio concluído, Passado, ou Falha declarações de actividade
Quando você definir o AICC_Lesson_Status variável, uma declaração XAPI é enviado. As seguintes condições irá determinar que tipo de declaração é enviada:
Você pode usar um modificar acção variável para definir AICC_Lesson_Status para concluído , passou ou falhou . Se isso for feito, o curso irá enviar um correspondente Concluído ou Passou ou Falhou comunicado.
Definir AICC_Lesson_Status ao passado ou concluída irá definir o da declaração XAPI result.completion como true eo result.success a verdade . Se AICC_Lesson_Status está concluído e a pontuação é menor do que a pontuação maestria AU, result.success será falsa .
Se AICC_Lesson_Status está definido para não , da declaração XAPI result.completion está definido como verdadeiro e result.success está definido como falso .
A pontuação deve ser incluída na declaração de conclusão se ele existe, se você tem um sistema de graduação, incluiu teste ou se você definir manualmente AICC_Score .
O envio de uma declaração XAPI
Você pode enviar uma declaração XAPI partir de qualquer local no curso. Ele será o padrão para os elementos da demonstração XAPI comuns que permitem que você especifique um verbo e um objeto. Isso pode ser desencadeada em um dos muitos gatilhos disponíveis para ações. Se você precisa de um controle total sobre a declaração e todos os seus valores ver Especificando verbos e objetos abaixo.
Especificando verbos e objetos
|
|
Para mais informações sobre verbos, visite http://www.adlnet.gov/expapi/verbs . |
Para a parte objeto da instrução, você pode usar qualquer uma das variáveis dinâmicas usando edição avançada e as macros variáveis. Você também pode usar o texto para informar sobre qualquer atividade. Este campo objeto será o identificador de atividade. Para garantir este é um IRI válida, uma substituição mínima de caracteres é feito usando esta expressão:
ActivityID (A localização da Actividade IDs)
Considere o uso de ações condicionais e grupos de acção para a capacidade de fazer cenários de monitoramento complexas.
Especificando na declaração de valores adicionais
valores ActivityContext são definidos automaticamente.
Enviando uma declaração XAPI e dinamicamente atualizar a declaração
Usando a ação Javascript correr, você pode personalizar e atualizar dinamicamente a declaração XAPI como você atravessa o título com o seu aluno, utilizando variáveis definidas em seu título. Isso permite que você facilmente configurar-se modelos que irão satisfazer qualquer caso de uso.
Abaixo está um exemplo simples, mas eficaz do Javascript que você pode executar usando a ação .. Este javascript irá criar a declaração e, em seguida, enviar a declaração que você criou.
var stmt=
{
"Verbo": {
"Id": VarxAPIVerbID.getValue (),
"exibição": {
"Und": VarxAPIVerbDisplay.getValue ()
}
},
"Objeto": {
"Definição": {
"Nome": {
"En-US": "xAPIandLODemo"
}
},
"Id": "http://uniqueurl.com/xAPIandLoDemo",
"ObjectType": "Atividade"
},
"Resultar": {
"Ponto": {
"Escalado": (parseInt (Test_1_Score.getValue ()) / 100)
},
"Conclusão": true,
"Sucesso": true
}
}
var tcAPI = window.parent.frames [ 'titlemgrframe'];
var tc_driver = tcAPI.tc_driver;
tcAPI.TinCanSendStatement (tc_driver, decl, função (XHR) {});A declaração acima contém algumas chamadas de função para obter o valor de
Abaixo estão duas opções para personalizar a declaração XAPI:
VarxAPIVerbID.getValue()
|
Isto usa a variável definida pelo utilizador Neste exemplo, ID é um URI tal como (Um exemplo correspondente de exibição é respondida .) |
(parseInt(Test_1_Score.getValue()) / 100)
|
Este utiliza uma variável reservada Test_1_Scorepara enviar a pontuação que eles receberam no teste. (Isto não tem o prefixo Var, uma vez que não é uma variável definida pelo utilizador. Para além disso, o Var é automaticamente prefixado para que quando ele está publicada.) |
Obtendo informações adicionais
Para mais informações sobre a especificação declaração XAPI, visite https://github.com/adlnet/xAPI-Spec/blob/master/xAPI.md . Para mais informações sobre o gerador de declaração XAPI e testador, visite http://tincanapi.com/statement-generator/ .
Exemplos xapi instrução de saída (de SCORM Nuvem)
2014-11-05T04: 05: 36,259 Joe King passou 'http://www.uniqueurl.com/xAPI%20Template' com pontuação 50 2014-11-05T04: 05: 36,256 Joe King incorretamente respondeu 'pergunta de pesquisa 1' com a resposta 'true' 2014-11-05T04: 05: 36,254 Joe King incorretamente respondeu 'Minha Teste Pergunta 2' com a resposta 'falso' 2014-11-05T04: 05: 36,251 Joe King respondeu corretamente 'Meu Teste Pergunta 1' com a resposta 'true' 2014-11-05T04: 05: 34,803 Joe King enviou 'Custom-XAPI-Statement' 2014-11-05T04: 05: 34,047 Joe King experimentado 'Ações XAPI Página' 2014-11-05T04: 05: 31,994 Joe King experimentado 'Levantamento após página' 2014-11-05T04: 05: 27,433 Joe King experimentado 'página Última pesquisa' 2014-11-05T04: 05: 25,582 Joe King experimentado 'Test 1 Falha' 2014-11-05T04: 05: 21.783 Joe King falhou 'Test 1', com pontuação de 50 2014-11-05T04: 05: 17,391 Joe King experimentado 'página Última test' 2014-11-05T04: 05: 12,855 Joe King experimentado 'Page 1' 2014-11-05T04: 05: 10.555 Joe King experimentado 'Page 1' 2014-11-05T04: 05: 09,837 Joe King tentou 'http://www.uniqueurl.com/xAPI%20Template'
Declaração Curso tentada (auto)
2014-11-05T04: 05: 09,837
Joe King tentou 'http://www.uniqueurl.com/xAPI%20Template'
{
"Id": "3d26bd57-0558-4a02-934d-501c7d85d3b7",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/attempted",
"exibição": {
"En-US": "tentativa"
}
},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 07.734Z",
"Armazenado": "2014-11-05T04: 05: 09.837Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"Definição": {
"Nome": {},
"descrição": {}
},
"ObjectType": "Atividade"
}
}
Declaração Curso tentada (auto)
2014-11-05T04: 05: 10.555
Joe King experimentado 'Page 1'
{
"Id": "3ed638c0-a422-41e5-b7d7-42bf43e59b39",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/experienced",
"exibição": {
"En-US": "experiente"
}
},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
],
"Pai": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 08.506Z",
"Armazenado": "2014-11-05T04: 05: 10.555Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template/a001_page_1.html",
"Definição": {
"Nome": {
"En-US": "Página 1"
}
},
"ObjectType": "Atividade"
}
}
Passou / Declaração Teste Falha (auto)
2014-11-05T04: 05: 21.783
Joe King falhou 'Test 1', com pontuação de 50
{
"Id": "1820c7e8-6509-4c45-b672-af7ae301ec40",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/failed",
"exibição": {
"En-US": "falhou"
}
},
"Resultar": {
"Ponto": {
"Cru": 50,
"Min": 0,
"Max": 100
},
"Sucesso": false,
"Conclusão": false
},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
],
"Pai": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 20.030Z",
"Armazenado": "2014-11-05T04: 05: 21.783Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template/Test%201",
"Definição": {
"Nome": {
"En-US": "Test 1"
}
},
"ObjectType": "Atividade"
}
}
Pergunta Declaração respondidas (auto)
2014-11-05T04: 05: 36,251
Joe King respondeu corretamente 'Meu Teste Pergunta 1' com a resposta 'true'
{
"Id": "a8af22bf-8e38-447c-8e6a-500c3673f867",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/answered",
"exibição": {
"En-US": "respondeu"
}
},
"Resultar": {
"Sucesso": true,
"Resposta": "true"
},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
],
"Pai": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 10.000Z",
"Armazenado": "2014-11-05T04: 05: 36.251Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template-Question_1_67_1415160320014",
"Definição": {
"descrição": {
"En-US": "Meu Teste Pergunta 1"
},
"Type": "http://adlnet.gov/expapi/activities/cmi.interaction",
"InteractionType": "verdadeiro ou falso",
"CorrectResponsesPattern": [
"verdade"
]
},
"ObjectType": "Atividade"
}
}
Declaração de costume XAPI de XAPI Ação Declaração
2014-11-05T04: 05: 34,803
Joe King enviou 'Custom-XAPI-Statement'
{
"Id": "6a108ff9-1bcc-4bb0-9021-732fb7bad775",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/sent",
"exibição": {
"En-US": "enviado"
}
},
"Resultar": {},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
],
"Pai": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 32.376Z",
"Armazenado": "2014-11-05T04: 05: 34.803Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template/Custom-xAPI-Statement",
"Definição": {
"Nome": {
"En-US": "Custom-XAPI-Statement"
}
},
"ObjectType": "Atividade"
}
}
Passou / Compld / Declaração Curso Falha (auto)
2014-11-05T04: 05: 36,259
Joe King passou 'http://www.uniqueurl.com/xAPI%20Template' com pontuação 50
{
"Id": "6e8c000e-47d0-4b8c-842b-d9573422ce1b",
"Ator": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"nome":
"ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Verbo": {
"Id": "http://adlnet.gov/expapi/verbs/passed",
"exibição": {
"En-US": "passado"
}
},
"Resultar": {
"Ponto": {
"Cru": 50,
"Min": 0,
"Max": 100
},
"Sucesso": true,
"Conclusão": true,
"Duração": "PT25.97S"
},
"Contexto": {
"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
"contextActivities": {
"Agrupamento": [
{
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
]
}
},
"Timestamp": "2014-11-05T04: 05: 33.714Z",
"Armazenado": "2014-11-05T04: 05: 36.259Z",
"Autoridade": {
"Nome": "Joe King",
"conta": {
"Homepage": "http://cloud.scorm.com/",
"Nome": "ZUASCUHYVJ|wieloch@trivantisboca.com"
},
"ObjectType": "Agente"
},
"Versão": "1.0.0",
"Objeto": {
"Id": "http://www.uniqueurl.com/xAPI%20Template",
"ObjectType": "Atividade"
}
}
© de Copyright Trivantis 2019