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 — Prepara una búsqueda
Descripción
yaz_search() prepara una búsqueda en la conexión dada.
Como yaz_connect() esta función es no bloqueante y únicamente prepara una búsqueda para ser ejecutada posteriormente cuando se llame a la función yaz_wait() .
Parámetros
-
id -
El recurso de conexión devuelto por yaz_connect().
-
type -
Este parámetro representa el tipo de la consulta - únicamente
"rpn"está soportado ahora, en cuyo caso el tercer argumento especifica una consulta de tipo Type-1 en notación de prefijo de consulta. -
query -
La consulta RPN es una representación textual de la consulta Type-1 tal y como está definida por el estandard Z39.50 . Sin embargo, en la representación del texto utilizada por YAZ se necesita una notación de prefijo, es decir que el operador precede a los operandos. El string de la consulta es una secuencia de tokens donde se ignora el espacio en blanco a menos que esté rodeado de dobles comillas. Los Tokens que empiecen con una arroba (
@) se considerarán operadores, de otro modo, se tratarán como términos de búsqueda.Operadores RPN Sintaxis Descripción @andquery1 query2intersección de las consultas query1 y query2 @orquery1 query2unión de las consultas query1 y query2 @notquery1 query2query1 y no query2 @setnameconjunto resultado de referencia @attrsetset queryespecifica el conjunto de atributos para la consulta. Esta construcción sólo se permite una sola vez - en el inicio de la consulta @attr[set] type=value queryaplica atributos a la consulta. El tipo y valor son enteros especificando el tipo del atributo y valor del atributo respectivamente. El conjunto, si se informa, especifica el conjunto atributo. Se muestra más información sobre atributos en el link » Z39.50 Maintenance Agency site.
Nota:
Si se desea utilizar una notación más amigable, utilizar el interpretador CCL - functiones yaz_ccl_conf() y yaz_ccl_parse().
Valores devueltos
Devuelve true en caso de éxito o false en caso de error.
Ejemplos
Ejemplo #1 Query Examples
Se puede buscar por términos sencillos, como en el caso siguiente:
computer
La consulta
"knuth donald"
Esta consulta aplica dos atributos para la misma frase.
@attr 1=1003 @attr 4=1 "knuth donald"
El primer atributo es de tipo type 1 (usa Bib-1), el valor del atributo es 1003
(Autor).
El segundo atributo es de tipo type 4 (estructura), valor 1 (frase),
así que debe buscar documentos donde Donald Knuth es el autor.
La consulta
@and @or a b @not @or c d e
(a or b) and ((c or d) not
e).
Otro ejemplo, más complejo:
@attrset gils @and @attr 1=4 art @attr 1=2000 company
art aparece en el título (GILS,BIB-1)
y en los que company aparece como Distributor (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);
}
?>
