En ligne 1, changement de une ligne |
!!!La médiathèque |
!!!La Médiathèque |
En ligne 3, changement de une ligne |
La médiathèque est une application web développé par le pôle applications scientifiques pour faciliter le stockage des images des collections et leur association avec les spécimens des collections ou une campagne BASEXP. |
La [médiathèque|http://collections.mnhn.fr/mediatheque] 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|Bases_Collections] |
* La base (et l'application) des [registres de collections|http://science.mnhn.fr/catalogues] |
* [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|mediatheque_recoltes_sonnerat] |
En ligne 5, changement de une ligne |
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 lu 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. |
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. |
En ligne 12, ajout de 2 lignes |
Elle met en oeuvre la plupart des principes retenus pour gérer les [images de collections|Images_Coll] |
|
En ligne 9, changement de une ligne |
!!Quelles sont les méta-données associées aux médias? |
Pour en savoir plus sur les différentes version de la médiathèque, veuillez suivre les liens ci-dessous. |
En ligne 18, ajout de 6 lignes |
*[Médiathèque 0.4.0 release notes|Mediatheque_0.4.0_release_notes] |
*[Médiathèque 0.3.0 release notes|Mediatheque_0.3.0_release_notes] |
*[Médiathèque 0.2.0 release notes|Mediatheque_0.2.0_release_notes] |
|
!!1 - Quelles sont les méta-données associées aux médias? |
|
En ligne 19, changement de une ligne |
*''dimensions'' : longueur et largeur de l'image en pixel. Cette information est récupéré automatiquement par l'application. |
*''dimensions'' : longueur et largeur de l'image en pixel. Cette information est récupérée automatiquement par l'application. |
En ligne 33, changement de une ligne |
*''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. |
*''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. |
En ligne 65, changement de une ligne |
!!Ajouter une image |
!!2 - Ajouter une image |
En ligne 75, changement de une ligne |
!!Importer un lot d'images |
!!3 - Importer un lot d'images |
En ligne 90, ajout de une ligne |
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). |
En ligne 78, changement de une ligne |
!!Rechercher des médias |
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". |
En ligne 94, ajout de une ligne |
!Les modèles de nom de fichiers |
En ligne 96, ajout de 216 lignes |
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. |
|
[{Image src = 'mediatheque_modeles_nom_fichier.jpg'}] |
|
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__. |
|
[{Image src = 'mediatheque_selection_fichiers.jpg'}] |
|
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. |
|
[{Image src = 'mediatheque_recherche.jpg'}] |
|
Le bouton à droite permet de supprimer tous les critères de recherche. |
|
!Rechercher un spécimen |
|
[{Image src = 'mediatheque_rechercher_un_specimen.jpg'}] |
|
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 |
|
[{Image src = 'mediatheque_rechercher_une_campagne_2.jpg'}] |
|
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 |
|
[{Image src = 'mediatheque_recherche_avancee.jpg'}] |
|
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 |
| [{Image src = 'specimen2.png'}] | \\voir tous les médias du spécimen |
| [{Image src = 'expedition.png'}] | \\voir tous les médias de la campagne basexp |
| [{Image src = 'science.png'}] | \\voir la fiche spécimen sur science.mnhn.fr |
| [{Image src = 'basexp.png'}] | \\voir la fiche de la campagne sur expeditions.mnhn.fr |
| [{Image src = 'hors_mnhn.png'}] | \\ce média appartient au schéma HORS_MNHN |
| [{Image src = 'registre.png'}] | \\ce média est associé à une page de registre |
| [{Image src = 'specimens.png'}] | \\le média est lié à plusieurs spécimen |
| [{Image src = 'not_published.png'}] | \\média non publié |
| [{Image src = 'nolinks.png'}] | \\média lié à aucun spécimen ou à aucune campagne basexp |
| [{Image src = 'edit.png'}] | \\éditer le média |
| [{Image src = 'delete.png'}] | \\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) |
} |
] |
} |
}}} |