Le principe des exports⚓

Sommaire
  1. Les différents modèles d'export
  2. Exporter c'est appliquer un ensemble de transformations définies dans un xslt
  3. Le principe du filtre d'export
  4. Développer de nouveaux modèles d'export

Les différents modèles d'export⚓

Objectif principal

Exporte le Document EAD complet :

filtre non pris en compte

Exporte des composants précis :

filtre requis

Exporte des éléments de composants précis :

filtre requis

Extension recommandée

traitement xml

Modèle Natif

Modèle Natif-Déclaration

Modèle Kill-id

Modèle Natif-C

Modèle Natif-Filtre

.xml

Affichage

Modèle IRComplet_htmlpourpdf

.html

Modèle Liste

.html

Conversion

Modèle DublinCore-CSV (*)

Modèle DublinCore-CSV filtre (*)

.csv

Modèle DublinCoreSimple(*)

Modèle DublinCoreQualifie(*)

.xml

Modèle MarcXML(*)

.xml

Modèle MarcISO2709

.mrc

Modèle MarcISO2709UTF8

.mrk8

Contrôle qualité

Modèle Visio_controle

.html

Modèle Valeurs_controle-Filtre

.txt

Modèle Element_controle-Filtre

.txt

Alimentation de Wikimedia Commons

Modèle Wikimedia_book_CSV filtre (*)

Modèle Wikimedia_artwork_CSV filtre (*)

.csv ou .txt

(*) : L'xslt de ce modèle est publié sous licence CeCILL sur le github de l'Abes

Voir ici les spécificités de chaque modèle.

Exporter c'est appliquer un ensemble de transformations définies dans un xslt⚓

Exporter depuis Calames consiste à appliquer un xslt, fichier de transformation du fichier xml EAD de départ.

Pour accéder à l'xslt appliqué par le modèle d'export⚓

Les principaux modèles d'export sont publiés sous licence CeCILL sur le github de l'Abes.

Il est donc possible de

  • d'appliquer ces xslt à des fichiers EAD extérieur à Calames

  • d'adapter ces modèles à un besoin ponctuel pour l'utiliser sur le résultat xml d'un export Natif-Déclaration de Calames

  • d'investir collectivement sur l'adaptation de certains de ces xslt à des besoins partagés et de solliciter l'Abes pour leur intégration dans Calames

Le principe du filtre d'export⚓

Les modèles d'export qui s'appliquent uniquement à des composants (voire des éléments EAD précis) requièrent la saisie d'un XPath dans le champ Filtre de la fenêtre d'export. L'XPath permet d'expliciter le chemin XML dans un ou plusieurs document EAD afin d'en sélectionner des composants ou des éléments EAD.

  • La saisie d'un filtre est requise en cas d'export Natif-C, Natif-Filtre, MarcXML, MarcISO2709, MarcIso2709UTF8, DublinCoreSimple, DublinCoreQualifie, EvalXpath.

  • Le champ Filtre s'affiche systématiquement, même si l'export sélectionné ne le prend pas en compte (voir le tableau des différents modèles d'exports ci-dessus). Dans le cas des modèles où le filtre est inopérant, l'export fonctionne normalement, même si l'XPath d'exemple affiché par défaut dans le champ "Filtre" ne correspond à rien.

Attention

L'xpath présent par défaut à titre d'exemple : //c[@id=''cgm-1234578''] ne correspond à aucun cas précis : l'ID "cgm-1234578" n'est pas un ID présent dans Calames

Cet xpath exemple doit impérativement être modifié pour que fonctionnent les exports requérant un "Filtre".

Si, dans le champ Filtre, aucun xpath n'est saisi, que l'xpath par défaut n'est pas adapté, ou que l'xpath corrigé ne correspond à rien dans le ou dans l'un ou l'autre des documents EAD en cours d'export, le fichier résultat de l'export propre au fichier concerné ne contient aucun composant et affiche une alerte :

(Rappel : il y a toujours un fichier résultat d'export par fichier EAD dans Calames, et donc autant de fichier résultat que de clés saisies dans le champ Clés du formulaire d'export

La syntaxe à utiliser dans le champ Filtre est celle des expressions XPath.

Pour en savoir plus sur cette syntaxe consulter ce tutoriel : "XPath, XSLT : des langages XML appliqués à l'EAD".

Attention

Il y a une exception à l'application de cette syntaxe : le filtre dans Calames ne reconnaît pas les caractères guillemets ou double quotes ("). Il est donc nécessaire de leur substituer deux caractères apostrophes ou simples quotes (') au sein des expressions Xpath devant en comporter.

ExempleExemple pré-saisi dans le champs Filtre⚓

composant <c> à l'identifiant fictif dans la syntaxe attendue par Calames

//c[@id=''cgm-1234578'']

Il est composée de la manière attendue : la valeur de l'attribut identifiant est bien encadrée par 2 x 2 simples quotes.

ExempleExemples d'xpath⚓

L'Abes met à votre disposition un fichier complet d'exemples différents types d'xpath appliqués aux données Calames

Appliquer un XPath à plusieurs fichiers EAD lors d'un même export⚓

Il est possible d'appliquer un XPath à plusieurs fichiers EAD simultanément lors d'un export. Saisir l'XPath dans le champ Filtre de la fenêtre d'export, puis saisir les clés de chaque fichier séparées par une virgule sans espace dans le champ "Clés".

Attention

Comme le précise la procédure d'export simultané de plusieurs fichiers EAD, même pour un export avec filtre, il y a autant de fichier résultats que de fichiers EAD concernés par l'export : selon les besoins, ils doivent ensuite être éventuellement fusionnés

Développer de nouveaux modèles d'export⚓

L'Abes peut incrémenter de nouveaux modèles d'export à des fins d'usage régulier qu'il s'agisse de traitement générique pouvant être proposé à tous les établissements ou de traitements spécifiques pour alimenter un outil propre à l'établissement.