LRSDump 

LRSDump est un outil xAPI permettant d’extraire des données d’un LRS (Learning Record Store) afin de les utiliser avec des outils de BI (Business Intelligence) ou de Learning Analytics.

LRS

Télecharger Version 1.0.1 : Windows (64bit) Linux (64bit)

 Documentation LRSDump 

Utilisation selon le LRS

lrsdump [] [--=]

lrsdump -h to display Help

Exemples :

Avec Learning Locker:

Commande : lrsdump – since="2019-01-01 00:00:00"

Fichier conf.json
{
"endpoint": "https://saas.learninglocker.net/data/xAPI",
"username": "xxxxxxxxxxxxxxxxxxxxxxx",
"password": "xxxxxxxxxxxxxxxxxxxxxxx",
"outputDirectory": ".",
"OutputFormat": "CSV",
"Ascending": false,
"DayPerDayLoading": true,
"AnonymizeData": true,
"BatchSize": 500,
}
Avec SCORM Cloud

Commande : lrsdump

Fichier conf.json
{
"endpoint": "https://cloud.scorm.com/lrs/XXXXXXXXXX/",
"username": "xxxxxxxxxxxxxxxxxxxxxxx",
"password": "xxxxxxxxxxxxxxxxxxxxxxx",
"outputDirectory": ".",
"OutputFormat": "CSV",
}
Avec  Cornerstone On Demand CSOD

Commande : lrsdump

Fichier conf.json
{
"endpoint": "https://xxxxxxx.csod.com/services/api/LRS/",
"OauthTokenUrl": "https://xxxxxxx.csod.com/services/api/oauth2/token",
"username": "xxxxxxxxxxxxxxxxxxxxxxx",
"password": "xxxxxxxxxxxxxxxxxxxxxxx",
"outputDirectory": ".",
"OutputFormat": "CSV",
}

Configuration

Configuration options are read from (in this order):

  • The conf.json file (another file can be specified as first argument)
  • Environment variables (Prefix options with « CONF_ »
  • Use command line arguments (ex. –username=Admin)

Example of conf.json:

{
  "endpoint": "https://mylrs.com/xapi/",
  "username": "",
  "password": ""
}

Options disponibles

  • Endpoint [Required] : Url of the LRS endpoint
  • Password [Required] : Mot de passe ou secret
  • Username [Required] : Nom d’utilisateur ou clé d’authentification
  • OauthTokenUrl : If your LRS is using an oAuth2 authentication (like CSOD Cornerstone On Demand), indicate the token request URL.
  • AnonymizeData (Default: False) : Anonymize all personal data of the Actor
  • Ascending (Default: True) : Envoyer l’option « Ascending »
  • BatchPerDay (Default: False) : Parfois (nous avons eu le cas des instances SAAS Learning Locker) le LRS contient trop de données et ne peut pas répondre assez rapidement, cette option permet de traiter par lots, jours par jours, la requête principale du LRS.
  • BatchSize [Range(1, 10000)] (Default: 1000) : Résultats demandés par les requêtes, si la valeur est supérieure à ce que le LRS peut accepter, il doit la diminuer automatiquement
  • OutputDirectory (Default: .)
  • OutputFormat [values: JSON, CSV] (Default: JSON) : voir les formats
  • Since [Format(« yyyy-MM-dd HH:mm:ss »)]
  • Until [Format(« yyyy-MM-dd HH:mm:ss »)]

Format

  • Le format JSON génère un grand tableau JSON contenant toutes les statements
  • Le format CSV génère 3 fichiers dans le répertoire de sortie :
    • actions.csv toutes les déclarations
    • actors.csv détails sur les acteurs
    • objects.csv détails sur les objets