LazReport Documentation/es: what changed

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

Old	New		Line
1	1		# PRESENTACIÓN
2	2
3	3		LazReport es un grupo de componentes que agregan a las aplicaciones la capacidad de generar reportes, usa un diseñador visual para crear reportes basados en bandas e incluye un mecanismo de reportes con previsualizador que ademas incluye un interprete para ejecutar guiones de usuario. El diseñador de reportes puede ser invocado en tiempo de ejecución
4	4
5	5		# LINCENCIA
6	6
7	7		LazReport se origina en FreeReport 2.32 y gracias a la compañía Fast Reports Inc. esta disponible bajo la licencia LGPL modificada, la misma licencia que usa la libreria LCL de Lazarus. Para mayor información, vea los archivos lazreport/ license.txt, license-rus.txt y licence-lazreport.txt
8	8
9	9		# AUTORES
10	10
11	11		FreeReport fué creado por la compañía Fast Reports Inc. La adaptación inicial del código a LazReport fue hecha por Olivier Guilbaud, para mayor infomación visite el sitio original de LazReport en SourceForge <http://lazreport.sourceforge.net/>. La integración en Lazarus y actual encargado del proyecto es Jesús Reyes Aguilar. LazReport no podría haber llegado a su estado actual sin la colaboración de muchos otros desarrolladores, vea el archivo lazreport/doc/contributors.txt
12	12
13	13		# INSTALACIÓN
14	14
15	15		Para Instalar LazReport en Lazarus:
16	16
17	17		1. Abrir el paquete LazReport Package. Menú: Componentes-\>Abrir archivo de paquete (.lpk)...
18	18		2. Abrir archivo components/lazreport/source/lazreport.lpk
19	19		3. Instalar
20	20
21	21		La siguiente vez que Lazarus sea iniciado, debería mostrar una separador LazReport en la paleta de componentes.
22	22
23	23		# DOCUMENTACIÓN
24	24
25	25		El Manual del Desarrollador y La Guia del Usuario específicas para LazReport están aún por escribirse, mientras tanto, la mayoría de las funciones de LazReport están descritas en el Manual del Desarrollador de FreeReport (vea lazreport/doc/fr_eng.sxw en la instalción de Lazarus), Algunas cosas dependientes de la plataforma descritas allí, como objetos OLE, no están implementados en LazReport. También algunos ejemplos o imágenes hacen referencia a ejemplos que están disponibles solamente en Delphi.
26	26
27	27		Hasta que la documentación especifica para LazReport sea elaborada, ésta página wiki será usada como repositorio de documentación, quizás en el futuro la documentación faltante pueda ser generada desde aquí. Se alienta a los usuarios a que agreguen temas que sientan haya necesidad de documentar, incluso si la descripción o contenido de dichos temas deba ser proporcionado por otros usuarios.
28	28
29	29		## Operadores
30	30
31	31		Los siguientes operadores están soportados:
32	32
33	33		\| Tipo Operador \| Operador \|
34	34		\|---------------------------------\|-------------------------------------------\|
35	35		\| Logicos \| \>, \<, BUT, AND, NOT, =, \< \>, \>=, \<= \|
36	36		\| Aritméticos\\|\\|-, *, +, MOD, / \| \|
37	37
38	38		## Funciones
39	39
40	40		Las siguientes funciones están disponibles:
41	41
42	42		### Funciones de agregación
43	43
44	44		SUM(\<X\>)
45	45		Devuelve la suma de valores representados por \<X\>, que generalmente es un campo de datos.
46	46
47	47		AVG(\<X\>)
48	48		Devuelve el promedio de los valore de \<X\>.
49	49
50	50		COUNT
51	51		Cuenta la cantidad de ocurrencias o registros.
52	52
53	53		MIN(\<X\>)
54	54		Devuelve le menor valor de todos los posibles valores de \<X\>.
55	55
56	56		MAX(\<X\>)
57	57		Devuelve le mayor valor de todos los posibles valores de \<X\>.
58	58
59	59		### Funciones de formateo
60	60
61	61		FORMATDATETIME(\<X\>, \<Y\>)
62	62		Devuelve una cadena con el valor \<Y\> (de tipo TDateTime) en el formato \<X\>. \<X\> usa la sintaxis default de los [formatos de Lazarus](http://www.freepascal.org/docs-html/rtl/sysutils/formatdatetime.html).
63	63
64	64		FORMATFLOAT(\<X\>, \<Y\>)
65	65		Devuelve una cadena con el valor numérico \<Y\> en el formato \<X\>. \<X\> usa la sintaxis default de los [formatos de Lazarus](http://www.freepascal.org/docs-html/rtl/sysutils/formatfloat.html).
66	66
67	67		STRTODATE(\<X\>)
68	68		Devuelve la representación en fecha (tipo TDateTime) de la cadena \<X\>. \<X\> debe estar formateada correctamente.
69	69
70	70		STRTOTIME(\<X\>)
71	71		Devuelve la representación en tiempo (tipo TDateTime) de la cadena \<X\>. \<X\> debe estar formateada correctamente.
72	72
73	73		### Funciones de cadenas
74	74
75	75		LOWERCASE(\<X\>)
76	76		Devuelve \<X\> pasada a minúsculas.
77	77
78	78		UPPERCASE(\<X\>)
79	79		Devuelve \<X\> pasada a mayúsculas.
80	80
81	81		NAMECASE(\<X\>)
82	82		Devuelve \<X\> con una mayúscula inicial en cada palabra.
83	83
84	84		COPY(\<X\>, \<Y\>, \<Z\>)
85	85		Es similar a la función "copy" de Pascal: devuelve la porción de la cadena \<X\> desde la posición \<Y\> contando \<Z\> letras.
86	86
87	87		### Funciones numéricas
88	88
89	89		FRAC(\<X\>)
90	90		Devuelve la parte fraccionaria del número real \<X\>.
91	91
92	92		INT(\<X\>)
93	93		Devuelve la parte entera del número real \<X\>.
94	94
95	95		ROUND(\<X\>)
96	96		Devuelve el número real \<X\> redondeado al entero inmediato superior.
97	97
98	98		STR(\<X\>)
99	99		Devuelve una cadena representando al número \<X\>.
100	100
101	101		### Funciones lógicas
102	102
103	103		IF(\<X\>, \<Y\>, \<Z\>)
104	104		Devuelve \<Y\> si la expresión \<X\> es verdadera. Si es falsa, devuelve \<Z\>.
105	105
106	106		## Agregando tus propias funciones
107	107
108	108		Aunque probablemente no se necesite demasiado, LazReport te permite definir tus propias funciones. Ver [[LazReport Documentation\|LazReport Documentation#Documentation]] para las funciones ya existentes. Para agregar tus propias funciones:
109	109
110	110		## Filtros de Exportación
111	111
112	112		Los filtros de exportación de LazReport se invocan usando el siguiente código.
113	113
114	114		```delphi
115	115		if TheReport.PrepareReport then
116	116		TheReport.ExportTo(TfrHTMExportFilter, 'exportedfile.html');
117	117		```
118	118
119	119		Donde TheReport contiene una instancia del componente TfrReport. En este ejemplo se usa TfrHTMExportFilter para generar un archivo llamado 'exportedfile.html'. No es necesario preparar de nuevo el reporte si éste ha sido preparado con anterioridad. Para poder hacer uso de TfrHTMExportFilter el programador debe arrastrar y soltar un componente TfrHTMExportFilter desde el separador LazReport en la paleta de componentes, hacia el Diseñador de Formularios. Como una alternativa se puede añadir manualmente lr_e_htm a la clausula "uses" de la unidad.
120	120
121	121		A partir de la versión 0.9.6 de LazReport el soporte de filtros de exportación ha sido mejorado, ahora los filtros de exportación pueden tomar parámetros que los usuarios pueden manipular ya sea cambiando los valores directamente o presentando al usuario final alguna interfaz de usuario. Para poder hacer cambios en los parametros, el programador debe crear un manipulador para el evento TfrReport.OnExportFilterSetup, disponible al seleccionar el componente TfrReport en el separador "Eventos" del Inspector de Objetos.
122	122
123	123		El método manipulador del evento OnExportFilterSetup (de tipo TExportFilterSetup) toma un parámetro "sender" del tipo TfrExportFilter, para poder usar este tipo se debe añadir la unidad lr_class.pas a la clausula uses de la unidad. Todas la clases del tipo ExportFilter comparten este evento y el programador debe hacer un type-cast a la clase del filtro de exportación deseado, por ejemplo:
124	124
125	125		```delphi
126	126		if sender is TfrHTMExportFilter then
127	127		begin
128	128		TfrHTMExportFilter(sender).UseCSS := false;
129	129		end;
130	130		```
131	131
132	132		A continuación una descripción de los filtros de exportación disponibles.
133	133
134	134		### TfrExportFilter
135	135
136	136		Esta es la clase báse de todos los filtros de exportación, y defines dos propiedades que pueden ser modificadas por el desarrollador en el evento *OnExportFilterSetup*:
137	137
138	138		- BandTypes: TfrBandTypes. Se trata de un conjunto de tipos de bandas, solo las bandas incluidas en este conjunto son efectivamente exportada, el resto de las bandas presentes en el informe se ignorarán. Usando esta propiedad un programador podría, por ejemplo, exportar sólo el contenido de la banda principal, dejando los títulos, encabezados y pies de página fuera de la salida exportada así:
139	139
140	140		```delphi
141	141		sender.BandTypes := [btMasterData];
142	142		```
143	143
144	144		de forma predeterminada, todas las bandas son procesadas pero TfrCSVExportFilter cambia esta propiedad para procesar únicamente la cabecera principal, las cabeceras de columna y las bandas principales de datos.
145	145
146	146		- UseProgressbar: boolean. Esta propiedad activa o desactiva la visualización de la barra de progreso del filtro de exportación. La propiedad tiene el valor predefinido como falso.
147	147
148	148		### TfrTextExportFilter
149	149
150	150		Hereda de: TfrExportFilter \<- TfrTextExportFilter\
151	151		localizado en el archivo lr_e_txt.pas incluido en el paquete LazReport.
152	152
153	153		Es la clase base de los filtros de texto. Este filtro de exportación trata de hacer una representación en texto de un informe gráfico mediante el ajuste de las coordenadas gráficas originales en una rejilla más gruesa donde cada unidad es un punto de la fuente UsedFont, dependiendo del valor de UsedFont, la salida exportada será más o menos parecida al diseño de objetos en el informe gráfico.
154	154
155	155		Además de las propiedades heredadas de la clase TfrExportFilter, TfrTextExportFilter define dos propiedades más.
156	156
157	157		- UsedFont: integer. Esta propiedad define las dimensiones en puntos de la rejilla de salida, los objetos en el informe se colocan en esta red recalculando las posiciones x e y. El valor predeterminado es 10, si el usuario cambia este valor a 0 o menos, LazReport mostrará automáticamente un cuadro de diálogo preguntando por el valor UsedFont, si el usuario introduce un valor no válido, se utilizará el valor 10. Ee utiliza el valor 10 porque es el valor que mejor se adapta a los informes habituales que se hacen con las fuentes de 10-13 puntos.
158	158		- UseBOM: boolean. Esta propiedad permitirá la inclusión de caracteres UTF-8 con Byte Order Mark al comienzo de la salida de texto (ver [BOM](http://en.wikipedia.org/wiki/Byte_order_mark)) que es requerido por algunos editores/visores, ya que BOM no se utiliza de forma predeterminada.
159	159
160	160		### TfrCSVExportFilter
161	161
162	162		inheritance: TfrExportFilter \<- TfrTextExportFilter \<- TfrCSVExportFilter\
163	163		located in: lr_e_csv.pas file included in LazReport package.
164	164
165	165		This special text export filter produces Comma Separated Value output (actually any character can be used as separator), it differs from it's ancestor in that it doesn't try to create text layout representation of graphical report, instead, for each record output it tries to guess the fields order from the source report, it then produce a list of fields using a separator defined by the user. Beside the properties inherited from its ancestor classes it defines some properties to customize the generated output.
166	166
167	167		- QuoteType:TfrQuoteType. This property controls whether the generated field value should be wrapped using specified quote char or not. Possible values are qtNone, qtQuoteChar and qtAutoQuote. With qtNone the field value is never wrapped, qtQuoteChar will use the character specified by property QuoteChar, any instance of QuoteChar already present in field value is duplicated. qtAutoQuote first try to find if any instance of separator or QuoteChar is already present in field value, if affirmative it behaves as if qtQuoteChar has been specified, on the contrary case, the field value is not wrapped just as if qtNone has been specified. QuoteType property is set to qtQuoteChar by default.
168	168		- QuoteChar:TUTF8Char. This holds the character to be used to wrap the field value in case of QuoteType of value qtQuoteChar has been specified or deduced if qtAutoQuote is set. Any instance of this character in the field value will be duplicated. by default QuoteChar is set to the " character.
169	169		- Separator:TUTF8Char. This is the character used to separate the fields in each record, by default is set to the ',' (COMMA) character but any UTF-8 valid character could be used. Some CSV files are actually TAB separated files, to get this, set Separator:=#9;
170	170
171	171		The CSV exporter do not use the inherited UsedFont property value so any value set will be ignored. With default property values, TfrCSVExportFilter will produce Excel compatible files, the only caveat is that Excel will not recognize the file as UTF-8 encoded. To force Excel to recognize the encoding automatically, set the property UseBOM to true.
172	172
173	173		### TfrHTMExportFilter
174	174
175	175		inheritance: TfrExportFilter \<- TfrTextExportFilter \<- TfrHTMExportFilter.\
176	176		Located in: lr_e_htm.pas in LazReport package.
177	177
178	178		This special text export filter produces valid "HTML 4.01 Transitional" output. Currently it defines only one additional property.
179	179
180	180		- UseCSS:boolean. This property controls whether or not the produced output include CSS information, this property is set to true by default.
181	181
182	182		# INICIO RÁPIDO
183	183
184	184		## Reporte de Registros de un Dataset
185	185
186	186		En este ejemplo diseñaremos un reporte para imprimir registros desde un componente derivado de TDataset (TDbf, TSQLQuery, TZTable, TZQuery, Etcetera.). Primero se supone que LazReport ya esta instalado y que el componente dataset, llamado "Dbf1" aquí, ya esta configurado y activo.
187	187
188	188		1. Del separador LazReport en la paleta de componentes, seleccionamos el componente TfrReport y lo arrojamos en el Diseñador de Formularios, será nombrado automáticamente "frReport1".
189	189		2. Colocar también un componente TfrDbDataset, será nombrado "frDbDataset1"
190	190		3. Colocar un componente TButton, será nombrado "Button1", cambie su nombre a "btnShowReport"
191	191		4. Con el componente frDbDataset1 seleccionado, en el Inspector de Objectos seleccione "Dbf1" en la propiedad "Dataset"
192	192		5. Ahora seleccione frReport1 y usando el mismo procedimiento enlace su propiedad "Dataset" al componente "frDbDataset1":
193		-	~~<center>~~
194		-
195		-	~~<figure>~~
196		-	~~<img src="lrformsetup.png" title="lrformsetup.png" />~~
197		-	~~<figcaption>lrformsetup.png</figcaption>~~
198		-	~~</figure>~~
199		-
200		-	~~</center>~~
	193	+	![](/wiki-images/4/46/Lrformsetup.png)
201	194		6. Haga clic con el botón derecho sobre frReport1 y del menú seleccione "Diseñar Reporte". Se mostrará El Diseñador de Reportes de LazReport.
202	195		7. En la ventana del Diseñador de LazReport, seleccione el menu Herramientas-\>Herramientas-\>Insertar Campos DB. El diálogo "Insertar Campos" aparecerá.
203	196		8. En la lista de campos seleccione los campos que desee que aparezcan en el reporte
204	197		9. Seleccione las opciones "Incluir Encabezados" y "Incluir Bandas", el resultado debería ser similar a esto:
205		-	~~<center>~~
206		-
207		-	~~<figure>~~
208		-	~~<img src="lrinsertfieldsdialog.png" title="lrinsertfieldsdialog.png" />~~
209		-	~~<figcaption>lrinsertfieldsdialog.png</figcaption>~~
210		-	~~</figure>~~
211		-
212		-	~~</center>~~
	198	+	![](/wiki-images/7/7d/Lrinsertfieldsdialog.png)
213	199		10. Presione el botón "Aceptar", LazReport colocara bandas y campos en el reporte de una formasimilar a la siguiente:
214		-	~~<center>~~
215		-
216		-	~~<figure>~~
217		-	~~<img src="lrreportwithfields.png" title="lrreportwithfields.png" />~~
218		-	~~<figcaption>lrreportwithfields.png</figcaption>~~
219		-	~~</figure>~~
220		-
221		-	~~</center>~~
	200	+	![](/wiki-images/4/43/Lrreportwithfields.png)
222	201		11. Presione el boton de Vista Previa ![](/wiki-images/b/bb/Lrprevieweye.png), LazReport mostrará entonces una vista previa del reporte:
223		-	~~<center>~~
224		-
225		-	~~<figure>~~
226		-	~~<img src="lrpreviewreport.png" title="lrpreviewreport.png" />~~
227		-	~~<figcaption>lrpreviewreport.png</figcaption>~~
228		-	~~</figure>~~
229		-
230		-	~~</center>~~
	202	+	![](/wiki-images/4/43/Lrpreviewreport.png)
231	203		12. Guarde el reporte usando el menú Archivos-\>Guardar, seleccione el mismo directorio del proyecto actual y guardelo como listing1.lrf
232	204		13. Cierre el Diseñador de Reportes.
233	205		14. Haga doble clic sobre el botón btnShowReport y teclee el siguiente código:
234	206
235	207		```delphi
236	208		frReport1.LoadFromFile('listing1.lrf');
237	209		frReport1.ShowReport;
238	210		```
239	211
240	212		# Informar sobre errores
241	213
242	214		Por favor informa sobre los problemas utilizando el [seguimiento de errores (bugtracker) de lazarus/free pascal](http://www.freepascal.org/mantis/main_page.php), en el proyecto: "Lazarus Packages", Categoría "LazReport"; para remitir parches por favor, crea un informe de error y adjunta el parche al mismo.
243	215
244	216		------------------------------------------------------------------------
245	217
246	218		---
247	219		From the Free Pascal wiki, page "LazReport Documentation/es", as it stood on 2020-01-29 after a change by Skalogryz, 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).
248	220		Category: Castellano
249	221		Category: Español

Back to history