Table of Contents
Cette interface permet de créer, de mettre à jour et de publier des documents EAD dans le cadre du réseau Calames.
Elle a été développée par l'ABES, en s'appuyant sur l'éditeur XML XMetal. Certaines fonctionnalités ont donc été héritées telles quelles d'XMetal.
L'adresse de la base de production est la suivante : http://www.calames.abes.fr/prod.
La Database par défaut s'appelle "Calames". Il s'agit de la base "officielle", dont les données correspondent à l'interface publique. Il existe également une base de formation (Database = Formation). Cliquez sur "Valider".
Sur la page suivante, sélectionnez la "version standard" :
![]() |
Pour utiliser l'interface de production vous devez utiliser IE version 6.0 ou supérieure.
De plus, vous devez autoriser votre navigateur à executer des plugins venant du site de l'Abes.
Cette manipulation doit être faite avec des droits Administrateur sur le poste. Ensuite, l'utilisation de l'interface ne necessite plus ces droits administrateur.
Pour cela, vous avez quatre possiblilités :
1) Vous pouvez exécuter les contenus de ce ZIP : http://www.calames.abes.fr/Prod/droits.zip. Dans ce fichier Zip, vous devez exécuter successivement droits.bat et droits.reg. Attention, à l'exécution : des demandes de confirmation sont necessaires
2) Vous pouvez faire un paramétrage automatique en cliquant et en exécutant successivement les trois Url suivantes :
3) Vous pouvez aussi faire les manipulations manuellement en suivant les étapes suivantes.
Pour autoriser le Framework Dot.net à être utilisé, allez dans : Poste de travail/Panneau de configuration/Outils d'administration.
Vous devez trouver une Icone nommée :Microsoft .NET Framework 2.0 Configuration et/ou :Microsoft .NET Framework 1.0 Configuration. Pour chacune de ces fonctions cliquez dessus et effectuez les actions suivantes (attention ces menus peuvent être en français) :
Allez sur: My Computer/Runtime Security Policy/Machine/Code Groups/All_Code
Cliquez sur le bouton droit de la souris et choisissez: New
Dans la zone Name saisissez : "Calames" et cliquez sur suivant
Dans la zone de choix choisissez : Zone
Et en dessous choisissez: "Trusted Site" et cliquez sur suivant
Dans la zone use existing permission set choisissez "Full Trust".
Cliquez sur suivant et finish.
Vous devez refaire cette suite d'opérations pour chaque version du framework.
ATTENTION: Si l'outil de configuration n'est pas installé, vous pouvez le faire manuellement en ouvrant une invite de commande (DOS) en vous mettant dans le répertoire contenant le programme caspole.exe qui se trouve généralement sous le répertoire "c:/windows/Microsoft.NET/Framework/v1.1.4322", ou bien "c:/windows/Microsoft.NET/Framework/v2.0.50727" et tapez la commande : caspol -m -addgroup All_Code -zone Trusted FullTrust -name "cgm". Il est necessaire répéter l'opération pour chaque framework installé, sauf le 3.0. Ensuite ouvrez le navigateur Internet Explorer, allez dans Outils/Options internet et choisissez l'onglet "securité", puis choisissez l'icône "sites de confiance", verifiez que le niveau de sécurité est sur FAIBLE et cliquez sur le bouton "site".
Tapez dans la zone des sites à ajouter : http://193.52.69.127 et décochez "nécessite un serveur sécurisé" puis cliquez sur "ajouter". Faîtes la même opération pour l'adresse : http://www.calames.abes.fr.
Ensuite, Cliquez sur "OK" et relancez l'ordinateur - cette fois-ci en mode non administrateur si cela est nécessaire.
4) Enfin vous pouvez vous faire aider à distance en cliquant : http://www.calames.abes.fr/Prod/abes.exe Si vous ne pouvez pas télécharger un exécutable, alors cliquez à cette adresse : http://www.calames.abes.fr/Prod/abesZ.zip , décompressez et exécutez le contenu de ce .zip.
Procédure :
Dans le volet gauche, sélectionner "Documents EAD" (la racine de l'arbre), faire un clic droit, sélectionner "Licence" puis cliquer OK dans la petite fenêtre "EAD Editeur ... (ABES)" qui apparaît (le numéro de licence est alors enregistré dans le presse-papier).
Déplier l'arborescence de gauche (en cliquant sur chaque niveau), jusqu'à un élément qui n'a plus d'enfant. Le système demande alors un nom d'utilisateur et le numéro de licence. Le nom d'utilisateur est à votre guise. Pour le numéro de licence, il suffit de le coller car vous l'avez enregistré à l'étape précédente : faîtes CTRL + V (c'est-à-dire cliquer sur la touche Ctrl et la touche "V" en même temps).
L'interface de catalogage est composée de deux parties :
Gauche : volet de navigation et d'action développé spécifiquement par l'ABES.
Droite : éditeur XML XMetal.
au milieu : éditeur
à droite : listes des éléments et des attributs
Le volet gauche permet de parcourir les différents fichiers, de naviguer dans chaque fichier et d'effectuer diverses opérations soit sur les fichiers entiers (exporter, publier, lier...), soit sur un <c> (copier, coller, afficher...).
L'éditeur XMetal affiche le contenu des fichiers EAD selon une géométrie variable (un c, un <c> et ses enfants, tout dsc...). Il permet de modifier ce contenu, dans le respect de la DTD EAD. Il permet aussi de contrôler les points d'accès (lien aux autorités Sudoc)
![]() |
L'icone permet d'agrandir le volet gauche.
L'icone permet de diminuer le volet gauche.
L'icone permet de cacher le volet gauche.
L'icone permet d'agrandir le volet central.
L'icone permet de réduire le volet central.
L'icone permet de cacher le volet droit (liste des attributs et éléments disponibles).
Pour débuter la consultation d'un fichier EAD, il faut passer par le volet gauche de l'outil de catalogage.
Le volet gauche est une arborescence.
Pour parcourir les différents niveaux, il suffit de cliquer sur chaque noeud et les noeuds inférieurs apparaissent.
Démonstration à ajouter
Le premier niveau, appelé "Documents EAD" rassemble tous les fichiers EAD accessibles à un utilisateur. Par défaut, ne sont visibles que les fichiers pour lesquels l'utilisateur authentifié a des droits d'écriture. Il peut toujours voir les autres fichiers, même s'il ne peut les modifier ou les publier. Pour ce faire, il suffit de cliquer sur "Documents EAD", puis de faire un clic droit sur le même lien et de sélectionner "Voir les autres documents" dans le menu contextuel.
A partir d'un clic droit sur "documents EAD", un menu contextuel affiche les différentes fonctions accessibles :
Masquer le menu : fermer le menu contextuel
Nouveau document EAD : créer un nouveau document dans la base Calames (soit un document vide, soit un document préexistant sur votre poste).
Rafraîchir la liste : mettre à jour l'ensemble de l'arborescence
Rechercher : effectuer une recherche sur l'ensemble de la base Calames
Voir tous les documents : afficher les documents EAD des autres établissements. Vous ne pouvez modifier les documents des autres établissements.
Licence : activer la licence XMetal (une seule fois par établissement)
Au second niveau, on trouve les documents EAD ( = les instances XML/EAD).
Le libellé de chaque document se décompose ainsi :
numéro d'ordre propre au système, correspondant au rang d'inclusion dans la base.
nom libre du fichier, choisi par l'utilisateur au moment de la création ou de l'import du fichier. Il est conseillé de suivre certaines conventions de nommage :
commencer par le RCR de votre bibliothèque
utiliser des termes qui identifient clairement le fichier (exemple : "Fonds Untel", "Série générale ms 1 - ms 514")
A partir d'un clic droit sur la racine de chaque document, un menu contextuel affiche les différentes fonctions accessibles :
Masquer le menu : fermer le menu contextuel
Déplier (rafraîchir la liste) : afficher les niveaux inférieurs (un clic gauche permet également de "déplier" un noeud).
Editer : afficher un document entier pour le modifier. Attention à la taille du document ! Il est la plupart du temps préférable d'éditer un composant, et non le document entier. Si le document ou le composant qu'on choisit d'éditer est très important, le système affiche une alerte.
Gestion :
Détection doublons : identifier les id en doublons à travers la base. La cote des <c> suspects est précisée.
Supprimer : supprimer un document EAD de la base. C'est une action irréversible.
Publier : rendre un document visible et interrogeable dans l'interface publique.
Ne plus publier : retirer un document de l'interface publique. Le document n'est pas automatiquement supprimé de la base. Il reste consultable et modifiable dans l'interface de catalogage.
Exporter : exporter le document sous différents formats.
Traces : afficher les traces Système liées à ce fichier, en particulier le processus de publication.
Tous les autres niveaux sont des noeuds de fichiers EAD :
![]() |
Il suffit de cliquer sur chaque noeud pour afficher les noeuds inférieurs.
A partir du niveau dsc, on ne peut déplier que des composants c. Pour en savoir plus sur les c, voir plus loin.
A partir d'un clic droit sur un noeud EAD, un menu contextuel affiche les différentes fonctions accessibles :
Masquer le menu : fermer le menu contextuel
Déplier (rafraîchir la liste) : afficher les niveaux inférieurs (un clic gauche permet également de "déplier" un noeud).
Editer : afficher un noeud pour le modifier. Attention à la taille !
Edition : effectuer un certain nombre de modifications à partir de l'arbre (à gauche), sans passer par l'éditeur XMetal (à droite). Pour en savoir plus, voir plus loin.
Propriétés : afficher des informations techniques sur la position du noeud dans le document EAD.
Publier : publier un <c> et ses enfants, sans publier tout le document. (Cette fonction n'apparaît qu'à un niveau c.)
Supprimer : supprimer un noeud et ses enfants du document EAD. C'est une action irréversible.
Pour afficher un noeud sans niveau inférieur, il suffit de cliquer dessus.
Pour afficher un noeud ayant des niveaux inférieurs, il faut faire un clic droit sur ce noeud et sélectionner l'action "éditer". Dès lors, cet élément est en écriture pour vous, mais n'est plus modifiable pour les autres.
Remarque : faut-il prévoir un bouton "afficher" qui permette de voir un fragment ayant des enfants sans le passer en mode Edition, donc sans le verrouiller ?
Si un noeud est trop volumineux, le système propose une édition partielle : il affichera le noeud en question, mais pas ses enfants. Vous ne pourrez modifier que ses attributs. Vous pouvez passer outre cette proposition et afficher l'ensemble du noeud. S'il s'agit d'afficher, le seul risque est d'attendre qu'Xmetal traite les données reçues. S'il s'agit de modifier, une erreur peut intervenir au moment de l'enregistrement et les modifications peuvent être perdues.
L'éditeur XMetal offre deux vues différentes :
une vue aves les étiquettes EAD (vue par défaut)
une vue "normale" sans les étiquettes.
Vue avec les étiquettes :
![]() |
Vue normale :
![]() |
Pour passer d'une vue à l'autre, on peut utiliser le menu "Vue" ou bien les icones en bas à gauche du volet XMetal.
Il n'est pas possible d'afficher le code source des fragments EAD (c'est une évolution envisageable de l'application). Néanmoins, pour vérifier le code source d'un fragment hors de Calames, il est possible de le copier puis le coller dans un éditeur comme Bloc-Notes.
Afin de voir les attributs des éléments EAD, il suffit de passer la souris sur une balise, comme dans l'exemple ci-dessous (attributs role et normal d'un <persname>).
![]() |
Les attributs d'un élément sont visibles aussi dans le bloc des attributs, à droite (ici, attributs du <c>) :
![]() |
Pour afficher un composant <c> terminal (sans enfant c) dans l'éditeur XMetal (à droite), il suffit de cliquer dessus.
Pour afficher un composant <c> ayant des enfants c, il faut faire un clic droit sur ce noeud et sélectionner l'action "éditer" . Dès lors, ce composant est en écriture pour vous, mais n'est plus modifiable pour les autres : il est verrouillé.
Remarque : faut-il prévoir un bouton "afficher" qui permette de voir un fragment ayant des enfants sans le passer en mode Edition, ce qui le verrouille ?
Si un <c> est trop volumineux, le système propose une édition partielle : il affichera le composant en question, mais pas ses enfants c. Vous pouvez passer outre cette proposition et afficher l'ensemble du composant. S'il s'agit d'afficher, le risque est seulement d'attendre. S'il s'agit de modifier, une erreur peut intervenir au moment de l'enregistrement et les modifications peuvent être perdues.
On peut modifier un fichier EAD
soit à partir de la vue arborescente offerte par le volet gauche
soit à partir de l'éditeur XMetal à droite
La première méthode se prête davantage à des modifications de structure : copier-coller d'un <c>, ajout ou suppression d'un <c>...
La seconde méthode permet aussi d'effectuer ces modifications de structure (sur des fragments de taille raisonnable), mais surtout d'éditer de l'EAD dans toute sa finesse.
Sans utiliser l'éditeur XMetal, on peut effectuer des modifications de structure sur le fichier EAD à partir de la vue arborescente du volet gauche.
En utilisant le menu contextuel généré par le clic droit, on peut accéder à différentes opérations d'"édition" :
copier un noeud
couper (déplacer) un noeud
coller un noeud après un autre, avant ou à l'intérieur
créer un noeud après un autre, avant ou à l'intérieur
couper/coller une série de noeuds de même niveau
supprimer
A propos des identifiants de <c>
Chaque <c> possède un identifiant (attribut id). Cette information est essentielle pour la cohérence de la base et pour assigner des URL publiques et stables aux différents <c>. Ces identifiants doivent donc être uniques et stables.
Comme les opérations sur les <c> peuvent supprimer des <c> ou en dupliquer, le système introduit des mécanismes de sécurité :
Tout copier-coller d'un <c> supprime les id. (Au moment du coller, un nouvel id est ajouté au <c>)
Tout couper-coller laisse les id en l'état.
En créant un nouveau c, l'utilisateur n'a pas à se préoccuper des id. Le système s'en occupe à l'enregistrement.
On peut couper un noeud dans un document A et le coller dans un document B.
![]() |
Pour déplacer un noeud, on utilise la fonction couper puis la fonction coller.
Cette opération déplace le noeud sans le modifier. En particuler, l'id du <c> reste inchangé, puisqu'il n' y a pas ici de risque de duplication d'un id.
Le couper-coller fonctionne au sein d'un même document ou d'un document à l'autre.
Copier un noeud - notamment un composant <c> - peut faciliter l'édition de noeuds qui ont la même structure et/ou le même contenu.
Il ne faut pas utiliser le copier/coller pour déplacer un composant <c> ! Le copier/coller modifie l'id du c, et donc son URL dans l'interface de consultation.
Démonstration à ajouter
Cette fonction permet de créer un nouvel élément :
si cette fonction est appelée au niveau d'un <c>, seul un autre <c> peut être créé, soit dedans, soit après, soit avant ;
dans les autres cas, une boîte de dialogue apparaît qui permet de décider de l'élément à créer :
soit en écrivant son nom ;
soit en introduisant un bloc XML prérempli.
Démonstration à ajouter
Démonstration à ajouter
Pour pouvoir modifier un fragment du document EAD dans XMetal, il faut effectuer un clic droit sur le fragment visé et sélectionner la fonction "éditer" . Dès lors, vous et vous seul pouvez enregistrer des modifications sur ce fragment : ce dernier est dit "verrouillé".
Pour déverrouiller un noeud, il suffit de cliquer ailleurs dans l'arbre.
Après avoir effectué les modifications voulues, il faut enregistrer en cliquant sur l'icône .
Attention : vérifier que les icônes "Enregistrer" et "lien aux autorités"
sont affichées au-dessus de l'éditeur avant de faire des modifications, sinon celles-ci ne pourront être sauvegardées.
NB : nous cherchons un moyen technique d'empêcher l'écriture ou le balisage dans XMetal quand un fragment est en édition.
Si vous rencontrez le bug qui fait disparaître le bouton Enregistrer, enregistrez le fragment par le menu d'XMetal Edition/Enregistrer.
Dès que le bug sera résolu, ce menu disparaîtra.
Attention : dans le menu Edition/Enregistrer, vous pouvez enregistrer même si vous n'êtes pas en mode Edition : le fragment n'est donc pas verrouillé ; vous risquez d'écraser les modifications effectuées par un autre utilisateur simultané.
Pour insérer un nouveau noeud EAD, il suffit de cliquer dessus dans la liste des éléments disponibles (en bas à droite).
Pour renseigner un attribut, il suffit de l'éditer dans la liste des attributs (en haut à droite).
Validation (à compléter !!)
Attention au copier/coller et aux id de <c> dans XMetal
Dans le volet XMetal, les copier/coller de <c> ne modifient pas les id, ce qui risque de générer des id en double. C'est pourquoi, si, à l'enregistrement d'un fragment, le système identifie plusieurs <c> ayant le même id, il renomme tous les id de <c> sauf le premier.
Copier :
soit clic-droit sur un élément et copy, puis paste
soit CTRL+C, puis CTRL+V
Coller :
soit clic-droit sur un élément et cut, puis paste
soit CTRL+X, puis CTRL+V
Il existe différentes fonctionnalités avancées qui facilitent la saisie des données et garantir leur qualité :
listes de valeurs pour les attributs
exemple: saisie des attributs type de <physfacet> ou de <unitid>
listes de valeurs pour attributs et éléments
exemple : saisie des codes et libellés de langue dans l'élément <language>
mise en valeur de certaines portions de texte
exemple : les <persname>, <corpname> et <famname> sans attribut role sont soulignés, afin de mettre en évidence cet oubli. Idem pour les <unitid> sans attribut type.
fenêtres spéciales d'aides à la saisie
exemple : fenêtre des autorités Sudoc
D'autres aides à la saisie pourront être ajoutées en fonction des besoins, par exemple pour faciliter la saisie des dates.
A compléter...
Le lien aux notices d'autorité du Sudoc permet de normaliser la forme des points d'accès. Cette normalisation améliore la recherche et le feuilletage dans Calames.
Pour lier un élément EAD (<persname>, <corpname>, <famname>, ...) à une notice d'autorité Sudoc, il y a différentes méthodes :
Partir d'un nom qui n'est pas balisé :
Surligner le nom à baliser
Cliquer sur l'icône Autorités
Dans la fenêtre des autorités, sélectionner le bon index de recherche
Lancer la recherche, éventuellement après avoir modifié les termes de recherche
Si la recherche dans les autorités Sudoc renvoie plus de 30 résultats, seuls les 30 premiers sont affichés dans un premier temps. Pour accéder aux 30 suivants, cliquer sur la flèche, à gauche du bouton Rechercher
Cliquer sur un résultat (à gauche) pour le visualiser (à droite)
Cliquer deux fois sur le résultat (en affichage court, à gauche) pour lier l'élément EAD à cette autorité
La fenêtre des autorités se ferme et vous revenez à l'écran XMetal
La balise est ajoutée, ainsi que les attributs normal (forme normalisée du nom), source ("Sudoc") et authfilenumber (ppn = identifiant de notice d'autorité Sudoc). Le contenu de l'élément est lui aussi renseigné avec la forme normale.
Partir d'un nom balisé :
surligner le nom balisé
cliquer sur
Dans la fenêtre des autorités, le bon index est déjà sélectionné, en fonction de l'élément EAD de départ
Lancer la recherche, éventuellement après avoir modifié les termes de recherche
Si la recherche dans les autorités Sudoc renvoie plus de 30 résultats, seuls les 30 premiers sont affichés dans un premier temps. Pour accéder aux 30 suivants, cliquer sur la flèche, à gauche du bouton Rechercher
Cliquer sur un résultat (à gauche) pour le visualiser (à droite)
Cliquer deux fois sur le résultat (en affichage court, à gauche) pour lier l'élément EAD à cette autorité
La fenêtre des autorités se ferme et vous revenez à l'écran XMetal
La balise est ajoutée, ainsi que les attributs normal (forme normalisée du nom), source ("Sudoc") et authfilenumber (ppn = identifiant de notice d'autorité Sudoc). Le contenu de l'élément est lui aussi renseigné avec la forme normale.
A ce jour, seuls les éléments <persname>, <corpname> et <famname> sont gérés. Les autres éléments seront ajoutés.
Elément <persname> <=> Index Personne
Elément <corpname> <=> Index Collectivité
Elément <famname> <=> Index Famille
A ce jour, la récupération du point d'accès dans l'attribut @normal n'est pas complète. Elle sera quand le serveur z39.50 fournira l'information nécessaire. Cela n'empêche pas de faire le lien, car c'est le ppn qui compte. L'attribut normal sera corrigé par batch.
A ce jour, la recherche sur les index Personne, Collectivité ou Famille renvoie les mêmes résultats. En attendant que des index plus fins ne renvoient que les notices correspondantes à la catégorie visée, il existe un moyen visuel de les distinguer. Par exemple, après une recherche sur Collectivité, seules les notices de collectivité sont alignées à gauche - vous pouvez ignorer les autres, qui sont des notices d'une autre catégorie.
Si l'indexation au fil du texte (= hors <controlaccess>) est pratiquée, il faudra faire en sorte que la forme normale issue de la notice d'autorité n'écrase pas la fome placée entre les balises. Dans ce cas, la forme normale ne sera mentionnée que dans l'attribut normal.
![]() |
Se placer sur la racine de l'arbre (Documents EAD), puis faire clic droit et choisir "Rechercher".
La recherche s'effectue sur le texte intégral de tous les fichiers qui ont été publiés.
Pour afficher le résultat dans l'éditeur, il suffit de cliquer dessus. S'il s'agit d'un <c> issu d'un document d'une autre bibliothèque, il ne s'affichera pas à moins d'afficher tous les documents des autres bibliothèques (clic-droit sur la racine absolue de l'arborescence puis "Voir tous les documents" ).
Pour situer le résultat dans l'arborescence, il suffit de cliquer sur le bouton synchroniser.
La fonction d'export permet d'extraire de Calames chaque fichier sous différents formats :
natif = EAD
HTML (non achevé)
MARC (non achevé)
RDF (non achevé)
...
La fonction d'export servira aussi à extraire des rapports de diagnostic sur les données, leur profil, leur qualité.
L'acte de publier un fichier EAD ou composant <c> consiste à copier le fichier ou le fragment dans la base de consultation, à l'indexer et enfin à le rendre accessible au public et interrogeable.
Pour publier un document entier ou seulement un composant c, il faut faire un clic-droit sur celui-ci et choisir "Publier" . On peut alors décider d'effectuer la publication sans délai ("Immédiat") ou de la différer (choisir une date dans l'agenda).
Des consignes seront données sur les heures de publication opportunes.
Une fois la publication lancée, il faut attendre avant de pouvoir éditer le document à nouveau ou le voir en consulation.
L'attente peut être plus ou moins longue, selon la taille du document et le nombre d'utilisateurs en cours de catalogage ou de consultation.
La lecture des traces permet de voir la progression du processus de publication et les éventuelles anomalies. La publication sera avortée s'il existe dans ce fichier des id de<c> qui ne sont pas uniques à l'échelle de la base. Les traces indiquent les id non uniques. Pour identifier le<c> qui possède un id non unique, il faut appliquer l'opération "Détection des doubons" sur le fichier en question (clic-droit, puis gestion, puis détection).
Quand c'est possible, il est conseillé de faire des publications partielles, sur un <c> particulier. La publication partielle suppose que le document entier ait déjà été publié au moins une fois.
Pour savoir si un fichier a déjà été publié, il faut soit aller consulter les traces, soit aller vérifier dans l'interface publique. Ainsi, si le fichier dont l'id est 999 a été publié, il sera visible à l'adresse : http://www.calames.abes.fr/pub/ms/FileId-999
Tous les éléments ou attributs EAD ne sont pas indexés.
La suppression d'un fichier est irréversible.
Avant de supprimer un fichier publié, il faut le dépublier. Sinon, le fichier reste visible dans l'interface de consultation. Or, comme il a été supprimé de la base de production, il ne peut plus être "dépublié" (sauf par l'ABES).
Cette fonctionnalité permet d'ajouter un nouveau fichier à la base Calames
soit en important un fichier extérieur à Calames ;
soit en partant d'un structure EAD vide
![]() |
Cette fonctionnalité permet d'importer dans la base Calames un fichier EAD valide et conforme aux consignes du réseau Calames.
Ne pas laisser d'attributs id au niveau des éléments c. Ils risqueraient d'entrer en conflit avec les les id de <c> déjà présents dans d'autres fichiers de la base Calames.
Liens entre fichiers : on ne peut établir de relations de lien ou d'inclusion qu'entre des fichiers qui ont en commun le RCR : repository/corpname.
Publier dans l'ordre de dépendance : du liant vers le lié, de l'incluant vers l'inclus.
Comme si le premier c01 du second fichier venait juste après le dernier c01 du premier fichier