L'API SCORM® 2004 se décompose en 3 groupes de méthodes.

  1. Gestion de la session
    • Initialize() : Cette méthode est utilisée pour initialiser la communication entre le SCO et le LMS. Tous les SCO doivent obligatoirement appeler cette méthode.
    • Terminate() : Cette méthode est appelée lors de la fermeture du SCO. C'est la dernière action réalisée par le SCO. Il n'y a pas de spécifications concernant l'action à réaliser lorsque le LMS reçoit la méthode Terminate(). En fonction des implémentations, soit c'est la dernière page du SCO qui reste affichée, soit le LMS reprend le contrôle. Dans tous les cas, si le SCO a lancé une nouvelle fenêtre, il a la responsabilité de la fermer après l'appel à la méthode Terminate().
    • Commit() : Cette méthode permet de forcer l'envoi des informations remontées par le SCO jusqu'au LMS. En effet, il se peut que certaines implémentations de l'API SCORM (c'est le cas de GANESHA) utilise un cache pour accélérer le transfert d'informations entre le SCO et le LMS. Cependant, la prise en compte de ces informations nécessitera de toute façon l'appel à la méthode Terminate().
  2. Méthodes de transfert
    • GetValue() : Cette méthode permet au SCO de lire des informations contenues dans le LMS. Le modèle de données utilisé lors de cet échange est appelé RTE Data Model.
    • SetValue() : Cette méthode permet au SCO de remonter des informations vers le LMS. Le modèle de données utilisé lors de cet échange est appelé RTE Data Model.
  3. Gestion des erreurs
    • GetLastError() : Lors d'un appel aux méthodes précédentes, le LMS peut vérifier si la dernière communication a engendré une erreur ou non. Cette méthode fournie un code Erreur défini par SCORM® 2004.
    • GetErrorString() : En cas d'erreur, le SCO peut récupérer via cette méthode un message pour le diffuser à l'apprenant.
    • GetDiagnostic() : Cette méthode permet de retourner un message d'erreur plus précis de la dernière erreur rencontrée par le LMS.

aa
Source : ANEMA SEG04



  • Code erreur
Le tableau ci-dessous liste les différents codes d'erreurs retournés par le LMS.

Catégorie des erreurs

Valeur

Description

Pas d’erreur

0

 

Erreurs Générales

100 – 199

Ces erreurs prennent en compte l’Etat de l’API lors des appels d’une méthode

Erreurs de syntaxe

200 – 299

Ces erreurs indiquent un mauvais paramètre passé à une méthode de l’API

Erreurs du LMS

300 – 399

Ces erreurs indiquent un disfonctionnement dans l’implémentation des méthodes GetValue() , SetValue() et Commit()

Erreurs du modèle de données

400 – 499

Ces erreurs prennent en compte tous les problèmes concernant l’utilisation des éléments du modèle de données

Erreurs spécifiques

1000 - 65535

 

Source : SCORM® 2004 3rd Edition Run-Time Environment (RTE) Version 1.0 RTE-4-19 ©2006 Advanced Distributed Learning