Dans cet article, vous allez apprendre quand et comment fournir l'acteur via une chaîne de requête.

Une chaîne de requête est un ensemble de personnages contenant les valeurs requises pour suivre un module : le point de terminaison LRS (point de terminaison), l'authentification (authentification) et les informations sur l'apprenant (acteur). Les paramètres de la chaîne de requête sont situés après le « ? » dans l'URL de lancement.

Vous devez uniquement fournir l'acteur via une chaîne de requête lorsque les deux conditions suivantes sont vraies :

• L'option Fourni via une URL de lancement pour la section Actor est sélectionnée.
• Le module n'est pas publié pour un XAPI ou un LMS cmi5

Comment fournir l'acteur via une chaîne de requête

Installez la mise à jour de novembre 2021 ou une version ultérieure, puis suivez les étapes ci-dessous, selon que vous devez faire référence à un acteur spécifique ou à différents acteurs.

Remarque : Nous avons créé ce guide de test de lancement du LRS pour simplifier le processus de formatage et de test de votre chaîne de requête. Il n'est pas destiné à la production en direct.

Acteur spécifique

Procédez comme suit pour tester votre chaîne de requête pour un acteur spécifique.

1. Publiez votre module pour LMS/LRS, puis cliquez sur Ouvrir dans la fenêtre Publier avec succès. Cela ouvre un visualiseur de fichiers dans lequel vous pouvez voir les fichiers que Storyline 360 vient de créer.
2. Accédez au guide de test de lancement du LRS, cliquez avec le bouton droit de la souris n'importe où sur la page et sélectionnez Enregistrer sous pour télécharger la page sous forme de fichier HTML sur votre ordinateur.
3. Déplacez le fichier HTML d'exemple de lancement du LRS vers le dossier contenant le résultat publié à l'étape 1.
4. Ouvrez le fichier HTML d'exemple de lancement du LRS dans une fenêtre de navigateur, puis sélectionnez le format de chaîne de requête et entrez les détails relatifs au point de terminaison, à l'authentification et à l'acteur de votre LRS.
5. Cliquez sur le bouton Test pour lancer le module dans votre LRS. À ce stade, testez votre module en tant qu'apprenant pour envoyer des données dans les deux sens au LRS.

Différents acteurs

Lorsque vous avez besoin du JavaScript compatible pour fournir différents acteurs via une chaîne de requête dans le cadre d'une production en direct, utilisez cette approche. Choisissez l'un des deux formats de chaîne de requête (Storyline ou xAPI) pour générer un lien vers votre contenu avec un acteur pour l'apprenant actuel. Utilisez l'un ou l'autre format de chaîne de requête, sauf lors de la publication pour un LMS XAPI/CMI5 et un LRS. Pour ce scénario, nous vous recommandons d'utiliser le format de chaîne de requête Storyline pour éviter tout problème.

Format de chaîne de requête Storyline

Pour le format de chaîne de requête Storyline, partagez ce code avec votre administrateur LRS, car il est le mieux équipé pour configurer votre LRS :

var ToBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +' : '+ secret) ;
} ; 
 
 var FormatActor = function (nom, e-mail) {
return {
mbox : 'mailto :' + email, 
 objectType : 'Agent', 
 nom : nom
} ; 
 
 var isEmpty = function (valeur) {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 = fonction (acteur, point de terminaison, authentification) {
var SLXAPI = {} ; if (! 
 
 isEmpty (acteur) {
slxapi.actor = acteur ;} if (! 
 
 isEmpty (point de terminaison) {
slxapi.point de terminaison = point de terminaison ;} si (! 
 
 isEmpty (auth)) {
slxapi.auth = auth ;
} 
 
 if (isEmpty (slxAPI)) {
return « ;} return 'slxapi=' + encodeURIComponent (JSON.stringify (SLXApi)) ;
} 
 ; 
 
 /* 
 
 Utilisation : 
 var actor = FormatActor ('mon-nom', 'name@email.com') ; var auth = ToBasicAuth ('clé', 'secret') ; 
 var endpoint = 'http://url-to-my-endpoint/' ; var QueryString = formatSLXAPIqueryString (acteur, point de terminaison, authentification) ; 
 window.open ('http://path-to-content/story.html ?' + QueryString) ; */ 
 
 
 
 

Format de chaîne de requête xAPI

Pour le format de chaîne de requête xAPI, partagez ce code avec votre administrateur LRS, car il est le mieux équipé pour configurer votre LRS :

var ToBasicAuth = function (key, secret) {
return 'Basic '+ btoa (key +' : '+ secret) ;
} ; 
 
 var FormatActor = function (nom, e-mail) {
return {
mbox : 'mailto :' + email, 
 objectType : 'Agent', 
 nom : nom
} ; 
 
 var isEmpty = function (valeur) {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 = fonction (acteur, point de terminaison, authentification) {
var params = [] ; if (! 
 
 isEmpty (acteur)) {
params.push ('actor=' + encodeURIComponent (JSON.stringify (acteur))) ;} if (! 
 
 isEmpty (point de terminaison)) {
params.push ('endpoint=' + point de terminaison) ;} if (! 
 
 isEmpty (auth)) {
params.push ('auth=' + auth) ;
} 
 
 return params.join ('&') ;
} 
 
 /* 
 
 Utilisation : 
 var actor = FormatActor ('mon-name', 'name@email.com') ; var auth = toBasicAuth ('key', 'secret') ; 
 var endpoint = 'http://url-to-my-endpoint/' ; 
 var QueryString = FormatTincanQueryString (acteur, point de terminaison, auth) ; window.open ('http://path-to-content/story.html ?' + QueryString) ; 
 */