La Médiathèque#

La médiathèque est une application web développé par le pôle applications scientifiques pour faciliter le stockage des images des collections. Elle permet l'association de ces images avec les autres applications scientifiques. Dans l'immédiat, les applications reliées à la médiathèque sont :

• les bases des collections
• La base (et l'application) des registres de collections
• http://expeditions.mnhn.fr
• le référentiel HORS_MNHN pour le séquençage des spécimens prêtés
• le référentiel des récoltes de SONNERAT

Cette application permet de choisir une ou plusieurs images et de l'ajouter à la médiathèque, en lui associant des méta-données. Cette image est lue pour récupérer quelques informations et est envoyé automatiquement sur un serveur de stockage mis à disposition par la DSI. Ainsi, ce n'est plus l'utilisateur qui gère l'emplacement de l'image permettant un meilleur contrôle sur les images et d'en maintenir la cohérence.

Elle met en oeuvre la plupart des principes retenus pour gérer les images de collections

Pour pouvoir utiliser la médiathèque, il est nécessaire d'avoir un compte avec les droits adéquats. Si vous ne possédez pas de compte colhelper ou les droits sur la médiathèque, vous devrez demander la création d'un compte et/ou l'ajout des droits pour utiliser la médiathèque.

Pour en savoir plus sur les différentes version de la médiathèque, veuillez suivre les liens ci-dessous.

• Médiathèque 0.4.0 release notes
• Médiathèque 0.3.0 release notes
• Médiathèque 0.2.0 release notes

1 - Quelles sont les méta-données associées aux médias?#

Il est possible d'ajouter des méta-données aux images de la médiathèque.

Informations sur les images#

• type d'image (vocabulaire contrôlé) : photo, radio, radio numérique, spécimen, étiquette, dessin, figuré, socle, herbier, microscope électronique à balayage (MEB), manuscrit et texte.

• angle de vue (vocabulaire contrôlé) : recto, verso, ventral, dorsal, latéral, droite, gauche, face, dessus, dessous, détails.

• dimensions : longueur et largeur de l'image en pixel. Cette information est récupérée automatiquement par l'application.

• définition : champs libre permettant de mettre des informations sur la définition des images.

• couleur : champs libre permettant de mettre des informations sur les couleurs des images.

• traitement : champs libre permettant de mettre des informations sur les traitements effectués sur les images.

• qualité : qualité de l'image (de 1 à 5)

Informations générales#

• nom : champs libre permettant de nommer un média. Cette information n'est pas affichée sur science.mnhn.fr mais permet de retrouver son image dans la médiathèque.

• numéro d'inventaire : ce champs permet de lier l'image à un spécimen de collection. Pour cela, il faut renseigner le code institution (MNHN), l'acronyme de collection et le numéro d'inventaire. Il est possible d'associer l'image à plusieurs spécimens.

• campagne : ce champs permet de lier l'image à une campagne BASEXP. Une liste déroulante vous est proposée.

• auteurs : champs libre permettant de renseigner le ou les auteurs de l'image.

• année : année de l'image (numérique).

• crédit : champs libre permettant de créditer l'image.

• droits : champs permettant d'associer des droits Creative Commons (CC) appliqués à l'image. Pour en savoir plus, voir le site dédié aux Creative Commons.

• projet : champs libre permettant d'associer une image à un projet particulier.

• rang : champs numérique permettant d'ordonner les images dans la fiche spécimen ou dans la fiche de la campagne.

• description : champs libre permettant de décrire l'image.

• commentaires : champs libre dans lequel l'utilisateur peut mettre des commentaires sur l'image.

Les mots clés#

Il est possible d'associer un ou plusieurs mots clés aux images. Ces mots clés sont à l'appréciation de l'utilisateur et permettent de rechercher des médias en fonction de mots clés. C'est donc une aide non négligeable pour ordonner et retrouver ces images.

Les informations de publication#

• publier sur le site : si la case est coché, vous autorisez l'image à apparaître dans la fiche spécimen de science.mnhn.fr

• date de début : date de début de publication (à partir de).

• date de fin : date de fin de publication (jusqu'à).

2 - Ajouter une image#

Pour ajouter une nouvelle image, il faut cliquer sur "NOUVELLE IMAGE" dans le menu de l'application (en bas de votre navigateur). Vous serez dirigé vers une page qui vous demandera de sélectionner le fichier désiré.

Il vous suffira de cliquer sur le bouton "parcourir" et de choisir l'image que vous souhaitez ajouter à la médiathèque. Une fois l'image sélectionnée, il faut cliquer sur le gros bouton violet en dessous afin de procéder au téléversement de l'image. Vous serez alors redirigé vers la page d'édition du média. Vous pourrez alors renseigner les méta-données à votre guise.

Il faut noter que tous les formats d'images ne sont pas acceptés, seuls les JPG, GIF et PNG sont autorisés mais nous vous conseillons fortement d'utiliser des JPG comme indiqué dans les recommandations.

3 - Importer un lot d'images#

Pour effectuer une importation d'images par lot, il faut cliquer sur "IMPORTER PAR LOT" dans le menu de l'application (en bas de votre navigateur).

Vous serez alors dirigé vers une page qui vous permettra de créer un modèle d'image en renseignant les meta-données communes à toutes les images de votre lot. Cette page est calquée sur la page d'édition des images. Une fois les informations remplies, vous devez cliquer sur le bouton "ENREGISTRER ET CONTINUER".

Les modèles de nom de fichiers#

Vous êtes alors redirigé vers une nouvelle page vous permettant de choisir le modèle de nom de fichier permettant d'extraire des données à partir des noms des fichiers.

Trois modèles sont proposés à ce jour.

• Pas de modèle d'importation : comme son nom l'indique, aucun modèle est utilisé. Les noms des médias seront directement pris du nom des fichiers et aucune information n'est extraite.

• [institution_code]_[collection_code]_[catalog_number]_[rang] : ce modèle permet d'extraire le code institution, le code collection (acronyme), le numéro d'inventaire et le rang. Ces informations sont séparées par le séparateur "_" (underscore). Ne pas mettre les crochets "[" et "]".

• [nom]_[rang] : ce modèle permet d'extraire le nom du média et son rang.

Sélection des images#

Une fois le modèle de nom de fichier choisi, vous pouvez sélectionner les images proprement dites en cliquant sur le bouton "Parcourir". il faut noter que le nombre maximum d'images importées a été fixé à 150.

Si le nombre de fichiers est inférieur à 150, le bouton "importer" apparaît. Il ne reste plus qu'à cliquer dessus. Une barre de progression apparaîtra alors pour vous indiquer la progression de l'importation par lot.

4 - Rechercher des médias#

Un outil est à votre disposition pour rechercher des médias. Cet outil vous permettra de retrouver les médias d'un ou plusieurs spécimens, les médias d'une campagne en particulier ou de sélectionner différents critères grâce à une recherche avancée.

Le bouton à droite permet de supprimer tous les critères de recherche.

Rechercher un spécimen#

Il est possible de chercher un spécimen en particulier grâce à sont numéro d'inventaire. Il suffit de cliquer sur "Rechercher un spécimen" et de remplir le code institution, le code de collection et le numéro d'inventaire. Il est possible d'ajouter un joker * dans le numéro d'inventaire pour étendre la recherche à plusieurs spécimen.

ex : MNHN-EY-EY9335 ou MNHN-EY-EY933* (tous les médias dont le spécimen a un numéro d'inventaire commençant par MNHN-EY-EY933)

Rechercher une campagne#

Il est possible de rechercher tous les médias associés à une campagne BASEXP. Pour cela, il suffit de cliquer sur "Rechercher une campagne" et de taper le nom de la campagne désirée. Une liste de campagne vous ait proposé, choisissez la campagne et cliquez sur "Trouver".

ex : DongSha 2014

Recherche avancée#

La recherche avancée vous permet de trouver des médias en fonctions d'un certain nombre de critères :

• schéma,
• acronyme de collection,
• nom : il est possible d'ajouter un joker * à fin du nom rempli pour étendre la sélection à tous les médias dont le nom commence par,
• projet,
• auteur,
• utilisateur : c'est à dire le login de l'utilisateur qui a créé le média,
• type d'image,
• angle de vue,
• mots clés : il est possible de mettre plusieurs mots clés. Pensez à cliquer sur le bouton "ajouter" pour que la recherche prenne le mot clé en compte,
• par date d'importation dans la médiathèque.

Il est possible de filtrer cette recherche pour trouver

• seulement les médias non publiés,
• seulement les médias qui ne sont associés à aucun spécimen ou à aucune campagne,

Ceci nous permet de retrouver plus facilement les erreurs d'importation.

5 - La signification des icônes#

Dans la liste des médias, plusieurs icônes apparaissent :

icône	signification
	voir tous les médias du spécimen
	voir tous les médias de la campagne basexp
	voir la fiche spécimen sur science.mnhn.fr
	voir la fiche de la campagne sur expeditions.mnhn.fr
	ce média appartient au schéma HORS_MNHN
	ce média est associé à une page de registre
	le média est lié à plusieurs spécimen
	média non publié
	média lié à aucun spécimen ou à aucune campagne basexp
	éditer le média
	supprimer le média

6 - Les web services#

La médiathèque met à disposition des utilisateurs des services permettant d'importer une image, d'éditer les métadonnées d'une image et de supprimer une image.

Ces services ne sont accessibles qu'en HTTPS et sont protégés par une authentification. Les utilisateurs souhaitant utiliser ces services doivent être identifiés par une clé clientKey qui doit être renseigné dans le header de la requête. Cette clé est fourni au client par le Pôle Applications Scientifiques.

Il faut noter qu'il est nécessaire de préciser dans le header de la requête client le paramètre Content-Type qui doit être égal à application/x-www-form-urlencoded.

6.1 - Service permettant d'importer d'une image#

Ce service a pour objectif d'importer une image, accessible via http, dans la médiathèque et de renseigner les métadonnées associées. Ce service répond à la méthode HTTP POST et retourne un JSON contenant un compte rendu d'exécution et les erreurs éventuelles.

Ce service est accessible à l'adresse suivante :

https://mediatheque.mnhn.fr/service/private/media

Les paramètres du header#

• Content-Type (obligatoire) : application/x-www-form-urlencoded
• clientKey (obligatoire) : clé d'authentification du client

Les paramètres du body#

Les paramètres obligatoires

• url : Adresse de l'image à importer accessible via le protocole HTTP

Les paramètres optionnelles

• authors : Auteurs de l'image,
• credit : Crédit associé à l'image,
• name : Nom du média. Par défaut, le nom du fichier sans extension,
• owner : propriétaire de l'image,
• project : Projet ayant produit l'image,
• publish : 0 ou 1, indique si le média doit être publié. Par défaut 1,
• rights : Licence Creative Commons (CC) de l'image = cc0, cc-by, cc-by-nd, cc-by-nc-sa, cc-by-sa, cc-by-nc, cc-by-nc-nd,
• year : Année de l'image.

Les paramètres du spécimen

• institutionCode : Code de l'institution,
• collectionCode : Code de collection,
• catalogNumber : Numéro de catalogue,
• rank : Rang de l'image permettant d'ordonner les images d'un même spécimen.

La réponse#

• 201 : Créé / Created
• 400 : Mauvaise requête / Bad Request
• 401 : Non autorisé / Unauthorized
• 500 : Erreur interne au serveur / Internal Server Error

Le corps de la réponse contient un JSON donnant des indications sur l'exécution du service, fournit des informations sur le média nouvellement créé et les sources d'erreurs si le processus ne s'est pas déroulé normalement. Ce JSON est de la forme suivante :

{
    success: 1 ou 0,
    media: {
        uid: uid du média,
        url: url du média dans la médiathèque,
        mimeType: mime type du média
    },
    errors:[
        {
            source: paramètre de la requête qui est la source de l'erreur,
            error: type d'erreur (BAD_FORMAT, MALFORMED_URL, CONNECTION_ERROR, PARAMETER_NOT_ACCEPTED, SPECIMEN_NOT_FOUND)
        }
    ]
}

6.2 - Service permettant d'éditer ou de supprimer une image#

Ce service a pour objectif d'éditer les métadonnées associées à un média de la médiathèque ou de suprimer un média. Ce service répond aux méthodes HTTP PUT, DELETE et POST. La méthode POST a été ajouté pour les clients qui ne gèrent pas la méthode PUT. Il est donc nécessaire de passer un paramètre method pour indiquer la méthode HTTP souhaiter, en l'occurrence PUT pour éditer et DELETE pour supprimer le média.

Ce service est accessible à l'adresse suivante :

https://mediatheque.mnhn.fr/service/private/media/UID

où UID est l'identifiant unique du média.

Les paramètres du header#

• Content-Type (obligatoire) : application/x-www-form-urlencoded
• clientKey (obligatoire) : clé d'authentification du client

Les paramètres du body#

Les paramètres obligatoires

Si le client utilise la méthode HTTP POST, il est obligatoire de préciser la méthode dans un paramètre

• method : PUT ou DELETE

Les paramètres optionnelles Ces paramètres ne sont utilisables qu'en mode édition.

• authors : Auteurs de l'image,
• credit : Crédit associé à l'image,
• name : Nom du média. Par défaut, le nom du fichier sans extension,
• owner : propriétaire de l'image,
• project : Projet ayant produit l'image,
• publish : 0 ou 1, indique si le média doit être publié. Par défaut 1,
• rights : Licence Creative Commons (CC) de l'image = cc0, cc-by, cc-by-nd, cc-by-nc-sa, cc-by-sa, cc-by-nc, cc-by-nc-nd,
• year : Année de l'image.

Les paramètres du spécimen

• institutionCode : Code de l'institution,
• collectionCode : Code de collection,
• catalogNumber : Numéro de catalogue,
• rank : Rang de l'image permettant d'ordonner les images d'un même spécimen.

La réponse#

• 200 : Ok / Ok
• 204 : Pas de contenu / No Content
• 400 : Mauvaise requête / Bad Request
• 401 : Non autorisé / Unauthorized
• 404 : Non trouvé / Not found
• 500 : Erreur interne au serveur / Internal Server Error

Si la méthode spécifié est PUT et si l'édition des métadonnées du média s'est déroulé normalement, le service répond seulement par un code 200 / Ok.

Si la méthode spécifié est DELETE et si la suppression du média s'est déroulés normalement, le service répond seulement par un code 204 / No Content.

Sinon, le corps de la réponse contient un JSON donnant des indications sur l'exécution du service les sources d'erreurs si le processus ne s'est pas déroulé normalement. Ce JSON est de la forme suivante :

{
    success: 1 ou 0,
    errors:[
        {
            source: paramètre de la requête qui est la source de l'erreur,
            error: type d'erreur (PARAMETER_NOT_ACCEPTED, SPECIMEN_NOT_FOUND)
        }
    ]
}