{{ :blocks:logo-apl.png?nolink |}} ===== 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 [[:local:sharedresources:technique|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 | | [[local:sharedresources:import:lomfr|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 ---------- [[local:sharedresources:userguide|Retour index guide d'utilisation]] - [[:local:sharedresources|Revenir à l'index du composant]] [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]