array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.yaz-es.php', 1 => 'yaz_es', 2 => 'Prepara-se para uma solicitação de Serviço Estendido', ), 'up' => array ( 0 => 'ref.yaz.php', 1 => 'Funções de YAZ', ), 'prev' => array ( 0 => 'function.yaz-error.php', 1 => 'yaz_error', ), 'next' => array ( 0 => 'function.yaz-es-result.php', 1 => 'yaz_es_result', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/yaz/functions/yaz-es.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

yaz_es

(PECL yaz >= 0.9.0)

yaz_es — Prepara-se para uma solicitação de Serviço Estendido

Descrição

yaz_es( resource $id , string $type , array $args ): void

Esta função prepara para uma Solicitação de Serviço Estendido. Serviços Estendidos são uma família de vários recursos do Z39.50, como atualização de registros, pedido de itens, administração de banco de dados, etc.

Nota:

Muitos servidores Z39.50 não suportam Serviços Estendidos.

A função yaz_es() cria um pacote de solicitação de Serviço Estendido e o coloca em uma fila de operações. Use yaz_wait() para enviar a(s) solicitação(ões) ao servidor. Após a conclusão de yaz_wait(), o resultado da operação de Serviço Estendido deve ser esperado com uma chamada a yaz_es_result().

Parâmetros

id

O recurso de conexão retornado por yaz_connect().

type

Uma string que representa o tipo do Serviço Estendido: itemorder (Ordem de Item), create (Criação de Banco de Dados), drop (Remoção de Banco de Dados), commit (Operação de Confirmação), update (Atualização de Registro), xmlupdate (Atualização de XML). Cada tipo é especificado na seção a seguir.

args

Um array com opções de Serviços Estendidos, além de opções específicas do pacote. As opções são idênticas às oferecidas na API C do ZOOM C. Consulte os » Serviços Estendidos do ZOOM.

Valor Retornado

Nenhum valor é retornado.

Exemplos

Exemplo #1 Atualização de Registro

<?php
$con = yaz_connect("myhost/database");
$args = array (
"record" => "<gils><title>some title</title></gils>",
"syntax" => "xml",
"action" => "specialUpdate"
);
yaz_es($con, "update", $args);
yaz_wait();
$result = yaz_es_result($id);
?>

Veja Também