yaz_es
(PECL yaz:0.9-1.0.9)
yaz_es — Prépare pour une Requête de Service Étendu
Description
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: Plusieurs serveurs Z39.50 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 queue 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 qui représente 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. Référez-vous à ZOOM » Services Étendus.
Valeurs de retour
Aucune valeur n'est retournée.
Exemples
Example#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);
?>