Chapitre 13.1 — Cheatsheets

⏱️ TL;DR — Le condensé de tout le cours, en tableaux et blocs de code à balayer d’un regard : le modèle de données SCORM 1.2 et 2004 avec leurs méthodes d’API (LMSInitialize vs Initialize), le squelette d’un statement xAPI (actor / verb / object / result / context), les cinq paramètres de lancement cmi5 et ses verbes imposés, enfin les claims d’un id_token LTI 1.3 et l’objet Score d’AGS. Tout est résumé : pour la valeur exacte ou la version courante, remonte à adlnet.gov (ADL) ou 1edtech.org (1EdTech).

🎯 Objectifs

• Retrouver en un coup d’œil le bon champ, la bonne méthode, le bon verbe.
• Comparer côte à côte SCORM 1.2 et 2004 (données + API).
• Réciter le squelette d’un statement et les claims d’un lancement LTI.
• Garder sous la main les valeurs autorisées (statuts, moveOn, activityProgress…).

(a) SCORM — modèle de données & API

SCORM 1.2 — modèle de données (extraits)

SCORM 2004 — modèle de données (extraits)

⚠️ Piège — La différence structurelle entre 1.2 et 2004 : en 1.2, cmi.core.lesson_status mélange « fini » et « réussi » ; en 2004, complétion (cmi.completion_status) et réussite (cmi.success_status) sont deux champs distincts. Porter un contenu 1.2 vers 2004 sans dédoubler ce statut est le bug de migration classique (voir Partie 5).

Méthodes d’API — 1.2 vs 2004

L’objet JavaScript exposé par le LMS s’appelle API en 1.2 et API_1484_11 en 2004. On le trouve en remontant window.parent puis window.opener (« find the API »).

💡 Réflexe — Toutes les méthodes qui n’ont « rien » à transmettre prennent une chaîne vide "", pas null ni rien du tout : LMSInitialize(""), Commit(""). Et on termine toujours par LMSFinish("") / Terminate("") : c’est l’appel qui déclenche l’enregistrement final côté LMS. L’oublier = un SCO qui « marche » mais ne remonte rien (Partie 4).

(b) xAPI — squelette d’un statement

Trois champs obligatoires — actor, verb, object — le reste est optionnel ou posé par le LRS.

{
  "actor": {
    "objectType": "Agent",
    "mbox": "mailto:apprenant@exemple.fr"
  },
  "verb": {
    "id": "http://adlnet.gov/expapi/verbs/completed",
    "display": { "fr-FR": "a terminé" }
  },
  "object": {
    "objectType": "Activity",
    "id": "https://exemple.fr/xapi/activities/module-1",
    "definition": {
      "name": { "fr-FR": "Module 1" },
      "type": "http://adlnet.gov/expapi/activities/course"
    }
  },
  "result": {
    "score": { "scaled": 0.9, "raw": 45, "min": 0, "max": 50 },
    "success": true,
    "completion": true,
    "duration": "PT30M"
  },
  "context": {
    "registration": "UUID-de-la-tentative",
    "contextActivities": {
      "parent": [{ "id": "https://exemple.fr/xapi/activities/parcours" }]
    }
  },
  "timestamp": "2026-03-14T10:45:00+01:00"
}

Verbes ADL fréquents (à réutiliser, jamais inventer) : http://adlnet.gov/expapi/verbs/ suivi de completed, experienced, attempted, passed, failed, answered.

API du LRS (REST) : statements (PUT/POST/GET), activities/state, activities/profile, agents/profile, about. En-tête obligatoire : X-Experience-API-Version. Auth : Basic ou OAuth.

⚠️ Piège — C’est l’id (l’IRI) du verbe qui l’identifie, pas le display. Deux statements de même verb.id parlent du même verbe, que l’un affiche « a terminé » et l’autre « completed ». Ne bricole jamais l’identité d’un verbe via son libellé.

(c) cmi5 — lancement & verbes

Les cinq paramètres d’URL de lancement

Le LMS ouvre l’URL de l’AU en y greffant ces paramètres (URL-encodés) :

L’AU POSTe fetch → reçoit { "auth-token": "…" }, puis lit ses données de lancement dans le state LMS.LaunchData (State API) : launchMode (Normal / Browse / Review), masteryScore, moveOn, returnURL, contextTemplate.

Les verbes cmi5

Les statements ci-dessus sont « cmi5 defined » ; les autres statements libres émis par l’AU sont « cmi5 allowed ».

Les valeurs de moveOn

Condition qui décide quand l’apprenant a « satisfait » l’AU :

💡 Réflexe — Ordre non négociable au lancement : (1) lire les paramètres d’URL, (2) POSTer fetch → jeton, (3) lire LMS.LaunchData, (4) ensuite envoyer initialized. Et l’AU ne « satisfait » (completed/passed/failed) que en launchMode: "Normal" — jamais en Browse ni Review (Partie 8).

(d) LTI 1.3 — claims & objet Score (AGS)

Claims d’un id_token de lancement

Claims LTI namespacés sous https://purl.imsglobal.org/spec/lti/claim/ (ici avec le suffixe seul) :

Claims OIDC standard (hors namespace LTI) : iss (la plateforme), aud (= ton client_id), sub (identité stable de l’utilisateur), exp, iat, nonce, et si partagés name, email.

⚠️ Piège — La clé d’un apprenant, c’est sub + iss, pas l’e-mail (facultatif, changeant, parfois non partagé). Et on lit ces claims après avoir validé la signature du JWT via le JWKS de la plateforme.

Objet Score d’AGS — POST {lineitem}/scores

Type de média : application/vnd.ims.lis.v1.score+json. Scope requis : https://purl.imsglobal.org/spec/lti-ags/scope/score.

{
  "userId": "u-2342",
  "scoreGiven": 17,
  "scoreMaximum": 20,
  "activityProgress": "Completed",
  "gradingProgress": "FullyGraded",
  "timestamp": "2026-05-12T14:32:05.000Z",
  "comment": "Bravo. Revois la question 7."
}

Endpoint AGS (claim https://purl.imsglobal.org/spec/lti-ags/claim/endpoint) : lineitems (conteneur, GET/POST), lineitem (une colonne), et scope. Trois scopes : .../lti-ags/scope/lineitem (gérer les colonnes), .../lti-ags/scope/score (publier), .../lti-ags/scope/result.readonly (lire les results).

🧭 Sur FormaCampus — Ces quatre encadrés sont exactement les mémos que le studio de FormaCampus garde ouverts pendant une intégration : un pour débuguer un SCO (colonne API 1.2/2004), un pour vérifier un statement, un pour un lancement cmi5, un pour un renvoi de note. Copie, adapte, livre.

📚 La spec — SCORM (RTE, modèle CMI, API), xAPI (structure du statement, LRS) et cmi5 (lancement, verbes, moveOn) sur adlnet.gov (xAPI 2.0 = norme IEEE 9274.1.1). LTI 1.3, ses claims et AGS sur 1edtech.org. Les cheatsheets résument — la source tranche.

Chapitre suivant : 13.2 — Modèles prêts à l’emploi — les squelettes complets à copier-coller et adapter.