{{ :blocks:logo-apl.png?nolink |}} =====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 [[:local:sharedresources:technique|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 | | [[local:sharedresources:import:lomfr|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 ---------- [[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]]