Web services

Fragments EAD publiés dans Calames

L’interface publique de Calames fait appel à des web services spécifiques, dont une réplication a été mise en place pour permettre l’exploitation de données.

Les requêtes appelant ces services ont pour racine l’URL :  http://www.calames.abes.fr/prod/EadSearch_ccfr.aspx?Query =   suivie du nom de la fonction appelée et d’un critère d’interrogation (en général : l’identifiant d’un niveau descriptif).

Les réponses prennent la forme de documents XML ayant pour racine un élément <RESULT>. Les contenus EAD sont directement encapsulés dans des éléments <C>, et le cas échéant <ROOT> lorsqu’il s’agit de hauts niveaux d’instruments de recherche.

Ré-exploitation des données de Calames 

  •  « DetailFrereP » et « DetailFrereS » : fonctions complémentaires à « Detail » qui permettent la récupération des données détaillées du frère précédant ou du frère suivant le niveau dont l’ID a été renseigné. Les réponses XML sont structurées de la même manière qu’avec la fonction « Detail ». Exemple : http://www.calames.abes.fr/prod/EadSearch_ccfr.aspx?Query=DetailFrereS&id=PA1070028
  • « ListTousEnfants » : récupération des informations abrégées (identifiants <unitid> et/ou intitulés <unittitle>) de tous les enfants du niveau courant. Les réponses <RESULT> sont alors structurées en autant d’éléments <a> qu’il y a d’enfants : l’attribut @datemod y figure pour donner la date de dernière modification publique des données, afin de faciliter les récupérations de données de type moissonnage. Exemple : http://www.calames.abes.fr/prod/EadSearch_ccfr.aspx?Query=ListTousEnfants&id=Calames-201191216953751

Web services Calames dédiés aux points d'accès (autorités IdRef)

Les pages de l’interface publique IdRef sont alimentées à l’aide des web services de Calames, par les identifiants et références abrégées de chaque niveau descriptif EAD lié à IdRef, que le lien soit fait par l’intermédiaire d’un Nom de personne, de collectivité, de famille, de lieu, d’une indexation matière ou d’un Titre d’œuvre.

Les requêtes appelant ces services ont la même racine que les fonctions de moissonnage précédemment décrites : http://www.calames.abes.fr/prod/EadSearch_ccfr.aspx?Query = , suivi du nom de la fonction appelée. Le critère d’interrogation est l’identifiant de la notice d’autorité, appelé « PPN » dans IdRef et toujours renseigné sur neuf chiffres. Les exemples qui suivent font appel au PPN 026751852 (notice d’autorité du Nom de personne André Breton) .

  • « sumppn » : pour connaître le nombre total de niveaux descriptifs auxquels une notice d’autorité est directement liée (les niveaux indexés par héritage ne sont pas comptabilisés).
  • « ppnidref » : pour générer une liste des références archivistiques correspondant à la notice d’autorité liée. l’identifiant (PPN) de la notice d’autorité, il est nécessaire de préciser le nombre maximal de références attendues à l’aide du critère nb ». Chaque référence est constituée par quatre éléments d’informations ainsi mis en forme : "[Cote]. Intitulé/analyse (importance matérielle). Date".
    • Exemple : http://www.calames.abes.fr/prod/EadSearch_ccfr.aspx?Query=ppnidref&ppn=026751852&nb=50 donnera pour réponse les références des 50 premiers niveaux descriptifs publiés sous lesquels le Nom de personne « Henri Bosco » (PPN 027883795) a été directement indexé. A chaque élément enfant de la racine <RESULT> correspond une référence abrégée (attribut @shorttitle), l’identifiant du niveau descriptif (attribut @id) et le code de la fonction qu’il occupe vis-à-vis du ou des document(s) décrit(s) (attribut @role).

L'URL "Tout voir dans Calames" utilisé par l'interface IdRef et permettant l'affichage d'une liste de résultats dans l'interface publique de Calames est de type : http://www.calames.abes.fr/pub/#resultats?ppn=026751852

Remonter