In diesem Artikel erfahren Sie, wann und wie Sie den Akteur über eine Abfragezeichenfolge angeben.

Eine Abfragezeichenfolge besteht aus einer Reihe von Zeichen, die die für die Nachverfolgung eines Kurses erforderlichen Werte enthalten: den LRS-Endpunkt (Endpunkt), die Authentifizierung (Auth) und die Teilnehmerinformationen (Akteur). Die Parameter der Abfragezeichenfolge befinden sich hinter dem „?“ in der Start-URL.

Sie müssen den Akteur nur dann über eine Abfragezeichenfolge angeben, wenn beide der folgenden Bedingungen zutreffen:

• Die Option Per Start-URL bereitgestellt für den Bereich Akteur ist ausgewählt
• Der Kurs ist nicht für ein xAPI oder cmi5 LMS veröffentlicht

Wie gibt man den Actor über eine Abfragezeichenfolge an

Installieren Sie das Update vom November 2021 oder später und folgen Sie dann den nachstehenden Schritten, je nachdem, ob Sie auf einen bestimmten Schauspieler oder auf verschiedene Schauspieler verweisen müssen.

Hinweis: Wir haben diesen LRS Launch Test Guide erstellt, um das Formatieren und Testen Ihrer Abfragezeichenfolge zu vereinfachen. Es ist nicht für Live-Produktionsarbeiten gedacht.

Spezifischer Schauspieler

Gehen Sie wie folgt vor, um Ihre Abfragezeichenfolge für einen bestimmten Akteur zu testen.

1. Veröffentlichen Sie Ihren Kurs für LMS/LRS und klicken Sie dann im Fenster Veröffentlichung erfolgreich auf Öffnen. Dadurch wird ein Dateibetrachter geöffnet, in dem Sie die Dateien sehen können, die Storyline 360 gerade erstellt hat.
2. Gehen Sie zum LRS Launch Test Guide, klicken Sie mit der rechten Maustaste auf eine beliebige Stelle auf der Seite und Auswählen Sie Speichern unter, um die Seite als HTML-Datei auf Ihren Computer herunterzuladen.
3. Verschieben Sie die LRS Launch Sample HTML-Datei in den Ordner, der Ihre veröffentlichte Ausgabe aus Schritt 1 enthält.
4. Öffnen Sie die LRS Launch Sample HTML-Datei in einem Browserfenster, Auswählen Sie dann das Abfragezeichenfolgenformat aus und geben Sie die Details für den Endpunkt, die Authentifizierung und den Akteur Ihres LRS ein.
5. Klicken Sie auf die Schaltfläche Test, um den Kurs in Ihrem LRS zu starten. Testen Sie jetzt Ihren Kurs als Lernender, um Daten an das LRS hin und her zu senden.

Verschiedene Schauspieler

Wenn Sie in der Live-Produktion das unterstützende JavaScript für die Bereitstellung verschiedener Akteure über eine Abfragezeichenfolge benötigen, verwenden Sie diesen Ansatz. Wählen Sie aus zwei Abfragezeichenfolgenformaten — Storyline oder xAPI —, um einen Link zu Ihren Inhalten mit einem Schauspieler für den aktuellen Lernenden zu generieren. Verwenden Sie eines der beiden Abfragezeichenfolgenformate, außer wenn Sie sowohl für ein XAPI/CMI5-LMS als auch für LRS veröffentlichen. Für dieses Szenario empfehlen wir, das Storyline-Abfragezeichenfolgenformat zu verwenden, um Probleme zu vermeiden.

Storyline-Abfragezeichenfolgenformat

Teilen Sie diesen Code für das Storyline-Abfragezeichenfolgenformat mit Ihrem LRS-Administrator, da dieser am besten für die Konfiguration Ihres LRS gerüstet ist:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (name, email) {
return {
mbox: 'mailto:' + email, 
 ObjectType: 'Agent', 
 name: name
};
}; 
 
 var isEmpty = function (value) {
if (value == null) {
return true;
} 
 if (value) e.length === 0) {
return true;
} 
 if (typeof value === 'object' && object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formatsLxAPIQueryString = function (actor, endpoint, auth) {
var slxAPI = {}; 
 
 if (! isEmpty (Schauspieler)) {slxAPI.actor = Schauspieler;} if (! 
 
 
 isEmpty (Endpunkt)) {
slxApi.Endpoint = Endpunkt;} if (! 
 
 isEmpty (auth)) {
slxAPI.auth = auth;
} 
 
 if (isEmpty (slxAPI)) {
return „;} return 'slxapi=' + encodeURIComponent (json.stringify (slxAPI));
}
; 
 
 /* 
 
 Verwendung: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = toBasicAuth ('key (', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatsLxAPIQueryString (actor, endpoint, auth); window.open ('http://path-to-content/story.html?' + queryString); */ 
 
 
 
 

xAPI-Abfragezeichenfolgenformat

Teilen Sie diesen Code für das xAPI-Abfragezeichenfolgenformat mit Ihrem LRS-Administrator, da dieser am besten für die Konfiguration Ihres LRS gerüstet ist:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +': '+ secret);
}; 
 
 var formatActor = function (name, email) {
return {
mbox: 'mailto:' + email, 
 ObjectType: 'Agent', 
 name: name
};
}; 
 
 var isEmpty = function (value) {
if (value == null) {
return true;
} 
 if (value) e.length === 0) {
return true;
} 
 if (typeof value === 'object' && object.keys (value) .length === 0) {
return true;
} 
 return false;
}; 
 
var formattInCanQueryString = function (actor, endpoint, auth) {
var params = []; 
 
 if (! isEmpty (Akteur)) {
params.push ('actor=' + encodeURIComponent (json.stringify (Schauspieler)));} if (! 
 
 isEmpty (Endpunkt)) {params.push ('endpoint=' + endpoint);} if (! 
 
 
 isEmpty (auth)) {
params.push ('auth=' + auth);
} 
 
 return params.join ('&');
} 
 
 /* 
 
 Verwendung: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = toBasicAuth ('key', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formatIncAnQueryString (actor, endpoint, auth); window.open ('http://path-to-content/story.html?' + queryString); 
 */