<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.yaz.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.yaz-es.php',
    1 => 'yaz_es',
    2 => 'Prepara para una solicitud de servicio extendido',
  ),
  'up' => 
  array (
    0 => 'ref.yaz.php',
    1 => 'Funciones 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' => 'es',
    '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);

?>
<div id="function.yaz-es" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">yaz_es</h1>
  <p class="verinfo">(PECL yaz &gt;= 0.9.0)</p><p class="refpurpose"><span class="refname">yaz_es</span> &mdash; <span class="dc-title">
   Prepara para una solicitud de servicio extendido
  </span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.yaz-es-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>yaz_es</strong></span>(<span class="methodparam">
    <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$id</code>
   </span>, <span class="methodparam">
    <span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$type</code>
   </span>, <span class="methodparam">
    <span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$args</code>
   </span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>

  <p class="para rdfs-comment">
   Esta función prepara para una solicitud de servicio extendido.
   Los servicios extendidos es la familia de diversas facilidades Z39.50, tales como
   actualización de registros, ordenado de ítem, administración de base de datos, etc.
  </p>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    Muchos servidores Z39.50 no soportan servicios extendidos.
   </p>
  </p></blockquote>
  <p class="para">
   La <span class="function"><strong>yaz_es()</strong></span> crea un paquete de solicitud de servicio
   extendido y la pone en una cola de operaciones.
   Se utiliza <span class="function"><a href="function.yaz-wait.php" class="function">yaz_wait()</a></span> para enviar la(s) solicitud(es) al servidor.
   Después de completar <span class="function"><a href="function.yaz-wait.php" class="function">yaz_wait()</a></span> el resultado de
   la operación del servicio extendido se debe esperar con
   una llamada a <span class="function"><a href="function.yaz-es-result.php" class="function">yaz_es_result()</a></span>.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.yaz-es-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">id</code></dt>
     <dd>
      <p class="para">
       El recurso de conexión devuelto por <span class="function"><a href="function.yaz-connect.php" class="function">yaz_connect()</a></span>.
      </p>
     </dd>
    
    
     <dt><code class="parameter">type</code></dt>
     <dd>
      <p class="para">
       Un string que representa el tipo de servicio extendido:
       <code class="literal">itemorder</code> (Ordenado de ítem),
       <code class="literal">create</code> (Crear base de datos),
       <code class="literal">drop</code> (Descartar base de datos),
       <code class="literal">commit</code> (Operación de cometer),
       <code class="literal">update</code> (Actualizar registro),
       <code class="literal">xmlupdate</code> (Actualizar XML).
       Cada tipo se especifica en la sección siguiente.
      </p>
     </dd>
    

    
     <dt><code class="parameter">args</code></dt>
     <dd>
      <p class="para">
       Un array con las opciones de servicio extendido, más
       opciones específicas del paquete. Las opciones son idénticas a
       las ofrecidas en la API C de ZOOM C. Consulte a los
       <a href="http://www.indexdata.dk/yaz/doc/zoom.tkl" class="link external">&raquo;&nbsp;servicios extendidos</a> de ZOOM.
      </p>
     </dd>
    
   </dl>
  </p>

 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.yaz-es-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   No se retorna ningún valor.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.yaz-es-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 Actualizar registro</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$con </span><span style="color: #007700">= </span><span style="color: #0000BB">yaz_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"myhost/database"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$args </span><span style="color: #007700">= array (<br />    </span><span style="color: #DD0000">"record" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"&lt;gils&gt;&lt;title&gt;some title&lt;/title&gt;&lt;/gils&gt;"</span><span style="color: #007700">,<br />    </span><span style="color: #DD0000">"syntax" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"xml"</span><span style="color: #007700">,<br />    </span><span style="color: #DD0000">"action" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"specialUpdate"<br /></span><span style="color: #007700">);<br /></span><span style="color: #0000BB">yaz_es</span><span style="color: #007700">(</span><span style="color: #0000BB">$con</span><span style="color: #007700">, </span><span style="color: #DD0000">"update"</span><span style="color: #007700">, </span><span style="color: #0000BB">$args</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">yaz_wait</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">yaz_es_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$id</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

   </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.yaz-es-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.yaz-es-result.php" class="function" rel="rdfs-seeAlso">yaz_es_result()</a> - Resulados de Servicios Extendidos de Inspecci&oacute;n</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>