yaz_es
(PECL yaz >= 0.9.0)
yaz_es — Prépare pour une Requête de Service Étendu
Description
$id
,
string $type
,
array $args
)Cette fonction prépare pour une Requête de Service Étendu. Les Services Étendus sont de la famille des nombreux Z39.50, comme "Record Update", "Item Order", "Database administration", etc.
Note:
Il existe des serveurs Z39.50 qui ne supportent pas les Services Étendus.
La fonction yaz_es() crée des paquets d'une Requête de Service Étendu et les place dans une file d'attente d'opérations. Utilisez yaz_wait() pour envoyer la/les requête(s) au serveur. À la fin de yaz_wait(), le résultat de l'opération de Service Étendu devrait être obtenu avec un appel à yaz_es_result().
Liste de paramètres
-
id -
La ressource de connexion retournée par yaz_connect().
-
type -
Une chaîne de caractères représentant le type de Service Étendu : itemorder (Item Order), create (Create Database), drop (Drop Database), commit (Commit Operation), update (Update Record), xmlupdate (XML Update). Chaque type est spécifié dans la section suivante.
-
args -
Un tableau avec les options de service étendu et les options spécifiques du paquet. Les options sont identiques à celles offertes par l'API C de ZOOM C. Reportez-vous à ZOOM » Services Étendus.
Valeurs de retour
Aucune valeur n'est retournée.
Exemples
Exemple #1 Mise à Jour d'Enregistrements
<?php
$con = yaz_connect("myhost/database");
$args = array (
"record" => "<gils><title>un titre</title></gils>",
"syntax" => "xml",
"action" => "specialUpdate"
);
yaz_es($con, "update", $args);
yaz_wait();
$result = yaz_es_result($id);
?>