Neste artigo, você aprenderá quando e como fornecer o ator por meio de uma string de consulta.

Uma sequência de caracteres de consulta é um conjunto de caracteres que contém os valores necessários para monitorar um curso: o endpoint do LRS (endpoint), a autenticação (auth) e as informações do aluno (ator). Os parâmetros da sequência de caracteres de consulta estão localizados após o “?” no URL de lançamento.

Você só precisa fornecer o ator por meio de uma string de consulta quando as duas opções a seguir forem verdadeiras:

• A opção Fornecido via URL de lançamento para a seção Ator está selecionada
• O curso não foi publicado para um LMS xAPI ou cmi5

Como fornecer o ator por meio de uma string de consulta

Instale a atualização de novembro de 2021 ou posterior e siga as etapas abaixo, dependendo se você precisa fazer referência a um ator específico ou a atores diferentes.

Observação: criamos este guia do LRS Launch Test para simplificar o processo de formatação e teste de sua sequência de caracteres de consulta. Não se destina ao trabalho de produção ao vivo.

Ator específico

Siga estas etapas para testar sua string de consulta para um ator específico.

1. Publique seu curso para LMS/LRS e clique em Abrir na janela Publicação bem-sucedida. Isso abre um visualizador de arquivos onde você pode ver os arquivos que o Storyline 360 acabou de criar.
2. Acesse o guia do LRS Launch Test, clique com o botão direito do mouse em qualquer lugar da página e selecione Salvar como para baixar a página como um arquivo HTML no seu computador.
3. Mova o arquivo HTML de amostra do LRS Launch para a pasta que contém a saída publicada da etapa 1.
4. Abra o arquivo HTML de amostra do LRS Launch em uma janela do navegador, selecione o formato da sequência de caracteres de consulta e insira os detalhes do endpoint, da autenticação e do ator do LRS.
5. Clique no botão Testar para iniciar o curso em seu LRS. Neste momento, teste seu curso como aluno para enviar e receber dados para o LRS.

Atores diferentes

Quando você precisar do suporte de JavaScript para fornecer diferentes atores por meio de uma string de consulta em trabalhos de produção ao vivo, use essa abordagem. Escolha entre dois formatos de sequência de caracteres de consulta — Storyline ou xAPI — para gerar um link para seu conteúdo com um ator para o aluno atual. Use qualquer um dos formatos de sequência de caracteres de consulta, exceto ao publicar para um LMS xAPI/CMI5 e um LRS. Para esse cenário, recomendamos usar o formato de sequência de caracteres de consulta Storyline para evitar problemas.

Formato de string de consulta Storyline

Para o formato de sequência de caracteres de consulta Storyline, compartilhe esse código com seu administrador do LRS, pois eles estão mais bem equipados para configurar seu LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (nome, e-mail) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 nome: nome
};}; 
 
 var isEmpty = function (value) {if (value == null) {return true;
} 
 if (value.length === 0) {
return true;
} 
 if (type of value === 'object' && Object.keys (value) .length === 0) {
return true;
} 
 return false;}; 
 
 
 
 
 
var formatsLXAPIQueryString = function (ator, endpoint, auth) {var slxAPI = {}; if (! 
 
 
 isEmpty (actor)) {
slxAPI.actor = ator;} if (! 
 
 isEmpty (endpoint)) {
slxAPI.endpoint = endpoint;} if (! 
 
 isEmpty (auth)) {
slxapi.auth = auth;
} 
 
 if (isEmpty (slxAPI)) {
return “;} return 'slxapi=' + encodeUriComponent (json.stringify (slxAPI));
}
; 
 
 /* 
 
 Uso: 
 var actor = formatActor ('meu-nome', 'name@email.com'); 
 var auth = toBasicAuth ('key', 'secret'); var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatsLXAPIQueryString (ator, endpoint, autenticação); window.open ('http://path-to-content/story.html?' + queryString); */ 
 
 
 
 

Formato de cadeia de caracteres de consulta xAPI

Para o formato de sequência de caracteres de consulta xAPI, compartilhe esse código com seu administrador do LRS, pois eles estão melhor equipados para configurar seu LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (nome, e-mail) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 nome: nome
};}; 
 
 var isEmpty = function (value) {if (value == null) {return true;
} 
 if (value.length === 0) {
return true;
} 
 if (type of value === 'object' && Object.keys (value) .length === 0) {
return true;
} 
 return false;}; 
 
 
 
 
 
var formattinCanqueryString = function (ator, endpoint, auth) {
var params = []; if (! 
 
 isEmpty (actor)) {
params.push ('actor=' + encodeURIComponent (json.stringify (actor)));} if (! 
 
 isEmpty (endpoint)) {
params.push ('endpoint=' + endpoint);} 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 = formattinCanqueryString (actor, endpoint, auth); window.open ('http://path-to-content/story.html?' + queryString); 
 */