IdRef pour les développeurs

4.3. Construction de la requête (envoiClient) :

Exemple :

envoiClient ("Nom de personne",

"Matias Martinez",

« « ,

"",

"Langues",

"ger",

"Type de notice/Personne",

"Martinez",

"Matias",

"ger",

"20100101",

"Texte de la source",

"true"

);

Les valeurs doivent être passées dans l'ordre illustré ci-dessus.

Les noms et les valeurs des index et des filtres de recherche sont identiques à ceux qui sont affichés dans l'interface Web d'IdRef.

Index1. Index principal. Les valeurs possibles sont :

Index1 = index de recherche principal

Valeur

Signification

Nom de personne

Nom de collectivité

Nom commun

Rameau ou MesH

Nom géographique

Famille

Titre

Titre uniforme

Auteur-Titre

Nom de marque

Ppn

Identifiant de notice

Rcr

Codes RCR des bibliothèques Sudoc

Tout

Tous index confondus

Index1Value : valeur de cet index

Exemple : Index1:"Nom commun",Index1Value:zola

Index2 : Non utilisé aujourd'hui

Index1Value : valeur de Index2.

Index3 . Aujourd'hui, la seule valeur possible de Index3 est : Langues

Index2Value. Les valeurs possibles sont les codes de langue ISO 639-2 (sur trois caractères).

Exemple : Index3:"Langues",Index3Value:fre

Le passage des filtres doit suivre les règles que l’on retrouve dans l’interface web. En effet, en fonction de l’index choisi, certains filtres ne doivent pas êtres valués.

4 filtres sont définis :

Exemple : Filtre1:"Type de notice/Rameau"

Exemple : Filtre2:"En vedette/Oui"

En vie

Valeur

Signification

Non 

Personne morte ou Collectivité éteinte

Oui 

Personne vivante (ou date de décès non précisée) ou Collectivité existante (ou date d'extinction non précisée

En vedette

Valeur

Signification

Oui 

Utilisable en tête de vedette

Non 

Non utilisable en tête de vedette

En subdivision

Valeur

Signification

Oui 

Utilisable en subdivision

Non 

Non utilisable en subdivision

Type de notice

Valeur

Signification

Personne

Collectivité

Famille

Auteur-Titre

Chronologie

Rameau

Fmesh

Géographique

Titre

Titre uniforme

Rcr

Code RCR de Bibliothèque Sudoc

Marque

Dans le cas où la notice d'autorité à lier n'existe pas encore dans la base d'IdRef, il peut être nécessaire de créer une nouvelle notice. Afin de faciliter ce travail, l'application cliente peut envoyer à IdRef des données qui serviront à pré-remplir le formulaire de catalogage.

Ces données doivent être conformes aux valeurs attendues par le format de catalogage du Sudoc. [1]

Pour identifier une zone UNIMARC à pré-remplir, il suffit de suivre la convention suivante :

z{code de zone}_{code de sous-zone}

z103_a

Exemple :

Le paramètre z103_a:"20100101" permet de pré-remplir le champ Date de naissance dans le formulaire de catalogage. En effet, la sous-zone 103 $a contient une date, selon la syntaxe AAAAMMJJ.

Exemple :

Le paramètre z810_a:"texte" permet de pré-remplir le champ Source consultée avec profit, qui correspond au 810$a en UNIMARC.

Exemple :

Le paramètre z101_a:"ace" permet de pré-remplir la langue d'expression, qui correspond au 101$a en UNIMARC. La valeur "ace" est un code de langue ISO.

Ce paramètre AutoClick doit toujours être présent à la fin des paramètres.

Il prend pour valeur true ou false.

Il permet (ou empêche) de déclencher automatiquement la recherche dans IdRef.

Exemples :

AutoClick:"true"

AutoClick:"false"