In dit artikel leest u wanneer en hoe u de actor via een queryreeks kunt aanleveren.

Een queryreeks is een set tekens die de waarden bevat die vereist zijn om een cursus bij te houden: het LRS-eindpunt (eindpunt), de authenticatie (auth) en de cursistinformatie (actor). De parameters van de queryreeks bevinden zich achter de „?” in de start-URL.

U hoeft de actor alleen via een queryreeks aan te leveren als beide van de volgende punten waar zijn:

• De optie Geleverd via start-URL voor de sectie Actor is geselecteerd
• De cursus is niet gepubliceerd voor een xAPI of cmi5 LMS

Hoe de acteur te bevoorraden via een queryreeks

Installeer de update van november 2021 of later en volg daarna de onderstaande stappen, afhankelijk van of je naar een specifieke actor of naar verschillende actoren moet verwijzen.

Opmerking: We hebben deze LRS Launch Test-handleiding gemaakt om het formatteren en testen van uw queryreeks te vereenvoudigen. Het is niet bedoeld voor live productiewerk.

Specifieke acteur

Volg deze stappen om je queryreeks te testen voor een specifieke actor.

1. Publiceer je cursus voor LMS/LRS en klik vervolgens op Openen in het venster Succesvol publiceren. Dit opent een bestandsviewer waarin je de bestanden kunt zien die Storyline 360 zojuist heeft gemaakt.
2. Ga naar de LRS Launch Test-handleiding, klik met de rechtermuisknop ergens op de pagina en selecteer Opslaan als om de pagina als HTML-bestand op uw computer te downloaden.
3. Verplaats het LRS Launch Sample HTML-bestand naar de map die uw gepubliceerde uitvoer uit stap 1 bevat.
4. Open het LRS Launch Sample HTML-bestand in een browservenster, selecteer vervolgens de indeling van de queryreeks en voer de gegevens in voor het eindpunt, de authenticatie en de actor van uw LRS.
5. Klik op de knop Toetsen om de cursus in je LRS te starten. Test nu je cursus als cursist om gegevens heen en weer te sturen naar het LRS.

Verschillende acteurs

Als u het ondersteunende JavaScript nodig hebt voor het aanleveren van verschillende actoren via een queryreeks in live productiewerk, gebruik dan deze aanpak. Kies uit twee querytekenreeksindelingen — Storyline of xAPI — om een link naar je inhoud te genereren met een acteur voor de huidige cursist. Gebruik beide queryreeksindelingen, behalve wanneer u publiceert voor zowel een XAPI/CMI5 LMS als een LRS. In dit scenario raden we aan om de tekenreeksindeling Storyline te gebruiken om problemen te voorkomen.

Storyline Query String-indeling

Voor de indeling van de Storyline-queryreeks moet u deze code delen met uw LRS-beheerder, aangezien deze het best is uitgerust om uw LRS te configureren:

var toBasicAuth = functie (sleutel, geheim) {
return 'Basic' + btoa (key + ':' + secret);
}; 
 
 var formatActor = functie (naam, e-mailadres) {
return {
mbox: 'mailto: '+ email, 
 objectType:' Agent ', 
 naam: naam
};}; 
 
 var isEmpty = functie (waarde) {if (value == null) {return true;
} 
 if value e.length === 0) {
return true;
} 
 if (typeof value ===' object '&& object.keys (waarde) .length === 0) {
return true;
} 
 geeft false terug;}; 
 
 
 
 
 
var formatsLxAPIQueryString = functie (actor, eindpunt, auth) {
var slxAPI = {}; if (! 
 
 IsEmpty (acteur) {
SLXAPI.actor = acteur;} if (! 
 
 isEmpty (eindpunt)) {
SLXAPI.endpoint = eindpunt;} if (! 
 
 isEmpty (auth)) {
slxapi.auth = auth;
} 
 
 if (IsEmpty (slxAPI)) {
return „;} retourneer 'slxapi=' + encodeURIComponent (JSON.stringify (slxAPI));
}
; 
 
 /* 
 
 Gebruik: 
 var actor = formatActor ('mijnnaam', 'name@email.com'); var auth = toBasicAuth ('key', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatSLXAPIQueryString (actor, eindpunt, auth); window.open ('http://path-to-content/story.html?' + queryString); */ 
 
 
 
 

xAPI-querytekenreeksindeling

Deel deze code voor de xAPI-queryreeksindeling met uw LRS-beheerder, aangezien deze het best is uitgerust om uw LRS te configureren:

var toBasicAuth = functie (sleutel, geheim) {
return 'Basic' + btoa (key + ':' + secret);
}; 
 
 var formatActor = functie (naam, e-mailadres) {
return {
mbox: 'mailto: '+ email, 
 objectType:' Agent ', 
 naam: naam
};}; 
 
 var isEmpty = functie (waarde) {if (value == null) {return true;
} 
 if value e.length === 0) {
return true;
} 
 if (typeof value ===' object '&& object.keys (waarde) .length === 0) {
return true;
} 
 geeft false terug;}; 
 
 
 
 
 
var formattInCanQueryString = functie (actor, eindpunt, auth) {
var params = []; if (! 
 
 isEmpty (acteur)) {
params.push ('actor=' + encodeURIComponent (JSON.stringify (acteur)));} if (! 
 
 isEmpty (eindpunt) {
params.push ('endpoint=' + eindpunt);} if (! 
 
 isEmpty (auth)) {
params.push ('auth=' + auth);
} 
 
 return params.join ('&');
} 
 
 /* 
 
 Gebruik: 
 var actor = formatActor ('mijnnaam', 'name@email.com'); var auth = toBasicAuth ('key', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formattIncAnqueryString (actor, eindpunt, auth); 
 window.open ('http://path-to-content/story.html?' + QueryString); */