Trabajar con el API Experience (xapi)

En esta sección se describe cómo trabajar con la especificación e-learning xapi. Esta API experiencia, conocido como xapi, permite a los desarrolladores de contenido para recoger datos sobre la base de la experiencia de aprendizaje de sus usuarios. La sección incluye información acerca de cómo publicar con las opciones xapi y comprender los estados de experiencia xapi. Para las últimas especificaciones, documentos y explicaciones de los términos, visite la página web oficial xapi ( http://tincanapi.com/ ).

Publicar con las opciones xapi

Es necesario publicar en xapi para permitir a las declaraciones automatizados y manuales xapi. Siga los pasos descritos en la publicación para xapi para preparar el título de la publicación de xapi.

La mayoría de los estados xapi automáticos son controlados a través de las opciones de publicación cuando se publica un título a xapi. Estas opciones se agrupan en la Opciones xapi pestaña después de hacer clic en Publish :

Nivel de conformidad	Este campo está desactivado.
Lanzar curso en la ventana separada de LRS	Seleccione esta opción si desea que el título publicado que será lanzado en una nueva ventana. Cuando se selecciona esta opción, y el usuario sale del título publicado, se cerrará la ventana, y el usuario será devuelto a la LRS.
Informe de prueba / pregunta de la encuesta a la interacción LRS	Seleccione esta opción para grabar los datos de interacción de las preguntas contenidas en la prueba graduada de ser sometidos a la LRS. la interacción de datos incluye la siguiente información para cada pregunta graduada: La respuesta de usuario Si la respuesta del usuario es correcta o no Tiempo de la pregunta fue respondida Cantidad de tiempo que el usuario pasó en la página que contiene la respuesta
Preguntar al usuario para navegar hasta la última página visualizada	Seleccione esta opción para activar la función de marcación automática para el título publicado. Cuando se selecciona esta opción, y el usuario regresa al título publicado dentro de los LRS, el usuario tendrá la opción de omitir a la página que él o ella última considerarse en el título publicado.
Identificación actividad	Especificar el ID del curso, ya que será conocido dentro de los LRS.
Nombre de la actividad	Especificar el título del curso que desea que se muestre dentro de los LRS.
Descripción de la actividad	Especificar la descripción de los contenidos del curso que desea que se muestre dentro de los LRS.

Considere la siguiente hora de completar las opciones en Opciones xapi pestaña:

Observe que el identificador de actividad , Actividad Nombre y Descripción de la actividad para el curso pueden establecerse aquí. Las opciones se utilizan como contexto de otras declaraciones. Al crear el identificador de actividad , asegúrese de seguir las reglas para un IRI (Identificador de Recursos Internacional), como espacios evitando y caracteres especiales.
La opción Anexar marca de tiempo a la interacción para crear un identificador único siempre se desactiva para que una pregunta que siempre informa respuestas con el mismo ID de actividad.
Una declaración de actividad intento se envía automáticamente cuando se inicia el curso. Se envió a la actividad especificada en la información Curso sección (especificada por el identificador de actividad , Actividad Nombre y Descripción de la actividad ) de las opciones de publicación xapi.

Cuando la opción de pedir al usuario que vaya a la última página visitada se selecciona, su curso publicado puede reportar una declaración xapi con el verbo experimentado por cada página visitada por un alumno. La actividad en este es el nombre de la página HTML y es una URI codificada, de modo que puede ser utilizado para laLectora Online la función de marcadores.

Si quieres seguir el progreso a través del curso, añadir estas dos acciones a nivel de título:

En Mostrar - Declaración xapi - intentado - VAR (CurrentPageName)
En Ocultar - Declaración xapi - terminado - VAR (CurrentPageName)

Se informará preguntas en el interior de una prueba o una encuesta cuando obtenga una respuesta si la opción de informe de prueba / encuesta pregunta interacción para la LRS se selecciona. El texto de la pregunta y la respuesta se presentan en el estado xapi.

La prueba debe ser clasificado, pero no tiene que ser incluido en la puntuación global.
Además, el ActivityContext - Padres inciso declaración se establece en la actividad de su prueba.

El envío de declaraciones prueba correcta o incorrecta

Declaraciones xapi pasado o no se enviarán automáticamente para las pruebas que se establecen para ser calificados. La puntuación se establece junto con el verbo pasado o fallado . El nombre de visualización del objeto es el nombre de la prueba. El ID es el IRI de la actividad con el nombre de la prueba añadido a la misma. (Ver ejemplos a continuación).

Las propiedades de puntuación resultado para min a 0 y max a 100 se ajustan a 0 por defecto. El más bajo Puntaje de aprobación (%) campo (situado en la prueba de Resultados pestaña) debe incluirse siempre, incluso si se establece en 0 (en caso de que ninguno correcta).

Enviando Completado, pasado, o Failed declaraciones de actividad

Cuando se establece el AICC_Lesson_Status variables, se envía una declaración xapi. Las siguientes condiciones determinarán qué tipo de instrucción se envía:

Puede utilizar una acción variable para establecer modificar AICC_Lesson_Status a completado , pasó , o fallado . Si se hace esto, el curso se enviará la correspondiente Completado o Passed o Error comunicado.
Configuración AICC_Lesson_Status a pasado o completado establecerá de la declaración xapi result.completion true y la result.success de verdad . Si AICC_Lesson_Status se completa y la puntuación es inferior a la puntuación de dominio AU, result.success será falsa .
Si AICC_Lesson_Status se establece en no , de la declaración xapi result.completion se establece en verdadera y result.success se establece en falso .
La puntuación se debe incluir en la declaración de terminación, si existe, si usted tiene un graduadas, incluida prueba o si se establece manualmente AICC_Score .

El envío de una Declaración de xapi

Puede enviar un comunicado xapi desde cualquier lugar en el curso. Será por defecto los elementos del estado de xapi común que le permiten especificar un verbo y un objeto. Esto puede ser activado en uno de los muchos factores desencadenantes disponibles para las acciones. Si necesita un control total sobre la declaración y todos sus valores vea Especificación de los verbos y los objetos de abajo.

Especificación de los verbos y los objetos

Lectora Onlineutiliza las definiciones ADL para los verbos. Además, cualquier nombre verbo se puede introducir. nombres de verbos introducidos se añaden al espacio de nombres por lo que cualquier ADL ADL verbos futuros se pueden utilizar, o puede utilizar su propio verbo único. (LRS no validar el verbo y se permitirá informar sobre el mismo;. Por lo tanto, lo que permite el uso de ese espacio de nombres)

Para obtener más información sobre los verbos, visite http://www.adlnet.gov/expapi/verbs .

Para la parte objeto de la declaración, puede utilizar cualquiera de las variables dinámicas utilizando edición avanzada y las macros variables. También puede utilizar el texto para informar sobre cualquier actividad. Este campo de objeto será el identificador actividad. Para garantizar que esto es un IRI válida, un reemplazo mínimo de caracteres se realiza utilizando la siguiente expresión:

ActivityID (La ubicación de la ID de la Actividad)

Considere el uso de acciones condicionales y grupos de acción para la capacidad de hacer el seguimiento de escenarios complejos.

Especificación de valores adicionales de los estados

ActivityContext valores se ajustan automáticamente.

El envío de un comunicado xapi y actualizar dinámicamente la instrucción

Utilizando la acción Javascript correr, que puede personalizar y actualizar dinámicamente la declaración xapi a medida que avanza a través del título con su alumno mediante el uso de las variables definidas en el título. Esto le permite configurar fácilmente plantillas que satisfagan cualquier caso de uso.

A continuación se muestra un ejemplo simple pero eficaz del Javascript que se puede ejecutar mediante la acción .. Esta Javascript va a crear la declaración y luego enviar la declaración que ha creado.

var stmt=
			
			{
			"Verbo": {
			"Id": VarxAPIVerbID.getValue (),
			"monitor": {
			"Und": VarxAPIVerbDisplay.getValue ()
			}
			},
			"Objeto": {
			"definición": {
			"nombre": {
			"En-US": "xAPIandLODemo"
			}
			},
			"Id": "http://uniqueurl.com/xAPIandLoDemo",
			"OBJECTTYPE": "Actividad"
			},
			"Resultado": {
			"Puntuación": {
			"Reducido": (parseInt (Test_1_Score.getValue ()) / 100)
			},
			"Finalización": true,
			"Éxito": true
			}
			}

			var tcAPI = window.parent.frames [ 'titlemgrframe'];
			var tc_driver = tcAPI.tc_driver;

		tcAPI.TinCanSendStatement (tc_driver, stmt, la función (xhr) {});

La declaración anterior contiene algunas llamadas de funciones para obtener el valor de Lectora Onlinevariables. Estos también pueden ser valores de cadenas estáticas, por ejemplo si sólo quería para especificar el verbo y otros valores en el comunicado.

A continuación se presentan dos opciones para personalizar la declaración xapi:

VarxAPIVerbID.getValue()

Este utiliza la variable definida por el usuario xAPIVerbID. Utilizar el mismo prefijo Var como si estuviera referencia a la variable en todas las demás acciones. Puede establecer esta variable para cualquier verbo que desee. Asegúrese de que usted lo hace tanto el ID y la visualización .

En este ejemplo, ID es un URI comohttp://adlnet.gov/expapi/verbs/answered

(Un ejemplo correspondiente Display se respondió .)

(parseInt(Test_1_Score.getValue()) / 100) Este sistema utiliza una variable reservada de Test_1_Scoreenviar la puntuación que recibieron en la prueba. (Esto no tiene el prefijo Var ya que no es una variable definida por el usuario. Además, el Var se antepone automáticamente a ella cuando se publica.)

La obtención de información adicional

Para obtener más información acerca de la especificación comunicado xapi, visite https://github.com/adlnet/xAPI-Spec/blob/master/xAPI.md . Para obtener más información sobre el generador de declaración xapi y probador, visite http://tincanapi.com/statement-generator/ .

Ejemplos xapi Declaración de salida (de la nube SCORM)

2014-11-05T04: 05: 36.259
			Joe King pasó 'http://www.uniqueurl.com/xAPI%20Template' con la puntuación de 50
			2014-11-05T04: 05: 36.256
			Joe King respondió incorrectamente 'Encuesta Pregunta 1' con una respuesta 'verdadera'
			2014-11-05T04: 05: 36.254
			Joe King respondió incorrectamente 'Mi Pregunta de prueba 2' con la respuesta 'falsa'
			2014-11-05T04: 05: 36.251
			Joe King respondió correctamente 'Mi Pregunta de prueba 1' con una respuesta 'verdadera'
			2014-11-05T04: 05: 34.803
			Joe King envió 'Custom-xapi-Norma'
			2014-11-05T04: 05: 34.047
			Joe King experimentó 'acciones xapi Página'
			2014-11-05T04: 05: 31.994
			Joe King experimentó 'Después de la inspección Página'
			2014-11-05T04: 05: 27.433
			Joe King experimentó página Última encuesta '
			2014-11-05T04: 05: 25.582
			Joe King experimentó 'Prueba 1 fall'
			2014-11-05T04: 05: 21.783
			Joe King falló Prueba 1 'con la puntuación de 50
			2014-11-05T04: 05: 17.391
			Joe King experimentó página Última prueba '
			2014-11-05T04: 05: 12.855
			Joe King experimentó 'Page 1'
			2014-11-05T04: 05: 10.555
			Joe King experimentó 'Page 1'
			2014-11-05T04: 05: 09,837
		Joe King intentó 'http://www.uniqueurl.com/xAPI%20Template'

Declaración de golf intento de (auto)

2014-11-05T04: 05: 09,837
			Joe King intentó 'http://www.uniqueurl.com/xAPI%20Template'
			{
			"Id": "3d26bd57-0558-4a02-934d-501c7d85d3b7",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/attempted",
			"monitor": {
			"En-US": "intento"
			}
			},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 07.734Z",
			"Almacenado": "2014-11-05T04: 05: 09.837Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"definición": {
			"nombre": {},
			"Descripción": {}
			},
			"OBJECTTYPE": "Actividad"
			}
			}

