Shared Resources Library: Mass supplying library with resources

Introduction

This special advanced feature massively empowers a shared library from a pre-existing file stock, provided that enough metadata is available to document the imported resources.

As accessory, the import engine can distribute the resources imported into courses (in section format only)

This feature assumes:

have access to the server (ssh, console, desktop, etc.)

be able to upload the file stock in the server (sftp, ftp)

be able to launch scripts under the web server UID (sudo).

Preparation

The mass resource import operation must be prepared acurately before it is executed. You shall:

Collect documents/files to be imported into a standard volume (directory)

Prepare metadata and create the descriptor file according to the expected import syntax

The volume (directory) thus constituted can then be downloaded to the server in a temporary directory and the massive import action can be launched therein.

Additional note: The temporary import directory must be able to be written by the web server for writing the import log.

Resource directory

The resource directory can contain subdirectories that will serve as the basis for storing files in indexing categories. This nomenclature is then automatically added to the available taxonomies.

Alternatively, the metadata file can provide an indexing value in existing taxonomic namespace.

Metadata descriptor file

A metadata file must be provided in the volume to be imported. This file :

MUST be named “metadata.csv”

MUST be located at the root of the import volume

MUST be in CSV format

MUST be encoded in UTF-8

has a first row giving the name of the columns

Some of the columns provide metadata that will be “mapped” with standard entities of the indexing scheme. See the list in the Technical guide.

The file admits the following columns:

Fields relating to resource identification

Field	Mandatory	Format	Use
file	X	relative path	file position in volume (relative to the root of the archive)
category	string

Fields for publication during import

Field	Mandatory	Format	Use
shortname	string	The short name of the course where to create a publication of the resource when importing
section	int	The section number where to create a publication of the resource during import
visible	int	The initial visibility status of the created publication (0 or 1)

Fields for providing metadata

Field	Format	Use
title	string	Resource title. Whether it is empty or not provided, the base name of the file is used instead - size 1024 characters
description	string	Resource description
keywords	comma list	List of keywords/expression
documenttype	string	According to the nomenclature of LOMFR:1.9
documentnature	string	According to the nomenclature of ScoLOMFR:1.10
authors	comma list	Author description list with a name and a simplified date
contributors	comma list	List of description of contributors with a name and a simplified date
pedagogictype	string	According to the nomenclature of LOMFR:5.2
language	code language	Language according to LOM:1.3
difficulty	'very easy', 'easy', 'medium', 'difficult', 'very difficulty'	According to the nomenclature of LOM:5.9
guidance	text

see example with ScoLOMFR scheme

Credits

Valéry Frémaux (valery@activeprolearn.com)- Architecture and development

Florence Labord (florence@activeprolearn.com) : Documentation and functional review

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