<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.12 Maintainer: cucinato Status: ready -->
<!-- 
CCVS Documentation by Brendan W. McAdams <brendan@plexmedia.com>
Copyright (c) 2000 by the PHP Group

-Special Thanks to Red Hat, Inc. for the contribution of their original
documentation for the php3 version of this module, which helped us
start this document.  
-->
 
 <reference id="ref.ccvs">
  <title>Funzioni API CCVS</title>
  <titleabbrev>CCVS</titleabbrev>

  <partintro>
   <simpara>
    Queste funzioni si interfacciano con le API CCVS, permettendo di 
    lavorare direttamente con CCVS dagli script PHP.  CCVS &egrave; la soluzione di <ulink
    url="&url.redhat;">RedHat</ulink> per il  "mediatore"
    nella gestione dei pagamenti con carta di credito. Permette di comunicare direttamente
    con le societ&agrave; di autorizzazione di transazione attraverso una *nix box e un modem. Usando
    il modulo CCVS per PHP, &egrave; possibile procesare direttamente le carte di credito
    attraverso gli script PHP. Le seguenti informazioni
    esemplificheranno il processo.
   </simpara>
   <simpara>
    Per abilitare il supporto CCVS in PHP, occorre innanzitutto verificare la directory 
    dell'installazione CCVS. Occorrer&agrave; poi configurare PHP con l'opzione <option
    role="configure">--with-ccvs</option>. Se si usa questa
    opzione senza specificare il percorso all'installazaione CCVS, il PHP
    cercher&agrave; nel percorso di installazione di CCVS di default
    (/usr/local/ccvs). Se il CCVS &egrave; in un percorso non standard, eseguire
    configure con: <option
    role="configure">--with-ccvs=$ccvs_path</option>, dove $ccvs_path
    &egrave; il percorso dell'installazione di CCVS. Si noti che il supporto CCVS
    richiede che $ccvs_path/lib e $ccvs_path/include esistano,
    e include cv_api.h nella directory include e libccvs.a
    nella directory lib.
   </simpara>
   <simpara>
    Inoltre, un processo ccvsd deve essere attivato con le
    configurazioni che si vogliono utilizzare negli script PHP. Si
    dovr&agrave; anche assicurarsi che i processi PHP siano eseguiti con
    lo stesso utente del CCVS (es. se CCVS &egrave; installato
    come utente 'ccvs', i processi PHP devono pure essere eseguiti come utente
    'ccvs'.)
   </simpara>
   <simpara>
    Additional information about CCVS can be found at <ulink
    url="&url.redhat.ccvs;">&url.redhat.ccvs;</ulink>.
   </simpara>
   <simpara>
    Questa sezione di documentazione &egrave; ancora in sviluppo. Nel frattempo, RedHat
    mantiene della documentazione leggermente datata ma comunque utile 
    press <ulink url="&url.redhat.support;">&url.redhat.support;</ulink>.
   </simpara>
   <simpara>
     Aggiornamento: CCVS  stato abandonato da Red Hat e non ci sono progetti
     di emissione di ulteriori chiavo o contratti di supporto. Chi cerca un
     sostituto pu considerare 
     <ulink url="&url.redhat.mcve;">MCVE di Main Street Softworks</ulink>
     come un'alternativa.  simile nella struttura e ha un supporto PHP
     documentato!
   </simpara>
  </partintro>

  <refentry id="function.ccvs-init">
   <refnamediv>
    <refname>ccvs_init</refname>
    <refpurpose>Inizializza CCVS per il successivo utilizzo</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_init</methodname>
      <methodparam><type>string</type><parameter>nome</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-done">
   <refnamediv>
    <refname>ccvs_done</refname>
    <refpurpose>Ferma il processo CCVS e ripulisce gli oggetti creati</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_done</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-new">
   <refnamediv>
    <refname>ccvs_new</refname>
    <refpurpose>Crea una nuova transazione, vuota</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_new</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-add">
   <refnamediv>
    <refname>ccvs_add</refname>
    <refpurpose>Aggiunge dati ad una transazione</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_add</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
      <methodparam><type>string</type><parameter>tipo_arg</parameter></methodparam>
      <methodparam><type>string</type><parameter>valore_arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-delete">
   <refnamediv>
    <refname>ccvs_delete</refname>
    <refpurpose>Cancella una transazione</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_delete</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-auth">
   <refnamediv>
    <refname>ccvs_auth</refname>
    <refpurpose> 
     Esegue un test di autorizzazione al credito su una transazione
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_auth</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-return">
   <refnamediv>
    <refname>ccvs_return</refname>
    <refpurpose>
     Trasferisce fondi dal merchant al titolare della carta di credito 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_return</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-reverse">
   <refnamediv>
    <refname>ccvs_reverse</refname>
    <refpurpose>
     Esegue uno storno su un'autorizzazione gi&agrave; processata 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_reverse</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-sale">
   <refnamediv>
    <refname>ccvs_sale</refname>
    <refpurpose>
     Trasferisce fondi dal titolare della carta di credito al merchant
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_sale</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-void">
   <refnamediv>
    <refname>ccvs_void</refname>
    <refpurpose>
     Esegue uno storno su una transazione gi&agrave; completata 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_void</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-status">
   <refnamediv>
    <refname>ccvs_status</refname>
    <refpurpose>Controlla lo stato di una fattura</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_status</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-count">
   <refnamediv>
    <refname>ccvs_count</refname>
    <refpurpose>
     Conta quante transazioni di un dato tipo sono archiviate nel sistema 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>int</type><methodname>ccvs_count</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>tipo</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-lookup">
   <refnamediv>
    <refname>ccvs_lookup</refname>
    <refpurpose>
     Cerca una voce di un determinato tipo nel database #
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_lookup</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>fattura</parameter></methodparam>
      <methodparam><type>int</type><parameter>num</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-report">
   <refnamediv>
    <refname>ccvs_report</refname>
    <refpurpose>Restituisce lo stato del processo di comunicazione </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_report</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>tipo</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-command">
   <refnamediv>
    <refname>ccvs_command</refname>
    <refpurpose>
     Esegue un comando caratteristico di un particolare protocollo, 
     quindi non disponibile nelle API di CCVS
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_command</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
      <methodparam><type>string</type><parameter>tipo</parameter></methodparam>
      <methodparam><type>string</type><parameter>val_arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ccvs-textvalue">
   <refnamediv>
    <refname>ccvs_textvalue</refname>
    <refpurpose>Restuisce il valore testuale reso dalla precedente chiamata di funzione</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descrizione</title>
     <methodsynopsis>
      <type>string</type><methodname>ccvs_textvalue</methodname>
      <methodparam><type>string</type><parameter>sessione</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->