Declaración de golf intento de (auto)

			2014-11-05T04: 05: 10.555
			Joe King experimentó 'Page 1'
			{
			"Id": "3ed638c0-a422-41e5-b7d7-42bf43e59b39",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/experienced",
			"monitor": {
			"En-US": "experimentado"
			}
			},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			],
			"Padre": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 08.506Z",
			"Almacenado": "2014-11-05T04: 05: 10.555Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/a001_page_1.html",
			"definición": {
			"nombre": {
			"En-US": "Página 1"
			}
			},
			"OBJECTTYPE": "Actividad"
			}
		}

Pasado / Declaración de Error en la prueba A (automático)

2014-11-05T04: 05: 21.783
			Joe King falló Prueba 1 'con la puntuación de 50
			{
			"Id": "1820c7e8-6509-4c45-B672-af7ae301ec40",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/failed",
			"monitor": {
			"En-US": "fallido"
			}
			},
			"Resultado": {
			"Puntuación": {
			"En bruto": 50,
			"Min": 0,
			"Max": 100
			},
			"Éxito": false,
			"Finalización": false
			},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			],
			"Padre": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 20.030Z",
			"Almacenado": "2014-11-05T04: 05: 21.783Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Test%201",
			"definición": {
			"nombre": {
			"En-US": "Prueba 1"
			}
			},
			"OBJECTTYPE": "Actividad"
			}
		}

