mod:sharedresource:userguide:addandimport

Ressources Mutualisées : Alimenter en masse une librairie mutualisée

Introduction

Cette fonctionnalité permet d'alimenter massivement une librairie à partir d'un stock de fichier préexistant, sous réserve que suffisamment de métadonnées soient disponibles pour documenter les ressources.

Accessoirement, le moteur d'import peut distribuer les ressources importées dans des cours (en format section uniquement)

Cette fonctionalité suppose:

  • avoir un accès au serveur (ssh, console, bureau, etc.)
  • pouvoir télécharger les lots de fichiers dans le serveur (sftp, ftp)
  • pouvoir lancer des scripts sous l'utilisateur du serveur Web (sudo).

Préparation

L'opération d'import de ressources en masse doit être préparée avant d'être exécutée. Cette préparation consiste en :

  • Réunir les document/fichiers à importer dans un volume (répertoire) normalisé
  • Préparer les métadonnées et créer le fichier descripteur selon la syntaxe d'import attendue

Le volume (répertoire) ainsi constitué peut alors être téléchargé sur le serveur dans un répertoire temporaire et l'action d'import massif peut y être lancée dessus.

Note importante : Le répertoire temporaire d'import doit pouvoir être écrit par le serveur web pour l'écriture du journal d'import.

Répertoires de ressources

Le répertoire de ressources peut contenir des sous-répertoires qui serviront de base au rangement des fichiers dans des catégories de nomenclature. Cette nomenclature est alors automatiquement ajoutée aux taxonomies disponibles.

Alternativement, le fichier de métadonnées peut apporter une valeur d'indexation dans les taxonomies existantes.

Fichier descripteur de métadonnées

Un fichier de métadonnées doit être fourni dans le volume à importer. Ce fichier :

  • doit être nommé “metadata.csv”
  • doit être situé à la racine du volume d'import
  • doit être au format CSV
  • doit être encodé en UTF-8
  • a une première ligne donnant le nom des colonnes

Certaines des colonnes fournissent des métadonnées qui seront “mappées” avec des entités standard du schéma d'indexation. Voir la liste dans le Guide technique.

Le fichier admet les colonnes suivantes :

Champs relatif à l'identification de la ressource
Champ Obligatoire Format Usage
file X chemin relatif position du fichier dans le volume (relativement à la racine de l'archive)
category string
Champs relatif à la publication lors de l'import
Champ Obligatoire Format Usage
shortname string Le nom court du cours où créer une publication de la ressource lors de l'import
section int Le numéro de section où créer une publication de la ressource lors de l'import
visible int L'état de visibilité initial de la publication créée (0 ou 1)
Champs relatif à la fourniture de métadonnées
Champ Format Usage
title string Intitulé de ressource. Si il est vide ou non fourni, le nom de base du fichier est utilisé à la place - taille 1024 caractères
description string Description de la ressource
keywords liste à virgule Liste de mots/expression clefs
documenttype string Selon la nomenclature du LOMFR:1.9
documentnature string Selon la nomenclature du ScoLOMFR:1.10
authors liste à virgule Liste de description d'auteurs comportant un nom et une date simplifiée éventuelle
contributors liste à virgule Liste de description de contributeurs comportant un nom et une date simplifiée éventuelle
pedagogictype string Selon la nomenclature du LOMFR:5.2
language code langue Langue selon le LOM:1.3
difficulty 'very easy', 'easy', 'medium', 'difficult', 'very difficult' Selon la nomenclature du LOM:5.9
guidance text

voir l'exemple du LOM FR

Crédits

  • Valéry Frémaux (valery@activeprolearn.com)- Développements et tests
  • Florence Labord (florence@activeprolearn.com) : Documentation et revue fonctionnelle

Retour index guide d'utilisation - Revenir à l'index du composant Revenir à l'index des plugins - Revenir au catalogue

mod/sharedresource/userguide/addandimport.txt · Dernière modification: 2024/04/04 15:52 (modification externe)