Trabalhando com a API Experience (XAPI)

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 dos 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/ ).

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 o seu 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 agrupadas na Opções XAPI guia depois de 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: A resposta de usuário Se a resposta do usuário está correta ou não Vez que a questão foi respondida O tempo que o usuário gastou na página que contém a resposta
Solicitar que o usuário navegue até a última página visualizada	Seleccione esta opção para habilitar o recurso de bookmarking automático para o título publicado. Quando esta opção for selecionada, 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 no 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 utilizados como o contexto para outras instruçõ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.
A opção Anexar timestamp à interação para criar uma identificação única está sempre desativado de modo que uma pergunta sempre relata respostas com a mesma ID de Atividade.
Uma declaração de actividade tentativa é enviado automaticamente quando o curso é iniciado. Ele é enviado para a atividade especificada no Informações sobre o curso secção (especificado pelo ID de Atividade , nome da atividade e Atividade Descrição ) das opções de publicação XAPI.

Quando a opção de Solicitar que o usuário navegar para a última página visualizada é selecionado, seu curso publicado pode relatar uma declaração XAPI com o verbo experimentou para cada página visitada por um aprendiz. A actividade neste processo é o nome da página HTML e é codificada para URI de modo que pode ser utilizada 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 do título:

No Show - Declaração XAPI - tentativa - VAR (CurrentPageName)
Em Hide - Declaração XAPI - completou - VAR (CurrentPageName)

Questões dentro de um teste ou inquérito será comunicado quando respondeu se a opção Relatório questão de teste / pesquisa de 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 é definido como a atividade do seu teste.

Enviando Demonstrações de teste passou ou falhou

Declarações XAPI passou ou não será enviado automaticamente para os 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. O ID é o IRI da actividade com o nome do teste adicionado a ele. (Veja exemplos abaixo).

As propriedades de pontuação resultado para min a 0 e no máximo a 100 está tudo pronto 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 é definido como 0 (no caso de nenhum correto).

Envio de Concluído, Passed ou Falha declarações de actividade

Quando você define o AICC_Lesson_Status variável, uma declaração XAPI é enviado. As condições a seguir vai 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 Passed ou Falha comunicado.
Definir AICC_Lesson_Status ao passado ou concluída será definido 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 UA, 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ídas na declaração de conclusão se ele existir, se você tem um sistema de graduação, incluiu teste ou se você definir manualmente AICC_Score .

Enviando uma Declaração XAPI

Você pode enviar uma declaração XAPI partir de qualquer localização no curso. Ele será o padrão dos elementos de instrução comum XAPI que lhe permite especificar um verbo e um objeto. Isto pode ser desencadeado por um dos muitos gatilhos disponíveis para acções. Se você precisa de um controle total sobre a declaração e todos os seus valores veja Especificando verbos e objetos abaixo.

Especificando verbos e objetos

Lectora Online utiliza as definições ADL para verbos. Além disso, qualquer verbo nome pode ser inserido. nomes verbais inseridos são acrescentados ao namespace ADL assim qualquer futuro verbos ADL pode ser usado, ou você pode usar seu próprio verbo único. (Os LRS não iria validar o verbo e lhe permitiria relatórios sobre ele;. Permitindo, portanto, a utilização desse espaço de nomes)

Para mais informações sobre verbos, visite http://www.adlnet.gov/expapi/verbs .

Para a parcela objeto da declaraçã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 é feita 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 definidas automaticamente.

Enviando uma comunicaçã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 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": {
			"Name": {
			"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, stmt, function (XHR) {});

A declaração acima contém algumas chamadas de função para obter o valor de Lectora Online variáveis. Estes também podem ser valores de cadeia estáticos, por exemplo, se você só queria especificar o verbo e outros valores no comunicado.

Abaixo estão duas opções para personalizar a declaração XAPI:

VarxAPIVerbID.getValue()

Este usa a variável definida pelo usuário xAPIVerbID. Use o mesmo prefixo Var como se estivesse fazendo referência a variável em todas as outras ações. Você pode definir esta variável para qualquer verbo que deseja. Certifique-se de que você faça tanto o ID ea exibição .

Neste exemplo, a ID é um URI tal comohttp://adlnet.gov/expapi/verbs/answered

(Um exemplo correspondente de exibição é respondida .)

(parseInt(Test_1_Score.getValue()) / 100) Este utiliza uma variável de reservada Test_1_Scorepara enviar a pontuação que receberam no teste. (Isto não tem o prefixo Var, pois não é uma variável definida pelo usuário. Além disso, o Var é automaticamente anteposto a ele quando ele for publicado.)

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 Declaração de Saída (de SCORM Cloud)

2014-11-05T04: 05: 36,259
			Joe King passou 'http://www.uniqueurl.com/xAPI%20Template ", com pontuação de 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 incorrectamente respondidas 'My Test 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 experimentou 'Ações XAPI Página'
			2014-11-05T04: 05: 31,994
			Joe King experimentou «Inquérito após página '
			2014-11-05T04: 05: 27,433
			Joe King experimentou 'página Última pesquisa'
			2014-11-05T04: 05: 25,582
			Joe King experientes 'Teste 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 experimentou 'página Última test'
			2014-11-05T04: 05: 12,855
			Joe King experimentou 'Page 1'
			2014-11-05T04: 05: 10.555
			Joe King experimentou 'Page 1'
			2014-11-05T04: 05: 09,837
		Joe King tentou 'http://www.uniqueurl.com/xAPI%20Template'

Declaração Course tentada (auto)

2014-11-05T04: 05: 09,837
			Joe King tentou 'http://www.uniqueurl.com/xAPI%20Template'
			{
			"Id": "3d26bd57-0558-4a02-934d-501c7d85d3b7",
			"Ator": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Versão": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"Definição": {
			"Name": {},
			"Descrição": {}
			},
			"ObjectType": "Atividade"
			}
			}

Declaração Course tentada (auto)

			2014-11-05T04: 05: 10.555
			Joe King experimentou 'Page 1'
			{
			"Id": "3ed638c0-a422-41e5-b7d7-42bf43e59b39",
			"Ator": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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": {
			"Name": {
			"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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Versão": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Test%201",
			"Definição": {
			"Name": {
			"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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "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 Acção Statement

2014-11-05T04: 05: 34,803
			Joe King enviou 'Custom-XAPI-Statement'
			{
			"Id": "6a108ff9-1bcc-4bb0-9021-732fb7bad775",
			"Ator": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/sent",
			"exibição": {
			"En-US": "enviado"
			}
			},
			"Resultado": {},
			"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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Versão": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Custom-xAPI-Statement",
			"Definição": {
			"Name": {
			"En-US": "Custom-XAPI-Statement"
			}
			},
			"ObjectType": "Atividade"
			}
		}

Passou / Compld / Declaração Course Falha (auto)

2014-11-05T04: 05: 36,259
			Joe King passou 'http://www.uniqueurl.com/xAPI%20Template ", com pontuação de 50
			{
			"Id": "6e8c000e-47d0-4b8c-842b-d9573422ce1b",
			"Ator": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name":
			"ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/passed",
			"exibição": {
			"En-US": "passou"
			}
			},
			"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": {
			"Name": "Joe King",
			"conta": {
			"Homepage": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"ObjectType": "Agente"
			},
			"Versão": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"ObjectType": "Atividade"
			}
			}