En este artículo, aprenderás cuándo y cómo proporcionar el actor mediante una cadena de consulta.

Una cadena de consulta es un conjunto de personajes que contiene los valores necesarios para realizar el seguimiento de un curso: el punto final del LRS (punto final), la autenticación (auth) y la información del alumno (actor). Los parámetros de la cadena de consulta se encuentran después del signo «?» en la URL de inicio.

Solo necesitas proporcionar el actor a través de una cadena de consulta si se cumplen las dos condiciones siguientes:

• Se selecciona la opción Suministrado mediante URL de inicio para la sección Actor
• El curso no está publicado para un LMS xAPI o cmi5

¿Cómo proporcionar el actor mediante una cadena de consulta

Instala la actualización de noviembre de 2021 o una versión posterior y, a continuación, sigue los pasos que se indican a continuación, en función de si necesitas hacer referencia a un actor específico o a otros actores.

Nota: Hemos creado esta guía de pruebas de lanzamiento del LRS para simplificar el proceso de formatear y probar la cadena de consulta. No está pensada para trabajos de producción en directo.

Actor específico

Sigue estos pasos para probar la cadena de consulta para un actor específico.

1. Publique su curso para LMS/LRS y, a continuación, haga clic en Abrir en la ventana Publicación correcta. Se abrirá un visor de archivos en el que podrá ver los archivos que Storyline 360 acaba de crear.
2. Vaya a la guía de pruebas de lanzamiento del LRS, haga clic con el botón derecho en cualquier parte de la página y seleccione Guardar como para descargar la página como un archivo HTML en su ordenador.
3. Mueva el archivo HTML de muestra de lanzamiento del LRS a la carpeta que contiene el resultado publicado del paso 1.
4. Abra el archivo HTML de muestra de lanzamiento del LRS en una ventana del navegador y, a continuación, seleccione el formato de cadena de consulta e introduzca los detalles del punto final, la autenticación y el actor del LRS.
5. Haga clic en el botón Probar para iniciar el curso en su LRS. En este punto, pruebe su curso como alumno para enviar datos de ida y vuelta al LRS.

Diferentes actores

Cuando necesite el JavaScript de soporte para proporcionar diferentes actores a través de una cadena de consulta en un trabajo de producción en vivo, utilice este enfoque. Elige entre dos formatos de cadenas de consulta (Storyline o xAPI) para generar un enlace a tu contenido con un actor para el alumno actual. Utilice cualquier formato de cadena de consulta, excepto cuando publique tanto para un LMS XAPI/CMI5 como para un LRS. Para este escenario, recomendamos usar el formato de cadena de consulta Storyline para evitar problemas.

Formato de cadena de consulta Storyline

Para el formato de cadena de consulta de Storyline, comparte este código con tu administrador del LRS, ya que es el que está mejor preparado para configurar tu LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (nombre, correo electrónico) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 
 name: 
 name}; 
 
 var isEmpty = function (value) {
if (value) {
return true;
} 
 if (value.length === 0) {
return true;
} 
 if (typeof value === 'object' && Object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formatsLXapiQueryString = function (actor, punto final, autenticación) {
var slxApi = {}; 
 
 if (! isEmpty (actor)) {slxAPI.actor = actor;} if (! 
 
 
 isEmpty (punto final) {
slxAPI.endpoint = punto final;} if (! 
 
 isEmpty (auth)) {
slxAPI.auth = auth;
} 
 
 if (isEmpty (slxAPI)) {return «;} 
 return 'slxapi=' + encodeURIComponent (JSON.stringify (SLXAPI));
}
; 
 
 /* 
 
 Uso: 
 var actor = formatActor ('my-name', 'name@email.com'); 
 var auth = toBasicAuth ('key', 'secret'); var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatSLXApiQueryString (actor, punto final, autenticación); window.open ('http://path-to-content/story.html?' + queryString); */ 
 
 
 
 

Formato de cadena de consulta xAPI

Para el formato de cadena de consulta xAPI, comparte este código con tu administrador del LRS, ya que es el que está mejor preparado para configurar tu LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (nombre, correo electrónico) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 
 name: 
 name}; 
 
 var isEmpty = function (value) {
if (value) {
return true;
} 
 if (value.length === 0) {
return true;
} 
 if (typeof value === 'object' && Object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formattInCanQueryString = function (actor, punto final, autenticación) {
var params = []; 
 
 if (! isEmpty (actor)) {
params.push ('actor=' + encodeURIComponent (JSON.stringify (actor)));} if (! 
 
 isEmpty (punto final) {params.push ('punto final =' + punto final);} if (! 
 
 
 isEmpty (auth)) {
params.push ('auth=' + auth);} 
 
 return params.join ('&'); 

} 
 
 /* 
 
 Uso: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = toBasicAuth ('key', 'secret'); var endpoint = 'http://url-to-my-endpoint/'; var queryString = formatInCanQueryString ('key', 'secret'); 
 var endpoint = ''; 
 var queryString = formatInCanQueryString ('key', endpoint ') auth); window.open (' http://path-to-content/story.html? '+ queryString); */