Sign in Join
Wiki copytemporary

Zeos tutorial/es: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

OldNewLine
11## Descripción
22
33Este tutorial trata acerca de como obtener, instalar y utilizar Zeoslib con [[Glossary|Lazarus]] y [[Glossary|FPC]].\
44
55**El equipo de Zeos tiene su propio foro. Es el mejor sitio para obtener más información acerca de ZeosLib y para hacer/responder cuestiones sobre su utilización y reporte de errores. Podéis acceder al mismo a través de [foro sobre ZeosLib](http://zeoslib.sourceforge.net/).**.
66
77Gracias al equipo de ZeosDBO y colaboradores por hacer posible que este paquete esté disponible también para Lazarus / FPC. Han realizado un magnífico trabajo. Si alguno de ellos quiere contribuir a documentar en más profundidad el uso de este paquete o aportar ejemplos sencillos para su uso con diferentes bases de datos ayudaría a los que estamos empezando.
88
99Adicionalmente existe un interesante tuorial en este sitio, tiene la opción de traducción al idioma del visitante:
1010
1111<http://serge-girard.developpez.com/tutoriels/temp/ZeosDBO/>
1212
1313## Obteniendo Zeos
1414
1515Zeos ha sido portado a [[Glossary|Lazarus]] y se puede descargar desde [Sourceforge.net](http://sourceforge.net/projects/zeoslib/)aunque también hay releases que pueden obtenerse fácilmente desde su SVN siguiendo los pasos siguientes:
1616
1717### Windows
1818
1919- Conseguir un cliente SVN, por ejemplo [TortoiseSVN](http://tortoisesvn.tigris.org) e instalarlo
2020- Ver [Getting Started with TortoiseSVN](http://tortoisesvn.net/docs/release/TortoiseSVN_en/help-onepage.html#tsvn-dug-general)
2121- Hacer un Checkout desde Windows Explorer: <http://svn.code.sf.net/p/zeoslib/code-0/trunk>
2222
2323### Linux/BSD
2424
2525- Conseguir un cliente SVN (esvn, kdesvn, etc.)
2626- Crear el directorio zeosdbo, acceder al mismo y desde consola hacer
2727- svn checkout <http://svn.code.sf.net/p/zeoslib/code-0/trunk>
2828
2929## Instalando los componentes
3030
3131Esta es una parte complicada por lo que debes tener un poco de paciencia y leer este apartado cuidadosamente.
3232
3333- Comprueba que tienes al menos la versión 1.0.4 de Lazarus (diciembre 2012) y al menos la versión 7.0.3 estable de ZeosLib.
3434
3535- Comenzar una instancia de Lazarus.
3636
37371. Pulsar en **Paquete/Abrir archivo de paquete (.lpk)** desde el menú principal.
38382. Ve a **.\ZEOSDBO-7.0.3-stable\packages\lazarus** y abre **zcomponent.lpk**
39393. Presiona **\[Compilar\]** solamente si no necesitas instalar los componentes en el IDE.
40404. Presiona **\[Usar \>\>\]** para ver las opciones que ofrece.
41415. Selecciona **Agregar al Proyecto** si no quieres añadirlo al IDE o bien **Instalar** para que se añada a la solapa del IDE de Lazarus
42426. Pregunta si necesitas recompilar Lazarus, en concreto con el mensaje emergente '''El paquete "zcomponent 7.0" se marcó para instalar. Actualmente lazarus solo soporta paquetes enlazados estáticamente. La instalación completa necesita reconstruir y reiniciar Lazarus ¿Desea reconstruir ahora Lazarus?
4343
4444- Responde **\[Si\]** esta vez.
4545- Espera a que la compilación termine, la ventana emergente de mensajes nos va mostrando la evolución del proceso, Lazarus debería reiniciarse después de esto.
4646- Si todo está bien se debería ver la solapa **\[Zeos Access\]** en la paleta de componentes.
4747
48-<img src="Zeos_Components.png" title="Zeos_Components.png" width="650" />
48+![](/wiki-images/2/25/Zeos_Components.png)
4949
5050Si se presenta el error "Cannot find unit ZClasses" o algo similar, entonces hay que chequear cuidadósamente como están escritos los nombres de fichero (en cuanto a mayúsculas/minúsculas) en sus ficheros de código fuente.
5151
5252- Incluso si cuadran exactamente, el paquete autogenerado del fichero fuente puede dar lugar a un tipificado incorrecto (mayúsculas/minúsculas) en la claúsula "uses" (Lazarus 0.9.18), i.e.:
5353
5454Si lo anterior falla, tal como se explica en el foro de ZeosLib es conveniente ir compilando cada uno de los paquetes siguiendo el siguiente orden:
5555
5656`  - 1º. zcore.lpk`
5757
5858`  - 2º. zparsesql.lpk`
5959
6060`  - 3º. zplain.lpk`
6161
6262`  - 4º. zdbc.lpk`
6363
6464`  - 5º. zcomponent.lpk `
6565
6666Si el resultado de la compilación individual de todos es correcto, entonces ya estaríamos en condiciones de escoger el paquete Zcomponent y con la opción de **Usar \>\>\>** y a continuación **Instalar** tenerlo en nuestro IDE como una solapa más de componentes visuales.
6767
6868``` pascal
6969
7070 { Este fichero ha sido generado automáticamente por Lazarus. ¡No se debe editar!
7171 Esta fuente solo se utiliza para compilar e instalar el paquete.
7272 }
7373 unit Zcore;
7474 interface
7575 uses
7676 Zclasses, Zcollections, Zcompatibility, Zexprparser, Zexprtoken, Zexpression,
7777 Zfunctions, Zmatchpattern, Zmessages, Zsysutils, Ztokenizer, Zvariables,
7878 Zvariant;
7979 implementation
8080 end.
8181```
8282
8383- Fíjate que Lazarus ha renombrado la unit ZClasses como Zclasses, dando lugar a un conflicto de nombres. Presumiblemente este es un error en Lazarus, no de los paquetes Zeos. Un camino a seguir para solucionarlo es renombrar todos los ficheros fuente de Zeos a minúsculas. Accede a cada subdirectorio bajo src/ y ejecuta este mandato en una ventana de bash (shell) de windows:
8484
8585` rename -v 'y/A-Z/a-z/' *`
8686
8787- Entonces, en Lazarus, reabre el paquete (.lpk) y corrige el nombre de fichero (mayúsculas/minúsculas) seleccionando en "More..."/"Fix Files Case"
8888- El paquete debería poderse compilar entonces.
8989
9090## Descripción de la paleta de componentes ZeosDBO
9191
9292**La descripción detallada de cada uno de los componentes de la paleta es:**
9393
94-<img src="PaletaComponentesZeos.png" title="PaletaComponentesZeos.png" width="650" />
94+![](/wiki-images/2/2d/PaletaComponentesZeos.png)
9595
9696### Componente TZConnection (ZConnection):
9797
9898![Componente TZConnection (ZConnection)](/wiki-images/5/5c/TZConnection.png) ===\>**Componente TZConnection (ZConnection):**
9999
100100**Nos va a permitir conectar con la base de datos (BBDD). Tiene una serie de propiedades (disponibles también en el inspector de objetos) como son:**
101101
102102- **AutoCommit**: boolean (**true**/**false**).
103103
104104- **AutoEncodeStrings**: boolean (**true**/**false**).
105105
106106- **Catalog**: ejemplo **public**
107107
108108- **ClientCodepage**: ejemplo **Spanish_Spain.1252**
109109
110110- **Connected**( * ): boolean (**true**/**false**), si establecemos su valor a **true** podremos ver en tiempo de diseño si la conexión es aceptada, caso contrario nos volverá a establecer automáticamente **false**.
111111
112112- **ControlsCodePage**:
113113
114114:* **cCP_UTF16**
115115
116116:* **cCP_UTF8**
117117
118118:* **cGET_ACP**
119119
120120- **Database**: aquí especificamos el nombre de la base de datos a la cual queremos conectar y que contendrá una o más tablas. Atención que si utilizamos SQLite, si la BBDD no existe, la crea.
121121
122122- **DesignConnection**: boolean (**true**/**false**), establecemos su valor a true en caso de que queramos tener activa la conexión en tiempo de diseño de forma que se autorellenen los controles de bases de datos que situemos en el formulario.
123123
124124- **HostName**( * ): es el nombre del equipo que contiene la(s) base(s) de datos a las que deseamos conectar. Pueden encontrarse en una ubicación local con lo que podríamos poner **localhost** o bien **127.0.0.1**, pero también en una ubicación en red local o incluso en internet, siendo por ejemplo para una red local **192.168.1.12**. En el caso de resolver mediante resolución de nombre DNS también valdría el nombre del equipo.
125125
126126- **LibraryLocation**: aquí especificamos la ubicación de los ficheros librería que vamos a necesitar para el caso concreto del protocolo que escojamos. Por ejemplo si en protocolo escogemos **postgresql-9** y nuestro programa lo tenemos en C:\test\\ entonces como valor de **LibraryLocation** podríamos poner **C:\test\libpq.dll**. Para Linux la librería podría ser libpq.o e igualmente la situariamos en la carpeta de nuestro programa por ejemplo **/opt/test/libpq.so**. En Linux hay que tener en cuenta que quizá necesitemos establecer un enlace simbólico dado que la libería la podemos encontrar con el nombre adaptado a la versión de PostgreSQL para que el genérico libpq enlace a la versión instalada (Linux utiliza ampliamente el nombre del fichero para especificar las versiones del fichero independientemente que en algunos casos el formato interno también pueda contener información del formato, ver por ejemplo mandato readelf de Linux). Estas liberías (puede que necesitemos para nuestro programa otras adicionales) las podemos coger de la instalación de PostgreSQL (C:\Archivos de programa\PostgreSQL\9.x\bin) para otras bases de datos habrá que mirar donde se encuentran. En el caso de Windows también podemos ubicar esta libería en c:\windows\system32 o bien c:\windows\syswow64. Y luego decidir si se registra también o no.
127127
128128- **LoginPromt**: boolean (**true**/**false**). En caso de valer **true** debería presentarnos un cuadro de solicitud de login.
129129
130130- **Name**( * ): simplemente nos deja establecer el nombre personalizado del componente de forma que es la referencia que vamos a utilizar en nuestro programa.
131131
132132- **Password**( * ): aquí especificamos la palabra de paso o contraseña. Durante el periodo de diseño también la podemos rellenar en el inspector de objetos o bien en tiempo de ejecución del programa.
133133
134134- **Port**: es el número de puerto que se utiliza junto a **HostName** para identificar de forma inequívoca el equipo con el que queremos conectar. Para el caso de PostgreSQL sería por ejemplo el **5432** o **3306** para MariaDB..... Para cada tipo de base de datos suele haber uno característico aunque en la configuración se puede cambiar (Para cada tipo de base de datos es conveniente revisar la documentación para ver las que soporta).
135135
136136- **Properties**: algunas propiedades para la conexión a la base de datos (para cada tipo de base de datos es conveniente revisar la documentación para ver las que soporta), por ejemplo:
137137
138138:***AutoEncodeStrings=ON**
139139
140140:***codepage=Spanish_Spain.1252**
141141
142142- **Protocol**( * ):
143143
144144:* ASA: **ASA12** / **ASA7** / **ASA8** / **ASA9**
145145
146146:* firebird-x.x: **firebird-1.0** / **firebird-1.5** / **firebird-2.0** / **firebird-2.1** / **firebird-2.5**
147147
148148:* firebirdd-x.x: **firebirdd-1.5** / **firebirdd-2.0** / **firebirdd-2.1** / **firebirdd-2.5**
149149
150150:* [FreeTDS_MsSQL](http://www.freetds.org/): **FreeTDS_MsSQL\<=6.5** / **FreeTDS_MsSQL\>=2005** / **FreeTDS_MsSQL-2000** / **FreeTDS_MsSQL-7**
151151
152152:* [FreeTDS_Sybase](http://www.freetds.org/): **FreeTDS_Sybase\<10** / **FreeTDS_Sybase-10+**
153153
154154:* **interbase-6**
155155
156156:* **MariaDB-5**
157157
158158:* **mssql**
159159
160160:* mysql: **mysql** / **mysql-4.1** / **mysql-5** / **mysqld-4.1** / **mysqld-5**
161161
162162:* **oracle**
163163
164164:* **oracle-9i**
165165
166166:* **pooled.***
167167
168168:* postgresql: **postgresql** / **postgresql-7** / **postgresql-8** / **postgresql-9**
169169
170170:* sqlite: **sqlite** / **sqlite-3**
171171
172172:* **sybase**
173173
174174- **ReadOnly**: boolean (**true**/**false**). Permite especificar si nuestra conexión va a ser de solo lectura (valor a **true**) o de lectura/escritura (valor a **false**).
175175
176176- **SQLHourGlass**: boolean (**true**/**false**). En caso de establecer su valor a **true**, entonces nos mostrará un reloj de arena mientras se espera que termine algún proceso SQL en curso.
177177
178178- **Tag**: etiqueta que en el inspector de objetos nos la pone predeterminada a **0**.
179179
180180- **TransactIsolationLevel**: permite definir el nivel de aislamiento de las transacciones que se realicen:
181181
182182:* **tiNone**
183183
184184:* **tiReadCommitted**
185185
186186:* **tiReadUnCommitted**
187187
188188:* **tiRepeatableRead**
189189
190190:* **tiSerializable**
191191
192192- **UseMetaData**: boolean (**true**/**false**). Permite especificar si se utilizan o no metadatos.
193193
194194- **User**( * ): el nombre de usuario que utilizaremos para conectar a la base de datos seleccionada para esta conexión. Dado que permite establecer múltiples conexiones podríamos conectarnos con otro nombre de usuario y a otra base de datos distinta al mismo tiempo utilizando otro componente ZConnection.
195195
196196- **Version**: nos muestra la versión de Zeos DBO que estemos utilizando. A modo de ejemplo nos podría mostrar **7.1.4-stable**.
197197
198198### Componente TZReadOnlyQuery (ZDataSet)
199199
200200![Componente TZReadOnlyQuery (ZDataSet)](/wiki-images/6/6a/TZReadOnlyQuery.png) ===\> **Componente TZReadOnlyQuery (ZDataSet)**
201201
202202**Nos va a permitir realizar una consulta (query) en modo solo lectura. Tiene una serie de propiedades (disponibles también en el inspector de objetos) como son:**
203203
204204- **Active'': boolean (**true**/**false''').
205205- **AutoCalcFields**: Por defecto establecido a **true**.
206206- **Connection**: lo vinculamos a un componente connection de los que tengamos disponibles.
207207- **DataSource**:
208208- **FetchRow**: por defecto a 0.
209209- **Filter**: define la cadena de filtrado que deseamos establecer aplicada a la información retornada en la consulta.
210210- **Filtered**: boolean (**true**/**false**). Por defecto establecido a **false**. Filtrado habilitado si **true**.
211211- **IndexFieldNames**:
212212- **IsUniDirectional**: por defecto a **false**.
213213- **LinkedFields**:
214214- **MasterFields**:
215215- **MasterSource**:
216216- **Name**: aquí podemos cambiar el nombre del componente que por defecto es **ZReadOnlyQuery1**.
217217- **Options**:
218218
219219
220220**doAlwaysDetailResync**: boolean (**true**/**false**).
221221
222222**doCalcDefaults**: boolean (**true**/**false**).
223223
224224**donDontSortOnPost**: boolean (**true**/**false**).
225225
226226**doOemTraslate**: boolean (**true**/**false**).
227227
228228**doPreferPrepared**: boolean (**true**/**false**).
229229
230230**doSmartOpen**: boolean (**true**/**false**).
231231
232232**doUpdateMasterFirst**: boolean (**true**/**false**).
233233
234234- **ParamCheck**: boolean (**true**/**false**). Por defecto establecido a **true**.
235235- **Params**: parámetros adicionales para realizar la consulta. Si no se añade ninguno aparece como **0 items**.
236236- **Properties**: propiedades (del tipo TStrings).
237237- **ShortedFields**: Campos para ordenación, permite seleccionar (si tenemos conexión establecida en tiempo de ejecución y la query activa) del listado de campos disponibles.
238238- **ShortType**: tipo de ordenación, podemos escoger entre:
239239
240240
241241**stAscending**: orden ascendente.
242242
243243**stDescending**: orden descendente.
244244
245245**stIgnored**: se ignora el orden.
246246
247247- **SQL**: aquí podemos definir la(s) sentencias de consulta (querys) que se adapten a nuestras necesidades. A modo de ejemplo podemos poner **SELECT * FROM tabla** que nos seleccionará todo el contenido de la tabla **tabla** (cambiar por el nombre de la tabla que cada uno tenga creada) de la base de datos a la que estemos conectados. Se puede establecer perfectamente mediante código de forma que cambie según nuestras necesidades.
248248- **Tag**: etiqueta establecida por defecto a **0**.
249249
250250### Componente TZQuery (ZDataSet)
251251
252252![Componente TZQuery](/wiki-images/a/af/TZQuery.png) ===\> **Componente TZQuery (ZDataSet)**
253253
254254**Nos va a permitir realizar una consulta (query) en modo lectura-escritura. Tiene una serie de propiedades (disponibles también en el inspector de objetos) como son:**
255255
256256- **Ative**( * ): boolean (**true**/**false**).
257257- **AutoCalcFields**:
258258- **CachedUpdates**:
259259- **Connection**( * ): lo vinculamos a algún componente ZConnection, por ejemplo ZConnection1, eso ya según el nombre que le pongamos que es modificable.
260260- **DataSource**:
261261- **FetchRow**:
262262- **Filter**: define la cadena de filtrado que deseamos establecer aplicada a la información retornada en la consulta.
263263- **Filtered**: boolean (**true**/**false**). Por defecto establecido a false. Filtrado habilitado si true.
264264- **IndexFieldNames**:
265265- **LinkedFields**:
266266- **MasterFields**:
267267- **MasterSource**:
268268- **Name**: aquí podemos cambiar el nombre del componente que por defecto es ZQuery1.
269269- **Options**:
270270
271271
272272**doAlwaysDetailResync**: boolean (**true**/**false**).
273273
274274**doCalcDefaults**: boolean (**true**/**false**).
275275
276276**donDontSortOnPost**: boolean (**true**/**false**).
277277
278278**doOemTraslate**: boolean (**true**/**false**).
279279
280280**doPreferPrepared**: boolean (**true**/**false**).
281281
282282**doSmartOpen**: boolean (**true**/**false**).
283283
284284**doUpdateMasterFirst**: boolean (**true**/**false**).
285285
286286- **ParamChar**: por defecto viene establecido a **:**
287287- **ParamCheck**: boolean (**true**/**false**).
288288- **Params**: parámetros adicionales para realizar la consulta. Si no se añade ninguno aparece como **0 items**.
289289- **Properties**:
290290- **ReadOnly**: boolean (**true**/**false**). Por defecto establecido a false.
291291- **Secuence**:
292292- **SecuenceField**: campo para **Secuence**, permite seleccionar (si tenemos conexión establecida en tiempo de ejecución y la query activa) del listado de campos disponibles.
293293- **ShowRecordTypes**: puede tener los siguientes valores que se mostrarán u ocultarán dependiendo de si se establecen a true o false, por defecto muestra estos: \[usUnmodified,usModified,usInserted\]
294294
295295
296296**usDeleted**: boolean (**true**/**false**).
297297
298298**usInserted**: boolean (**true**/**false**).
299299
300300**usModified**: boolean (**true**/**false**).
301301
302302**usUnmodified**: boolean (**true**/**false**).
303303
304304- **ShortedFields**: Campos para ordenación, permite seleccionar (si tenemos conexión establecida en tiempo de ejecución y la query activa) del listado de campos disponibles.
305305- **ShortType**: tipo de ordenación, podemos escoger entre:
306306
307307
308308**stAscending**: orden ascendente.
309309
310310**stDescending**: orden descendente.
311311
312312**stIgnored**: se ignora el orden.
313313
314314- **SQL**( * ): aquí podemos definir la(s) sentencias de consulta (querys) que se adapten a nuestras necesidades. A modo de ejemplo podemos poner **SELECT * FROM tabla** que nos seleccionará todo el contenido de la tabla **tabla** (cambiar por el nombre de la tabla que cada uno tenga creada) de la base de datos a la que estemos conectados. Se puede establecer perfectamente mediante código de forma que cambie según nuestras necesidades.
315315- **Tag**: etiqueta establecida por defecto a **0**.
316316- **UpdateMode**: modo de actualización, puede tomar los siguientes valores:
317317
318318
319319**umUpdateChanged**: modo de actualización únicamente del contenido modificado.
320320
321321**umUpdateAll**: modo de actualización de todo el contenido.
322322
323323- **UpdateObject**:
324324- **WhereMode**:
325325
326326
327327**wmWhereKeyOnly**
328328
329329**wmWhereAll**
330330
331331### Componente TZTable (ZDataSEt)
332332
333333![Componente TZTable](/wiki-images/6/6f/TZTable.png) ===\> **Componente TZTable (ZDataSEt)**
334334
335335- **Active**: boolean (**true**/**false**). Para activar/desativar la tabla. Por defecto establecido a **false**.
336336- **AutoCalcFields**: boolean (**true**/**false**). Permite autocalcular los campos. Por defecto establecido a **true**.
337337- **CachedUpdates**: boolean (**true**/**false**). Por defecto establecido a **false**.
338338- **Connection**: Permite escoger entre la(s) conexiones disponibles para nuestra tabla.
339339- **FetchRow**: por defecto a **0**.
340340- **Filter**:
341341- **Filtered**: Por defecto establecido a **false**.
342342- **IndexFieldNames**:
343343- **LinkedFields**:
344344- **MasterFields**:
345345- **MasterSource**:
346346- **Name**: Permite definir el nombre para este componente, por defecto se asigna ZTable1 para el primer componente de este tipo.
347347- **Options**:
348348
349349
350350**doAlwaysDetailResync**: boolean (**true**/**false**). Por defecto establecido a **false**.
351351
352352**doCalcDefaults**: boolean (**true**/**false**). Por defecto establecido a **true**.
353353
354354**doDontSortOnPost**: boolean (**true**/**false**). Por defecto establecido a **false**.
355355
356356**doOemTranslate**: boolean (**true**/**false**). Por defecto establecido a **false**.
357357
358358**doPreferPrepared**: boolean (**true**/**false**). Por defecto establecido a **false**.
359359
360360**doSmartOpen**: boolean (**true**/**false**). Por defecto establecido a **false**.
361361
362362**doUpdateMasterFirst**: boolean (**true**/**false**). Por defecto establecido a **false**.
363363
364364- **Properties**: cadenas para especificar propiedades (TStrings).
365365- **ReadOnly**: boolean (**true**/**false**). Por deecto establecido a **false**.
366366- **Secuence**:
367367- **SecuenceField**:
368368- **ShowRecordTypes**: permite mostrar los tipos de registro de acuerdo a sus posibles \[usUnmodified,usModified,usInserted\].
369369- **SortedFields**: Campos ordenados, en el desplegable nos muestra los campos disponibles en la tabla seleccionada.
370370- **ShortType**: tipo de ordenación, para ello disponemos de tres posibilidades stAscending, stDescending, stIgnored.
371371- **TableName**: establecemos su valor con el nombre de la tabla con la que deseamos trabajar dentro de la base de datos que estemos utilizando.
372372- **Tag**: Etiqueta, establecida por defecto a **0**.
373373- **UpdateMode**: modo de actualización, dispone de dos modalidades:
374374
375375
376376**umUpdateChanged**.
377377
378378**umUpdateAll**.
379379
380380- **UpdateObject**:
381381- **WhereMode**: dispone de dos modalidades:
382382
383383
384384**wmWhereKeyOnly**.
385385
386386**wmWhereAll**.
387387
388388![Componente TZUpdateSQL](/wiki-images/a/a2/TZUpdateSQL.png) ===\> **Componente TZUpdateSQL (ZSqlUpdate)**
389389
390390![Componente TZConnectionGroup](/wiki-images/d/d5/TZConnectionGroup.png) ===\> **Componente TZConnectionGroup (ZConnectionGroup)**
391391
392392![Componente TZGroupedConnection](/wiki-images/0/02/TZGroupedConnection.png) ===\> **Componente TZGroupedConnection (ZGroupedConnection)**
393393
394394![Componente TZStoredProc](/wiki-images/f/fd/TZStoredProc.png%E2%80%8E) ===\> **Componente TZStoredProc (ZStoredProcedure)**
395395
396396![Componente TZSQLMetadata](/wiki-images/d/d9/TZSQLMetadata.png) ===\> **Componente TZSQLMetadata (ZSqlMetadata)**
397397
398398![Componente TZSQLProcessor](/wiki-images/7/72/TZSQLProcessor.png) ===\> **Componente TZSQLProcessor (ZSqlProcessor)**
399399
400400![Componente TZSQLMonitor](/wiki-images/2/2d/TZSQLMonitor.png) ===\> **Componente TZSQLMonitor (ZSQLMonitor)**
401401
402402![Componente TZSecuence](/wiki-images/2/20/TZSecuence.png) ===\> **Componente TZSecuence (ZSecuence)**
403403
404404![Componente TZIBEventAlerter](/wiki-images/b/ba/TZIBEventAlerter.png) ===\> **Componente TZIBEventAlerter (ZIBEventAlerter)**
405405
406406![Componente TZPgEventAlerter](/wiki-images/e/e3/TZPgEventAlerter.png) ===\> **Componente TZPgEventAlerter (ZPgEventAlerter)**
407407
408408Las entradas añadidas aquí sobre componentes de ZeosDBO son para animar a otros a completar la explicación sobre los mismos, no soy un experto y hay componentes de los cuales no tengo conocimiento sobre su uso. Las pruebas que he realizado son utilizando Lazarus 1.4.0 y PostgreSQL 9.2 en local y me ha permitido establecer conexiones con BBDD y sus correspondientes tablas de una manera fluida incluyendo tipos BLOB definidos en la parte de postgres como bytea, sin problemas. Animo a que gente con más conocimiento complete las entradas. Por mi parte en la medida que tenga tiempo y vaya aprendiendo más trataré de plasmarlo aquí.
409409
410410## Comentarios
411411
412412En el momento actual Zeos CVS para Lazarus tiene paquetes rotos. Algunos comentarios de IgD:
413413
414414Utilizando una instalación limpia de Lazarus 0.9.12 (última versión estable) fuí capaz de instalar ZeosLib (13 Octubre 2005). Primero corrige los siguientes errores en ZeosLib:
415415
416416- 1\. Cambia ZplainPostgreSql81.pas a ZPlainPostgresSql8x.pas en zplain.lpk
417417
418418`<Item22>`\
419419`  <Filename Value="../../src/plain/ZPlainPostgreSql81.pas"/>`\
420420`  <UnitName Value="ZPlainPostgreSql8x"/>`\
421421`</Item22>`\
422422
423423- 2\. Fix the following typos in zdbc.lpk:
424424
425425a\. Remove extra "/" from "build/" (remove the one that is inside the quotes)
426426
427427`<SearchPaths>`\
428428`  <OtherUnitFiles Value="../../src/dbc/"/>`\
429429`  <UnitOutputDirectory Value="build/"/>`\
430430`</SearchPaths>`\
431431
432432b\. Add missing quote to unitname value
433433
434434`<Item43>`\
435435`  <Filename Value="../../src/dbc/ZDbcASA.pas"/>`\
436436`  <UnitName Value="ZDbcASA/>`\
437437`</Item43>`
438438
439439Ahora, aquí están las instrucciones de instalación:
440440
441441Antes de la versión 0.9.13 de Lazarus era necesario abrir cada uno de los paquetes de Zeos a través de Paquetes/Abrir Paquete en el siguiente orden:
442442
4434431. zcore.lpk
4444442. zparsesql.lpk
4454453. zplain.lpk
4464464. zdbc.lpk
447447
448448Entonces finalmente abre zcomponent.lpk para compilarlo e instalarlo. En Lazarus 0.9.13 \> solamente puede abrir zcomponent.lpk. El IDE abrirá el resto automáticamente.
449449
450450Nota: los cuatro primeros paquetes solamente necesitan ser compilados y no pueden ser instalados.
451451
452452--Forest 17:41, 2 Nov 2005 (CET)
453453
454454- 3\. Si compilas e instalas Lazarus con éxito, pero después de compilarse, comienza con:
455455
456456![](/wiki-images/5/57/Zeoserror.gif)
457457
458458Entonces se puede hacer:
459459
460460Dentro del fichero Zeos.Inc reemplazar, en la sección "// Settings for Debug mode": {\$R-} a {\$R+}
461461
462462--Junior 19:48, 15 Apr 2006 (GMT)
463463
464464Si aún así después de mostrar un error no recuperable que permita arrancar Lazarus, nos queda la alternativa de buscar el fichero ejecutable tal como estaba antes de compilar todo y que figura como lazarus.old.exe
465465
466466## Hacer la primera aplicación Zeos
467467
468468Las propiedades elementales necesarias para una aplicación simple funcional que se describen aquí se han marcado como referencia en los componentes de arriba como ( * ) para que esté más claro.
469469
470470- Sitúa un componente **ZConnection** en el formulario.
471471 - Establecer las propiedades de User, Password, Host, Port y Protocol (y cualquier otro parámetro que se necesite).
472472 - Establecer la propiedad "Set Connected" con el valor True.
473473
474474- Sitúa un componente **ZQuery** en el formulario (cuidado con confundirlo con ZReadOnlyQuery).
475475 - Establecer la propiedad "Connection" al valor de ZConnection activo.
476476 - Establecer la propiedad Sql a algo similar a **SELECT * FROM MyTable** (selecciona todo el contenido de la tabla especificada de la base de datos que se haya abierto previamente, es una sentencia SQL).
477477 - Establecer la propiedad "ACTIVE" al valor True.
478478
479479- Sitúa un componente **DataSource** de la solapa **\[Data Access\]**.
480480 - Establecer la propiedad "DataSet" con valor igual a la ZQuery activa.
481481
482482- Sitúa un componente **DBGrid** de la solapa **\[Data Controls\]**.
483483 - Establece el parámetro Datasource con el valor DataSource.
484484 - Si todo está bien se deberían ver los registros rellenos con datos en la tabla.
485485
486486## Más información sobre como trabajar con Zeos
487487
488488En los siguientes enlaces se pueden encontrar artículos realmente útiles explicando el uso de Zeos y su uso interno, alguno de los cuales además tratan además sobre materias específicas de Delphi pero que pueden ser utilizadas con Lazarus también.\
489489
490490- [Tutorial en español de Zeos+Lazarus+Sqlite:](http://lazaruszeos.blogspot.com/2010/07/uso-de-componentes-zeos-en-lzarus-y.html)
491491- [ZeosLib DBOs 6.1.5 - con Delphi 7 y Firebird 1.5 \[Enlaze roto](http://zeos.firmos.at/kb.php?mode=article&k=12)\]
492492- [Descripción de la arquitectura de los objetos de ZeosDB \[Enlaze roto](http://zeos.firmos.at/kb.php?mode=article&k=8)\]
493493- [Una introducción a la API de ZDBC \[Enlaze roto](http://zeos.firmos.at/kb.php?mode=article&k=7)\]
494494
495495**Por favor completar esto :)**
496496
497497## Posibles fallos e incidencias
498498
499499- He notado que en algunas ocasiones cuando se construye Lazarus no es capaz de encontrar algunos ficheros de Zeos, como un método rápido puedes probar esto:
500500 - Use **Components/Package Graph** from the main menu.
501501 - Abre el paquete **ZComponent**.
502502 - Right Click on the **Files** item in the list.
503503 - Selecciona **\[Recompile all required\]**.
504504 - Cuando pregunte "Re-Compile this and all required packages?" responder **\[Yes\]**.
505505 - Recompila Lazarus normalmente (con paquetes).\
506506 \
507507
508508- Hay un error en [[Glossary|FPC's]] [AnsiStrComp](http://lazarus-ccr.sourceforge.net/docs/rtl/sysutils/ansistrcomp.html) que causa comparación no fiable PChar, esto es obvio cuando se utiliza DBGrid para editar datos, **AnsiStrComp('abc', 'abcd')** no puede detectarlo ya que son diferentes pero detecta **AnsiStrComp('abd', 'abcd')** ignorando múltiples caracteres de la segunda cadena. Este error fue encontrado por Jesusrmx. Este error probablemente será subsanado pronto, ver [Bug Report](http://www.freepascal.org/bugs/showrec.php3?ID=4325).\
509509 \
510510
511511- \[Ya arreglado en trunk 1013\] Tratando de compilar la revisión 903 de ZeosDBO trunk (20110806) sobre GNU/Linux amd64 x86_64 da errores en el archivo ZClasses.pas como los siguientes:
512512 - Error: No matching Implementation for interface method "IUnknown.QueryInterface (constref TGuid, out \<Formal type\>) LongInt; Cdecl;"
513513 - El problema se debe a cambios en FPC relacionados con la compatibilidad entre plataformas (http://wiki.freepascal.org/User_Changes_2.6.0#IInterface.QueryInterface.2C_._AddRef_and_._Release_definitions_have_been_changed)
514514 - y la solución es editar el archivo ZClasses.pas como en el siguiente parche:
515515
516516`-    function QueryInterface({$IFDEF FPC_HAS_CONSTREF}constref{$ELSE}const{$ENDIF} IID: TGUID; out Obj): HResult; {$IFNDEF WINDOWS}cdecl{$ELSE}stdcall{$ENDIF}; virtual;                                                      `\
517517`-    function _AddRef: Integer; {$IFNDEF WINDOWS}cdecl{$ELSE}stdcall{$ENDIF};                                                                                                                                                 `\
518518`-    function _Release: Integer; {$IFNDEF WINDOWS}cdecl{$ELSE}stdcall{$ENDIF};                                                                                                                                                `\
519519`+    function QueryInterface({$IFDEF FPC_HAS_CONSTREF}constref{$ELSE}const{$ENDIF} IID: TGUID; out Obj): HResult; {$IF (not defined(WINDOWS)) AND (FPC_FULLVERSION>=20501)}cdecl{$ELSE}stdcall{$IFEND}; virtual;`\
520520`+    function _AddRef: Integer; {$IF (not defined(WINDOWS)) AND (FPC_FULLVERSION>=20501)}cdecl{$ELSE}stdcall{$IFEND};`\
521521`+    function _Release: Integer; {$IF (not defined(WINDOWS)) AND (FPC_FULLVERSION>=20501)}cdecl{$ELSE}stdcall{$IFEND};`\
522522`  public`\
523523`    constructor Create(const Controller: IInterface);`\
524524`    property Controller: IInterface read GetController;`\
525525`@@ -89,7 +93,8 @@`\
526526`  TContainedObject = class(TAggregatedObject, IInterface)`\
527527`  protected`\
528528`-    function QueryInterface({$IFDEF FPC_HAS_CONSTREF}constref{$ELSE}const{$ENDIF} IID: TGUID; out Obj): HResult; {$IFNDEF WINDOWS}cdecl{$ELSE}stdcall{$ENDIF}; override;`\
529529`+    function QueryInterface({$IFDEF FPC_HAS_CONSTREF}constref{$ELSE}const{$ENDIF} IID: TGUID; out Obj): HResult; {$IF (not defined(WINDOWS)) AND (FPC_FULLVERSION>=20501)}cdecl{$ELSE}stdcall{$IFEND}; override;`\
530530`  end;`\
531531`  {$ENDIF}`\
532532`@@ -221,7 +226,8 @@`\
533533`  Result := IInterface(FController)._AddRef;`\
534534`end;`\
535535`-function TAggregatedObject._Release: Integer; {$IFNDEF WINDOWS}cdecl{$ELSE}stdcall{$ENDIF};`\
536536`+function TAggregatedObject._Release: Integer; {$IF (not defined(WINDOWS)) AND (FPC_FULLVERSION>=20501)}cdecl{$ELSE}stdcall{$IFEND};`
537537
538538* \[Ya arreglado en trunk 1013\] Tratando de compilar la revisión 903 of ZeosDBO trunk en GNU/Linux con FPC 2.6.0 o superior, da el siguiente error en ZAbstractRODataset.pas: "Error: Expected another 2 array elements". El problema es que FPC2_1UP no está definido porque el archivo src/Zeos.inc no verifica las versiones nuevas. Si estamos usando solo versiones nuevas de FPC (2.6, 2.7 o superiores) podemos modificar src/Zeos.inc agregando las lineas siguientes justo antes de {\$IFDEF VER2_5}, y el error no aparece mas.
539539
540540`+  {$DEFINE FPC2_5UP}`\
541541`+  {$DEFINE FPC2_4UP}`\
542542`+  {$DEFINE FPC2_3UP}`\
543543`+  {$DEFINE FPC2_2UP}`\
544544`+  {$DEFINE FPC2_1UP}`\
545545`+  {$DEFINE FPC2_UP}`\
546546`+`\
547547`   {$IFDEF VER2_5}`\
548548`     {$DEFINE FPC2_5UP}`
549549
550550---
551551*From the Free Pascal wiki, page "Zeos tutorial/es", as it stood on 2020-03-03 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*
552552Category: Castellano
553553Category: Español

Back to history