Comment interroger Calypso à distance?

Il vous est possible d'interroger Calypso à distance de deux façons distinctes:

1. Par l'utilisation du protocole Z39.50. À titre d'exemple, ce protocole est utilisé par Maestro, le service de recherche fédérée des bibliothèques de l'UdeM, pour interroger Calypso.
2. Par l'utilisation du protocole OAI-PMH. C'est sur ce protocole que repose le "moissonnage" des données de Calypso par des services d'aggrétation d'information tel WorldCat et OAIster.

1. Protocole Z39.50

Calypso utilise l'extension ZContent afin d'offrir une fonctionnalité de recherche conforme à la norme Z39.50. Ceci signifie que des usagers ou organisations qui utilisent un logiciel client Z39.50 installé sur leur poste de travail ou leur serveur institutionnel peuvent interroger Calypso directement depuis leur client Z39.50 au lieu de passer par l'interface web de recherche de Calypso.
Calypso uses the ZContent extension in order to offer a Z39.50 search compatibility. This means that individuals and organizations, who have Z39.50 client software installed on their own computers or institutional servers, potentially can search Calypso using their own software rather than Calypso native web interface.

Les clients Z39.50 les plus connus, pour les environnements PC et Mac comprennent: EndNote, Reference Manager, ProCite et Bookwhere. Pour pouvoir, par l'entremise de l'un de ces clients, interroger Calypso, vous devez d'abord configurer dans votre client, un profil propre à Calypso en inscrivant les valeurs suivantes:
The most commonly used Z39.50 client software for PCs and Macs includes: EndNote, Reference Manager, ProCite and Bookwhere. In order for any of these software to be used for connecting to Calypso, a Calypso configuration profile must be created in the program software, as follows:

2. Protocole OAI-PMH

Le protocole Open Access Initiative - Protocol for Metadata Harvesting (OAI-PMH) est une norme qui permet de mettre en place des infrastructures d'interopérabilité pour des informations documentaires. Cette norme facilite l’échange de données entre des fournisseurs de données (par exemple des bibliothèques) et un fournisseur de service (qui peut être une autre bibliothèque, un centre de documentation, un site web, un portail thématique, etc.) désirant réutiliser ces données.

Le protocole OAI-PMH est très simple et s'articule autour des normes HTTP et XML. Le protocole HTTP est utilisé pour le transfert des données entre une base de données de documents et un moissonneur (harvester). Le format XML est utilisé pour représenter les données échangées de façon structurée. Ainsi vous pouvez à l'aide d'un simple navigateur Web interroger une base de données OAI tel Calypso et récupérer le fichier XML résultant pour un traitement subséquent.

Une requête OAI est en fait une requête HTTP et est toujours constituée d'un URL de base propre à un dépôt. Cet URL de base est complété par une liste d'arguments sous la forme de paires nom=valeur. Le protocole OAI définit justement quelles peuvent être ces paires nom=valeur.

Une réponse OAI (réponse faite par un dépôt suite à une requête effectuée par un moissonneur) est toujours en format XML, sous la forme d'un document XML unique et bien formé.

Le protocole OAI est composé de six instructions (verb). Le tableau suivant décrit ces instructions, en mentionnant les paramètres qui peuvent être associés. Un paramètre suivi d'un astérisque(*) indique qu'il est obligatoire.

La syntaxe pour utiliser ces instructions et paramètres dans une requête OAI-PMH est de la forme suivante :
[URL de base de la base de données de documents]?verb=[instruction]&[paramètre]=valeur&[paramètre]=valeur

Les spécifications du protocole sont en ligne à l'adresse suivante:http://www.openarchives.org/OAI/openarchivesprotocol.html

L'URL de base de Calypso est: http://calypso.bib.umontreal.ca/cgi-bin/oai.exe

Exemples de requêtes:

• Lister les ensembles (qui correspondent aux collections) de Calypso:
  http://calypso.bib.umontreal.ca/cgi-bin/oai.exe?verb=ListSets
• Lister uniquement les identifiants des documents de la collection "Paysages du Nouveau-Québec de 1974 à 1984"
  (identifiant "_nquebec" obtenu dans la réponse à la requête précédente)
  http://calypso.bib.umontreal.ca/cgi-bin/oai.exe?verb=ListIdentifiers&metadataPrefix=oai_dc&set=_nquebec
• Obtenir les métadonnées du document portant l'identifiant "oai:calypso.bib.umontreal.ca:_diame/1452" (Écluses de Saint-Lambert):
  http://calypso.bib.umontreal.ca/cgi-bin/oai.exe?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:calypso.bib.umontreal.ca:_diame/1452
• Pour une récolte périodique par exemple, lister uniquement les métadonnées des documents déposés/modifiés depuis le 1er juin 2013 dans la collection "Images d'aménagement":
  http://calypso.bib.umontreal.ca/cgi-bin/oai.exe?verb=ListRecords&metadataPrefix=oai_dc&set=_diame&from=2013-06-01