Declaración pregunta respondida (automático)

2014-11-05T04: 05: 36.251
			Joe King respondió correctamente 'Mi Pregunta de prueba 1' con una respuesta 'verdadera'
			{
			"Id": "a8af22bf-8e38-447c-8e6a-500c3673f867",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/answered",
			"monitor": {
			"En-US": "contestado"
			}
			},
			"Resultado": {
			"Éxito": true,
			"Respuesta": "true"
			},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			],
			"Padre": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 10.000Z",
			"Almacenado": "2014-11-05T04: 05: 36.251Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template-Question_1_67_1415160320014",
			"definición": {
			"Descripción": {
			"En-US": "Mi pregunta de la prueba 1"
			},
			"Type": "http://adlnet.gov/expapi/activities/cmi.interaction",
			"InteractionType": "verdadero o falso",
			"CorrectResponsesPattern": [
			"cierto"
			]
			},
			"OBJECTTYPE": "Actividad"
			}
			}

Declaración xapi personalizada según el extracto de xapi Acción

2014-11-05T04: 05: 34.803
			Joe King envió 'Custom-xapi-Norma'
			{
			"Id": "6a108ff9-1bcc-4bb0-9021-732fb7bad775",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/sent",
			"monitor": {
			"En-US": "enviado"
			}
			},
			"Resultado": {},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			],
			"Padre": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 32.376Z",
			"Almacenado": "2014-11-05T04: 05: 34.803Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template/Custom-xAPI-Statement",
			"definición": {
			"nombre": {
			"En-US": "Custom-xapi-Declaración"
			}
			},
			"OBJECTTYPE": "Actividad"
			}
		}

