Quick Reference For Attribute Fields
(eg: "@attr 2=" refers to the Relation attribute)
1 = Use Field
2 = Relation
3 = Position
4 = Structure
5 = Truncate
6 = Completeness
yaz_search
(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)
yaz_search — Prépare une recherche
Description
yaz_search() prépare une recherche sur la connexion donnée
Comme pour yaz_connect(), cette fonction n'est pas bloquante et ne fait que préparer la recherche pour exécution ultérieure lorsque yaz_wait() est appelée.
Liste de paramètres
-
id -
La ressource de connexion retournée par yaz_connect().
-
type -
Ce paramètre représente le type de requête - seul
"rpn"est supporté actuellement et, dans ce cas, le troisième argument est un préfixe de notation de requête utilisé par YAZ. -
query -
Les requêtes RPN sont des représentations textuelles des requêtes de type Type-1, comme défini dans le standard Z39.50. Cependant, dans la représentation textuelle utilisée par YAZ, une notation à préfixe est utilisée, c'est-à-dire que l'opérateur précède l'opérande. La chaîne de requête est une séquence de mots réservés, où les espaces sont ignorés, à moins qu'ils n'aient été mis entre guillemets doubles. Les mots réservés qui commencent par un arobase (
@) sont considérés comme des opérateurs et traités comme tels.Opérateurs RPN Syntaxe Description @andquery1 query2intersection des requêtes query1 et query2 @orquery1 query2union des requêtes query1 et query2 @notquery1 query2requêtes "query1 et non(query2)" @setnamenomme le résultat @attrsetset queryspécifie le jeu d'attributs de la requête. Cette construction n'est autorisée qu'une seule fois, au début d'une requête. @attr[set] type=value queryapplique les attributs à une requête. Le type et la valeur sont des entiers indiquant les types et valeurs des attributs, dans cet ordre. Le jeu, si fourni, spécifie le jeu d'attributs utilisé. Vous pouvez trouver des informations sur les attributs sur le site » Z39.50 Maintenance Agency.
Note:
Dans le cas où vous voudriez utiliser une notation plus facile, utilisez l'analyseur CCL - fonctions yaz_ccl_conf() et yaz_ccl_parse().
Valeurs de retour
Cette fonction retourne true en cas de succès ou false si une erreur survient.
Exemples
Exemple #1 Exemples de Requête
Vous pouvez chercher pour des termes simples, comme ceci :
ordinateur
La requête
"knuth donald"
Cette requête applique deux attributs à la même phrase.
@attr 1=1003 @attr 4=1 "knuth donald"
Le premier attribut est de type 1 (Bib-1), et sa valeur est 1003
(Auteur).
Le second attribut est de type 4 (structure), valeur 1 (phrase),
ce qui fait que la requête recherche les documents dont
Donald Knuth est l'auteur.
La requête
@and @or a b @not @or c d e
(a or b) and ((c or d) not e).
Un autre exemple, plus complexe :
@attrset gils @and @attr 1=4 art @attr 1=2000 company
art
apparaît dans le titre (GILS,BIB-1) et dont la société
(company) apparaît comme distributeur (GILS).
add a note
User Contributed Notes 3 notes
jwohlers at mail dot wcc dot cc dot il dot us ¶
22 years ago
k dot andris at gmail dot com ¶
15 years ago
To display holdings data set the syntax and the record format to "opac" (at least for Horizon ILS). It will give you an xml, containg <holding> elements with all info:
<?php
$z = yaz_connect(...
yaz_syntax($z, 'opac');
yaz_search($z, 'rpn', '@attr 1=4 "title%"');
yaz_wait();
$hits = yaz_hits($z);
yaz_range($z, 1, $hits);
yaz_present($z);
for($i = 1; $i <= $hits; $i++)
my_display(yaz_record($z, $i, 'opac'));
yaz_close($z);
function my_display($s)
{
$lines = explode("\n", trim($s));
var_dump($lines);
}
?>
