====== wAdoConnect ======

Este componente nos crea una conexión a un servidor de Base de Datos SQL (MySQl, MariaDB, SQLLite, SQLServer, Firebird, Interbase o PostgreSQL) mediante ODBC utilizando ADO.

<Code:xailer linenums:1>
   WITH OBJECT wAdoConnect():New()
     :cHost   := "192.168.1.1"
     :cUser   := "user"
     :cPass   := "1234"
     :nEngine := xc_MariaDB
     :cDriver := "MariaDB ODBC 3.1 Driver"
     :Connect()
   END WITH
</Code>

En caso de producirse algún error durante una tarea con el wAdoConnect, podemos consultar el error producido con; 
  * Application:hAdoError["Title"] - Que estará vacío si no se ha producido ningún error.
  * Application:hAdoError["Text"] - Texto extra del error 
  * Application:hAdoError["Code"] - Código de error devuelto por la conexión.


===== Configuración de Apache =====
Hay que tener en cuenta que **wAdoConnect** utiliza OLE para conectarse a ODBC, por lo que debemos tener configurado Apache para que pueda encontrar OLE.

Para eso debemos añadir al fichero **httpd.conf**, que encontraremos en **\Apache24\conf** las siguientes líneas; <Code>
  # Para tener una variable que apunte a la carpeta cgi-bin
  Define CGIROOT "c:/Apache24/cgi-bin"

  # Para que funcione el OLE dentro de Apache
  SetEnv ProgramFiles "C:\Program Files"
  SetEnv "ProgramFiles(x86)" "C:\Program Files (x86)"
  SetEnv ProgramFilesW6432 "C:\Program Files"
  SetEnv CommonProgramFiles "C:\Program Files\Common Files"
  SetEnv "CommonProgramFiles(x86)" "C:\Program Files (x86)\Common Files"
  SetEnv CommonProgramFilesW6432 "C:\Program Files\Common Files"
</Code>
Yo tengo por costumbre ponerlas debajo de 'ServerRoot "${SRVROOT}"'.

**Si hemos ejecutado [[utilidades:nefelewizard|Néfele Wizard]] en la máquina, existirán esas líneas ya que las crea al detectar Apache.**


===== Propiedades =====

^Nombre         ^Init   ^Descripción                                                                     ^Versión ^
| lAbortOnErrors  |  .F.  | Cancela la ejecución en caso de algún error |  0.3.5|
| lDisplayErrors  |  .F.  | Nos envía a [[utilidades:nefeleconsole|Néfele Console]] el error que se ha producido |  0.3.5|
| cLastError |    | Código del error |  0.3.5|
| cMsgError  |    | Mensaje del Error  |  0.3.5|
| cHost |    | Servidor al que vamos a conectarnos (en SQLite no tiene uso)   |  0.3.5|
| cUser |    | Usuario para la conexión  |  0.3.5|
| cPassword |    | Contraseña del Usuario  |  0.3.5|
| cDriver |    | Driver ODBC que se utilizara para la conexión  |  0.3.5|
| cClientDLL |    | Librería DLL que se utilizara en Firebird, hay que incluir el Path completo |  0.3.5|
| nPort |    | Puerto de conexión  |  0.3.5|
| [[nefele:constantes#seleccion-de-tipo-de-base-de-datos|nEngine]] |  xc_MariaDB  | Tipo de Base de datos  |  0.3.5|
| cConnect |  | Si no utilizamos nEngine tendremos que indicarle la cadena de conexión |  0.3.5|
| nTimeOut |  20  | Segundos de timeout en la conexión |  0.3.5|
| aFileds  |      | Cabeceras de la ultima consulta SQL |  0.3.5|
| nRecCount |   | Número de registros recuperados en la ultima consulta SQL|  0.3.5|

===== Métodos=====
^Método                         ^Descripción            ^Versión ^
|Connect( cConnect )  | Establece la conexión con el Servidor de Base de Datos, si hemos defino las propiedades de conexión no es necesario pasarle cConnect  |  0.3|
|Disconnect()  | Cierra la conexión con el Servidor de Base de Datos.  |  0.3|
|Execute( cSelect )  | Ejecuta una cadena SQL, nos retorna .T. si se ha podido ejecutar.  |  0.3|
|[[metodos:buildsqlst|BuildSQLSt]]  | Nos permite construir una select con una plantilla.  |  0.3|
|QueryArray( cSelect, @aHeader )  | Devuelve un Array de registros (aunque se un solo registro devolverá un array bidimensional)  |  0.3|
|QueryArrayHash( cSelect, @aHeader )  | Devuelve un Array de Hash (aunque sea un solo registro devolverá un array bidimensional)  |  0.3|
|QueryValue( cSelect, xDefault )  | Devuelve solo un valor, en caso de Nil devolverá xDefault.  |  0.3|
|QueryRecordSet( cSelect, @aHeader )  | Devuelve un RecordSet.  |  0.3|
|QueryRow( cSelect, @aHeader )  | Devuelve un array con los valores un registro.  |  0.3|
|QueryRowHash( cSelect, @aHeader )  | Devuelve un Hash con los valores de un registro.  |  0.3|