Pasado / Compld / Declaración curso no aprobado (automático)

2014-11-05T04: 05: 36.259
			Joe King pasó 'http://www.uniqueurl.com/xAPI%20Template' con la puntuación de 50
			{
			"Id": "6e8c000e-47d0-4b8c-842b-d9573422ce1b",
			"Actor": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"nombre": 
			"ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Verbo": {
			"Id": "http://adlnet.gov/expapi/verbs/passed",
			"monitor": {
			"En-US": "pasado"
			}
			},
			"Resultado": {
			"Puntuación": {
			"En bruto": 50,
			"Min": 0,
			"Max": 100
			},
			"Éxito": true,
			"Finalización": true,
			"Duración": "PT25.97S"
			},
			"Contexto": {
			"Registro": "61d426da-436a-4b2a-8daa-ce94f6082f2f",
			"contextActivities": {
			"Agrupación": [
			{
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			]
			}
			},
			"Marca de tiempo": "2014-11-05T04: 05: 33.714Z",
			"Almacenado": "2014-11-05T04: 05: 36.259Z",
			"autoridad": {
			"Name": "Joe King",
			"Cuenta": {
			"Página principal": "http://cloud.scorm.com/",
			"Name": "ZUASCUHYVJ|wieloch@trivantisboca.com"
			},
			"OBJECTTYPE": "Agente"
			},
			"Versión": "1.0.0",
			"Objeto": {
			"Id": "http://www.uniqueurl.com/xAPI%20Template",
			"OBJECTTYPE": "Actividad"
			}
			}