W tym artykule dowiesz się, kiedy i jak dostarczyć aktorowi za pomocą ciągu zapytania.

Ciąg zapytania to zestaw znaków, który zawiera wartości wymagane do śledzenia kursu: punkt końcowy LRS (punkt końcowy), uwierzytelnianie (auth) i informacje o uczestniku (aktor). Parametry ciągu zapytania znajdują się po „?” w adresie URL uruchamiania.

Musisz podać aktora za pomocą ciągu zapytania tylko wtedy, gdy oba poniższe są prawdziwe:

• Opcja Dostarczone przez adres URL uruchamiania dla sekcji Aktor jest zaznaczona
• Kurs nie jest publikowany dla XAPI lub cmi5 LMS

Jak dostarczyć aktora za pomocą ciągu zapytania

Zainstaluj aktualizację z listopada 2021 r. lub nowszą, a następnie wykonaj poniższe czynności, w zależności od tego, czy musisz odwołać się do konkretnego aktora, czy do różnych aktorów.

Uwaga: Stworzyliśmy ten przewodnik LRS Launch Test, aby uprościć proces formatowania i testowania ciągu zapytania. Nie jest przeznaczony do produkcji na żywo.

Konkretny aktor

Wykonaj następujące kroki, aby przetestować ciąg zapytania dla określonego aktora.

1. Opublikuj swój kurs dla LMS/LRS, a następnie kliknij Otwórz w oknie Opublikuj pomyślnie. Otwiera to przeglądarkę plików, w której można zobaczyć właśnie utworzone pliki Storyline 360.
2. Przejdź do przewodnika LRS Launch Test, kliknij prawym przyciskiem myszy w dowolnym miejscu strony i wybierz Zapisz jako, aby pobrać stronę jako plik HTML na swój komputer.
3. Przenieś przykładowy plik HTML LRS Launch do folderu zawierającego opublikowane dane wyjściowe z kroku 1.
4. Otwórz przykładowy plik HTML LRS Launch w oknie przeglądarki, a następnie wybierz format ciągu zapytania i wprowadź szczegóły dotyczące punktu końcowego, uwierzytelniania i aktora LRS.
5. Kliknij przycisk Test, aby uruchomić kurs w swoim LRS. W tym momencie przetestuj swój kurs jako uczestnik, aby przesyłać dane tam iz powrotem do LRS.

Różni aktorzy

Jeśli potrzebujesz wspierającego JavaScript do dostarczania różnych aktorów za pomocą ciągu zapytania w pracy produkcyjnej na żywo, użyj tego podejścia. Wybierz jeden z dwóch formatów ciągów zapytań - Storyline lub XAPI - aby wygenerować link do treści z aktorem dla obecnego uczestnika. Użyj dowolnego formatu ciągu zapytania, z wyjątkiem publikacji zarówno dla XAPI/Cmi5 LMS, jak i LRS. W tym scenariuszu zalecamy użycie formatu ciągu zapytania Storyline, aby uniknąć problemów.

Format ciągu zapytania fabularnego

W przypadku formatu ciągu zapytania Storyline udostępnij ten kod administratorowi LRS, ponieważ jest on najlepiej przygotowany do konfiguracji LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (klucz +': '+ secret);
}; 
 
 var formatActor = funkcja (nazwa, e-mail) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 name: name
};}; 
 
 var isEmpty = funkcja (wartość) {
if (value == null) {return) {true;
} if (value.length === 0) {
return true;
} 
 if (typeof value === 'object' && object.keys (wartość) .length === 0) {
return true;
} 
 zwraca wartość false;}; 
 
 
 
 
 
var formatsLXapiQueryString = funkcja (aktor, punkt końcowy, auth) {var slxAPI = {}; if (! 
 
 
 iSEmpty (aktor)) {
SLXAPI.actor = aktor;} jeśli (! 
 
 iSEmpty (punkt końcowy)) {
slxAPI.endpoint = punkt końcowy;} jeśli (! 
 
 iSEmpty (auth)) {
slxAPI.auth = auth;
} 
 
 if (isEmpty (slxAPI)) {
return „;} zwraca 'slxapi=' + encodeURIComponent (json.stringify (slxAPI));
}
; 
 
 /* 
 
 Zastosowanie: 
 var actor = formatActor ('my-name', 'name@email.com'); var = auth ToBasicAuth ('key', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; var QueryString = formatsLXapiQueryString (aktor, punkt końcowy, auth); 
 window.open ('http://path-to-content/story.html?' + QueryString); */ 
 
 
 
 

Format ciągu zapytania XAPI

W przypadku formatu ciągu zapytania XAPI udostępnij ten kod administratorowi LRS, ponieważ jest on najlepiej przygotowany do konfiguracji LRS:

var toBasicAuth = function (key, secret) {
return 'Basic '+ btoa (klucz +': '+ secret);
}; 
 
 var formatActor = funkcja (nazwa, e-mail) {
return {
mbox: 'mailto:' + email, 
 objectType: 'Agent', 
 name: name
};}; 
 
 var isEmpty = funkcja (wartość) {
if (value == null) {return) {true;
} if (value.length === 0) {
return true;
} 
 if (typeof value === 'object' && object.keys (wartość) .length === 0) {
return true;
} 
 zwraca wartość false;}; 
 
 
 
 
 
var formAttinCanQueryString = funkcja (aktor, punkt końcowy, auth) {
var params = []; if (! 
 
 iSEmpty (aktor)) {
params.push ('actor=' + encodeURIComponent (json.stringify (aktor)));} jeśli (! 
 
 iSEmpty (punkt końcowy)) {
params.push ('endpoint=' + punkt końcowy);} jeśli (! 
 
 isEmpty (auth)) {
params.push ('auth=' + auth);
} 
 
 zwraca params.join ('&');
} 
 
 /* 
 
 Zastosowanie: 
 var actor = formatActor ('my-name', 'name@email.com'); var auth = ToBasicAuth ('key', 'secret'); 
 var endpoint = 'http://url-to-my-endpoint/'; 
 var queryString = formattinCanQueryString (aktor, punkt końcowy, auth); 
 window.open ('http://path-to-content/story.html?' + QueryString); */