In questo articolo imparerai quando e come fornire l'attore tramite una stringa di query.

Una stringa di query è un insieme di personaggi che contiene i valori necessari per tracciare un corso: l'endpoint LRS (endpoint), l'autenticazione (auth) e le informazioni sull'allievo (attore). I parametri della stringa di query si trovano dopo il «?» nell'URL di avvio.

È necessario fornire l'attore tramite una stringa di query solo quando entrambe le seguenti condizioni sono vere:

• L'opzione Fornito tramite URL di avvio per la sezione Attore è selezionata
• Il corso non è pubblicato per un LMS xAPI o cmi5

Come fornire l'attore tramite una stringa di query

Installa l'aggiornamento di novembre 2021 o successivo, quindi segui i passaggi seguenti, a seconda che tu debba fare riferimento a uno o più attori specifici.

Nota: abbiamo creato questa guida LRS Launch Test per semplificare il processo di formattazione e test della stringa di query. Non è pensato per lavori di produzione dal vivo.

Attore specifico

Segui questi passaggi per testare la stringa di query per un attore specifico.

1. Pubblica il tuo corso per LMS/LRS, quindi fai clic su Apri nella finestra Pubblicazione avvenuta con successo. Si apre un visualizzatore di file in cui è possibile visualizzare i file Storyline 360 appena creati.
2. Vai alla guida LRS Launch Test, fai clic con il pulsante destro del mouse in un punto qualsiasi della pagina e seleziona Salva con nome per scaricare la pagina come file HTML sul tuo computer.
3. Spostate il file HTML LRS Launch Sample nella cartella che contiene l'output pubblicato del passaggio 1.
4. Aprite il file HTML di esempio di LRS Launch Sample in una finestra del browser, quindi selezionate il formato della stringa di query e inserite i dettagli per l'endpoint, l'autenticazione e l'attore del vostro LRS.
5. Fate clic sul pulsante Test per avviare il corso nel vostro LRS. A questo punto, testate il vostro corso come allievo per inviare dati avanti e indietro al LRS.

Attori diversi

Se hai bisogno del supporto di JavaScript per fornire diversi attori tramite una stringa di query nei lavori di produzione dal vivo, usa questo approccio. Scegli tra due formati di stringhe di query, Storyline o xAPI, per generare un link ai tuoi contenuti con un attore per l'allievo corrente. Utilizza entrambi i formati di stringa di query, tranne quando si pubblica sia per un LMS XAPI/CMI5 che per LRS. In questo scenario, consigliamo di utilizzare il formato di stringa di query Storyline per evitare problemi.

Formato della stringa di interrogazione Storyline

Per il formato di stringa di interrogazione Storyline, condividete questo codice con il vostro amministratore LRS, che è in grado di configurare al meglio il vostro LRS:

var toBasicAuth = function (key, secret) {
return 'Basic' + btoa (chiave + ':' + segreto);
}; 
 
 var formatActor = function (nome, email) {
return {
mbox: 'mailto: '+ email, 
 ObjectType:' Agente ', 
 nome: nome
};
}; 
 
 var isEmpty = function (valore) {
if (valore == null) {
return true;}; 
 var isEmpty = function (valore) {
if (valore == null) {
return true;
} 
 if (value.length === 0) {return true;} if (tipo di valore ===' oggetto '&& object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formatSLXAPIQueryString = funzione (attore, endpoint, autenticazione) {
var slxAPI = {}; 
 
 if (! isEmpty (actor)) {slxAPI.actor = actor;} if (! 
 
 
 isEmpty (endpoint)) {
slxAPI.endpoint = endpoint;} if (! 
 
 isEmpty (auth)) {
slxAPI.auth = auth;
} 
 
 if (isEmpty (slxAPI)) {
return «;} return 'slxapi=' + encodeURIComponent (json.stringify (slxAPI));
}
; 
 
 /* 
 
 Utilizzo: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = toBasicAuth ('chiave', 'segreto'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatSLXAPIQueryString (attore, endpoint, autenticazione); window.open ('http://path-to-content/story.html?' + queryString); */ 
 
 
 
 

Formato della stringa di interrogazione xAPI

Per il formato di stringa di query xAPI, condividete questo codice con il vostro amministratore LRS, che è in grado di configurare al meglio il vostro LRS:

var toBasicAuth = function (key, secret) {
return 'Basic' + btoa (chiave + ':' + segreto);
}; 
 
 var formatActor = function (nome, email) {
return {
mbox: 'mailto: '+ email, 
 ObjectType:' Agente ', 
 nome: nome
};
}; 
 
 var isEmpty = function (valore) {
if (valore == null) {
return true;}; 
 var isEmpty = function (valore) {
if (valore == null) {
return true;
} 
 if (value.length === 0) {return true;} if (tipo di valore ===' oggetto '&& object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formattIncanQueryString = funzione (attore, endpoint, autenticazione) {
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 ('&');
} 
 
 /* 
 
 Utilizzo: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = toBasicAuth ('chiave', 'segreto'); 
 var endpoint = 'http://url-to-my-endpoint/'; var queryString = formattIncanQueryString = (attore, endpoint, autenticazione); 
 window.open ('http://path-to-content/story.html?' + queryString); 
 */