JasperReports Server Admin Guide Release 5.6.es PDF

JasperReports SERVIDOR
GUA DEL
ADMINISTRADOR
Copyright 2005-2014, TIBCO Software Inc. Todos los derechos reservados. Impreso en los U.S.A Jaspersoft, la Jaspersoft
logo, Jaspersoft iReport Designer, JasperReports Biblioteca, JasperReports Server, Jaspersoft OLAP, Jaspersoft
Estudio y Jaspersoft ETL son marcas registradas y / o marcas comerciales registradas de TIBCO Software Inc. en los Estados
Unidos y en jurisdicciones de todo el mundo. Todos los dems nombres de compaas y de productos son o pueden ser el
comercio
nombres o marcas comerciales de sus respectivos propietarios.
Esta es la versin 0814-JSP56-20 del Gua del administrador del servidor JasperReports.
Tabla de contenido
Captulo 1 Introduccin a la administracin del servidor JasperReports
1.1 Descripcin general de las Organizaciones
1.1.1 Individual Organizacin por omisin
1.1.2 Organizaciones Mltiples
1.1.3 Niveles de Administradores
1.2 Descripcin del repositorio
Estructura 1.2.1 Folder
1.2.2 Recursos
1.2.3 Datos de Ejemplo
1.2.4 Examinando y buscando
1.3 Resumen de Usuarios y Roles
1.3.1 Administracin de usuarios y roles
1.3.2 Administracin delegada
1.4 Introduccin a la seguridad
1.4.1 Autenticacin
1.4.2 Autorizacin general
1.5 Administrator Login
1.5.1 JasperReports Server Heartbeat
1.5.2 Administrador de Correo
Pages 1.6 Administrador
Captulo 2 Organizacin, usuario y administracin de funciones

2.1 Las organizaciones encargadas
2.1.1 Visualizacin de las propiedades de la
Organizacin
2.1.2 Creacin de una Organizacin
2.1.3 Las carpetas predeterminadas para
Organizaciones
2.1.4 Edicin de una Organizacin
2.1.5 Eliminacin de una Organizacin
2.2 Administracin de usuarios
2.2.1 Visualizacin de las propiedades del usuario
2.2.2 Creacin de un usuario
2.2.3 Edicin de un usuario
2.2.4 Edicin de perfil Atributos
11
12
12
12
13
14
14
14
15
16
17
17
18
19
19
20
21
21
21
22
25
25
27
27
28
28
29
29
30
31
33
34
Gua del administrador del servidor JasperReports
2.2.5 Activacin o desactivacin de usuarios en bloque

2.2.6 Borrado de uno o ms usuarios
2.3 Roles Gestin
2.3.1 Visualizacin de Propiedades de la funcin
2.3.2 Creacin de un rol
2.3.3 Asignacin de usuarios a un rol
2.3.4 Borrado de una o varias funciones
Captulo 3 Administracin Repositorio

3.1 Tipos de recursos
3.2 Estructura JasperReport
3.2.1 menciona recursos en el Repositorio
3.2.2 Referencias absolutas
3.2.3 Recursos Locales y referencias externas
3.2.4 Las referencias en Subinformes
3.2.5 Datos Snapshots
3.3 Gestin de carpetas y Recursos
3.3.1 Recursos IDs
3.3.2 Creacin de carpetas
3.3.3 Recursos Agregando
3.3.4 Cambiar el nombre de carpetas y Recursos
3.3.5 Copiar y mover
3.3.6 Edicin de Recursos
3.3.7 Supresin de carpetas y Recursos
3.4 Mltiples Organizaciones en el Repositorio
3.4.1 Organizacin de carpetas
3.4.2 Consideraciones de diseo
3.4.3 menciona recursos en el Repositorio
3.4.4 Mejores Prcticas
3.5 Permisos
3.5.1 La herencia de permisos
3.5.2 Permisos acumuladas
3.5.3 permisos de administrador
3.5.4 Ejecutar permiso de slo
3.5.5 Permisos de usuario por defecto
3.5.6 Establecer permisos
3.5.7 Pruebas de permisos de usuario
Captulo 4 Fuentes de datos

4.1 Fuentes de datos JDBC
4.2 Drivers Gerente JDBC
4.3 Fuentes de datos JNDI
4.4 Fuentes de datos de AWS
4.5 Fuentes de datos Cassandra
4.5.1 Creacin de un origen de datos Cassandra
4.5.2 El aumento de los lmites de descriptor de fichero para
Cassandra
4.6 Fuentes de datos Hadoop Hive-
36
36
36
38
39
39
40
43
44
45
46
46
47
48
48
48
49
49
50
51
52
53
54
55
55
55
56
57
57
58
59
59
59
60
60
62
65
66
68
71
73
75
76
77
78
4.7 Fuentes de datos MongoDB

4.8 Fuentes de datos virtuales
4.8.1 Consideraciones sobre el rendimiento
4.8.2 Registro de Fuentes de datos virtuales
4.9 Big Data Connectors para orgenes de datos virtuales
4.9.1 Creacin de Big Data Conectores
4.9.2 Esquema Relacional para MongoDB Conector
4.10 Fuentes de datos de frijol
Captulo 5 Otros recursos en el Repositorio

5.1 Consultas
5.2 Tipos de datos
5.3 Lista de valores
5.4 Controles de entrada
5.5 Controles de entrada basados en consultas
5.5.1 Creacin de un control de entrada basado en consultas
5.5.2 Parmetros incorporadas para controles de entrada basados en
consultas
5.5.3 Consultas basadas en el dominio
5.6 Controles de entrada en cascada
5.6.1 Parmetros en consultas de control de entrada
5.6.2 Creacin de un control de entrada en cascada
5.7 Recursos de archivos
5.7.1 Fuentes
5.7.2 Archivos JAR
5.7.3 Paquetes de Recursos
5.7.4 Creacin de un recurso de archivo
5.7.5 Edicin de un archivo de recursos
Captulo 6 Temas
6.1 Introduccin a los Temas
6.2 Cmo funcionan los temas
6.2.1 Tema Archivos
Mecanismo 6.2.2 Herencia
Esquema Prioridad 6.2.3 CSS y anulaciones personalizados
6.3 Temas de Administracin de
6.3.1 Ajuste del tema del sistema
6.3.2 Establecimiento de una Organizacin Temtica
6.3.3 Restringir el acceso a los temas
6.4 Creacin de Temas
6.4.1 Creacin de carpetas temticas y de recursos de archivo
6.4.2 Cargar Tema Archivos ZIP
6.4.3 Temas Depositar en la plantilla de carpeta
6.5 Trabajar con archivos CSS
6.5.1 Tema de Desarrollo Workflow
6.5.2 Firebug Plug-in para Firefox
6.5.3 Test Platform
6.5.4 Modificacin de la presentacin de Jaspersoft OLAP
80
82
85
85
86
86
87
88
91
91
94
95
96
99
99
103
104
105
106
107
110
111
111
111
112
112
115
115
117
118
119
120
120
121
122
123
124
124
125
127
127
127
128
128
129
6.5.5 Interfaz de usuario de ejemplo

Captulo 7 Importacin y Exportacin
7.1 Importacin y exportacin Catlogos
7.1.1 Ajuste de la clave de cifrado Import-Export
7.1.2 Importacin sin cifrar Catlogos
7.2 Importacin y exportacin a travs de la interfaz de usuario
web
7.2.1 Exportacin desde la interfaz de usuario del repositorio
7.2.2 Exportacin desde la interfaz de usuario de configuracin
7.2.3 Importacin desde la interfaz de usuario de configuracin
7.3 Importacin y exportacin a travs de la lnea de comandos
7.3.1 Exportacin desde la lnea de comandos
7.3.2 Importacin desde la lnea de comandos
7.3.3 Configuracin de Importacin-Exportacin Utilidades
7.4 Alternos Scripts Import-Export
7.4.1 Ejecucin de Importacin de Buildomatic
7.4.2 Ejecucin de Exportacin de Buildomatic
Captulo 8 Seguridad de aplicaciones

8.1 Cifrado de contraseas en los archivos de configuracin
8.1.1 Configuracin de cifrado de contraseas en Tomcat (o primavera tcServer)
8.1.2 Cifrado de contraseas de configuracin en la Enterprise Servers
8.1.3 Cifrado de Propiedades adicionales en default_master.properties
8.1.4 Cifrado de contrasea para la autenticacin externa
8.1.5 Opciones de cifrado
8.2 Configuracin de opciones de contrasea de usuario
8.2.1 Configuracin de la memoria Contrasea
8.2.2 Habilitacin de caducidad de la contrasea
8.2.3 Permitir que los usuarios cambien sus contraseas
8.2.4 Cumplimiento de patrones de contrasea
8.3 Configuracin del usuario Sesin inactiva
Prevencin 8.4 Configuracin CSRF
8.5 Configuracin de validacin de entrada
8.5.1 Mensajes de Error del Seguro
8.5.2 Edicin de reglas de validacin de entrada
8.5.3 Creacin de expresiones Validator
8.5.4 Validacin de Nuevos Parmetros de entrada
8.5.5 validacin de consulta
8.5.6 Configuracin adicional
8.6 Restriccin de la subida de archivos
8.7 Ocultacin de Seguimiento de la pila de mensajes
8.8 Definicin de una directiva entre dominios para Flash
8.9 Cifrado de contraseas de usuario
8.9.1 Cadas e Recreando la base de datos en PostgreSQL
8.9.2 Cadas e Recreando la base de datos en MySQL
8.9.3 Cadas e Recreando la base de datos en Oracle
8.9.4 Cadas y Recrear en la base de datos de Microsoft SQL Server
129
131
131
132
132
132
133
134
135
137
137
139
141
142
142
142
145
146
146
147
147
149
149
150
151
151
152
152
153
154
154
156
156
158
158
159
159
160
162
162
164
166
166
166
166
8.10 de cifrado de sesin de usuario Inicio de

sesin
8.10.1 Clave Dinmica Encryption
8.10.2 esttico clave de cifrado
Captulo 9 Configuracin del Sistema
9.1 Ajustes de configuracin en la interfaz de usuario
9.2 Configuracin para el uso de proxies
9.3 Configuracin de la persistencia de sesin
9.4 Configuracin Ad Hoc
9.4.1 Ad Hoc Configuracin de la consulta
9.4.2 Ad Hoc Polticas de datos
9.4.3 Ad Hoc Polticas de datos para Big Data
9.4.4 Ad Hoc plantillas de informe y Generadores
9.4.5 Ad Hoc del archivo de configuracin
9.4.6 Ad Hoc administracin del cach
9.4.7 Ad Hoc Configuracin de filtros OLAP
9.5 Habilitacin de datos instantneas
9.5.1 Configuracin Global Snapshot de datos
9.5.2 Informe de nivel de configuracin de instantnea de datos
9.5.3 Datos instantneas en el Programador
9.6 Configuracin de registros del sistema
9.6.1 Administracin de los valores de registro
9.6.2 Archivos de registro de configuracin
9.6.3 Adicin de un registrador a la pgina Configuracin de registro
9.7 Configuracin de servicios Web de Amazon
9.8 Configuracin de Dominios
9.8.1 Desactivacin de la validacin de dominios Comprobar
9.8.2 Optimizacin del copo de nieve de esquema se une
9.8.3 Configuracin de dominio Dependencia Comportamiento
9.8.4 Habilitacin de Oracle sinnimos
9.8.5 Habilitacin de campos CLOB
9.8.6 Habilitacin de tipos de propiedad
9.8.7 Extendiendo Mapping JDBC Tipo
9.8.8 Acceso a vistas materializadas
9.9 Configuracin de JasperReports Biblioteca
9.9.1 Ampliacin de JasperReports Biblioteca
9.9.2 Cambiar el lmite de referencias cruzadas
9.9.3 Configuracin de un Chart Tema Global
9.9.4 Desactivacin de interactividad en el Visor de informes
9.9.5 Habilitacin de las XHTML o HTML Exportadores
9.9.6 Habilitacin de Flash o HTML5 para Pro Charts
9.9.7 Configuracin de un motor de JavaScript para la grfica de representacin de
informes
9.10 Configuracin del funcionamiento del control de entrada
9.11 Configuracin del Programador
9.11.1 Configuracin de la Directiva fallo de encendido del Programador
9.11.2 Configuracin del Programador notificaciones de error
167
168
168
171
172
175
176
178
178
179
181
181
183
184
189
190
190
191
192
192
193
196
197
197
199
200
200
201
202
203
204
205
205
206
206
207
207
208
208
209
210
212
213
213
214
9.11.3 Restriccin del sistema de archivos de salida

9.11.4 Extraccin de opciones Informe Programacin de intervalo
9.11.5 Adicin de un Holiday Exclusin Calendario
9.12 Configuracin del latido del corazn
9.13 Configuracin de la Ayuda en lnea
Captulo 10 Diagnsticos del servidor

10.1 Eventos que se audita y monitoreados
10.2 Configuracin de Auditora y Supervisin
10.2.1 Habilitacin Auditora y Monitoreo
10.2.2 Auditora Opciones de copia de
10.2.3 Desactivacin de Eventos y Propiedades
10.3 Uso de los Datos de Auditora
10.3.1 Elementos de dominio de Auditora
10.3.2 Informes de Auditora y Ad Hoc Vistas
10.4 Uso de la Monitorizacin de Datos
10.4.1 Los productos Domain Monitoring
10.4.2 Informes de Seguimiento y Ad Hoc Vistas
10.5 Importacin y exportacin de datos de eventos
10.6 Real-Time Diagnstico
10.7 La exposicin de Diagnstico a travs del agente JMX de Jaspersoft
10.7.1 Conexin al agente JMX
10.7.2 Configuracin del nombre del puerto y la conexin
10.7.3 Configuracin de las funciones para las conexiones JMX
10.7.4 Desactivacin de conexiones remotas a la agente JMX
10.7.5 Conexin Alternativa a travs del servicio del servidor de aplicaciones JMX
10.8 Uso de los datos de diagnstico en los Informes
Atributos 10.9 Excluyendo diagnstico
10.10 Desactivacin Real-Time Diagnstico
Apndice A Solucin de problemas

A.1 Nmero de usuarios ha superado el
Correr A.2 Fuera de Conexiones de base de datos
A.3 Los campos no mencionados en Ad Hoc Editor
A.4 nombres de campo Desaparecer en Ad Hoc Editor
A.5 Ad Hoc de filtro con todos los valores que causan error
A.6 Ad Hoc dimensiones demasiado grandes
A.7 URLs personalizados No se cargan en Dashboards
A.8 Imprimir No Viendo en Dashboards
Programador A.9 Enviar varios mensajes de correo
electrnico
Programador A.10 Correr Tareas eliminadas
A.11 Grficos que no aparece en Excel de Exportacin
Trabajo fuentes de datos con A.12
A.12.1 Registro de Operaciones de JDBC
Drivers A.12.2 JDBC
Drivers A.12.3 JDBC en JBoss
Permisos de bases de datos A.12.4
215
216
216
218
219
221
222
223
223
224
225
226
227
229
230
230
231
232
233
233
233
234
234
235
235
236
237
239
241
241
242
242
243
243
244
245
245
246
246
247
247
247
248
248
248
A.12.5 JDBC URL de base de datos

A.12.6 JNDI Servicios en Apache Tomcat
A.12.7 JNDI Los servicios en JBoss
A.12.8 JNDI Servicios en WebLogic
A.12.9 Creacin de un origen de datos de SQL Server mediante la autenticacin de Windows
A.13 Hadoop Hive-Reports no se ejecuta
A.14 Volviendo a la pgina inicial Antiguo
Apndice B Localizacin
B.1 Configuracin de JasperReports Server para Multi-byte Fuentes
B.1.1 Habilitacin de fuentes asiticas del este
Cuadros B.1.2 Configuracin Ad Hoc para fuentes asiticas
B.1.3 Configuracin de las opciones de OLAP para grficos por defecto
Fuentes
B.1.4 incrustacin de fuentes en PDF de salida
B.2 UTF-8 Configuracin
B.2.1 Tomcat
B.2.2 JBoss
B.2.3 PostgreSQL
B.2.4 MySQL
B.2.5 Oracle
B.3 Cambio de codificacin de caracteres
B.3.1 Configuracin de servidor JasperReports
B.3.2 Configuracin de la base de datos del servidor Application Server y
Configuracin B.3.3 para localizados esquemas de anlisis
B.4 La creacin de un Locale
B.4.1 Acerca de las propiedades de archivos
B.4.2 Creacin de un paquete de recursos
B.4.3 Ajuste de la fecha y de fecha y hora Formatos
B.4.4 Configuracin de formato de datos Mscaras
B.5 Configuracin JasperReports servidores que ofrece una configuracin
regional
B.5.1 Especificacin de los entornos nacionales adicionales
B.5.2 Especificacin de zonas horarias adicionales
B.5.3 Configuracin de una zona horaria predeterminada
249
250
250
250
251
252
252
253
253
254
254
255
256
256
256
257
257
258
258
259
259
260
260
261
261
263
264
265
266
266
267
268
Glosario
269
ndice
279
10
CAPTULO 1 PANORAMA DE JasperReports SERVIDOR DE

ADMINISTRACIN
JasperReports Server genera en JasperReports Biblioteca como una familia completa de Business Intelligence (BI)
productos, proporcionando slidos informes esttico e interactivo, servidor de informes y capacidades de anlisis de datos.
Estos
las capacidades estn disponibles como productos independientes o como parte de una suite de BI integrado de extremo a
extremo utilizando
metadatos comunes y la prestacin de servicios compartidos, tales como la seguridad, un depsito, y la programacin.
El corazn de la Jaspersoft BI Suite es el servidor, que proporciona la capacidad de:
Fcil de ver y explorar los datos en el basado en la web de arrastrar y soltar Ad Hoc interfaz del Editor.
Eficiente y segura gestin de muchos informes.
Interactuar con los informes, incluida la clasificacin, filtrado, el formato, la introduccin de parmetros y la perforacin en
los datos.
Organizar informes y contenido de la web para crear atractivas, Jaspersoft Dashboards ricos en datos que transmiten
rpidamente
tendencias de negocios.
Jaspersoft OLAP es un componente opcional de JasperReports Server, controlada por licencia y se describe en su
gua de usuario propia.
Mientras que el Editor Ad Hoc permite a los usuarios crear informes sencillos, informes ms complejos se pueden crear fuera de
la
servidor. Puede usar Jaspersoft iReport Designer (en adelante denominado "iReport") o escribir su propio cdigo para JRXML
crear un informe que se puede ejecutar en el servidor. Jaspersoft recomienda utilizar iReport menos que tenga una
conocimiento profundo de la estructura de archivos JasperReports Biblioteca. Consulte la Gua del usuario del servidor
JasperReports para
ms informacin.
Jaspersoft ofrece varias otras fuentes de informacin para ayudar a ampliar su conocimiento de JasperReports del servidor:
Nuestros guas Ultimate documentan funciones avanzadas, las mejores prcticas, y numerosos ejemplos. Los clientes
pueden
descargar libremente desde la Jaspersoftonline tienda.
Nuestro libre Business Intelligence Tutoriales le permiten aprender a su propio ritmo, y cubre temas para los
desarrolladores,
los administradores, los usuarios de negocio y datos integradores. Los tutoriales estn disponibles en lnea en el
profesional
Nuestras
muestras
gratuitas,
que se instalan
con JasperReports Biblioteca, Jaspersoft iReport Designer y JasperReports
Seccin
de Servicios
de nuestra
sitio web.
Server, se documentan en lnea. El muestras documentacin se puede encontrar en nuestra comunidad web.
Esta gua del administrador describe caractersticas que slo estn disponibles para los usuarios que tienen funciones de
administrador.
Muchos de los procedimientos de configuracin tambin se supone que tiene acceso ilimitado a los JasperReports
Equipo host del servidor.
Este captulo contiene las siguientes secciones:
Informacin general de las

Organizaciones
Descripcin del repositorio
11
Visin general de usuarios y roles

Introduccin a la seguridad
Administrator Login
Administrador de Pginas
En esta seccin se describe la funcionalidad que puede ser restringido por la licencia de software para JasperReports
Server. Si usted no ve algunas de las opciones descritas en esta seccin, su licencia puede prohibirle
usarlos. Para saber lo que usted est autorizado a utilizar, o para actualizar su licencia, pngase en contacto con Jaspersoft.
JasperReports Server es un componente tanto de un proyecto comunitario y ofertas comerciales. Cada integra la
caractersticas estndar tales como la seguridad, la programacin, una interfaz de servicios web, y mucho ms para correr y
compartir
informes. Ediciones comerciales ofrecen caractersticas adicionales, grficos Ad Hoc, grficos flash, cuadros de mando,
incluyendo,
Dominios, auditora, y una arquitectura multi-organizacin para la celebracin de grandes despliegues de BI.
1.1
Informacin general de las

Organizaciones
La arquitectura de la versin comercial de JasperReports Server se basa en las organizaciones, que son lgicas
entidades dentro de JasperReports Server que tienen sus propios usuarios, roles y ramas del repositorio. Como con cualquier
estructura empresarial o jerarqua, las organizaciones pueden tener suborganizaciones, que a su vez puede tener
suborganizaciones, y as sucesivamente.
En la instalacin JasperReports Server por omisin, hay una sola organizacin que imita la estructura simple de
versiones anteriores de JasperReports servidor. Si desea implementar mltiples organizaciones, hay cierto diseo
consideraciones que deben tener en cuenta.
1.1.1
Individual Organizacin por omisin

Despus de una instalacin por defecto, JasperReports Server contiene una sola organizacin en la que usted puede
implementar su
informes. Por ejemplo, si instala los datos de ejemplo, se ve una sola organizacin que mantiene toda la muestra
recursos, usuarios y roles.
Organizaciones individuales estn diseados para manejar la mayora de los casos de negocios y son fciles de administrar.
Incluso en un
organizacin nica, hay un administrador de sistema y un administrador organizacin que comparten tareas administrativas. Si el
necesidades de su negocio llamar para ms organizaciones, que deben gestionar varios niveles de administracin y
posiblemente crear recursos compartidos en el repositorio. Las siguientes secciones ofrecen los casos de uso y explicar la
funcionamiento de mltiples niveles de los administradores.
1.1.2
Mltiples organizaciones
Hay muchos escenarios para la definicin de mltiples organizaciones en JasperReports Server. Por ejemplo:
12
Un proveedor de la aplicacin, tales como (SaaS) empresa de software-as-a-service o un departamento informtico, tiene
una
aplicacin alojada siendo ofrecido a muchos clientes. Integra JasperReports servidor en su aplicacin en
para ofrecer cuadros de mando, informes y anlisis. Hay una serie de informes comunes y fuentes de datos que
son tiles en todos los clientes, pero hay informes especficos de los clientes, as. Mquinas y bases de datos son
compartida por los clientes, de acuerdo con la propia arquitectura del proveedor, pero dentro de la funcionalidad
proporcionada por
JasperReports Server, cada cliente es una organizacin independiente. Los clientes pueden gestionar sus propios usuarios
en el
aplicacin alojada, y mapas de JasperReports esquema de autenticacin del servidor de la aplicacin para la correcta
organizacin. El mecanismo de organizacin proporciona toda la potencia de JasperReports Server para cada uno de los
los clientes del proveedor, asegurando al mismo tiempo que sus datos e informes son seguras.
Una empresa tiene muchos departamentos pero quiere consolidar el entorno de BI para que todos los departamentos son
compartir una infraestructura de BI comn. Corporativo de TI slo tiene que implementar y mantener una nica instancia de
JasperReports Server, y cada departamento est representado por una organizacin que gestiona sus propios usuarios.
Para
la seguridad y la simplicidad, los departamentos no comparten bases de datos, excepto en el caso de sub-departamentos,
tales
como cuentas por pagar de ser un sub-departamento de Finanzas. Los usuarios acceden a JasperReports servidor
directamente, la tala
con su nombre de departamento y nombre de usuario. Administradores de la organizacin se han definido las fuentes de
datos
La funcin de organizacin es suficiente para acomodar cualquier combinacin de estos escenarios flexibles y muchos como
Dominios y especfica a las necesidades de los usuarios de sus departamentos.
ella. En todos los casos, los administradores pueden configurar entornos seguros para cualquier nmero de organizaciones y
usuarios finales
experimentar una potente plataforma de BI que se adapte a sus necesidades.
Cada organizacin o jerarqua de las organizaciones co-existe con independencia de la misma instancia de JasperReports
Server, que asla las organizaciones vecinas entre s, sino que permite a las organizaciones de padres tienen plena
control sobre sus suborganizaciones. Los usuarios pueden acceder slo a los datos y recursos en su organizacin o un
suborganizacin y administradores pueden definir las funciones y establecer permisos para restringir an ms el acceso.
1.1.3
Los niveles de Administradores

Cada organizacin tiene un administrador que puede administrar usuarios, roles y permisos del repositorio en que
organizacin. La administracin de las organizaciones es jerrquica, lo que significa que el administrador tambin puede
gestionar todos los usuarios y roles en suborganizaciones de cualquier nivel.
Fundamentalmente, hay tres niveles de administracin:
El administrador del sistema - Tambin llamado administrador de sistema. La ID del administrador de sistema es superusuario.
l existe
en el nivel raz, fuera de todas las organizaciones. El sistema de administracin gestiona la instalacin JasperReports
Server,
crea organizaciones de primer nivel, y configura los ajustes a nivel de servidor. El sistema administrador puede crear,
modificar,
y eliminar usuarios, roles y objetos de repositorio de cualquier organizacin.

El administrador de una organizacin de nivel superior - Tambin llamado organizacin de administracin. El administrador
organizacin
gestiona todos los usuarios, roles y objetos de repositorio en toda una organizacin, incluyendo cualquier
suborganizaciones.
El nombre predeterminado de inicio de sesin del administrador organizacin es jasperadmin.
El administrador de un suborganizacin - Funcionalmente equivalente a un administrador organizacin, pero debido a la
jerarquams
de las
organizaciones,
un conjunto
limitadoyde
usuarios, roles
y objetos del repositorio
puede
La distincin
importante
es entregestiona
el administrador
de sistema
organizacin
de administracin.
Incluso eny el
casoser
de un
anulado
por
una
organizacin
de
administracin
de
nivel
superior.
organizacin predeterminada sola, hay un administrador de sistema para la configuracin del servidor, y un administrador para
la organizacin nica
organizacin. El sistema administrador puede gestionar todos los usuarios y todo el repositorio, pero a veces es ms
conveniente utilizar el administrador de la organizacin para hacer esto debido a que el administrador organizacin ve el
repositorio en la
misma manera que los usuarios de la organizacin.
Cuando hay suborganizaciones, el administrador de la organizacin matriz puede o bien gestionar sus usuarios y
papeles, o delegar esas tareas a un administrador en cada suborganizacin. El administrador de un suborganizacin
se limita a acceder a los recursos y la gestin de usuarios y roles en el suborganizacin, por lo tanto el mantenimiento de la
seguridad de la organizacin matriz y la o de los padres de otros suborganizaciones.
13
1.2
Descripcin del repositorio

El repositorio es una estructura jerrquica de carpetas donde JasperReports Server, los administradores y los usuarios
almacenar
recursos para la creacin, funcionamiento y visualizacin de informes. En su aspecto y funcin, el repositorio se asemeja a un
sistema de archivos con una estructura de carpetas que contienen los archivos. Sin embargo, el repositorio se aplica
realmente como
base de datos que es privado a la instancia del servidor. Como resultado de ello, carece de algunas de las funciones de un
sistema de archivos.
1.2.1
Estructura de carpetas
La raz de la estructura de rbol del repositorio es accesible slo para el administrador de sistema conectado como
superusuario (Como se
se muestra en la siguiente figura) en la edicin comercial, o jasperadmin en la edicin de la comunidad. El rbol
contiene las carpetas de cada organizacin (en la edicin comercial), y carpetas para determinada configuracin
configuracin.
Figura 1-1 raz de las carpetas predeterminadas Mostrando Repositorio

En el repositorio, cada organizacin tiene su propia rama, contenida en una carpeta con el nombre de la organizacin. Cada
carpeta de nivel superior de organizacin tambin contiene una carpeta llamada Organizaciones de modo que pueden ser
suborganizaciones
creado.
La figura anterior muestra la opinin del superusuario, a partir de la raz. En la carpeta Organizaciones hay una carpeta para
la organizacin por omisin, que se denomina Organizacin. Esta figura tambin muestra una segunda organizacin de nivel
superior.
Usuarios de edicin comercial conectado como jasperadmin ver una estructura similar.
JasperReports servidor automticamente restringe el acceso de cada usuario a la sucursal de su propia organizacin de la
repositorio. Los administradores del sistema ( superusuario) Pueden ver y crear carpetas en todas las organizaciones, mientras
que la organizacin
(administradoresjasperadmin) Slo puede ver y crear carpetas en las organizaciones que administran. En general,
Jaspersoft recomienda evitar la colocacin de recursos directamente en la carpeta raz o de la organizacin. En su lugar, utilice
carpetas para los distintos tipos de recursos, como en los datos de la muestra.
1.2.2
Recursos
Los recursos se almacenan en el repositorio y se utilizan como entrada para la creacin de informes y la realizacin de anlisis.
Algunos
recursos, como imgenes, fuentes o archivos JRXML creados en iReport, se cargan desde los archivos. Otros, como los datos
fuentes y dominios, se crean en s JasperReports Server. Por supuesto, cuadros de mando, vistas e informes pueden
tambin se guardar en el repositorio para ejecutarse tan a menudo como sea necesario, y de salida, como PDF o HTML se
pueden guardar en
el repositorio tambin.
14
Todos los recursos, incluyendo carpetas, tienen un identificador nico, un nombre y una descripcin opcional. El ID de un
recurso,
junto con el ID de sus carpetas que encierran crea un camino que puede ser utilizado para hacer referencia a los recursos. El
nombre y
descripcin
en la interfaz
usuario
cuando
navegador
o buscar
en el repositorio.
Los recursosaparece
se almacenan
en un de
formato
interno
queelno
es accesible
a los usuarios
o administradores, a pesar de cierta
objetos se pueden descargar a su sistema de archivos en un formato de salida, tales como XML. Cualquier recurso puede ser
exportado
con la js-exportacin de servicios pblicos, pero los archivos resultantes son para copia de seguridad o transferir a otro servidor
JasperReports
instancia y no se puede modificar.
JasperReports servidor restringe el acceso a las carpetas y los recursos en funcin de las organizaciones, nombres de usuarios
y roles. El
administrador de sistema y organizacin de administracin pueden definir permisos como se explica en "Visin general de
usuarios y funciones"
en la pgina 17.
1.2.3
Sample Data
Al instalar los datos de ejemplo en JasperReports Server, la organizacin por omisin (Organizacin) tiene la muestra
contenido. En la siguiente figura, se puede ver las carpetas que contienen los recursos de la muestra, como se ve por el
administrador de sistema
y organizacin predeterminada de administrador.
Administrador del sistema (superusuario)
Vista:
Organizacin admin (jasperadmin) Vista:
Figura 1-2 Sistema de admin y la admin Vistas de datos de ejemplo

Los datos de la muestra incluye cuadros de mando, informes, Dominios, fuentes de datos, y muchos de sus componentes,
como
tipos de entrada y archivos de imagen. Cada tipo de contenido se almacena en una carpeta separada, por lo que es fcil de
localizar. El
Carpeta Supermart demo contiene un ejemplo completo de cuadros de mando, informes y recursos para los diversos negocios
escenarios en una empresa supermercado ficticio.
15
La carpeta pblica es una carpeta especial del sistema que aparece en la raz y en cada carpeta de organizacin. Su contenido
se comparten con todas las organizaciones. El sistema de administracin debe gestionar la carpeta pblica y establecer
permisos para que
los usuarios pueden acceder a los recursos compartidos (como las fuentes de datos, logos y plantillas de informes), pero no
modificarlos.
1.2.4
Examinando y buscando
Los usuarios y administradores pueden navegar o buscar en el repositorio, en funcin de la accin que se desea realizar
y cmo se organizan los recursos. Al navegar por las carpetas y su contenido, los administradores tienen ms
acciones disponibles, tales como la creacin de recursos. Buscando el repositorio encuentra recursos especficos ms rpido.
Explorar - En la pgina Inicio, haga clic en Ver> Repositorio.
Figura 1-3 Navegando por el repositorio
16
En el modo Visualizar, el panel de carpetas de la izquierda muestra las carpetas en el repositorio y el panel Repositorio
enumera el contenido de la carpeta seleccionada. La barra de herramientas en el panel Repositorio permite llevar a cabo
acciones
tal como Copiar, Cortar, Pegar, y Eliminar; seleccionar varios recursos en una misma carpeta para realizar acciones de
forma masiva.
Modo de- Ingrese
bsqueda
tiene de
la barra
de herramientas.
Buscar
un no
trmino
bsqueda
en el campo de bsqueda en la parte superior de cualquier pgina, o
seleccione Ver> Resultados de la bsqueda.
Figura 1-4 Bsqueda del Repositorio

Los filtros en el panel de la izquierda permiten a los usuarios a refinar su bsqueda. El Ver> Informes y Ver> OLAP
Vistas tambin utilizar la funcin de bsqueda con filtros predefinidos para encontrar todos los informes y todas las vistas
OLAP a la que el
usuario tiene acceso.
Para obtener ms informacin sobre la navegacin y la bsqueda en el repositorio, consulte la Gua del usuario de
JasperReports Server.
1.3
Visin general de usuarios y roles

Las cuentas de usuario y la pertenencia a funciones proporcionan mecanismos de autenticacin y autorizacin para
implementar el acceso
Control en JasperReports Server. Los usuarios introducen un nombre de organizacin si se requiere, un nombre de usuario y
una contrasea en
Para acceder a JasperReports Server. Basada en funciones de administradores asignan nombrados roles a usuarios y luego
crean
En
la versin
los usuarios
y los roles
estn
con las organizaciones en
permisos
paracomercial
restringir de
anJasperReports
ms el accesoServer,
a los objetos
del repositorio
y en
los asociados
datos de Dominios.
que se han definido, y que siguen el mismo modelo jerrquico. Usuarios y roles definidos en una organizacin
puede ser concedido o denegado el acceso a cualquier carpeta del depsito o el objeto en la organizacin o sus
suborganizaciones.
Sin embargo, el administrador de la suborganizacin no tiene visibilidad de los roles y los usuarios de los padres
organizacin, incluso si se utilizan en el permiso de acceso dentro de la suborganizacin.
Los nombres de usuario y nombres de rol son nicos dentro de una organizacin, pero no necesariamente entre
suborganizaciones o
en todas las organizaciones en el servidor. Por ejemplo, el administrador de la organizacin por defecto se llama jasperadmin
en toda organizacin. Debido a que la organizacin se debe dar al iniciar la sesin, JasperReports Server puede
distinguir entre cada usuario. En algunos casos, tales como servicios web, un usuario se identifica por la cadena nica
nombre de usuario | organization_id.
En la edicin de la comunidad de JasperReports Server, no es slo una organizacin predeterminada. Todo usuario y el papel
nombres pertenecen a esta organizacin.
El acceso al repositorio se define directamente en los recursos del repositorio. Los administradores pueden definir un nivel de
acceso, tales como lectura y escritura, de slo lectura o sin acceso, y cada permiso puede basarse ya sea en un nombre de
usuario o en
un nombre de rol.
1.3.1
Administracin de usuarios y roles

Los administradores realizan las siguientes acciones para gestionar los usuarios en su
organizacin:
17
1.3.2
Crear, modificar y eliminar usuarios.

Establecer propiedades de la cuenta de usuario, como nombre, correo electrnico, y la configuracin de la contrasea.
Sin embargo, ningn administrador puede
nunca ver la contrasea existente de un usuario en texto sin cifrar.
Entrar como cualquier usuario de la organizacin de los permisos de pruebas.
Crear, modificar y eliminar roles.
Asignar roles a los usuarios.
Establecer permisos de acceso a carpetas ni recursos del repositorio.
Administracin delegada
JasperReports Server permite tres niveles de la administracin delegada:
La estructura jerrquica de las organizaciones significa administradores en cada organizacin se limitan a acciones
dentro de su organizacin. Pero esto slo se aplica a mltiples organizaciones en las que tiene sentido tener
administradores subordinados.
Los permisos Administrar permite a un usuario ver y establecer permisos en una carpeta o recurso. Esto permite que un
power-usuario gestionar su propia seccin del repositorio, pero no para crear o administrar usuarios.
Concesin ROLE_ADMINISTRATOR,ROLE_SUPERUSER, O ambos permite a un usuario para ver la interfaz de gestin
y crear usuarios y roles. Esto es cierto la administracin delegada, mediante el cual un usuario que no sea superusuario o
jasperadmin tiene las mismas habilidades.
En el caso de la verdadera administracin delegada, hay tres factores que determinan el alcance de un usuario de
privilegios administrativos:
ROLE_ADMINISTRATOR - JasperReports Servidor confiere los privilegios de nivel de organizacin para cualquier usuario con
este Esto incluye Gestin de usuarios, roles y permisos en el repositorio, as como los recursos que crean en
papel.
el repositorio. Cuando un usuario con este rol inicia una sesin, el servidor muestra los mens adicionales para acceder a
la
pginas de administracin y gestin de los recursos del repositorio. Cualquier administrador, que por definicin tiene esta
funcin, puede
asignarlo a cualquier otro usuario.
ROLE_SUPERUSER - Cuando un usuario ya tiene ROLE_ADMINISTRATOR, Esta funcin adicional permite el acceso a
las funciones de configuracin del sistema. Slo un administrador del sistema puede asignar esta funcin a otro usuario;
organizacin
los administradores no pueden ver o asignar este rol.
En un entorno multi-organizacin, ROLE_SUPERUSER No se debe dar a los administradores de organizacin o
usuarios de la organizacin, ya que esto permite el acceso a la cach Especial compartida por todas las organizaciones.
En el caso
de una sola organizacin, como en la instalacin por defecto, puede asignar esta funcin a la organizacin
administradores que permitan el acceso a la configuracin del sistema sin otorgar privilegios para crear organizaciones de
grado superior o
otros administradores de sistemas.
La organizacin del usuario - Independientemente de los roles, el administrador siempre est limitada en su alcance al
organizacin en la que se crea la cuenta de usuario, incluidas las suborganizaciones de los mismos. En ningn caso puede
un
usuario, incluso con la ROLE_SUPERUSER, Nunca ver o modificar cualquier organizacin, usuario, rol o carpeta fuera de
la organizacin a la que pertenece el usuario.
Cualquier administrador puede conceder ROLE_ADMINISTRATOR a cualquier usuario. Ese usuario se convierte entonces
equivalente a una
organizacin de administracin de la organizacin en la que l pertenece. Con el fin de delegar la administracin del
sistema, la
administrador de sistema existente debe primero crear otros usuarios en el nivel raz, fuera de cualquier organizacin. El
sistema
administrador puede asignar tanto ROLE_ADMINISTRATOR y ROLE_SUPERUSER concederles administrador de sistema
privilegios. Para ms informacin sobre estas funciones, consulte "Permisos" en la pgina 57.
18
1.4
Introduccin a la seguridad
JasperReports Server garantiza que las personas slo pueden acceder a los datos que se les permite ver. Los mecanismos que
definir las organizaciones, usuarios, roles y recursos de trabajo del repositorio juntos para proporcionar control de acceso
completa que
incluye:
Autenticacin - Restringe el acceso a los usuarios identificados y protege el acceso con contraseas. Define los roles
para agrupar a los usuarios y la asignacin de permisos. La autenticacin se explica con ms detalle en la siguiente seccin.
Autorizacin - Controla el acceso a los objetos del repositorio, pginas y mens basados en usuarios y roles.
La autorizacin se explica con ms detalle en una seccin siguiente.

Seguridad a nivel de datos (slo versin comercial) - Define los permisos de fila y columna de nivel para acceder a su
datos. Permisos de fila y nivel de columna se pueden definir y ejecutadas en Dominios. Para obtener ms informacin,
consulte la Gua del usuario de JasperReports Server. Si implementa Jaspersoft OLAP, puede utilizar funciones a
asegurar sus datos en cualquier nivel de la jerarqua de un esquema de anlisis. Para obtener ms informacin, consulte la
Jaspersoft
Gua del usuario de OLAP.
Los administradores deben mantener la seguridad en mente en todo momento en la gestin de las organizaciones, usuarios,
roles y recursos,
debido a que el mecanismo de seguridad detrs de cada uno de ellos dependen de los dems.
1.4.1
Autenticacin
La primera parte de la seguridad es definir las cuentas de usuario y seguro con contraseas. Los usuarios deben iniciar sesin
con su
ID de usuario y contrasea para que tengan una identidad en JasperReports Server. Las definiciones servidor almacena los
usuarios,
incluidas las contraseas cifradas, en una base de datos privada. Los administradores crear, modificar y eliminar cuentas de
usuario
JasperReports
Server tambin
implementacomo
las funciones
queense"Gestin
pueden de
asignar
a cualquier
nmero
a travs de las pginas
de administrador,
se describe
usuarios"
en la pgina
29.de usuarios. Roles permiten
a los administradores
crear grupos o categoras de usuarios que se otorgan permisos similares. Un usuario puede pertenecer a cualquier nmero de
funciones
y recibir los privilegios de cada uno de ellos. La definicin de funciones servidor almacena en su base de datos privada, y
administradores crear, modificar y eliminar los roles a travs de las pginas de administrador, como se describe en "Gestin
Roles "en la pgina 36.
JasperReports Server se basa en el marco de seguridad de la primavera de cdigo abierto; tiene muchas opciones
configurables para:
Servicios de autenticacin externos como LDAP (utilizado por Microsoft Active Directory y Novell eDirectory)
Inicio de sesin nico utilizando central Servicio de autenticacin de JA-SIG (CAS)
Autenticacin Java y Servicio de autorizacin (JAAS)
Seguridad de los contenedores (Tomcat, Espoln)
SiteMinder
El acceso de usuarios annimos (deshabilitado por defecto)
JasperReports Server tambin es compatible con estos estndares de cifrado y autenticacin:
HTTPS, incluyendo el requerir HTTPS

HTTP Bsica
HTTP Digest
X509
El framework Spring es fcilmente extensible para integrar a los usos y servicios de autenticacin y comerciales
transporta.
Autenticacin se realiza de forma predeterminada a travs de la interfaz de usuario de la web, lo que oblig inicio de sesin, y
/ oa travs de HTTP Bsica
autenticacin para servicios web, como Jaspersoft iReport Designer y para XML / A de trfico. El servidor puede
sincronizar automticamente con un servicio de autenticacin externo. Los usuarios externos no necesitan ser creados
19
manualmente en el servidor primero. Tanto los usuarios como los roles se crean automticamente en el servidor desde sus
definiciones en
un servicio de autenticacin externo. Para una visin general del sistema de autenticacin y detalles sobre externo
autenticacin, consulte la JasperReports servidor de autenticacin Cookbook.
1.4.2
Autorizacin general
Con la identidad de un usuario y los roles establecidos, JasperReports servidor controla el acceso del usuario de las
siguientes maneras:
Las opciones de men y
pginas
Los mens que aparecen en JasperReports Servidor dependen de los roles del usuario. Para
ejemplo, slo los usuarios con el rol de administrador pueden ver el Gestionar men y
acceder a las pginas de administrador. Mediante la modificacin de la configuracin del servidor,
puede
modificar el acceso a los mens, elementos de men y las pginas individuales. Consulte el
Gua de compilacin del servidor Fuente JasperReports y JasperReports Servidor ltimo
Gua para obtener ms informacin.
Alcance Organizacin
Los usuarios pertenecen a las organizaciones y se limitan a ver a los recursos dentro de su
organizacin. Las organizaciones tienen sus propios administradores, pero slo ven la
usuarios, roles y recursos de su organizacin. Cuando JasperReports Server es
configurado con mltiples organizaciones, que estn efectivamente aislados el uno del otro,
aunque el administrador de sistema puede compartir recursos a travs de la carpeta pblica. Para
obtener ms
informacin, consulte "Mltiples Organizaciones en el repositorio" en la pgina 55.
Permisos de recursos
Los administradores pueden definir permisos de acceso en todas las carpetas y recursos en el
repositorio. Los permisos se pueden definir para cada papel y cada usuario, o pueden ser
dejado sin definir lo que se heredan de la carpeta principal. Por ejemplo, el usuario puede
el acceso a una carpeta donde crean informes han lectura-escritura, pero el administrador
Tambin puede crear informes compartidos en la misma carpeta que se establece en slo lectura. El
permisos posibles son: acceso, ejecutar solamente, de slo lectura, lectura eliminar, lectura
escribir-eliminar y administrar (ver "Permisos" en la pgina 57).
Los permisos se aplican al acceder a cualquier recurso, ya sea directamente a travs de la

interfaz de repositorio, de forma indirecta cuando se llama desde un informe, o mediante programacin
a travs de los servicios web. Los permisos son acumulativos, lo que significa que un usuario tiene la
ms permisiva acceso que se concede a cualquiera de los roles a los que pertenece el usuario.
Privilegios de administrador
20
JasperReports servidor distingue entre la lectura o escritura de un recurso en el

repositorio y ver o editar la definicin interna de un recurso. Para mayor seguridad
efectos, la concesin de un permiso de lectura o de escritura del usuario en un recurso no permite
ver o editar la definicin del recurso. Por ejemplo, los usuarios deben ejecutar o leer
permiso en una fuente de datos para ejecutar los informes que lo utilizan, pero no puede ver los datos
la definicin de la fuente que incluye una contrasea de base de datos. Adems, slo los
administradores
puede interactuar con carpetas temticas para cargar, descargar y activar archivos CSS que
controlar la interfaz de usuario.
La seguridad a nivel de datos La seguridad a nivel de datos define qu datos se pueden recuperar y mostrar en un informe, basado
en el nombre de usuario y roles de usuario que ejecuta el informe. Por ejemplo, una
informe de gestin podra permitir a cualquier usuario ver la jerarqua de gestin,
gerentes veran la informacin sobre los salarios de sus empleados directos, y slo
los gerentes de recursos humanos veran todos los valores salariales.
La seguridad a nivel de datos en dominios se explica en el JasperReports usuario del servidor
Gua. La seguridad a nivel de datos a travs de vistas OLAP est cubierto de la Jaspersoft OLAP
Gua del usuario.
Nota: Este tipo de seguridad slo est disponible en la edicin comercial de
Atributos del perfil
1.5
Atributos del perfil son pares nombre-valor asociados a una cuenta de usuario. Pueden
proporcionar informacin adicional sobre el usuario, y tambin pueden ser utilizados para restringir
el acceso a datos a travs de archivos de seguridad de dominio y esquemas OLAP. Para obtener
informacin sobre
definir atributos de perfil, ver "Editar Perfil Atributos" en la pgina 34.
Administrator Login
Administradores de sesin en la pgina de inicio de sesin estndar, utilizando las siguientes
contraseas por defecto:
Ediciones comerciales:
administrador de sistema: nombre de usuario superusuario y la contrasea superusuario
organizacin de administracin: nombre de usuario jasperadmin y la contrasea
jasperadmin
Proyecto de la Comunidad: administrador de sistema: nombre de usuario jasperadmin y la contrasea jasperadmin

Por razones de seguridad, siempre cambiar el administrador por defecto las contraseas inmediatamente despus de la
instalacin
JasperReports Server. Para obtener instrucciones, consulte "Edicin de un usuario" en la pgina 33.
Para obtener ms informacin acerca de las opciones en la pgina de inicio de sesin y de registro con mltiples
organizaciones, consulte la
Gua del usuario de JasperReports Server.
La primera vez que inicie sesin como administrador, se le pedir a optar-en el programa Heartbeat. Usted
Tambin debe establecer las contraseas y correo electrnico de administrador.
1.5.1
JasperReports Server Heartbeat

Cuando inicia sesin en JasperReports Server por primera vez despus de la instalacin, los usuarios de la edicin comercial
puede
se le pregunte a optar en el servidor de Heartbeatprogram. Se reporta la informacin especfica de Jaspersoft sobre su
aplicacin: el sistema operativo, JVM, servidor de aplicaciones, base de datos (tipo y versin), y JasperReports
Edicin de servidor y nmero de versin. Mediante el seguimiento de esta informacin, Jaspersoft puede crear mejores
productos que
funcionar de manera ptima en su entorno. No se recopila informacin personal.
Para optar al programa, haga clic en Okay. Para optar por no, desactive la casilla de verificacin
a continuacin, haga clic en Okay.
1.5.2
Administrador de Correo
Despus de iniciar sesin por primera vez, se debe configurar el correo electrnico en el superusuario y jasperadmin cuentas a
Su direccin de correo electrnico. En casos muy raros, puede que el servidor le notificar por correo electrnico acerca de
problemas con su licencia.
21
Este es tambin un buen momento para cambiar las contraseas por defecto en la superusuario y jasperadmin cuentas
tambin.
Para configurar el correo electrnico y las contraseas en las cuentas de administrador, editar la informacin de la cuenta de
usuario como se describe en
"Edicin de un usuario" en la pgina 33.
1.6
Administrador de Pginas
Los administradores tienen acceso a pginas especiales para administrar el servidor. Despus de iniciar sesin, haga clic en
Ver opciones en el
Caja de administracin en la pgina de introduccin o seleccionar un elemento de la Gestionar men en cualquier pgina.
Administrador del
sistema:
Organizacin de administrador:
Figura 1-5 Diferentes Administrar mens para diferentes administradores

En la edicin comercial de JasperReports Server, los controles de administrador son diferentes para el sistema y
administradores de la organizacin, como se muestra en la figura anterior. Administradores de la organizacin pueden administrar
usuarios, roles, y
suborganizaciones, pero slo dentro de su organizacin. Los administradores del sistema pueden gestionar organizaciones de
nivel superior, as
como usuarios y roles en cualquier organizacin. Adems, slo los administradores del sistema tienen acceso a la configuracin
a nivel de servidor
La
figura
el Admin
Home
pgina
para
losdeadministradores
sistemas que incluye el Ver configuracin
quesiguiente
se aplican
a losmuestra
registros,
Jaspersoft
OLAP,
y Ad
Hoc
cach de datosde
y polticas.
botn no
a disposicin de los administradores de la organizacin.
22
Figura 1-6 Gestionar Server Page para Sistema de administradores en las ediciones comerciales (superusuario)
El Acerca de JasperReports Servidor enlace en el pie de pgina de todas las pginas muestra el dilogo que se muestra en la
siguiente figura.
El cuadro de dilogo muestra el nmero de versin del producto, as como otra informacin, como la compilacin de software, su
el tipo de licencia, y su vencimiento. Por favor, tenga esta informacin si necesita ponerse en contacto con Jaspersoft para el
apoyo.
Figura 1-7 Acerca JasperReports dilogo del servidor
23
24
CAPTULO 2 ORGANIZACION, DE USUARIO, Y LA GESTIN

PAPEL
En una implementacin de una sola organizacin, el administrador slo tiene que crear los usuarios y roles. En las
implementaciones
con mltiples organizaciones, los administradores necesitan para crear organizaciones, rellenarlos con los usuarios, y crear
los papeles que utilizan despus para establecer los permisos de acceso.
En un despliegue con mltiples organizaciones, no puede haber administradores en todos los niveles de la jerarqua, como
descrito en "Administracin delegada" en la pgina 18. Parte de cualquier despliegue grande es para designar el
administradores que se encargan de todas las tareas. Por ejemplo, los administradores de sistemas pueden configurar el nivel
superior
organizaciones y roles predeterminados, sino de administracin de cada organizacin a continuacin, crear y gestionar los
usuarios de su
en particular la organizacin.
La interfaz en JasperReports Server para organizaciones que gestionan (los usuarios de la edicin comercial), usuarios y roles
(Tanto comerciales como ediciones comunidad) tiene capacidad para todos los niveles de administracin y hace que sea fcil
para ellos
buscar entre cientos de usuarios y roles, ya sea en una sola organizacin o difundir a travs de muchos. El
interfaz tambin hace cumplir el alcance de los privilegios administrativos. Por ejemplo, se asegura que una organizacin
administrador no puede ver las funciones y los usuarios de las organizaciones de padres.
2.1
Gestin de Organizaciones
Gestin de usuarios
Administracin de funciones
Gestin de Organizaciones
Los administradores del sistema y los administradores de la organizacin utilizan las mismas pginas para organizaciones que
gestionan, la nica diferencia es
que los administradores del sistema pueden gestionar organizaciones de nivel superior, mientras que los administradores de la
organizacin se limitan a
suborganizaciones.
Los usuarios de la edicin Comunidad y administradores de implementaciones con una sola organizacin por defecto
puede
en general, omita esta seccin. Sin embargo, este procedimiento se puede utilizar para cambiar el nombre del defecto
organizacin.
25
La siguiente figura muestra las organizaciones que el administrador de sistema (superusuario) puede ver, es decir, toda la
organizaciones en el repositorio. Como se muestra en el panel de Organizaciones de la izquierda, vista del sistema de admin
comienza en la raz de la jerarqua de la organizacin, e incluye todas las organizaciones y suborganizaciones definidos, por lo
que
l puede manejar cualquier organizacin o suborganizacin en el repositorio. En este ejemplo, hay dos de nivel superior
organizaciones, y uno de ellos tiene varias suborganizaciones.
Figura 2-1 Sistema Admin Ver Gestionar Organizaciones de Pgina

La siguiente figura muestra el mismo repositorio, como se ve por el administrador de la Organizacin (jasperadmin). Muestra
que la visin de esta administracin se limita a su propia organizacin y sus suborganizaciones, y l puede tener acceso y
administrar solo aquellos.
Figura 2-2 Organizacin Admin Ver Gestionar Organizaciones de Pgina
26
2.1.1
1.
2.
Visualizacin de las propiedades de la

Organizacin
Inicie sesin como un usuario con privilegios de administrador para la

organizacin.
Seleccione Gestionar> Organizaciones.
Aparece la pgina de gestin de la organizacin, como se muestra en Figura 2-1 o Figura 2-2.
3.
4.
2.1.2
Para seleccionar una organizacin, haga clic en su padre, en el panel de Organizaciones de la mano izquierda, a
continuacin, seleccione en el centro
Panel de Organizacin. Si hay muchas organizaciones, puede introducir un trmino de bsqueda para encontrar una
especfica
organizacin. Sin embargo, el trmino de bsqueda slo busca en la lista de la organizacin en los centros de
Organizaciones
Una vez que se selecciona una organizacin, el panel Propiedades muestra informacin sobre la organizacin:
panel.
Nombre - Muestra el nombre de la organizacin que aparece en la carpeta de la parte superior de la organizacin.
ID - nico y permanente identificacin de la organizacin que se utiliza para iniciar sesin en la organizacin.
Alias - nombre corto nico pero editable para la organizacin que tambin puede utilizarse al iniciar sesin.
Descripcin - descripcin opcional que slo aparece en este panel Propiedades.
Nmero de usuarios - Conde de todos los usuarios, incluidos los de las suborganizaciones. Haga clic en Gestionar para
ver
la lista de usuarios en la pgina de gestin de usuarios.
Nmero de Roles - Cuenta todos los papeles, incluidos los de todo suborganizaciones. El nmero de funciones hace
No incluye las funciones de sistema (como ROLE_USER) que aparecen en cada nivel de la organizacin, pero que son
definidos en el nivel raz. Haga clic en Gestionar para ver la lista de funciones en la pgina de administracin de
funciones.
Creacin de una Organizacin

1.
2.
3.
4.
Inicie sesin como un usuario con privilegios de administrador para el padre de la nueva
organizacin.
Haga clic en Gestionar> Organizaciones.
En el panel de Organizaciones de la mano izquierda, expanda la jerarqua de las organizaciones para
seleccionar al padre
organizacin, por ejemplo, Finanzas, a continuacin, haga clic en Aadir organizacin en el panel central.
Aparecer el cuadro de dilogo Agregar Organizacin.
Figura 2-3 Adicin de una Organizacin
27
5.
6.
Introduzca el nombre de la organizacin; el servidor rellena automticamente el ID y alias basado en el nombre. Usted
puede
cambiar el ID y alias, si es necesario antes de guardar la organizacin. Una vez guardado, el identificador de la
organizacin no puede
ya que
Para
guardar
modificarse.
la nueva
La organizacin,
descripcin eshaga
opcional.
clic enLaAadir
figura aanterior
la Organizacin
muestra este
<organizacin>.
cuadro de dilogo con valores de muestra.
La nueva organizacin aparece en los paneles de las Organizaciones. Cuando lo seleccione en el panel central, su
propiedades aparecen en el panel de propiedades de la derecha.
El panel de propiedades muestra el nmero de usuarios y roles en la organizacin y enlaces para gestionarlos. Por
De forma predeterminada, las nuevas organizaciones tienen el siguiente:
Dos usuarios con contraseas predeterminadas: el administrador (organizacinjasperadmin/jasperadmin) Y un usuario de

ejemplo
(joeuser / joeuser).
Por razones de seguridad, siempre cambiar las contraseas por defecto inmediatamente despus de crear una
nueva
organizacin. Para obtener instrucciones, consulte "Gestin de usuarios" en la pgina 29.
2.1.3
La organizacin no tiene funciones propias. Los usuarios tienen por defecto las funciones de todo el sistema
ROLE_USER y
ROLE_ADMINISTRATOR.
Hay una carpeta creada en el repositorio, bajo la carpeta Organizacin de los padres. La nueva organizacin
carpeta contiene una copia de la carpeta Plantilla Organizacin / carpeta de los padres. Para administrar la Organizacin
carpetas, seleccione Ver> Repositorio.
Las carpetas predeterminadas para

Organizaciones
Cada organizacin contiene una carpeta llamada Organizaciones especiales donde se crean suborganizaciones. El
Organizaciones carpeta siempre contiene una carpeta llamada plantilla de carpeta. Cuando se crea una nueva organizacin, la
todo el contenido de la plantilla de carpeta se copia para crear carpetas de la nueva organizacin. Los administradores pueden
aadir
carpetas y recursos en la plantilla de la carpeta, y estos tambin se copian cuando se crean organizaciones adicionales.
Las carpetas predeterminadas en la plantilla de carpeta
son:
Ad Hoc Componentes \ Temas - La ubicacin donde el Editor Ad Hoc busca temas para crear nuevas
informes.
Temp - Una carpeta slo los administradores visibles, que utiliza el servidor para almacenar archivos temporales.
Plantillas - Una carpeta para guardar las plantillas utilizadas en la generacin de informes de visitas Ad Hoc.
Temas - Una carpeta especial gestionados por el sistema para contener los archivos CSS que definen la interfaz de
usuario.
La carpeta pblica visible en cada organizacin es una carpeta compartida especial en el nivel raz. El repositorio
hace que sea accesible a todas las organizaciones, pero no est dentro de la carpeta de organizacin.
Hay una plantilla de carpeta en cada nivel de la jerarqua de la organizacin, incluyendo la raz. El sistema de administracin
puede agregar contenido a la plantilla de carpeta de nivel superior para su uso en la creacin de organizaciones de primer
nivel. Organizacin
los administradores pueden agregar contenido a su respectiva plantilla de carpeta para su uso en la creacin de
suborganizaciones.
Por ltimo, la propia plantilla de carpeta se copia en una nueva organizacin, por lo que los nuevos suborganizaciones tienen
el mismo
carpetas predeterminadas y recursos como su padre.
2.1.4
Edicin de una Organizacin

1.
2.
28

organizacin.
3.
4.
En las Organizaciones paneles de la izquierda, seleccione los padres de la organizacin. En el centro del panel
Organizaciones,
seleccione la organizacin.
En el panel Propiedades de la derecha, haga clic en Edit. Los campos en el panel Propiedades de la organizacin se
convierten en
editable.
Figura 2-4 Editando Propiedades de una Organizacin

5.
6.
2.1.5
Eliminacin de una Organizacin

1.
2.
3.
4.
2.2
Cambiar las propiedades de la organizacin, segn sea necesario. Cambiar el nombre de la organizacin cambia el
nombre de la
carpeta de organizacin, tambin, pero no hay otros datos. El ID de la organizacin no se puede cambiar; siempre tiene la
valor definido cuando se cre la organizacin. El alias y la descripcin se pueden cambiar.
Haga clic en Guardar para mantener los cambios o Cancelar para salir sin guardar.

organizacin.
En las Organizaciones paneles de la izquierda, seleccione los padres de la organizacin. En el centro del panel
Organizaciones,
seleccione la organizacin.
En el centro del panel Organizaciones, haga clic en
Eliminar.
Los administradores no pueden eliminar la organizacin a la que pertenecen. Confirmando el eliminar por completo
elimina todos los usuarios, roles y carpetas de la organizacin y todos sus suborganizaciones de JasperReports
Server.
Gestin de usuarios
Al igual que con las organizaciones, los administradores del sistema pueden gestionar todos los usuarios en todas las
organizaciones, as como crear usuarios fuera
de las organizaciones, como se describe en "Administracin delegada" en la pgina 18. Los administradores de la
organizacin pueden gestionar
slo
los usuarios
las organizaciones
que administran.
La instalacin
poren
defecto
de JasperReports
Server contiene los siguientes usuarios:
29
Tabla 2-1 Defecto Usuarios en Instalaciones JasperReports Server

Nombre de Usuario
Contrasea por defecto

(Distingue maysculas y
minsculas)
Organizacin
Descripcin
superusuario
superusuario
ninguno
Administrador de sistema por defecto (edicin comercial

solamente).
AnonymousUser
AnonymousUser
ninguno
Permite el acceso annimo; deshabilitado por

predeterminado. Si usted no permite el anonimato
acceso, este usuario se puede eliminar.
jasperadmin
jasperadmin
Organizacin
Por defecto organizacin admin en cada

organizacin.
joeuser
joeuser
Organizacin
Usuario final por defecto en todas las

organizaciones.
demostracin
demostracin
Organizacin
Incluido para su uso con datos de ejemplo.
CaliforniaUser
CaliforniaUser
Organizacin
Incluido para su uso con datos de ejemplo.
Usted debe aconsejar a los usuarios que cambien sus contraseas con regularidad. Para configurar el vencimiento
peridico de
sus contraseas, se refieren a "Configuracin de opciones de contrasea de usuario" en la pgina 150.
Algunas ediciones de servidor no incluyen todos estos usuarios; por ejemplo, superusuario no se crea en el
Edicin Comunidad del servidor, y demostracin y CaliforniaUser se crean slo cuando los datos de la muestra
est instalado.
2.2.1
1.
2.
30
Visualizacin de las propiedades

de usuario
Inicie sesin como un usuario con privilegios administrativos para la organizacin del
usuario.
Seleccione Gestionar> Usuarios o, en la pgina Administrador de inicio, haga clic
en Usuarios.
Como se muestra en la figura siguiente, la pgina Administrar usuarios muestra los usuarios en cada organizacin y
propiedades para el usuario seleccionado.
Figura 2-5 administrar usuarios Pgina

La lista de usuarios incluye a todos en la organizacin elegida y sus suborganizaciones. El mismo ID de usuario
puede aparecer ms de una vez en el panel Usuarios, lo que indica que los usuarios con la misma ID se crearon en
diferentes organizaciones. La tercera columna da el nombre de la organizacin de un usuario en particular.
3.
4.
En este ejemplo, el administrador de sistema puede ver todos los usuarios en todas las organizaciones mediante la
seleccin de la raz de la
Jerarqua de la organizacin. Siempre hay mltiples usuarios jasperadmin en una jerarqua de las organizaciones,
porque es el ID de administrador predeterminada en cada organizacin que se crea.
Para localizar a un
usuario:
Para buscar usuarios, expanda la jerarqua de la organizacin en el panel de la izquierda, y seleccione una
organizacin. Desplcese por la lista de usuarios, o elegir un suborganizacin para reducir la lista.
Para buscar un usuario especfico, seleccione la organizacin (o cualquier organizacin matriz) y entrar en una
bsqueda
cadena en el Bsqueda campo del panel Usuarios. Los resultados de la bsqueda a todos los usuarios en el
seleccionado muestran
organizacin y suborganizaciones cuyo nombre de usuario contiene la cadena de bsqueda. Si es necesario,
desplcese
a travs de los resultados o refinar su bsqueda.
Para detener la bsqueda, haga clic en
Seleccione el usuario en el panel Usuarios. Propiedades del usuario aparecen en el panel
Propiedades.
Las propiedades incluyen el nombre del usuario, ID de usuario, direccin de correo electrnico, las funciones asignadas, la
condicin de usuario, y el perfil
atributos. Status de usuario puede ser Activado o Discapacitados; los usuarios con discapacidad se muestran en texto gris
en la lista de
usuarios. Para mayor comodidad, los nombres de rol enlace a la pgina de administracin de roles para cada rol.
A medida que el administrador de una organizacin determinada, se puede ver los roles definidos en su organizacin y su
suborganizaciones, pero no la organizacin de padres (excepto para ciertos papeles de todo el sistema). Un usuario puede
tener
roles definidos y asignados de una organizacin de padres que no son visibles para el administrador de la
la organizacin del usuario. Para obtener ms informacin, consulte "Gestin de Roles" en la pgina 36.
2.2.2
Creacin de un usuario
1.
Inicie sesin como un usuario con privilegios administrativos para la organizacin a la que el usuario pertenece.
31
2.
3.
Seleccione Gestionar> Usuarios o, en la pgina Administrador de inicio, haga clic

en Usuarios.
En los paneles de Organizaciones, seleccione la organizacin a la que pertenecer el usuario, a continuacin, haga clic
en Aadir usuario.
Para los administradores de la edicin de la comunidad, simplemente haga clic en Aadir usuario.
Aparecer el cuadro de dilogo Agregar
usuario.
Figura 2-6 Adicin de un usuario

4.
Introduzca la siguiente informacin:
5.
32
Nombre de usuario - El nombre completo de la persona asociada a la cuenta de usuario. El nombre es opcional, pero
recomendada; que puede estar en cualquier formato o convencin. JasperReports Server siempre muestra la corriente
el nombre de usuario en la esquina superior derecha de la pantalla.
ID de usuario - genera automticamente a partir del nombre de usuario; puede aceptar el valor sugerido o escriba
el suyo propio. El ID de usuario se utiliza para iniciar sesin en JasperReports Server, y para los administradores para
gestionar usuarios
y recursos. ID de usuario deben ser nicos dentro de una organizacin, pero pueden existir en otras organizaciones.
E-mail - La direccin de correo electrnico de la persona. El correo electrnico es opcional, pero la direccin debe
estar en una vlida
formato.
Contrasea y confirmacin - Introduzca la misma contrasea en ambos campos.
Usuario est habilitada - Seleccione la casilla para habilitar al usuario de inmediato.
Los usuarios que no estn habilitados no pueden iniciar sesin en. Si implementa permisos basados en roles, es
posible que desee
retrasar permitiendo al usuario hasta que asigne ms roles. Para obtener ms informacin sobre las funciones,
consulte "Gestin
"en
la pgina
36. a <organizacin> (Aadir Usuario para los usuarios de edicin de la comunidad)
HagaRoles
clic en
Aadir
usuario
para crear el usuario.
El nuevo usuario aparecer en el panel Usuarios, a menos que ha introducido un trmino de bsqueda que excluye. Si
quieres
asignar funciones al usuario, haga clic en Editar en el panel Propiedades del nuevo usuario, como se muestra en la
siguiente
seccin.
2.2.3
Edicin de un usuario
Una forma de asignar funciones es agregar roles disponibles para un usuario determinado. Alternativamente, cuando se edita
papeles, usted puede
asignar cualquier nmero de usuarios a una funcin determinada.
1. Inicie sesin como un usuario con privilegios administrativos para la organizacin del
usuario.
2. Haga clic en Gestionar> Usuarios o, en la pgina Administrador de inicio, haga clic en Usuarios.
3. En el panel organizaciones, seleccionar la organizacin del usuario. (Los usuarios comerciales solamente. Usuarios de la
Comunidad pase a la
paso 4)
4.
El panel de usuarios se actualiza para mostrar los usuarios en la organizacin seleccionada, que incluye a todos
los nios
organizaciones.
En el panel Usuarios, seleccione el usuario.
La informacin de cuenta de usuario seleccionado se muestra en el panel Propiedades.
5.
En el panel Propiedades, haga clic en Edit.
Figura 7.2 Edicin de las propiedades de un usuario

6.
Modificar el nombre de usuario, direccin de correo electrnico, la contrasea y el

estado de habilitacin, segn sea necesario.
No puede editar el ID de usuario; siempre tiene el valor definido cuando se crea el usuario originalmente.
7.
Para asignar o quitar las funciones del usuario, seleccione los roles, y haga clic en los botones de flecha entre los Roles
Disponible y Roles listas Asignado.
33
8.
9.
2.2.4
La lista de funciones disponibles incluyen ningn papel en las organizaciones del administrador actual, as como el
papeles especiales de todo el sistema. Para obtener ms informacin sobre cmo crear y agregar funciones, consulte
"Gestin de Roles" en la
pgina 36.
Haga clic en Guardar para mantener los cambios o Cancelar para salir de la edicin sin
guardar.
En el panel Propiedades, haga clic en Entrar como usuario para probar los permisos del usuario, como se explica en
"Pruebas de usuarios
Permisos "en la pgina 62.
Inicio de sesin como otro usuario tambin es necesario cuando usted est manteniendo los recursos que utilizan
absoluta
referencias en el repositorio. Para obtener ms informacin, consulte "Recursos de su anuncio en el repositorio" en la
pgina 56.
Edicin de atributos del perfil

Atributos del perfil son pares nombre-valor asociados a una cuenta de usuario. Pueden proporcionar informacin adicional
sobre el usuario, y pueden tambin ser usados para restringir el acceso a datos a travs de los archivos de seguridad de
dominio y OLAP
esquemas. Desde la versin 5.0, JasperReports Server proporciona una interfaz de usuario para agregar, editar y eliminar el
perfil
atributos de cuentas de usuario. Jaspersoft recomienda el uso de esta interfaz en lugar de acceder a la privada
base de datos de repositorio, como se requera anteriormente.
Para agregar, editar o eliminar atributos del perfil:
1. Inicie sesin como un usuario con privilegios administrativos para la organizacin del
usuario.
3. En el panel organizaciones, seleccionar la organizacin del usuario. (Los usuarios comerciales solamente. Usuarios de la
Comunidad pase a la
paso 4)
4.
5.
34
El panel de usuarios se actualiza para mostrar los usuarios en la organizacin seleccionada, que incluye a todos
los nios
organizaciones.
En el panel Usuarios, seleccione el usuario. La informacin de cuenta de usuario elegido se muestra en las Propiedades
panel.
En el panel Propiedades, haga clic en Editar y seleccione el Atributos pestaa en la parte superior del
panel.
Figura 8.2 Edicin de los atributos de un usuario

6.
Para crear un nuevo atributo, escriba un nombre de atributo y un valor de atributo, haga clic en Aadir.
7.
8.
Los atributos pueden tener mltiples valores especificados como una lista separada por comas en el campo de valor. No se
puede agregar
dos atributos con el mismo nombre.
Para quitar un atributo existente, haga clic en Retire en la fila correspondiente.
Para editar un atributo, retrela y vuelva a crearla con el valor deseado.
9.
Haga clic en Guardar. Los nuevos atributos aparecen en una tabla en el panel Propiedades
del usuario.
Figura 2-9 Visualizacin de los atributos de un usuario
35
2.2.5
Activacin y desactivacin de usuarios en

bloque
Los administradores necesitan a veces para evitar que los usuarios inicien sesin en desactivando las cuentas de usuario. Por
ejemplo,
cuando se realizan cambios en la configuracin, es posible que desee bloquear todos los usuarios hasta que se acaban los
cambios. Granel
operaciones permiten a los administradores seleccionar cualquier nmero de usuarios, y superusuario puede seleccionar todos los
usuarios
el servidor,
excepto
1. Inicieensesin
como un
usuario con privilegios administrativos para la organizacin de
s mismo.
usuarios.
3. En el panel de Organizaciones, seleccione la organizacin de usuarios; para habilitar o deshabilitar los
usuarios en diferentes
organizaciones, seleccionar la organizacin comn de los padres.
4. En la lista de usuarios, seleccione todos los usuarios activar o desactivar. Utilice Control-clic y Mays y hacer clic para
hacer
selecciones mltiples. Si la lista de usuarios es demasiado largo, introduzca un trmino de bsqueda para encontrar
usuarios y activar o desactivar
ellos individualmente.
clic en Habilitar o Desactivar en la barra de
5. Haga
men.
2.2.6
Borrado de uno o ms usuarios

1.
2.
3.
4.
5.
2.3
Inicie sesin como un usuario con privilegios administrativos para la organizacin del
usuario.
Haga clic en Gestionar> Usuarios o, en la pgina Administrador de inicio, haga clic en Usuarios.
En el panel organizaciones, seleccionar la organizacin del usuario; para eliminar varios usuarios en diferentes
organizaciones,
seleccione la organizacin comn de los padres.
En la lista de usuarios, seleccione el usuario que desea eliminar. Utilice Control-clic y Mays y hacer clic para seleccionar
varias opciones. Si
la lista de usuarios es demasiado largo, introduzca un trmino de bsqueda para buscar y seleccionar el usuario.
En la barra de herramientas del panel Usuarios, haga clic en Eliminar y confirmar la
accin.
Administracin de
funciones
Roles definen conjuntos de usuarios que tienen concedido permisos similares. Los administradores crean papeles, ellos
asignado a
los usuarios, y establecer permisos en el repositorio (vase "Permisos" en la pgina 57). De forma predeterminada,
JasperReports Servidor
incluye las siguientes funciones; algunos son necesarios para el funcionamiento del sistema, algunos se incluyen como parte
de la muestra
Tabla
datos: 2-2 Funciones predeterminadas en Instalaciones JasperReports Server
36
Papel
Descripcin
ROLE_SUPERUSER
Ediciones comerciales solamente. Esta funcin determina los privilegios de administrador del
sistema, como
se explica en "Administracin delegada" en la pgina 18. Es un nivel de sistema
papel, sin embargo, el administrador del sistema puede asignar a los administradores de la
organizacin en
implementaciones de una sola organizacin.
Nunca elimine esta funcin, es necesario para la correcta administracin del servidor.
Papel
Descripcin
ROLE_ADMINISTRATOR
Esta funcin determina los privilegios de administrador de organizacin, como se explica en

"Administracin delegada" en la pgina 18. JasperReports Servidor
asigna automticamente esta funcin al usuario jasperadmin predeterminada en cada nueva
organizacin. Se trata de un papel a nivel de sistema especial que es visible en todos los
organizacin y que la organizacin los administradores pueden asignar a otros usuarios.
Nunca elimine esta funcin, es necesario para la correcta administracin del servidor.
ROLE_USER
Cada usuario que se registra en JasperReports Server debe tener esta funcin. El
servidor asigna automticamente esta funcin a cada usuario que se crea, y es
necesario iniciar sesin. Es un papel a nivel de sistema especial que es visible en todos los
organizacin.
Nunca elimine esta funcin, es necesario para crear usuarios y les permite iniciar sesin.
ROLE_ANONYMOUS
Cuando el acceso annimo est habilitado, JasperReports servidor automticamente

asigna esta funcin a cualquier agente que accede al servidor sin iniciar sesin. Es un
papel a nivel de sistema especial que es visible en todas las organizaciones. Esta funcin es
tambin asignado al usuario annimo predeterminada. Por defecto, el anonimato
el acceso est desactivado y no se utiliza esta funcin. Es una funcin del sistema que
incluso el
administrador de sistema no se puede eliminar.
ROLE_PORTLET
JasperReports Server asigna esta funcin a los usuarios que se crean

automticamente cuando un portal como Liferay solicita autenticacin para un
conexin. Si el nombre de usuario especificado no existe en el servidor, es
creado, asignado la contrasea del usuario en el portal, y se asigna la
ROLE_PORTLET y ROLE_USER roles. Si usted no utiliza un servidor de portal,
esta funcin se puede eliminar.
ROLE_DEMO
Esta funcin permite el acceso a la demo Principal Supermart, informes, y si

implementar Jaspersoft OLAP, vistas OLAP. Este rol se asigna a la
usuario de demostracin en la organizacin por omisin. Estos objetos estn disponibles slo
si
instalar los datos de ejemplo al instalar JasperReports Server. Es
un papel a nivel de sistema especial que es visible en cada organizacin
Cuando ya no necesita los datos de la muestra, esta funcin se puede eliminar.
ROLE_SUPERMART_
MANAGER
Esta funcin se utiliza para asignar los permisos relativos a los datos de la muestra. Es un
papel a nivel de sistema especial que es visible en todas las organizaciones. Demuestra
caractersticas de seguridad de datos disponibles en Jaspersoft OLAP. Consulte la Jaspersoft
Gua OLAP ltimo para obtener ms informacin.
Cuando ya no necesita los datos de la muestra, esta funcin se puede eliminar.
ROLE_ETL_ADMIN
Esta funcin ya no gobierna ningn permiso JasperReports Server o

funcionalidad, a menos que su servidor se integra con Talend Integration Suite
Enterprise Edition (EE TIS). De lo contrario, no aparece en el servidor.
A excepcin de las cinco funciones especiales a nivel de sistema visibles en todas las organizaciones, los roles se definen
dentro
organizaciones. El mismo papel ID puede definirse en organizaciones separadas, siempre que es nica dentro de cada
organizacin. Los administradores pueden gestionar todos los papeles en sus organizaciones y cualquier suborganizacin,
pero nunca pueden
ver roles en una organizacin de padres o hermanos. JasperReports Server aplica este esquema para asegurar que
organizaciones son seguras y slo papeles vlidos se asignan a los usuarios.
37
Es posible que un administrador asignar un rol a un usuario en un suborganizacin, donde el papel se define en un
organizacin matriz del usuario. El administrador de la organizacin del usuario no puede ver el papel en la gestin de la
usuario, pero el administrador de la organizacin de la funcin puede, y los permisos asociados a la funcin son
adecuadamente
forzada.
2.3.1
1.
2.
Visualizacin de las propiedades

de rol
Inicie sesin como un usuario con privilegios administrativos para la organizacin de la funcin. Usuarios de la
Comunidad inicie la sesin como cualquier
usuario con privilegios administrativos.
Seleccione Gestionar> Funciones o, en la pgina Administrador de inicio, haga clic
en Roles.
Como se muestra en la figura siguiente, la pgina Administrar funciones muestra las funciones de cada organizacin
y
propiedades para cada papel.
Figura 2-10 Administrar funciones Pgina
3.
4.
38
La lista de funciones incluye todas las funciones en la organizacin elegida y sus suborganizaciones. La lista de funciones
tambin
incluye las funciones de nivel de sistema de cinco por defecto. El mismo nombre de funcin puede aparecer ms de una
vez, lo que indica que
papeles con el mismo nombre se crearon en diferentes organizaciones. La segunda columna (en blanco en esta figura)
da el nombre de la organizacin de un papel particular.
En este ejemplo, el administrador de sistema puede ver todos los papeles en todas las organizaciones mediante la
seleccin de la raz de la
Jerarqua de la organizacin.
Para seleccionar una funcin, haga clic en su organizacin en el panel de Organizaciones. (usuarios comerciales solamente.
usuarios de la Comunidad
saltar al paso 4)
Se muestra el panel Funciones.
Haga clic en la funcin en el panel
Funciones.
Para filtrar la lista de roles, introduzca una cadena de bsqueda en el Bsqueda campo del panel Funciones. Los
resultados de la bsqueda
mostrar todos los papeles en la organizacin y suborganizaciones seleccionado cuyo nombre contiene la bsqueda
cadena. Si es necesario, desplcese por la lista nueva o refinar su bsqueda.
5.
Para detener la bsqueda, haga clic en

Seleccione la funcin en el panel Funciones. Propiedades de la funcin aparecen en el panel
Propiedades.
El panel Propiedades muestra el nombre de la funcin, la organizacin donde se define, y la lista de usuarios
a quien se le ha asignado el papel. La lista de usuarios muestra slo sus ID de usuario, pero se cierne sobre un ID
muestra un tooltip con el nombre completo y la organizacin, como se muestra en Figura 2-10.
Al ver las propiedades de los papeles especiales a nivel de sistema, slo ver los usuarios con este rol en
su organizacin o cualquier suborganizacin. Un administrador organizacin nunca puede ver a los usuarios fuera de su
organizacin o sus suborganizaciones.
2.3.2
Creacin de un rol
1.
Inicie sesin como un usuario con privilegios administrativos para la organizacin en la que se utilizar el papel.
2.
3.
Seleccione Gestionar> Funciones o, en la pgina Administrador de inicio, haga clic en Roles.

En los paneles de Organizaciones, seleccione la organizacin a la que el papel va a pertenecer. (solo los usuarios
comerciales.
Usuarios de la Comunidad vaya al paso 4)
Haga clic en Agregar rol.
4.
Aparecer el cuadro de dilogo Agregar

funcin.
Figura 2-11 Adicin de un Papel

5.
6.
2.3.3
Introduzca el nombre de la funcin. Roles no tienen otras propiedades o la

configuracin.
Haga clic en Agregar rol a <organizacin> (Aadir Papel para los usuarios de edicin de la comunidad) para
crear el papel.
La nueva funcin aparece en el panel Funciones, a menos que ha introducido un trmino de bsqueda que excluye. Si
quieres
asignar usuarios a la funcin, haga clic en Editar en el panel Propiedades del nuevo papel, como se muestra en el
siguiente
seccin.
Asignacin de usuarios a un rol

La interfaz de gestin de funciones permite asignar varios usuarios a un rol. Para asignar varias funciones a un
solo usuario, editar las propiedades del usuario con el procedimiento en "Edicin de un usuario" en la pgina 33.
1.
Inicie sesin como un usuario con privilegios administrativos para la organizacin en la que se define el papel.
2.
3.

En los paneles de Organizaciones, seleccione la organizacin de la funcin. (Los usuarios comerciales solamente. Usuarios
de la Comunidad pase a la
paso 4)
39
4.
Seleccione la funcin en el panel Funciones.

A menos que usted est en el sistema como administrador del sistema, no se puede editar o eliminar el nivel de sistema
de cinco especiales
roles.
5.
En el panel Propiedades, haga clic en Edit.

Las propiedades del papel se pueden editar. Puede cambiar el nombre de la funcin y los usuarios asignados a
la misma.
Figura 2-12 Edicin de los miembros de una funcin

6.
Introduzca un nombre diferente para cambiar el nombre de la funcin en todo el

servidor.
Permisos en el repositorio que utilizan el nombre de la funcin se actualizan automticamente. Sin embargo, los nombres de
rol en
archivos de seguridad para dominios y OLAP son no actualizado con el nuevo nombre de la funcin y puede causar una
seguridad
riesgo. Si utiliza archivos de seguridad para dominios o OLAP, no cambie los nombres de rol sin verificar los archivos como
as. Para obtener ms informacin, consulte la Gua del usuario de JasperReports Server.
7.
8.
2.3.4
Para asignar o quitar usuarios de la funcin, seleccione los usuarios y haga clic en los botones de flecha entre los
usuarios
Disponible y Usuarios listas Asignado.
Haga clic en Guardar para mantener los cambios o Cancelar para salir sin guardar.
Eliminacin de una o varias funciones

1.
Inicie sesin como un usuario con privilegios administrativos para la organizacin en la que se define el papel.
2.
3.

En los paneles de Organizaciones, seleccione la organizacin de la funcin. (Los usuarios comerciales solamente. Usuarios
de la Comunidad pase a la
paso 4)
4.
40
Seleccione la funcin en el panel Funciones. Utilice Control-clic y Mays y hacer clic para seleccionar varias
opciones.
A menos que usted est en el sistema como administrador del sistema, no se puede editar o eliminar el nivel de sistema
de cinco especiales
roles.
5.
En la barra de herramientas del panel de funciones, haga clic Eliminar y confirmar la

accin.
41
42
CAPTULO 3 ADMINISTRACIN DE
GUARDAMUEBLES
JasperReports Server proporciona un entorno potente y flexible para implementar y ejecutar JasperReports.
El repositorio almacena todos los recursos que se utilizan para ejecutar y crear informes, incluidas las definiciones de origen de
datos, JRXML
archivos, tipos de datos y los archivos auxiliares, como imgenes. Los administradores crean las carpetas y los recursos para
que los usuarios pueden
crear, ejecutar y guardar los informes que necesitan. Para los administradores que deseen personalizar la interfaz de usuario, la
repositorio tambin contiene los archivos CSS y de imagen que definen un tema.
El repositorio est estructurada como una jerarqua de carpetas que se basa en la jerarqua de las organizaciones. El
Interfaz web del servidor JasperReports permite examinar los recursos del repositorio, gestionar su estructura de carpetas,
y asegurar su contenido. Este captulo trata de las tareas bsicas de administracin del repositorio, incluyendo:
Creacin de carpetas y organizar los objetos del repositorio.

La gestin de las referencias a las fuentes de datos, imgenes, fuentes y otros recursos de los que dependen
los informes.
El control del acceso a los recursos en el repositorio a travs de roles y permisos a nivel de objeto.
Ms informacin sobre el repositorio se cubre en las siguientes secciones:
"Descripcin del repositorio" en la pgina 14

"Otros recursos en el repositorio" en la pgina 91
"Temas" en la pgina 115
Tambin puede acceder al repositorio mediante programacin utilizando los servicios web y APIs. Para obtener ms
informacin
sobre estas funciones, consulte la Gua de Servicios Web JasperReports Servidor y para la JasperReports Servidor
ltima gua, respectivamente.
Tipos de recursos
Estructura JasperReport
Gestin de carpetas y Recursos
Varias organizaciones en el Repositorio
Permisos
43
3.1
Tipos de recursos
Recursos en el repositorio tienen un tipo que determina cmo los usuarios pueden interactuar con l. Los diversos recursos
tipos se basan en diversos informes y elementos que informan los usuarios y administradores almacenan en el repositorio.
Hay dos tipos fundamentales de recursos: los que crea el usuario final, y los que el administrador
debe crear. Los usuarios finales crean los siguientes recursos. Procedimientos para los usuarios finales crear estos recursos
son
descrito en el JasperReports Gua del usuario del servidor:
Tabla 3-1 Recursos Creado por Usuarios Finales
Tipo de recurso
Descripcin
Ad Hoc vista
Edicin Professional. Creado de forma interactiva en el Editor Ad Hoc arrastrando

y colocar columnas de datos en una tabla, un grfico o tabla de referencias cruzadas. Los usuarios
pueden entonces
explorar sus datos mediante la aplicacin de filtros y la realizacin de operaciones de pivote. Un
Ad Hoc
punto de vista tambin se puede guardar como un informe interactivo y compartir con otros
usuarios.
Edicin Professional. Una coleccin de informes, controles de entrada, grficos, etiquetas,
y contenido de la web muestra junto. Los usuarios crean cuadros de mando de forma interactiva en
el
Diseador de paneles y guardarlos en el repositorio.
Dashboard
Recurso de contenido
Informe de salida de cualquier formato, ya sea que se ejecute un informe en el fondo o desde
programar un informe. Un recurso de contenido es un archivo simple que el repositorio permite
los usuarios ver o descargar.
JasperReport o simplemente
informe
Un tipo complejo que combina un archivo JRXML, una fuente de datos, y opcional
componentes como controles de entrada para definir un informe que los usuarios pueden ejecutar en
el
servidor. Dependiendo del escenario de uso, los usuarios y los administradores crean
JasperReports en el servidor. Para obtener ms informacin, consulte "Estructura JasperReport"
en la pgina 45. Opcionalmente, los informes tambin pueden almacenar una instantnea de los
datos del informe a
mejorar el rendimiento cuando muchos usuarios acceden a los mismos informes.
Versin del
Edicin Professional. Informes con controles de entrada le permiten guardar

combinaciones de datos de entrada de modo que usted puede ejecutar una versin personalizada del
informe
directamente. En el repositorio, versiones de informe siempre se enumeran en el informe original.
Los otros tipos de recursos son creados y gestionados en el repositorio por los administradores. La siguiente
recursos en general, apoyan la creacin de informes:
Tabla 3-2 Recursos Creado por administradores
44
Tipo de recurso
Descripcin
Fuente de datos
Una conexin que apunte a una base de datos u otros datos de la tienda. Las fuentes de datos
definen
donde los datos se almacenan para ejecutar informes. Hay varios tipos de fuentes de datos,
basado en el tipo de conexin o ubicacin de los datos: JDBC, JNDI, y los datos de frijol
fuentes. Para obtener ms informacin, consulte "Fuentes de datos" en la pgina 65.
Tipo de datos
Un tipo bsico que define el formato para los valores de entrada, por ejemplo, texto, nmero o
fecha. Un tipo de datos tambin puede especificar un rango vlido para el valor de entrada.
Tipo de recurso
Descripcin
Dominio
Una capa de metadatos que selecciona, se une, y filtra las tablas y los campos de sus datos y
le permite darles etiquetas fciles de usar. Un dominio puede ser la base de un Grupo Especial
informe. Dominios tambin apoyan la seguridad a nivel de fila y la localizacin de las etiquetas.
Dominios
se documentan ms en el Gua del usuario de JasperReports Server.
Archivo
Un recurso que almacena un archivo en el repositorio. "Archivo Tipos de recursos" en la pgina 110
da la lista de formatos de archivo y su propsito.
Control de entrada
Un tipo complejo que especifica qu valores usuarios pueden ingresar a un informe y cmo la
campo de entrada aparece cuando se ejecuta el informe, por ejemplo, botones de radio o cheque
cajas. Los controles de entrada dependen de los tipos de datos o listas de valores para especificar el
formato de
la entrada.
Lista de valores
Un tipo bsico que define una lista de etiquetas arbitrarias de entrada. Cada etiqueta se asocia
con un valor que puede corresponder a los datos. Por ejemplo, la lista de nombres de los meses
en los datos de la muestra asocia el nombre de cada mes con los valores de 1 a 12.
Consulta
Una cadena de consulta de base de datos, por ejemplo, en SQL. El JRXML no necesariamente
incluir la consulta, en cuyo caso, debe definir un recurso de consulta para su uso en la
JasperReport.
Los administradores tambin pueden gestionar los recursos OLAP en el repositorio, si su licencia es compatible con
Jaspersoft OLAP.
Para obtener ms informacin acerca de OLAP y los recursos de Mondrian, consulte la Gua del usuario de Jaspersoft OLAP.
Tabla 3-3 Recursos OLAP creados por los administradores
3.2
Tipo de recurso
Descripcin
XML Mondrian / A Fuente
Una definicin de origen XMLA en el servidor de un XML en el cliente remoto / Una conexin.
OLAP Client Connection
Define cmo recuperar datos para una vista OLAP. Una conexin de cliente OLAP es o bien
una conexin directa de Java (conexin Mondrian) o una conexin API basada en XML
(XML / A la conexin).
OLAP Vista
Si implementa Jaspersoft OLAP, una vista de datos multidimensional que se basa en

una conexin de cliente OLAP y una consulta MDX. Como JasperReports, que son
colecciones de recursos individuales que definen la forma de acceder y presentar los datos.
Estructura JasperReport
El recurso en el repositorio que agrega toda la informacin necesaria para que un informe se denomina JasperReport. A
JasperReport se basa en un archivo de JRXML que se ajusta a la biblioteca de cdigo abierto JasperReports que el servidor
utiliza para rendir informes.
A JasperReport es un recurso complejo que se compone de otros recursos:
Un archivo JRXML que define el informe, llamado el JRXML principal.

Una fuente de datos que suministra los datos para el informe.
Una consulta si no se especifica en el JRXML principal.
45
La consulta puede especificar su propia fuente de datos, que anula la fuente de datos definida en el informe.
Los controles de entrada para los parmetros que los usuarios pueden entrar antes de ejecutar el informe. Los controles de
entrada son
compuesto de cualquiera de:
Una definicin de tipo de datos.
Una lista de valores.
Todos los recursos de archivos adicionales, como imgenes, fuentes y paquetes de recursos referenciados por la plantilla
del informe.
Si el informe contiene subinformes, los archivos JRXML para los subinformes.
La coleccin de todos los recursos que se hace referencia en un JasperReport a veces se llama una unidad de informe. Fin
los usuarios suelen ver e interactuar con un JasperReport como un recurso nico en el repositorio, pero los creadores informe
debe
definir todos los recursos del componente.
3.2.1
Hacer referencia a los recursos en el Repositorio

Hay varias maneras de definir y referenciar todos los recursos en un JasperReport.
Recursos en entornos sin JasperReports Server, los informes se almacenan en el sistema de archivos, y compartieron son
normalmente se almacena en una unidad de red accesible a todos los desarrolladores y usuarios. Esta solucin es a veces poco
prctico,
ya que no siempre se puede aadir estos recursos a la ruta de clases, y el uso de rutas absolutas tiene sus propias limitaciones.
Adems, el almacenamiento de los recursos en el sistema de archivos desalienta su reutilizacin: los desarrolladores pueden
invertir tiempo en
la creacin de nuevas versiones de los recursos que ya existen, porque no saben acerca de ellos.
Mediante el almacenamiento de recursos en el repositorio, JasperReports Server facilita y confiable para compartir recursos tales
como
imgenes, plantillas de estilo y subinformes entre los informes. Los imitadores del repositorio una carpeta y archivo de la
estructura, de modo que
referencias
a archivos
externos se pueden
manejaracomo
referencias
a recursos
externos
el repositorio.
En las versiones
de JasperReports
Server anterior
la 5.5,
el JasperReports
utiliza
la repo:en
sintaxis.
A partir de 5,5, esto no es
ya las rutas de archivos necesarios y ordinarios se reconocen y se gestionen en el repositorio.
Cuando subes tu JRXML al repositorio, sus referencias de archivos se convierten en referencias de repositorio vlido, y
usted puede almacenar todos sus recursos en lugares bien conocidos en el repositorio. Esto simplifica el proceso de
subir sus informes, porque usted no tiene que cargar los recursos cada vez. Adems, puede administrar estos
recursos, ya sea a travs de iReport, a travs de la interfaz de usuario JasperReports Server, oa travs de las API del servidor.
Por ejemplo, al actualizar un recurso de imagen logo, todos los informes que hacen referencia al recurso tambin muestran la
nueva
logo.
3.2.2
Referencias absolutas
Las referencias absolutas son URIs en la JRXML del informe que especifique la ruta al repositorio de un recurso. La ruta puede
se refieren al sistema de archivos donde se cre el JRXML, pero cuando subido al servidor, se refiere a las carpetas del
repositorio.
La ruta debe comenzar con uno de los siguientes:
/para representar a la raz del repositorio en la edicin de la comunidad, o la organizacin del usuario actual en
ediciones comerciales. Por ejemplo, / Images / logo es un recurso en la carpeta / images.
../ para representar a la carpeta en la que se carga el JasperReport. Por ejemplo, ../myLogo es un recurso en el
misma carpeta que el JasperReport.

Al igual que con una ruta del sistema de archivos, la ruta del repositorio se compone del identificador de recursos de cada
carpeta principal, que termina
con el ID del recurso. iReport con el servidor JasperReports plug-in es compatible con referencias absolutas de
que le permite arrastrar los recursos de la vista de rbol del repositorio en el rea de diseo.
46
Si implementa organizaciones, la ruta absoluta es relativa la organizacin del usuario, como se describe en
"Mltiples Organizaciones en el repositorio" en la pgina 55.
Al subir la JRXML con referencias absolutas de recursos como parte de un JasperReport en el servidor, slo
deber asegurarse de que existe el recurso con la ruta dada en el repositorio antes de ejecutar el informe. Cuando el
informe se ejecuta, el servidor localiza el recurso en el repositorio y lo utiliza para representar el informe.
Debido a que los recursos de archivos tales como imgenes, fuentes y JAR son los nicos recursos con los cuales puede crear
referencias
directamente en JRXML, que son los nicos recursos de los que puede crear referencias absolutas.
Una desventaja de las referencias absolutas es que JasperReports Server no mantener la dependencia entre
la JRXML y la referencia absoluta. Al subir la JRXML, no hay ninguna advertencia si el recurso hace
no existe, y el servidor permite eliminar el recurso del repositorio aunque est todava se hace referencia.
Si el recurso no est disponible, se ejecuta el informe falla con un error.
3.2.3
Recursos Locales y referencias externas

JasperReports Server proporciona ms flexibilidad y potencia al utilizar referencias indirectas en lugar de absoluta
referencias. Referencias indirectas son nombres de marcador de posicin que deben estar vinculados manualmente al recurso
cuando
subir la JasperReport. La sintaxis de una referencia indirecta slo contiene un nombre de marcador de posicin para el
recurso, por ejemplo:
logoImage
Cuando se carga un JRXML con esta referencia, el servidor le pide que proporcione el recurso. Usted tiene dos
opciones:
La creacin de un nuevo recurso, en este caso por subir una imagen, que se convierte en parte de la JasperReport. Esto es
llamado un recurso local. No se puede acceder a este recurso desde otro lugar en el repositorio, slo existe
dentro de la JasperReport.
Seleccin de un recurso desde el repositorio, llamado una referencia externa, ya que es externo a la
JasperReport. Esto permite que cualquier nmero de informes que enlazan con el mismo recurso, sin embargo, permitir
que dicho recurso sea
gestin independiente de ellos.
Si bien las referencias indirectas requieren un poco ms de trabajo que las referencias absolutas en el JRXML, el servidor
gestiona
la dependencia. Existen recursos locales como parte de JasperReport, y las referencias externas no se pueden eliminar hasta
que ya no son referenciados.
En los casos en que no quiere hacer referencia a los recursos existentes, los recursos locales permiten que los informes sean
altamente
personalizado y autnomo. Un recurso local que se define dentro de la JasperReport tiene todo lo mismo
propiedades como recurso repositorio, pero no es accesible en el repositorio. Los usuarios deben editar el JasperReport a
acceso a cualquier recurso que define localmente.
Los usuarios que no sean administradores pueden crear JasperReports pero no otros recursos en el repositorio.
Por lo tanto, si un administrador no les proporcionan los recursos para las referencias externas, su nica opcin es
para crear los recursos locales para todas las dependencias dentro de la JasperReport.
Las referencias indirectas se utilizan implcitamente en otros casos cuando se define una JasperReport:
El propio JRXML principal es o bien un recurso local creado por la carga de un archivo o una referencia externa a un
existente recurso de archivo JRXML en el repositorio.
Cada informe debe tener un origen de datos y JasperReports Server le da la opcin de crear un nuevo local de
de recursos o de utilizar una referencia externa a un origen de datos existente.
47
Cada informe tambin debe tener una consulta que coincide con su origen de datos. Usted puede optar por crear una
consulta local
recursos o utilizar una referencia externa a una consulta existente.
Los parmetros en un informe se manejan de manera implcita como una referencia indirecta a un control de entrada. Por
cada parmetro
nombrado en su JRXML principal, debe definir un control de entrada, ya sea como un recurso local o externo
referencia.
Cada nivel de referencia indirecta es independiente de la otra. Por ejemplo, cuando se crea un JasperReport, se
puede optar por crear un control de entrada como un recurso local, pero que el control de entrada puede tener una referencia
externa
a su tipo de datos. El servidor se las arregla la dependencia entre el control de entrada local y el tipo de datos
recursos en el repositorio.
Recursos locales y las referencias externas son su uso en todo el repositorio, por ejemplo al crear la entrada
controles, recursos de consulta, Dominios y recursos OLAP.
3.2.4
Las referencias en Subinformes

Un subinforme es un archivo JRXML subordinado que se incluye en un JasperReport. Al igual que con todos los otros
recursos
referencia el JRXML principal, el archivo JRXML subinforme puede especificarse como un valor absoluto, un local de
recurso o una referencia externa.
Como un archivo JRXML, un subinforme puede hacer referencia a otros recursos propios. Sin embargo, el subinforme se
ejecuta como parte de
la JRXML principal, y cualquier referencia en el subinforme se interpretan en relacin con el recurso JasperReport
(Representado por el JRXML principal) y el contexto en el que el JasperReport se est ejecutando.
3.2.5
Datos Snapshots
A partir de JasperReports Servidor 4.7, los recursos de informes tambin pueden almacenar una instantnea de los datos del
informe. Una instantnea es una
copia de los datos que la consulta devuelve cuando se actualicen los datos. Esta instantnea de datos es una estructura interna
que
no es visible ni accesible desde el repositorio. Sin embargo, cuando instantneas de datos estn habilitadas, una instantnea de
datos es
almacenada en el repositorio con cada informe. Cuando los usuarios abren un informe, el visor de informes recupera y muestra
de
la instantnea.
Despus,
los usuarios
la opcin de
actualizar
los datosde
endatos,
el visor
de informes,
y si
Para
obtener ms
informacin
acerca tienen
de la interaccin
con
las instantneas
consulte
la Gua
deltienen
usuario de
permisos, el ahorro
de la
instantnea
JasperReports
Server.
Para
habilitar de datos de nuevo en el recurso informe.
instantneas, ver "Habilitacin de instantneas de datos" en la pgina 190.
3.3
Gestin de carpetas y Recursos

Los administradores y los usuarios con los permisos adecuados pueden crear, modificar, mover y eliminar carpetas y recursos
en el repositorio. Los roles y permisos del usuario especficas determinan las acciones que estn disponibles. Para el
definicin de los permisos de las carpetas y recursos, consulte "Permisos" en la pgina 57.
Una de las responsabilidades de un administrador de JasperReports Server es la creacin de un ambiente para que los
usuarios creen y
guardar cuadros de mando, Ad Hoc vistas e informes. Eso generalmente significa la creacin de una estructura de carpetas
donde los usuarios tienen
permiso de escritura. Los usuarios con permisos de escritura tambin pueden crear sus propias subcarpetas para almacenar
sus informes y
Otro
escenario
que los administradores pueden configurar los recursos implica que los usuarios creen JasperReports. Cuando
cuadros
de mando.
dado permiso de escritura, los usuarios tienen la posibilidad de cargar archivos JRXML y definir los recursos dentro de la
JasperReport. Pero por razones de seguridad, slo el administrador puede crear fuentes de datos compartidas y otros recursos
en el repositorio. Si muchos usuarios estn cargando archivos JRXML como JasperReports, el administrador debe crear
48
fuentes y recursos de datos compartidos antes de tiempo en el repositorio. Esto tambin tiene la ventaja de simplificar
mantenimiento, por ejemplo, la actualizacin de un archivo de logotipo compartido en lugar de tener muchos usuarios
editar sus informes.
3.3.1
ID de los recursos
Todos los recursos, incluyendo carpetas, disponen de una identificacin, un nombre y una
descripcin opcional:
La ID se utiliza internamente para hacer referencia a los recursos. Al igual que con los archivos, el ID debe ser nico
dentro de su carpeta, pero
pueden existir en varias carpetas.
El nombre es una etiqueta para el recurso que aparece en la interfaz de usuario del repositorio.
La descripcin opcional aparece en el repositorio y en la informacin sobre herramientas. Usted puede dar descripciones
ms largas a
recursos para ayudar a los usuarios a entender sus contenidos o finalidad.
Como en un sistema de archivos, los ID de carpetas anidadas que contienen un recurso definen la ruta de acceso al objeto.
Por ejemplo,
el camino a un informe podra ser: / informes / samples / Freight. El camino de cada recurso se muestra bajo su nombre en
El anuncio o la bsqueda resultados de repositorio.
Para ver el nombre y el ID de los recursos de un recurso, haga clic en la carpeta o el recurso en el repositorio o de bsqueda
resultados y seleccione Propiedades ... en el men contextual.
Propiedades Figura Recurso 3-1 de dilogo para un recurso grabable

Si usted tiene escribir o administrar el permiso como se muestra en la figura, tambin se puede editar el nombre y la descripcin
de
el recurso. Para algunas operaciones como la exportacin, lo que necesita la ruta del recurso, tambin llamado repositorio URI,
que
usted puede copiar de este cuadro de dilogo.
3.3.2
Creacin de carpetas
Cualquier usuario con permiso de escritura en una carpeta puede crear nuevos subcarpetas.
Para crear una carpeta:
1. Inicie sesin como un usuario que tenga permiso de escritura en la carpeta
principal.
49
2.
Seleccione Ver> Repositorio y busque la carpeta principal en el panel de carpetas del lado izquierdo.
3.
4.
Haga clic derecho en la carpeta principal y seleccione Agregar carpeta en el men

contextual.
Aparecer el cuadro de dilogo Agregar carpeta.
Figura 3-2 Cuadro de dilogo Agregar

carpeta
5.
Introduzca un nombre de carpeta y una descripcin opcional, a

continuacin, haga clic en Aadir.
Se crea la carpeta en el repositorio. El nombre aparece en la jerarqua de carpetas. La descripcin es slo
visible al ver las propiedades de la carpeta, como se muestra en Figura 3-1.
Nuevas carpetas y sus futuros contenidos heredan los permisos de sus carpetas principales. Los administradores pueden
cambiar los permisos de la nueva carpeta, como se describe en "Permisos de configuracin" en la pgina 60. Los usuarios
finales
no puede cambiar los permisos en el repositorio a menos que les ha concedido el permiso Administrar por un
administrador.
3.3.3
Adicin de recursos
Cada recurso tiene diferentes requisitos, por ejemplo, algunos se crean a partir de los archivos cargados, otros son creados por
la definicin de los valores de un asistente. Los procedimientos especficos para la adicin de cada tipo de recurso se dan como
sigue:
Recursos interactivos tales como Ad Hoc vistas y cuadros de mando se describen en la JasperReports usuario del servidor
Gua.
JasperReports se tratan en el Gua del usuario de JasperReports Server.
Dominios estn cubiertos en el Gua del usuario de JasperReports Server. Dominios slo estn disponibles en la
Edicin Comercial de JasperReports Server.

Recursos y Mondrian OLAP estn cubiertos en el Gua del usuario de Jaspersoft OLAP.
Las fuentes de datos, consultas, controles de entrada, y los recursos de archivos se explican en el captulo "Otros recursos
en
el repositorio "en la pgina 91

La mayora de los recursos se crean a travs de la opcin de men Agregar recurso en el men contextual de las carpetas en la
repositorio. En la siguiente figura, se puede ver el men completo y submen con todos los administradores de los recursos
puede crear:
50
Figura 3-3 Agregar recurso Context Menu Ampliado

Para cada recurso se crea, debe especificar un nombre y un recurso ID que se utiliza para hacer referencia al recurso
en el repositorio. Adems, cada dilogo tiene una o ms pginas para especificar los valores y controles especficos
al recurso que va a agregar.
Nuevos recursos heredan los permisos de la carpeta en la que se crean. Los administradores pueden cambiar
los permisos en el nuevo recurso, tal como se describe en la seccin "Permisos" en la pgina 57.
3.3.4
Cambiar el nombre de carpetas y Recursos

Cualquier usuario con permiso de escritura en una carpeta o recurso puede cambiar su nombre y
descripcin.
No se puede cambiar el nombre de carpeta de nivel superior de la organizacin de la manera descrita aqu. El nombre de
la carpeta de nivel superior se copia del nombre de la organizacin. Por lo tanto, para cambiar el nombre de la
carpeta, usted tiene que cambiar el nombre de la organizacin, tal como se describe en la seccin "Edicin de un
Organizacin "en la pgina 28.
Para cambiar el nombre de una carpeta o recurso:

1. Inicie sesin como un usuario que tiene permiso de escritura para la carpeta o
recurso.
2. En el repositorio, navegar o buscar el recurso. Para cambiar el nombre de carpetas, seleccione Ver> Repositorio y
busque la carpeta.
3.
Haga clic derecho en el objeto y seleccione Propiedades ... en el men contextual.

Aparecer el cuadro de dilogo
Propiedades.
51
Figura 3-4 Cuadro de dilogo Propiedades para un Informe de

Recursos
Puede cambiar la carpeta o el nombre y la descripcin de los recursos, pero no la identidad o el tipo de recurso; el ID es
permanente una vez que el recurso es creado, y el tipo se muestra aqu slo para informacin.
4.
3.3.5
Haga clic en Enviar para guardar los cambios.
Copiar y mover
La interfaz de repositorio permite a cualquier usuario con la copia de la autorizacin correspondiente o mover recursos y
carpetas.
Copiado requiere permiso de lectura en la fuente, en movimiento requiere eliminar el permiso de la fuente, y ambos
requerir permiso de escritura en la carpeta de destino.
Puede arrastrar y soltar los objetos, o puede copiar y pegar o cortar y pegar desde sus mens contextuales.
Las carpetas se deben mover de una en una, sino mltiples recursos de la misma carpeta se pueden copiar o mover
juntos.
Copiar y mover acciones no son posibles en la interfaz de bsqueda, slo en la muestra la interfaz de repositorio
la lista de carpetas. Actualmente, no es posible crear una copia de un recurso en la misma carpeta.
Los objetos movidos heredan sus permisos de la carpeta de destino en el que se encuentre; que hacen
no mantener los permisos que tenan antes de la mudanza. Si desea que los objetos tengan otros permisos,
debe configurar los permisos de nuevo despus de la mudanza (vase "Permisos" en la pgina 57).
Para copiar o mover carpetas y recursos:

1. Inicie sesin como un usuario que tiene los permisos necesarios para la carpeta o recurso.
2.
Haga clic en Ver> Repositorio, y expanda las carpetas para mostrar el objeto que desea copiar o mover.
3.
Haga clic derecho en el objeto y seleccione Copia o Cut. Si el comando Cut no aparece en el men, lo hace
no tener permiso de borrado requerida para mover el objeto.
Puede seleccionar varios recursos con Control + clic o Mays-clic, pero slo se puede seleccionar una sola carpeta
a la vez.
52
4.
Haga clic derecho en la carpeta de destino y seleccione Pega en el men contextual. Si el Pega comando no hace
aparecer en el men, que no tiene permiso de escritura all.
Como alternativa, puede arrastrar el recurso seleccionado o carpeta para moverlo de la carpeta de destino. Para realizar una
copia, debe presionar la tecla Control antes hacer clic para arrastrar. Al arrastrar los recursos, el destino
carpeta est resaltado en azul si tiene permiso para escribir all, y en color gris lo contrario. Si intenta mover
un recurso a una ubicacin en la que no tiene permiso, el servidor muestra el contenido de la meta
carpeta, pero el recurso no se mueve.
3.3.6
Recursos Edicin
Los diferentes tipos de recursos tienen diferentes formas de ser editado. Para los usuarios finales que trabajan con interactivo
recursos, la edicin incluye principalmente el Abrir en Designer accin en el men contextual de los cuadros de mando y Ad
Vistas hoc. Los procedimientos de la siguiente tabla se describen adicionalmente en la Gua del usuario de JasperReports
Server.
Tabla 3-4 Recursos que los usuarios finales pueden editar
Tipo de recurso
Cmo editar
Ad Hoc vistas
Edicin Professional. Los usuarios seleccionan Abrir en Designer y modificar la vista

interactiva. Despus de cambiar el contenido, los usuarios pueden sobrescribir la vista existente o
guardar como un nuevo punto de vista.
Los informes creados a partir de visitas Ad Hoc se guardan en el mismo formato que
JasperReports, pero los recursos que se hace referencia en la unidad de informe se generan por el
Ad Hoc editor y no debe ser modificado. Hay una excepcin: los administradores
puede crear un archivo JSP y establecerla como una vista de informe personalizado.
Dashboard
Edicin Professional. Los usuarios seleccionan Abrir en Designer y modificar la

salpicadero de forma interactiva. Despus de cambiar el contenido, los usuarios pueden
sobrescribir la
tablero existente o guardarlo como un nuevo tablero de instrumentos.
Recurso Contiene
Informe de salida es un archivo almacenado en el repositorio. Estos archivos no se pueden editar,

slo
descargado o eliminado.
JasperReport
Los usuarios seleccionan Editar y cambiar la fuente de datos, controles de entrada, o de los
recursos de archivo que
se hace referencia en la JasperReport. Los administradores tambin pueden editar JasperReports.
Para obtener ms informacin, consulte "Estructura JasperReport" en la pgina 45.
Cuando los usuarios Run un informe, ste se muestra en el visor de informes interactivos. Si los
datos
instantneas estn habilitadas, el informe se muestra con datos que antes era
devuelto por la fuente de datos. Cuando instantneas de datos no estn habilitados, el servidor
pregunta el origen de datos y ejecuta la consulta del informe. Despus de interactuar con el
columnas y los valores del informe, los usuarios pueden guardar el informe, ya sea al sobrescribir
la
original o como una copia nueva, en funcin de los permisos del usuario.
Informe Version
Edicin Professional. Los usuarios pueden seleccionar Editar para cambiar los valores
almacenados como
parmetros de entrada.
Para el resto de recursos de la siguiente tabla, la edicin es accesible slo a los administradores. Los usuarios finales, incluso
aquellos
con permiso de escritura en un recurso, no puede editar estos recursos.
53
Tabla 3-5 Recursos que slo los administradores pueden editar

Tipo de recurso
Cmo editar
Fuente de datos
Los administradores seleccionar Editar desde el men contextual de estos recursos. Edicin de stos
recursos utiliza el mismo cuadro de dilogo que se utiliz para definir el recurso cuando es primero
aadido a JasperReports Server. Los administradores pueden ver la definicin actual de un
recursos o cambiar los valores que definen a un recurso. Por ejemplo, usted podra ver
el tipo de datos de un control de entrada, cambiar una consulta, o subir un nuevo archivo en un
archivo
de recursos.
Tipo de datos
Dominio
Archivo
Control de entrada
En el caso de Dominios, usted tambin tiene acceso al Diseador de dominio se utiliza cuando
creacin del dominio. Puede agregar tablas y campos, cambiar los filtros, o cambiar el
mostrar las caractersticas de los elementos del dominio. Para obtener ms informacin acerca de
Dominios, ver la Gua del usuario de JasperReports Server.
Lista de valores
Consulta
Para todos los otros tipos de recursos, consulte el procedimiento para la creacin de ellos
en "Otros
Recursos en el repositorio "en la pgina 91.
Al editar un recurso, hay varias limitaciones:
3.3.7
Puede modificar el nombre o la descripcin del recurso, pero no su ID. Si tiene que eliminar un ID, necesita
para crear un nuevo recurso similar y eliminar la antigua.
No se puede cambiar la ubicacin del recurso. Algunos cuadros de dilogo para la edicin de un recurso incluyen la guardan
ubicacin, pero el campo es slo para informacin. Para cambiar la ubicacin del recurso, vase "Copiar y
Mover "en la pgina 52.
Para los recursos de archivo, no se puede ver el nombre del archivo que se ha subido, ni en la mayora de los casos y
descargar
ver el contenido del archivo. Su nica opcin es subir un nuevo archivo para reemplazar el viejo.
Eliminacin de carpetas y Recursos

Los usuarios con el permiso de borrar en una carpeta o recurso pueden eliminar los objetos del repositorio. A fin de que
eliminar una carpeta, el usuario debe tener tambin eliminar el permiso de todos los recursos y carpetas que la carpeta
eliminada
contiene, porque todo el contenido de la carpeta eliminada se eliminan tambin.
Las carpetas se deben eliminar de una en una, sino mltiples recursos se pueden eliminar juntos.
No se puede deshacer de una eliminacin.
El repositorio no pierde de vista que los recursos son referenciados por otros recursos. No permite borrar
recursos si estn siendo referenciados por otros recursos. Por ejemplo, un tipo de entrada que es utilizado por un informe o una
archivo de propiedades que se utiliza por un dominio no se pueden eliminar, siempre y cuando el informe o dominio todava las
referencias.
Para encontrar los recursos que hacen referencia a la que desea borrar, que hay que buscar en cada informe, vista, Ad Hoc
Tema o dominio que usted sospecha de referencia a ella. Al editar la definicin de un JasperReport o una
Dominio, usted puede ver los recursos que hace referencia. A continuacin, puede eliminar ya sea la referencia del recurso o
eliminar el recurso entero que contiene la referencia.
Para eliminar una carpeta o recurso:

1. Inicie sesin como un usuario que tenga permiso para eliminar la carpeta o recurso.
54
2.
En el repositorio, navegar o buscar el objeto que desea eliminar.
3.
Haga clic derecho en el objeto y haga clic en Eliminar en el men contextual que
aparece.
En la vista del repositorio, puede seleccionar varios recursos y haga clic en Eliminar en la barra de herramientas o en el
contexto
men. En la lista de carpetas, slo se puede eliminar carpetas individuales a la vez, a pesar de todos los contenidos de las
carpetas,
se eliminan incluyendo subcarpetas. En los resultados de bsqueda, puede seleccionar varios recursos y haga clic derecho
para
seleccione Eliminar en el men contextual.
3.4
Varias organizaciones en el Repositorio

Si implementa varias organizaciones, hay ciertas consideraciones al momento de disear la estructura del repositorio
para su implementacin.
Mltiples organizaciones slo estn disponibles en la edicin profesional de JasperReports Server.
3.4.1
Organizacin de carpetas
En el repositorio, cada organizacin tiene su propia rama, contenida en una carpeta con el nombre de la organizacin.
JasperReports servidor automticamente restringe la vista de los usuarios y el acceso a la rama del repositorio en su
carpeta de organizacin. Los administradores de la organizacin pueden crear cualquier estructura de carpetas necesaria
dentro de la organizacin.
La carpeta de la parte superior de una organizacin est contenido en una carpeta llamada Organizaciones de la organizacin
matriz. Toporganizaciones de nivel estn contenidos en una carpeta llamada Organizaciones en la raz de la jerarqua de carpetas.
Los administradores pueden ver y navegar a la carpeta de organizaciones, y si se crean las suborganizaciones, pueden
tambin ver todas las carpetas y recursos en la suborganizacin. Como administradores de la organizacin de padres, que
pueden
tambin crear carpetas y recursos en la suborganizacin.
De forma predeterminada, los usuarios de una organizacin tambin pueden ver y crear carpetas y recursos en cualquier
suborganizacin. Para evitar esto, los administradores pueden cambiar los permisos de la carpeta Organizaciones
o carpetas de organizaciones individuales.
La carpeta de Organizaciones en cada organizacin es una carpeta especial que es administrado por el servidor.
Administradores
No puede crear carpetas o recursos directamente en la carpeta de Organizaciones. El servidor crea la carpeta para cada
suborganizacin cuando el administrador crea una nueva organizacin a travs de la Administrar> Organizaciones
pgina. Los administradores pueden crear carpetas y recursos en la carpeta de plantillas de carpeta en la carpeta de las
Organizaciones;
estos recursos se copian en las nuevas organizaciones. Para obtener ms informacin, consulte "Carpetas predeterminadas
para
Organizaciones "en la pgina 28
3.4.2
Consideraciones de diseo
El diseo cuidadoso del repositorio JasperReports servidor lleva a un ambiente claro y slido para su BI
medio ambiente y el acceso, pero seguro fcil para los usuarios. Una de las decisiones ms importantes es cmo desea que sus
organizaciones
y los usuarios acceder a los recursos: el que los recursos son compartidos a travs de las organizaciones en lugar de que son
especficos
a una organizacin en particular. Esto generalmente se descompone en varios escenarios, en funcin de los recursos que
las organizaciones necesitan:
Las organizaciones tienen recursos privados - Organizaciones disponer de fuentes de datos independientes, informes, vistas
OLAP, etc
Esto sera tpico de una organizacin con los departamentos. Estos recursos privados se almacenan en cada
carpetas propias de la organizacin, y tal vez slo unos pocos recursos, como los logotipos de la compaa seran
compartidas
entre ellos.
Organizaciones compartir recursos - Los recursos se mantienen en las carpetas pblicas en el que puedan ser utilizados por
todos
organizaciones y usuarios. Es posible que las fuentes de datos comunes e informes a travs de los clientes, pero el
55
3.4.3
datos subyacente se divide por la organizacin. Seguridad a nivel de datos restringe lo que los usuarios ven cuando se
ejecuta
informes pblicos y vistas OLAP.
Compartir recursos de la Organizacin, pero tienen algunas personalizaciones - Por ejemplo, los usuarios de la
organizacin crean
informes que son privadas y se almacenan localmente, sino que acceden a los recursos de las carpetas pblicas.
Las organizaciones tienen una organizacin jerrquica - Usted puede tener una organizacin que contiene otros
organizaciones. Por defecto, la organizacin matriz puede acceder a todos los recursos de sus organizaciones de nios. Si
usted no quiere esto, debe evitar la creacin de suborganizaciones o personalizar multi-organizacin del servidor
arquitectura.
Hacer referencia a los recursos en el Repositorio

Todos los recursos del repositorio pueden ser referenciados por Universal de Recursos Identificadores (URI), que especifica el
nombre de recurso y ruta de la carpeta del recurso. Debido a la jerarqua de las organizaciones, las referencias son en relacin
al usuario acceder a ellos. JasperReports servidor transforma referencias relativas a lugares reales de recursos en
el repositorio basado en la organizacin del usuario y la carpeta principal de la organizacin. Por defecto, las ubicaciones de
carpeta
se transforman en las formas siguientes:
Para los miembros de la organizacin, las ubicaciones en / public no se transforman, pero los de la organizacin del
principal
carpeta se transforman a la ubicacin real, por ejemplo, / organizaciones / organization_1.
Por ejemplo, si un usuario en org_1 ejecuta un informe que hace referencia a / images / Mylogo recurso de imagen, la ruta
real
en el repositorio que se capta es / organizaciones / org_1 / images / Mylogo. Si el informe tambin se hace referencia a
/ Public / sharedLogo, el servidor obtiene el recurso en / pblico / sharedLogo.
Para los administradores de sistemas, en toda el repositorio no se transforman. Ellos ven el repositorio real
nombres de ruta.
Si un administrador de sistema se ejecuta el mismo informe en el ejemplo anterior, la referencia a / images / Mylogo
intenta
buscar un recurso con nombre / imagen / MyLogo, que slo funciona si hay una carpeta en la raz del repositorio
imgenes nombradas con una copia de la Mylogo. El informe no (o no se encuentra un recurso) cuando se ejecuta por el
administrador de sistema, a menos que se inicia una sesin como ese usuario a travs de la Gestionar> Usuarios pgina.
Esta transformacin permite URIs para hacer referencia a diferentes recursos en funcin de la organizacin del usuario que
acceda a ellas. Por ejemplo, un informe puede tener un logo especfico de la organizacin como una imagen. Podemos
configurar el
reportar como sigue:
Logo URI especificado en el JRXML: / images / orgLogo. Cuando se transforma para cada usuario, el acceso a un URI
ubicacin con respecto a la carpeta principal de su organizacin.
Cada organizacin que utilice este informe debe tener una carpeta llamada / imgenes que contienen un recurso de imagen
con
la orgLogo ID. Cuando un usuario en cualquier organizacin se ejecuta el informe, el servidor obtiene la especfica
organizacin
imagen y la muestra.
Hay tres excepciones a las referencias estn transformadas. En estos casos, las referencias deben ser literal:
En las unidades de informe, las referencias a las fuentes de datos, JRXMLs, o

controles de entrada.
En las vistas OLAP, las referencias a las conexiones OLAP.
En conexiones OLAP, las referencias a las fuentes o los esquemas de datos.
Tambin, debido a que estas referencias no se transforman, se debe observar lo siguiente:
56
Para las tareas de mantenimiento en las unidades de informe de una organizacin, vistas OLAP y conexiones OLAP, debe
iniciar sesin
en que esa organizacin y hacer las tareas all. No se puede administrar los recursos como superusuario u otro
administrador de la organizacin.
Los tres recursos (unidades de informes, vistas OLAP y conexiones OLAP) no pueden hacer referencia a objetos a travs
de
organizaciones o incluso en su propia organizacin matriz. No se transformar la referencia; lo hara
debe tomarse literalmente y fracasara. Por ejemplo, si la fuente de datos para una unidad de informe est en los /
dataSources
carpeta de This_Org, los usuarios de That_Org no puede acceder a ella debido a que su referencia no puede cruzar las
organizaciones.
Para probar las referencias absolutas, debe iniciar sesin como administrador de la organizacin utilizando las referencias.
Ver "Prueba de permisos de usuario" en la pgina 62.
3.4.4
Mejores Prcticas
Las mejores prcticas para los recursos en un repositorio compartido por mltiples organizaciones son las
siguientes:
El sistema administrador debe iniciar sesin como usuario de la organizacin con el fin de mantener o ejecutar recursos
de la organizacin.
Recursos con referencias absolutas a los recursos en carpetas organizacin slo funcionan para los usuarios dentro de
la
organizacin o una organizacin de padres.

Si un JRXML que accede a recursos de la organizacin con URIs debe correr a travs de las organizaciones, entonces
todos
las organizaciones deben tener carpetas idnticas, nombres de objetos y tipos de objetos que se espera para esos
recursos.
La carpeta pblica se debe utilizar para los recursos que se comparten en todas las organizaciones.
3.5
Permisos
Los permisos de las carpetas y los recursos determinan lo que los usuarios ven en el repositorio y las acciones que son
permitido realizar. En la siguiente tabla, las acciones concedidas para cada permiso incluyen todas las acciones
concedido los permisos por encima de ella, excepto por el permiso Sin acceso. Las acciones concedidas para cada permiso
estrictamente excluir todas las acciones concedidas a los permisos por debajo de ella.
Permiso
Acciones Otorgadas en carpetas del repositorio y Recursos
Sin acceso
Los usuarios no pueden ver o acceder a la carpeta o el recurso, ya sea directamente en el

repositorio o indirectamente cuando se ejecuta un informe, cuadro de mandos, o consulta
OLAP.
Slo ejecucin
Los usuarios no pueden ver la carpeta o recurso en el repositorio, pero los informes,
tablero de instrumentos, o OLAP vistas que se ejecutan pueden acceder a ellos.
Slo Lectura
Consulte la carpeta o recurso de cualquier dilogo JasperReports Servidor
Ver las propiedades de una carpeta o un recurso
Copiar una carpeta y todo su contenido legibles
Copiar recursos individualmente o en mayor
Ver (pista) un informe, cuadro de mandos, o ver OLAP
Ejecucin de un informe en el fondo
Programar un informe para ejecutarlo

ms tarde
Cut (mover) una carpeta y todo su contenido
Eliminar una carpeta y todo su contenido
Cut (Move) los recursos de forma individual o en mayor
Eliminar recursos de forma individual o en masa
Leer + Supr
57
Permiso
Acciones Otorgadas en carpetas del repositorio y Recursos
Leer + Escribir
Leer + Escribir + Supr
Guarde las opciones de informe para un

JasperReport
Eliminar opciones de informe
Copie los recursos en una carpeta con este permiso
Editar recursos
Aadir una subcarpeta
Pegar en una carpeta (copiar o cortar)
Guardar una vista nueva Ad Hoc, un informe o cuadro de mandos en una

carpeta
Guarde el resultado de un informe programado en una carpeta
Cambiar el nombre de una carpeta o recurso y cambiar su cadena de

descripcin
Abra una vista especial en el Editor Ad Hoc o un panel de control en el diseador
Modificar y sobrescribir un Especial vista, informe o cuadro de mandos existente
Aadir un recurso JasperReport al repositorio (subir una JRXML)
Editar la definicin de un recurso JasperReport en el repositorio (reemplazar el

JRXML)
Administrar
Establezca los permisos (por funcin y por usuario) en una carpeta o recurso. Este
delegados eficazmente ciertas tareas de administracin del repositorio.
Administrar y PAPEL
_ADMINISTRATOR
Aadir (crear) un recurso en una carpeta
Edicin de un recurso, por ejemplo los componentes de una unidad de informes o en un

dominio
Permisos aplican al navegar o buscar en el repositorio, as como cuando se utiliza cualquier dilogo que acceda a
el repositorio, como por ejemplo cuando se navega por las carpetas para guardar un informe. Tenga en cuenta que:
3.5.1
Copiado hace no preservar los permisos en un objeto. Los usuarios pueden copiar un objeto de slo lectura, pguelo en un
carpeta de lectura-escritura, a continuacin, editar el objeto. Para ms detalles, consulte "Copiar y mover" en la pgina 52
Copia y corte (en movimiento) acciones slo pueden completarse si el usuario ha Leer + Escribir + Delete acceso
a la carpeta en la que se pega el objeto. Para ms detalles, consulte "Copiar y mover" en la pgina 52
Corte, eliminar y configurar permisos en las carpetas se permite slo si el usuario tiene el mismo permiso en
todos los contenidos de la carpeta. Corte y eliminacin de recursos a granel se permite slo si el usuario al menos ha Leer
+
Eliminar el permiso de todos los recursos seleccionados.
Eliminacin de un recurso o el contenido de una carpeta slo est permitido si no hay otros recursos dependen de ellos.
Para obtener ms
detalles, consulte "Eliminacin de carpetas y recursos" en la pgina 54
La herencia de permisos
De acuerdo con la arquitectura de permiso, hay una configuracin de permisos para cada usuario y rol en cada carpeta
y recursos en el repositorio. Para simplificar la definicin de permisos, JasperReports Server es compatible con el
herencia de los permisos de la carpeta principal de una carpeta o recurso. Si no se define explcitamente el permiso para
un usuario o rol en una carpeta o recurso determinado, el usuario o rol tiene el mismo permiso de acceso que se define en el
carpeta principal. Cuando un permiso se define explcitamente, que el permiso se aplica, independientemente de los de la
carpeta principal.
El uso de este mecanismo, los administradores pueden gestionar grandes jerarquas de contenido y mantenerlos seguros.
Cuando el
administrador establece un permiso de forma explcita, que el permiso para que un usuario o rol determinado se hereda de
forma recursiva por todos
del contenido de la carpeta y subcarpetas, a menos que tengan una definicin explcita de los suyos. Permisos que son
58
asignado en la carpeta de la parte superior de una organizacin se heredan a travs de toda la organizacin. Los permisos que
se establecen en
la carpeta raz o (si se utiliza la edicin profesional de JasperReports Server) carpeta de Organizaciones por el sistema
administrador se heredan a travs de mltiples organizaciones.
Por ejemplo, el administrador de sistema puede hacer que todas las organizaciones de slo lectura de forma
predeterminada para los usuarios comunes, y cada
organizacin administrador puede crear carpetas especficas grabable para que los usuarios pueden almacenar sus
informes y de salida.
3.5.2
Permisos acumuladas
Dado que los permisos se pueden asignar a los usuarios y roles, un usuario que pertenece a uno o ms roles puede tener
mltiples permisos definidos o heredados en cualquier carpeta o recurso determinado. De hecho, cada permiso tiene que ser
definido en la raz, incluso si tiene el valor predeterminado de Sin acceso, y por tanto basada en el usuario-cada de roles y
permisos en todas las carpetas y recursos tiene un ajuste a travs de la herencia. Por lo tanto, para cada carpeta o recurso,
cada usuario tiene una su propio permiso basado en el usuario y el permiso asignado al ROLE_USER.
Cmo JasperReports Servidor determinar la autorizacin efectiva de los muchos que se aplica? Permiso de la
servidor son estrictamente acumulativa, lo que significa que se aplica el menos restrictivo entre el conjunto de todos los permisos.
Incluso si un
permiso ms restrictivo, como Sin acceso, se establece de forma explcita, el permiso menos restrictivo como Lectura
Slo se aplica, independientemente de si se hereda o establece explcitamente.
3.5.3
Permisos de administrador
La arquitectura de la autorizacin del servidor JasperReports distingue entre los administradores y todos los dems usuarios.
Los administradores se definen como usuarios, ya sea con ROLE_SUPERUSER (disponibles en la edicin profesional de
JasperReports Server), ROLE_ADMINISTRATOR, o ambos. Por su diseo, los administradores de sistemas con la
ROLE_SUPERUSER siempre tienen acceso Administrar irrevocable de todo el repositorio, incluyendo a la
contenido de cada organizacin. El administrador del sistema no puede modificar los permisos para ROLE_
SUPERUSUARIO, para evitar el bloqueo o no puede administrar algn recurso. Por lo tanto, el administrador de sistema
puede establecer permisos para todos los dems usuarios, en cualquier carpeta o recurso, y en cualquier organizacin, si es
necesario. En
particular, el administrador del sistema puede modificar los permisos para ROLE_ADMINISTRATOR, por ejemplo, para compartir
algunos recursos a travs de todas las organizaciones al hacerlos de slo lectura a todo el mundo, incluida la organizacin
administradores.
Los administradores de organizacin son usuarios de la organizacin con el ROLE_ADMINISTRATOR, como el jasperadmin
defecto
creado en cada organizacin. De forma predeterminada, los administradores de la organizacin tienen los permisos Administrar
a todo en
su organizacin, salvo que el administrador del sistema ha cambiado a un permiso menor. Sin embargo, la organizacin
los administradores no pueden cambiar los permisos concedidos a ROLE_ADMINISTRATOR, para evitar que se anule
la configuracin del administrador de sistema y de encerrarse fuera de una carpeta o recurso.
3.5.4
Ejecutar permiso de slo

Al igual que en los sistemas de archivos, slo permiso de ejecucin en JasperReports Server permite ejecutar informes,
cuadros de mando, y
Vistas OLAP para acceder a un recurso, pero mantiene el recurso aparezca en el repositorio.
Ejecutar permiso de slo se aplica a las carpetas, as, evitando que aparecen en el rbol de carpetas cuando los usuarios
navegar en el repositorio, y an as permitir que los recursos que contienen a heredar el nico permiso de ejecucin. Este
es til para ocultar carpetas y recursos, como fuentes de datos que slo los administradores y los roles de los analistas de
datos
necesitan acceder en el repositorio. Sin embargo, si su slo ejecutar carpeta contiene slo lectura los recursos, los
recursos estn ocultas cuando se navega carpetas, pero se puede encontrar, ya sea accidental o intencionalmente, mediante el
uso de la
Bsqueda repositorio.
59
Al igual que con todos los dems permisos, ejecutar permiso de slo es ya sea basada en roles o basada en el usuario, de
manera que ciertos usuarios
puede acceder a un recurso de un informe de ejecucin, pero no en otros.
Si usted tiene datos o contenido sensible en un recurso, siempre fije No permission acceso para los usuarios o roles que
no debe ser capaz de acceder a l.
Ocultacin de un recurso con ejecutar permiso de slo no protege contra el acceso, porque malicioso
los usuarios que encuentran el ID de recurso pueden ser capaces de crear un informe, tablero de instrumentos, o consulta
OLAP que extrae el
contenido sensible.
3.5.5
Permisos de usuario
predeterminado
Para todos los usuarios que no sean administradores, el permiso predeterminado en la raz hay acceso y los permisos debe
ser
definido explcitamente. En la prctica, la instalacin por defecto del repositorio contiene datos de la muestra con una mezcla
de no
acceso, ejecutar solamente, de slo lectura, y los permisos que permiten a los usuarios de ejemplo para acceder a las
carpetas de lectura-escritura y
recursos. Los permisos de ejemplo muestran un enfoque comn para los permisos, lo que permite a los usuarios ver la
Le
recomendamos
que
se familiarice
con
mecanismo
de mientras
permisos que
mediante
la visualizacintienen
y la configuracin
de permisos en
recursos
que puedan
acceder
y ocultar
loselque
no pueden,
los administradores
acceso completo.
los datos de la muestra, tal como se describe en la siguiente seccin.
3.5.6
Establecer permisos
Los administradores pueden asignar permisos para acceder a cualquier carpeta o recurso en todo el repositorio. Los usuarios
con el
Administrar permisos en una carpeta pueden asignar permisos a esa carpeta y cualquier contenido que heredan el
permiso. Usuarios concedido permiso Administrar a un recurso slo puede establecer los permisos en ese especfico
de recursos.
Para establecer permisos en una carpeta o recurso en el repositorio:
1. Inicie sesin como un usuario con privilegios administrativos.
2.
En el repositorio, navegar o buscar la carpeta o recurso.
3.
Haga clic derecho en el objeto y seleccione Permisos de ... en el men contextual:

Se abre el cuadro de dilogo Permisos. Muestra los permisos vigentes para el objeto seleccionado. Por defecto, la primera
muestra los permisos dados a los roles. Los permisos que se heredan de los padres del objeto se indican mediante
un asterisco (*).
60
Figura 3-5 Permisos de dilogo que aparecen los permisos por rol
En sistemas con mltiples organizaciones, los usuarios y los roles que se muestran incluyen slo los que estn dentro del
mbito de
el usuario. Por ejemplo, en la organizacin nica forma predeterminada, el administrador de la organizacin no puede ver el
permiso
para
administrador
depuede
sistema
) Obasados
para ROLE_SUPERUSER.
En laelfigura
anterior, se
ver(superusuario
los permisos
en roles por defecto en la carpeta Tipos de datos de muestra de
4.
5.
entrada
como se ve por el administrador organizacin ( jasperadmin). Los miembros de ciertos roles pueden ver y modificar la entrada
tipos de datos almacenados en esta carpeta; estas funciones probablemente corresponden a los usuarios, tales como
analistas de datos. Los usuarios habituales
tienen ejecutar slo el permiso para que no se vean esta carpeta, pero los informes que se ejecutan pueden acceder a su
contenido.
Los administradores no pueden cambiar el permiso para que su funcin de administrador o nombre de usuario, para evitar
En
queelsecuadro de dilogo, haga clic en Usuario para ver los permisos asignados a los usuarios especficos. Haga clic en
Papel
durante
la visualizacin
usuario permisos.
eliminando
su capacidad
para de
establecer
Permisos para alternar espalda.
Para cada usuario o rol, puede seleccionar un nuevo permiso del desplegable.
En la siguiente figura, se puede ver los permisos de usuario por defecto en esta carpeta. En la instalacin por defecto, todos
los
permisos se definen por papel; Por lo tanto, todos los permisos de los usuarios son No Acceso heredado de la raz. El
figura muestra una de slo lectura autorizacin que se concede al usuario final de la muestra. Esto da al usuario joeuser la
capacidad de ver, pero no modificar la carpeta de tipos de datos de entrada y su contenido. Para el resto de los usuarios
finales, sin embargo,
la carpeta todava se ejecute slo debido a los ajustes en Figura 3-5.
61
Figura 3-6 Permisos de dilogo que aparecen los permisos de usuario

6.
Haga clic en Aplicar para guardar los cambios. Si alternar entre los permisos de usuario y de rol, debe hacer clic Aplicar
primero para guardar los cambios realizados.
7.
Haga clic en Aceptar para guardar los cambios y cerrar los permisos de dilogo cuando haya
terminado.
Puede abrir varios cuadros de dilogo de permisos para diferentes recursos o carpetas al mismo tiempo, as como
navegar por el repositorio. Esto ayuda cuando se trata de establecer los permisos de manera uniforme a travs de
varias carpetas o
organizaciones.
Hay dos casos especiales, cuando la configuracin de permisos:
3.5.7
Si un recurso hereda un permiso, por ejemplo, de slo lectura, no se puede establecer el permiso a la misma
valor, al menos no directamente. Tiene que cambiar temporalmente el nivel de permisos de la carpeta principal,
a continuacin, establecer el permiso explcito, a continuacin, establecer el permiso de la carpeta principal de nuevo al
valor original.
Cuando un recurso y su carpeta principal se han establecido para el mismo permiso de esta manera, el permiso
dilogo sigue mostrando el asterisco como si se hereda el permiso. Pero cuando el padre est ms tarde le dio un
diferente permiso, por ejemplo, de lectura y escritura, el recurso conserva su explcito permiso de slo lectura
en lugar de heredar de lectura-escritura.
Para restablecer el nivel de permiso para que una vez ms hereda de su carpeta padre, seleccione una diferente
nivel de permisos y haga clic en Aplicar, a continuacin, seleccione el permiso con el asterisco y haga clic en Aplicar de
nuevo.
Permisos de pruebas de usuario

Una vez que haya configurado usuarios, roles y permisos, Jaspersoft recomienda que pruebe los permisos
concedida a unos pocos usuarios representativos. Las pruebas tambin se recomienda al agregar nuevos usuarios, roles, y
recursos, y cuando usted hace grandes modificaciones a la configuracin de control de acceso.
Para comprobar los permisos de usuario:
1. Inicie la sesin como administrador.
2.
3.
4.
62
Seleccione Gestionar> Usuarios.

Seleccione la organizacin del usuario, a continuacin, navegar o buscar para el usuario cuyos permisos se est
probando.
En el panel Usuarios, seleccione el usuario.
5.
6.
En el panel Propiedades, haga clic en Entrar como

usuario.
Aparece la pgina de inicio del usuario seleccionado. La informacin de inicio de sesin en la esquina superior derecha
muestra que son
iniciar la sesin como ese usuario.
En el repositorio, navegar o buscar las carpetas y los recursos a prueba.
7.
Compruebe que JasperReports Server muestra las carpetas y los recursos esperados. Tome nota de cualquier objeto
que se debe mostrar, pero no lo son, y se muestran los objetos que deben ser ocultados pero.
8.
Cuando haya comprobado los permisos del usuario, haga clic en Salir.
Aparece su propia pgina de inicio.
9.
Para cambiar los permisos del usuario, modificar los permisos en el repositorio y modificar el usuario o rol
definiciones.
10. continuar con las pruebas hasta que los permisos del usuario son
satisfactorios.
11 Repita estos pasos con varios usuarios representativos para asegurarse de que su control de acceso es correcta
configurado. Una configuracin de control de acceso que no se ha probado no proteger los datos adecuadamente.
63
64
CAPTULO 4 FUENTES DE
INFORMACIN
Un origen de datos es un recurso en el repositorio que define cmo y dnde obtener los datos que aparecen en los informes,
Ad Hoc vistas y vistas OLAP. Los administradores deben definir fuentes de datos antes de cargar los informes que se basan en
ellos. Por lo general, un origen de datos especifica el URI del servidor de base de datos y los detalles que necesita para acceder
a ella,
como un nombre de usuario y contrasea.
JasperReports Server proporciona tipos de fuentes de datos para las bases de datos relacionales, la mayora de los sabores
de datos grandes, y para
datos especializadas como Amazon Web Services y datos JavaBean. Fuentes de datos virtuales permiten combinar
varias fuentes de datos en una sola.
JasperReports Servercan acceder a cualquier base de datos relacional que soporte el lenguaje de consulta SQL a travs de
JDBC
(Java Database Connectivity) API. En este caso, puede configurar dos tipos de fuentes de datos en el repositorio:
Fuente de datos JDBC - Establece una conexin directa al servidor de base de datos utilizando su driver JDBC. Despus
instalacin, drivers JasperReports Serverincludes JDBC para acceder a las bases de datos ms populares: MySQL,
PostgreSQL, Oracle, SQL Server y DB2. A partir del lanzamiento 5.6.1, el servidor tambin incluye un driver JDBC que
puede acceder a Hadoop-Hive. Si no est instalado el controlador de la base de datos, o si desea utilizar controladores
alternativos,
el administrador del sistema puede cargar y administrar los controladores JDBC a travs de la interfaz de usuario. Con
fuentes de datos JDBC,
JasperReports Server configura y administra las conexiones a la base de datos. De forma predeterminada, el mximo
nmero de conexiones simultneas para cada fuente de datos es 20.
Fuente de datos JNDI - Se basa en la JNDI (Java Naming and Directory Interface) de servicio de su aplicacin
servidor para acceder a una conexin de base de datos. Primero debe configurar el servidor de aplicaciones para instalar su
JDBC
conductores y configurar sus conexiones de base de datos. La configuracin del servidor de aplicaciones determina la
nmero de conexiones que se comparten. Tenga en cuenta que el servidor de aplicaciones se conecta a la base de datos
utilizando
JDBC, lo que significa que las fuentes de datos JNDI estn disponibles para todas las bases de datos que soportan JDBC.
Grandes almacenes de datos que no son compatibles con JDBC tienen un origen de datos
personalizado:
Fuente de datos Cassandra - Esta nueva fuente de datos introducido en JasperReports Servidor 5.6 es diferente de la
fuente de datos aportados por la comunidad de Cassandra. Esta fuente de datos es compatible con el lenguaje de consulta
de Cassandra
CQL 3.
Cloudera fuente de datos 5 - Esta fuente de datos puede acceder a las agrupaciones Apache Hadoop a travs de Cloudera
5 Hive o
Impala. Utiliza el lenguaje de consulta Hive (HiveQL) que es similar a SQL, pero distinta. Todos los dems HadoopFuentes de datos colmena debe utilizar el controlador JDBC se ha descrito anteriormente.
65
Fuente de datos MongoDB - Esta fuente de datos personalizada para MongoDB MongoDB soporta propia consulta de
Jaspersoft
Idioma.
Por ltimo, JasperReports Server tambin admite algunas fuentes de datos
especializadas:
Amazon Web Services (AWS) fuentes de datos - acceso a los datos almacenados en el almacn de datos utilizando AWS
JasperReports Server, ya sea en las instalaciones o en la nube.
Fuente de datos virtual - Le permite combinar mltiples fuentes de datos en una sola fuente de datos y unirse a ellos
dentro de un dominio. Tambin se puede envolver una fuente de datos para grandes datos para ser utilizados en un
dominio.
Fuente de datos Bean - Le permite acceder a los datos encapsulados en JavaBeans.
Fuente de datos de diagnstico interno - Una fuente de datos personalizada para propios datos de diagnstico del servidor.
El diagnstico
informacin slo est disponible para los administradores de sistemas ( superusuario por defecto). Para obtener ms
informacin, consulte "Utilizacin
los datos de diagnstico en los informes "en la pgina 236.
En el caso de anlisis de datos, JasperReports Server es compatible con las fuentes de datos OLAP (como Mondrian y XML /
A
conexiones). Para obtener informacin sobre las fuentes de datos de anlisis, consulte la Jaspersoft ltima gua OLAP.
Puede ampliar JasperReports Server para admitir cualquier fuente de datos personalizado. Fuentes de datos personalizados
consisten en
Clases Java de implementacin, un catlogo de mensajes, y una definicin de frijol de primavera. Para obtener ms
informacin
sobre las fuentes de datos personalizadas, consulte la Ultimate Guide servidor JasperReports.
4.1
Orgenes de datos JDBC

Administracin de controladores JDBC
Fuentes de datos JNDI
Fuentes de datos de AWS
Fuentes de datos Cassandra
Hadoop Hive-Fuentes de datos
Fuentes de datos MongoDB
Fuentes de datos virtuales
Conectores grandes datos para los orgenes de datos
virtuales
Fuentes de datos de frijol
Orgenes de datos JDBC

Fuentes de datos JDBC son conexiones directas a la base de datos que se manejan por JasperReports Server. Para crear
uno, usted debe proporcionar la direccin URL y las credenciales para acceder a su base de datos, junto con la base de datos
especfica de cualquier
parmetros de configuracin.
JasperReports Server incluye controladores JDBC para las bases de datos ms utilizadas. Si su base de datos no est
incluido, o si
que desea utilizar diferentes controladores JDBC, el administrador del sistema debe cargar el controlador JDBC apropiado
antes de crear una fuente de datos. Para obtener ms informacin sobre los controladores JDBC, consulte "Controladores de
Gestin de JDBC" en la
pgina 68.
Para crear una fuente de datos JDBC:
1. Inicie sesin como administrador.
2.
66
Haga clic en Ver> Repositorio, ampliar el rbol de carpetas y, haga clic en una carpeta para seleccionar Agregar recurso>
Datos
Fuente en el men contextual. Alternativamente, usted puede seleccionar Crear> Fuente de datos desde el men principal
en cualquier pgina y especificar una ubicacin de carpeta ms tarde. Si ha instalado los datos de ejemplo, la carpeta
sugerida es
Orgenes de datos.
Aparece la pgina Nuevo origen de datos.

3.
En el campo Tipo, seleccione JDBC Data Source.
4.
La pgina se actualiza para mostrar los campos necesarios para una fuente de datos
JDBC.
Escriba un nombre y una descripcin opcional para la fuente de datos. El identificador de recurso se rellena
automticamente basa
en el nombre.
Figura 4-1 Configuracin del tipo de origen de datos JDBC

5.
Seleccione el controlador JDBC para la base de datos. Si su controlador aparece como no instalado, un sistema
administrador debe cargar primero el conductor como se describe en "Gestin de Controladores JDBC" en la
pgina 68.
Figura 4-2 Seleccionar el controlador JDBC

6.
7.
Introduzca el nombre de host, el puerto y el nombre de base de datos para su base de datos. El nombre de host
predeterminado es el host local, y
el puerto por defecto es el puerto tpico para el proveedor de base de datos especificado. Los tres campos se combinan
automticamente para crear la URL JDBC que utilizar el servidor para acceder a la base de datos.
Para obtener ms informacin acerca de JDBC URL, incluyendo parmetros opcionales, consulte la seccin de solucin
de problemas
"URL de base de datos JDBC" en la pgina 249.
Escriba el nombre de usuario de base de datos y la contrasea. Estas son las credenciales que el servidor utilizar para
acceder a la
base de datos.
67
Figura 4-3 Prueba de la conexin JDBC
Defina el campo Zona horaria cuando los valores de fecha y hora almacenados en su base de datos no indican un
tiempo
zona. Cuando los valores de fecha y hora se almacenan en un formato que no sea de zona horaria local en relacin
con
Tiempo del Meridiano de Greenwich (GMT), debe especificar una zona horaria para que el servidor puede convertir
correctamente
los valores de fecha y hora leen de la base de datos de destino. Establezca el campo de zona horaria a la zona
horaria correcta para
los
datosde
enduda,
la base
deeldatos.
Laen
lista
de zonas
En caso
deje
campo
blanco
Zonahorarias
horaria. es configurable, como se describe en "Especificacin
Husos horarios adicionales "en la pgina 267.
8.
Si an no lo ha especificado la carpeta del repositorio, haga clic en Examinar ... elegir uno en el Guardar ubicacin
campo.
Haga clic en Prueba de conexin para validar la fuente de datos. Si la validacin falla, asegrese de que los valores que
introducidos son correctos y que la base de datos se est ejecutando. Para diagnosticar problemas de conexin JDBC,
puede activar
el registro como se describe en la seccin de solucin de problemas "Inicio de sesin de operaciones JDBC" en la pgina
247. la prueba es correcta, haga clic en Guardar. El origen de datos aparece en el repositorio.
10 Cuando
9.
4.2
Administracin de controladores
JDBC
Para acceder a una base de datos de JasperReports Server mediante JDBC debe tener un controlador adecuado, que debe ser
accesible en la ruta de clase del servidor. En JasperReports Servidor 5.6.1, los siguientes controladores se instalan por defecto:
MySQL (org.mariadb.jdbc.Driver)
PostgreSQL (org.postgresql.Driver)
Oracle (tibcosoftware.jdbc.oracle.OracleDriver)
Microsoft SQL Server (tibcosoftware.jdbc.sqlserver.SQLServerDriver)
IBM DB2 (tibcosoftware.jdbc.db2.DB2Driver)
Hive (tibcosoftware.jdbc.hive.HiveDriver)
Drivers para otras bases de datos se pueden descargar de los enlaces en el sitio web de la comunidad
Jaspersoft:
base de datos de los conductores http://community.jaspersoft.com/wiki/downloading-y-instalarEl administrador del sistema (usuario root) puede agregar controladores JDBC para otras bases de datos de las
siguientes maneras:
Durante la instalacin. Para obtener ms informacin, consulte la Gua de instalacin del servidor
JasperReports.
68
En cualquier momento a travs de la interfaz de usuario. Como se describe en el procedimiento siguiente, el

administrador del sistema puede agregar, reemplazar o
quitar controladores JDBC a travs de la interfaz de usuario, sin necesidad de reiniciar el servidor.
Slo el administrador del sistema puede gestionar los drivers JDBC, pero una vez que se suben, que estn disponibles para
todos los administradores que crean fuentes de datos.
JBoss no permite la flexibilidad de subir los conductores sobre la marcha. En JBoss, los conductores que no han sido
instalado no aparecen en la lista de abajo, y tienes que configurar y reiniciar JBoss para agregar un controlador. Para
ms informacin, consulte "Controladores JDBC en JBoss" en la pgina 248.
Para agregar un controlador JDBC:

1. Inicie la sesin como administrador del sistema ( superusuario en las ediciones comerciales, jasperadmin en la comunidad
ediciones).
2.
Seleccione Crear> Fuente de datos desde el men principal.
3.
4.
JDBC.
El selector desplegable para el campo Controlador JDBC muestra los controladores JDBC que estn disponibles y los que
no estn instalados.
Figura 4-4 Visualizacin de la lista de controladores JDBC disponibles

5.
6.
Si desea agregar un controlador que no se ha instalado, seleccione de la lista, a continuacin, haga clic en Agregar
controlador. El
Aparece dilogo Seleccionar controlador.
Si usted todava no ha obtenido el controlador, haga clic en el vnculo para Descarga e Instalacin de los controladores de
base de datos.
Esa pgina en el sitio web de la comunidad de Jaspersoft tiene vnculos con los controladores JDBC ms utilizados.
Despus
descargar un controlador para el sistema de archivos, puede volver al cuadro de dilogo Seleccionar controlador.
Figura 4-5 Adicin de un controlador JDBC
69
7.
8.
En el cuadro de dilogo Seleccionar controlador, haga clic Explorar para localizar el archivo JAR del controlador
correspondiente. Si el conductor tiene ms
de un archivo JAR, haga clic en el Explorar botn que aparece despus de seleccionar el primer archivo.
Haga clic en Subir para instalar el controlador y ponerla a disposicin de inmediato.
Puede sustituir cualquier conductor que cargue con las nuevas versiones del mismo driver. Si desea utilizar el
propio conductor del proveedor en lugar del controlador TIBCO JDBC, debe instalarlo como un nuevo controlador como se
describe en el
Gua de instalacin del servidor JasperReports.
Para actualizar un controlador JDBC:
ediciones).
2.
3.
4.
JDBC.
El selector desplegable para el campo Controlador JDBC muestra los controladores JDBC que estn disponibles y los que
no estn instalados.
5.
Para actualizar un controlador que ya se ha instalado, seleccione de la lista, a continuacin, haga clic en Editar conductor.
El Select
De dilogo del controlador aparece y le informa de que la seleccin de un controlador sobrescribe el existente.
Figura 4-6 Actualizacin de un controlador JDBC

6.
7.
8.
En el cuadro de dilogo Seleccionar controlador, haga clic Explorar para ubicar el nuevo
archivo JAR del controlador.
Haga clic en Subir para reemplazar el controlador existente y ponerla a disposicin de inmediato.
Ahora puede utilizar este controlador para crear una fuente de datos, y tambin se instalar el controlador al
otro
administradores crean fuentes de datos.
Para eliminar un driver JDBC cargada:

ediciones).
70
2.
Seleccione Ver> Repositorio y abra la carpeta Propiedades del sistema en la raz.
3.
4.
Haga clic derecho en el recurso GlobalPropertiesList y seleccione Editar en el men contextual.

Busque el controlador que ha cargado en la lista de propiedades. Los conductores con el [sistema] valor son el
controladores predeterminados configurados durante la instalacin.
5.
Haga clic en Retire junto al conductor que desea eliminar.
Figura 4-7 Extraccin de un controlador Subido JDBC

6.
Haga clic en Enviar para guardar los cambios.

Si el controlador JDBC de quitar era uno que actualiza un controlador predeterminado, el controlador predeterminado
volver a aparecer
como [SYSTEM] del controlador en el GlobalPropertiesList la prxima vez que utilice el asistente para nuevo origen de
datos.
4.3
Fuentes de datos JNDI

La fuente de datos JNDI accede a una conexin de base que se define previamente en el servidor de aplicaciones y
publicado como un recurso JNDI o servicio. En lugar de especificar un conductor y la base de datos como lo hace con los datos
JDBC
fuentes, slo tiene que especificar el nombre del servicio JNDI en el servidor de aplicaciones.
Servidores de aplicaciones utilizan los propios conexiones JDBC para exponer una base de datos a travs de JNDI. Usted
debe
especificar el nombre del servicio JNDI de una conexin JDBC. El servidor de aplicaciones tambin debe tener la
conductores y JDBC apropiadas pueden configurar para usarlos.
Para obtener informacin sobre la configuracin de una conexin JNDI en el servidor de aplicaciones, consulte las
siguientes secciones:
"JNDI Servicios en Apache Tomcat" en la pgina 250
"Trabajar con fuentes de datos" en la pgina 247
"JNDI Servicios en WebLogic" en la pgina 250
Para crear una fuente de datos JNDI:

2.
Datos
sugerida es
Orgenes de datos.
3.
En el campo Tipo, seleccione JNDI de origen de datos.

La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos JNDI.
71
4.
Rellene los campos requeridos, junto con cualquier informacin opcional.

El nombre del servicio es el nombre que el servidor de aplicaciones expone a travs de JNDI. Muestra la siguiente figura
valores para la conexin al servicio JNDI de la base de datos Foodmart incluyen en los datos de la muestra.
Figura 4-8 JNDI de datos fuente de la pgina
Defina el campo Zona horaria cuando los valores de fecha y hora almacenados en los RDBMS objetivo no indican un
tiempo
zona. Cuando los valores de fecha y hora se almacenan en un formato que no sea de zona horaria local en relacin con
Tiempo del Meridiano de Greenwich (GMT), debe especificar una zona horaria para que el servidor puede convertir fecha
y hora
valores ledos desde la base de datos de destino correctamente. Establezca el campo de zona horaria a la zona horaria
correcta para el
datos en la base de datos. La lista de las zonas horarias disponibles se puede configurar, como se describe en
"Especificacin
En caso de duda, deje el campo en blanco Zona horaria.
Husos horarios adicionales "en la pgina 267.
Haga clic en Prueba de conexin para validar la fuente de datos. Si la validacin falla, asegrese de que los valores que
introducidos son correctos, que la base de datos se expone a travs de JNDI, y que la base de datos se est ejecutando.
Asimismo, consulte
la seccin de solucin de problemas "Servicios de JNDI en Apache Tomcat" en la pgina 250.
6. Cuando la prueba es correcta, haga clic en Guardar. El origen de datos aparece en el
repositorio.
Para obtener ms informacin acerca de la configuracin y la exposicin de una conexin de base de datos JNDI en el nivel de
servidor de aplicaciones, consulte
la documentacin proporcionada con el servidor de aplicaciones.
5.
72
4.4
Fuentes de datos de AWS

Amazon Web Services (AWS) proporcionan la computacin y el almacenamiento de datos en la demanda en la nube. Socios
Jaspersoft
con Amazon para ofrecer soluciones de inteligencia de negocio basados en AWS.
JasperReports Server es compatible con dos de los servicios de base de datos de AWS como fuentes de
datos para la presentacin de informes:
Amazon Relational Database Service (RDS)
Almacn de datos Amazon Redshift

JasperReports Server puede acceder a cualquiera de estos servicios cuando se define una fuente de datos con la correcta
informacin de configuracin y credenciales. El asistente de la fuente de datos de AWS utiliza las credenciales de AWS
suministrados por el
para descubrir las fuentes de datos RDS y Redshift. A continuacin, utiliza estas credenciales para configurar correctamente los
grupos de seguridad
para mantener la conexin entre JasperReports Server y la fuente de datos AWS, incluso cuando la direccin IP
cambios. Puede acceder a fuentes de datos de AWS, tanto las instancias de servidor que usted mantiene en-independiente de
su
computadoras propias y las instancias de servidores virtuales que se ejecutan en la Elastic Compute Cloud de Amazon (EC2).
Para obtener ms
Para
crear unconsulte
origen de
datos de AWS:
informacin,
https://www.jaspersoft.com/cloud.
1. Entre en JasperReports Server como administrador.
2.
Datos
sugerida es
Orgenes de datos.
3.
En el campo Tipo, seleccione AWS origen de datos.
4.
La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos de
AWS.
Introduzca un nombre, una descripcin opcional y la ubicacin en el repositorio para almacenar la fuente
de datos.
Figura 4-9 Configurar el tipo de origen de datos y Propiedades de la

pgina
5.
Bajo el encabezado Configuracin de AWS, especificar sus credenciales de Amazon en una de las siguientes
maneras:
73
Figura 4-10 Seleccin de Credenciales AWS
Si su servidor JasperReports se est ejecutando en el servicio EC2 de Amazon, y tiene el papel instancia adecuada
asignado, el servidor lo detectar automticamente y utilizar sus credenciales de EC2. Usando el EC2
credenciales de instancia requiere que el papel fue configurado correctamente y se asigna cuando la instancia fue
creado. Si est utilizando el servicio EC2, Jaspersoft recomienda encarecidamente que utilice el EC2
credenciales.
Si su servidor JasperReports no se ejecuta en EC2 de Amazon, introduzca las credenciales de AWS asociados
con el RDS o servicio Redshift. Si usted no tiene las llaves de AWS, haga clic en Generar credenciales, luego mirar
por ellos en la Salidas ficha de su Pila de la consola de Amazon:
Figura 4-11 AWS acceso y claves secretas

6.
74
Bajo el encabezado Seleccionar un origen de datos de AWS, especifique los detalles de la conexin de la fuente de datos
de AWS que
que desea utilizar para conectarse:
a. Seleccione la regin AWS desde el desplegable.
b.
Haga clic en el Encontrar Mis Fuentes de datos de AWS

botn.
La fuente de datos de AWS consulta su entorno y muestra las fuentes de datos disponibles, como se muestra en
la siguiente figura.
c.
Seleccione el origen de datos.
d.
Introduzca su nombre de usuario, contrasea y nombre de base

de datos.
La fuente de datos de AWS consulta tu entorno y agrega el controlador y URL apropiada.
Figura 4-12 Seleccione una seccin AWS origen de datos

7.
Cuando haya introducido toda la informacin, haga clic en Probar conexin.

Si la conexin es satisfactoria, aparecer un mensaje en la parte superior de la pantalla. A veces el proceso toma un
pocos minutos. En ese caso, ver una alerta. Pruebe la prueba de nuevo despus de uno o dos minutos. Los realiza la
prueba
las siguientes acciones:
Valida el nombre de usuario y contrasea.
Crea un grupo de seguridad de base de datos.
Aade la direccin IP de la instancia de JasperReports Server para el grupo de seguridad para autorizar el ingreso a
el servicio de datos (RDS o Redshift).
Si desea controlar los detalles del nombre del grupo de seguridad o especificar la direccin IP de forma manual, ya que
tener un complejo VPC topologa, vase "Configuracin de Amazon Web Services" en la pgina 197. Tambin puede
cambiar el controlador JDBC por defecto a travs de la configuracin.
8.
Haga clic en Guardar.

El nuevo origen de datos aparece en el repositorio.
4.5
Fuentes de datos Cassandra

La base de datos Apache Cassandra proporciona escalabilidad y alta disponibilidad para ciertas aplicaciones de datos grandes.
En
JasperReports Servidor 5.6, Jaspersoft reemplaza el conector de la comunidad previamente soportado con una soportado
fuente de datos para Cassandra. Para obtener ms informacin acerca de Cassandra, consulte http://cassandra.apache.org/.
La fuente de datos Cassandra se basa en un nuevo controlador que tiene ciertas limitaciones en cmo se pueden estructurar
sus datos
y acceso:
75
La versin actual de Cassandra no admite valores NULL en los datos. Todos los campos obligatorios deben tener
valores por defecto no NULL. Esto tambin significa que los controles de entrada no puede ser nulo y se les debe dar un
valor.
La versin actual del controlador no admite las funciones de agregado (suma, min, max).
Para los parmetros de consulta, la versin actual del controlador es compatible con $ X (EN ...), pero no hay otras
funciones $ X.
Como se actualiza el controlador de Cassandra para incluir ms funcionalidad, Jaspersoft tiene previsto actualizar los datos
Cassadra
fuente en futuras versiones.
La fuente de datos Cassandra admite consultas en el Cassandra Lenguaje de consulta 3 (CQL3). Para mejorar
rendimiento, disear sus datos Cassandra con las siguientes directrices:
Especifique el Permitir el filtrado sufijo para acelerar las consultas.

Todos los campos de referencia en DONDE clusulas de una consulta deben ser
indexados.
Al igual que con todos los grandes almacenes de datos, fuentes de datos Cassandra tienen las siguientes limitaciones y
directrices de uso dentro
JasperReports del servidor:
Fuentes de datos Cassandra no son compatibles con las conexiones OLAP
Fuentes de datos Cassandra no se pueden utilizar directamente en Dominios. Para utilizar Cassandra en un dominio,
consulte "Big Data
Conectores para fuentes de datos virtuales "en la pgina 86.
Fuentes de datos Cassandra se pueden utilizar en temas ad hoc, pero no son compatibles con la optimizacin de
consultas.
Usted debe configurar los lmites de consulta para manejar grandes volmenes de datos (vase "Ad Hoc Polticas de datos
para grandes datos" en la
pgina 181).
Debe configurar la memoria JVM para manejar la cantidad esperada de datos (vase el JasperReports
Gua de instalacin del servidor).
4.5.1
Crear un origen de datos Cassandra

1.
Inicie sesin como administrador.
2.
Datos
sugerida es
Orgenes de datos.
3.
En el campo Tipo, seleccione Cassandra origen de datos.

La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos Cassandra.
76
Figura 4-13 Cassandra datos fuente de la pgina

4.

Utilice el puerto 9042 con la fuente de datos Cassandra. Puerto por defecto de Cassandra de 9160 es que el cliente Thrift
que es
utilizada con Cassandra. Para utilizar el lenguaje de consulta de Cassandra (CQL) con Cassandra de Jaspersoft
fuente de datos, usted necesita puede que tenga que configurar la instancia de Cassandra de la siguiente manera:
start_native_transport: true
native_transport_port: 9042
5.
6.
4.5.2
Haga clic en Probar conexin para comprobar los valores que ha entrado. Asegrese de que el puerto se establece en
9042, debido a que el
prueba de conexin tambin trabajar con el puerto equivocado (9160).
Cuando haya terminado, haga clic en Guardar. El origen de datos aparece en el
repositorio.
El aumento de los lmites de descriptor de fichero para

Cassandra
Muchos usuarios han informado de errores durante la visualizacin de muchos informes de una fuente de datos Cassandra.
Cassandra general
necesita ms que el lmite predeterminado de descriptores de archivos abiertos (1024).
77
Para aumentar el nmero de descriptores de archivos, los administradores necesitan para cambiar los lmites de seguridad
en el Casandra
linfticos y en los sistemas operativos que se ejecutan JasperReports servidor.
Para probar esta configuracin, puede aumentar los lmites de la sesin actual con la siguiente Linux
comandos:
sudo ulimit -Hn 32768
o
sudo ulimit -Sn 32768
Los efectos de los comandos anteriores se pueden restablecer si se reinicia el equipo. Para hacer que los cambios sean
permanentes,
editar el archivo /etc/security/limits.conf aadir los siguientes ajustes:
* Nofile suave 32768
* Duro nofile 32768
raz nofile suave 32768
raz dura nofile 32768
* Memlock suave ilimitada
* Duro memlock ilimitada
raz memlock suave ilimitada
raz dura memlock ilimitada
* Suave ilimitada
* Disco ilimitado
raz suave ilimitada
raz dura ilimitada
4.6
Hadoop Hive-Fuentes de datos

A diferencia de las bases de datos tradicionales, Hadoop soporta grandes cantidades de datos, a menudo llamados los grandes
datos. Desde la versin 5.6.1,
JasperReports Server admite dos tipos de fuentes de datos que procesan las solicitudes a un cluster Hadoop:
CDH 5 Hive-Impala Fuente de datos - Si accede a Hadoop-Hive2 o Hadoop-Impala a travs de un Cloudera 5

servidor solamente.
JDBC Data Source con controlador JDBC Hive - La mayora de los otros Colmena Colmena 1, 2 y Impala servidores.
Dependiendo de si utiliza Colmena 1, 2 Hive, o Impala, hay ciertas restricciones en el acceso a datos en
Hadoop.
Fuentes de datos CDH 5 Hive-Impala tienen una latencia muy baja, y permiten la interactividad con Ad Hoc vistas, filtros y
cuadros de mando. Sin embargo, fuentes de datos Hadoop-Impala todava tienen las siguientes limitaciones:
Fuentes de datos CDH 5 Hive-Impala no son compatibles con las conexiones OLAP.
Fuentes de datos CDH 5 Colmena-impala no se pueden utilizar directamente en Dominios. Para utilizar Hadoop-Impala en
un dominio,
ver "Conectores Big Data para fuentes de datos virtuales" en la pgina 86.
Fuentes de datos CDH 5 Hive-Impala se pueden utilizar en temas ad hoc, pero no apoyan la consulta
optimizacin.
pgina 181).
El controlador JDBC para Colmena funciona mayora de los otros Colmena 1, colmena 2, y el servidor impala, y se puede
utilizar con
Dominios. Sin embargo, el servidor original Hive 1 tiene alta latencia con tiempos de acceso del orden de 30 segundos
78
Fuentes de datos Hadoop Hive-tienen ciertas limitaciones y directrices para su uso en JasperReports del servidor:
Fuentes de datos Hadoop Hive-no son adecuados para la creacin de informes de forma interactiva en el Editor Ad Hoc.
Los informes basados en Hadoop Hive-no son adecuados para cuadros de mando.
Los filtros y controles de entrada basados en consultas que se basan en fuentes de datos Hadoop Hive-sern lentos para
rellenar la
lista de opciones.
Usted debe configurar los lmites de consulta y tiempo de espera para manejar la latencia (vea "Ad Hoc Polticas de datos
para Big
Datos "en la pgina 181).
En general, los informes basados en JDBC-Hive fuentes de datos son los ms adecuados para ser ejecutado en el fondo
de la
repositorio. Para informes muy grandes, considere programar para que se ejecuten en la noche por lo que la salida est
disponible
inmediatamente
cuando
necesite
durante
el da.
Para crear una fuente
delodatos
JDBC
Hive, siga
el mismo procedimiento que en el "Orgenes de datos JDBC" en la
pgina 66.
Para crear una fuente de datos CDH 5 Hive-Impala:
2.
Datos
sugerida es
Orgenes de datos.
3.
En el campo Tipo, seleccione CDH 5 Hive-Impala origen de datos.

La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos Hadoop-Hive.
Figura 4-14 Hadoop-Hive datos fuente de la pgina
79
4.

La URL de JDBC depende de qu tipo de servidor que est utilizando:
5.
4.7
Hive 2:
jdbc: hive2: // <nombre de host>: 10001 / default
Impala:
jdbc: hive2: // <nombre de host>: 21050 /; auth = noSasl

repositorio.
Fuentes de datos MongoDB

MongoDB es una arquitectura de datos grande basado en el modelo NoSQL que no es ni relacional ni basada en SQL.
Jaspersoft ofrece un conector que permite a los informes para utilizar MongoDB como fuente de datos. Los informes
sobre la base de un
Fuente de datos MongoDB se puede utilizar como temas que permiten a los usuarios crear Ad Hoc vistas basndose en
los campos
devuelto por la consulta MongoDB.
Al igual que con todos los grandes almacenes de datos, fuentes de datos MongoDB tienen las siguientes limitaciones y
directrices de uso dentro
JasperReports del servidor:
Fuentes de datos MongoDB no son compatibles con las conexiones OLAP
Fuentes de datos MongoDB no se pueden utilizar directamente en Dominios. Para utilizar MongoDB en un dominio, consulte
"Big Data
Conectores para fuentes de datos virtuales "en la pgina 86.
Fuentes de datos MongoDB se pueden utilizar en temas ad hoc, pero no son compatibles con la optimizacin de consultas.
pgina 181).
Para crear una fuente de datos MongoDB:
2.
Datos
sugerida es
Orgenes de datos.
3.
En el campo Tipo, seleccione MongoDB origen de datos.

La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos MongoDB.
80
Figura 4-15 MongoDB datos fuente de la pgina

4.

El MongoDB URL tiene la forma: MongoDB: // <nombre de host>: 27017 / <base de datos>
5.
El esquema se utiliza slo si va a envolver la fuente de datos MongoDB en una fuente de datos virtual para su uso en un
Dominio. Para obtener instrucciones, consulte "Esquema relacional para MongoDB Connector" en la pgina 87.

repositorio.
MongoDB est diseado para acceder a travs de llamadas a la API en una aplicacin o un shell de comandos. Como
consecuencia, no tiene un lenguaje de consulta definido. Para escribir consultas para orgenes de datos MongoDB,
Jaspersoft ha desarrollado un lenguaje de consulta basado en los objetos JSON-como en los que opera MongoDB.
JSON es el JavaScript Object Notation, una representacin textual de las estructuras de datos que es a la vez humano-y
legible por mquina.
6.
El lenguaje de consulta Jaspersoft MongoDB es un lenguaje declarativo para especificar qu datos para recuperar de
MongoDB. El conector convierte esta consulta en las llamadas a la API apropiadas y utiliza el Java MongoDB
conector para consultar la instancia MongoDB. Los siguientes ejemplos dan una visin general de la Jaspersoft
MongoDB Query Language, con trminos-SQL equivalente entre parntesis:
Recuperar todos los documentos (filas) de la coleccin determinada

(tabla):
81
{'collectionName': 'cuentas'}
De todos los documentos de la coleccin dada, seleccione los campos denominados (columnas) y ordenar los
resultados:
{
'collectionName': 'cuentas',
'FindFields ": {" nombre ": 1," phone_office': 1, 'billing_address_city': 1,
'Billing_address_street': 1, 'billing_address_country ": 1},
'Tipo': {'billing_address_country': - 1, 'billing_address_city ": 1}
}
Recuperar slo los documentos (filas) de la coleccin determinada (tabla) que responden a la consulta (clusula where). En
este caso, la fecha es mayor que-o-igual al parmetro de entrada, y el nombre coincide con una cadena (comienza con
N):
{
'collectionName': 'cuentas',
'FindQuery ": {
'Status_date ": {" $ gte': $ P {StartDate}},
"Nombre": {"$ regex ':' ^ N ',' $ opciones ':' '}
}
}
El Jaspersoft MongoDB Lenguaje de consulta tambin soporta caractersticas avanzadas de MongoDB como mapa-reducir
funciones y agregacin que estn ms all del alcance de este documento. Para obtener ms informacin, consulte la idioma
referencia en el sitio web de la comunidad de Jaspersoft.
4.8
Fuentes de datos virtuales

Fuentes de datos virtuales tienen dos escenarios de uso:
Ellos le permiten combinar mltiples fuentes de datos JDBC y JNDI y ponerlos a disposicin a unir
a travs de un dominio. Usted puede combinar cualquier nmero de fuentes de datos, incluyendo esquemas de diferentes
bases de datos, bases de datos de diferentes fabricantes y diferentes esquemas dentro de la misma base de datos en un
solo
objeto.
Fuentes de datos virtuales tambin hacen fuentes Cassandra, Hadoop-Hive, y MongoDB datos disponibles en Dominios.
En este uso, la fuente de datos virtual acta como un contenedor para la fuente de datos para los datos grandes, con cierta
limitaciones descritas en "Conectores Big Data para fuentes de datos virtuales" en la pgina 86.
Una fuente de datos virtual puede envolver una sola fuente de datos para los datos grandes, o combinar cualquier nmero de
JDBC, JNDI y
fuentes de datos de datos grandes.
Una vez que haya creado una fuente de datos virtual, se crea un dominio que se une a las tablas a travs de las fuentes de
datos a
definir las relaciones entre los datos. Ad Hoc vistas e informes basados en el dominio pueden acceder a la
datos combinados de forma transparente. Para obtener ms informacin sobre los dominios, consulte el captulo "Creacin de
Dominios" en la
82
Figura 4-16 Datos Virtual Fuente Escenario

Cuando se combinan las fuentes de datos en un origen de datos virtual, selecciona un alias para cada fuente de datos se
incluye;
este alias se aade como prefijo para las tablas de la fuente de datos original para asegurar que los nombres de las tablas son
nicos
a travs de la fuente de datos virtual.
Para crear una fuente de datos virtual:
2.
Datos
sugerida es
Orgenes de datos.
3.
4.
En el campo Tipo, seleccione Datos Virtual Fuente.

Rellene los otros campos requeridos, junto con cualquier informacin opcional.
83
5.
6.
7.
Localice las fuentes de datos que desea utilizar en el panel Orgenes de datos disponibles. Haga doble clic en cada uno de
los datos que desee
fuente para seleccionarlo. El origen de datos se muestra en el panel Orgenes de datos seleccionado.
Cambiar los alias editando directamente en la columna Alias, si se desea. El alias se utiliza para identificar el
fuente de datos seleccionada dentro de la fuente de datos virtual; tambin se agrega como prefijo al nombre de cada tabla
en
esa fuente de datos. Los espacios son no permitido en alias.
Haga clic en Guardar. El origen de datos aparece en el repositorio.
La siguiente figura muestra los valores para crear una fuente de datos virtual mediante la combinacin de dos de las
bases de datos
incluido en los datos de ejemplo: la base de datos Foodmart y la base de datos de SugarCRM.
Figura 4-17 Creacin de un origen de datos virtual
Fuentes de datos virtuales no pueden utilizar el campo Zona horaria que pueda crearse en fuentes de datos individuales. Si
se utiliza en
una fuente de datos virtual, una fuente de datos de destino con una zona horaria no devolver los valores de fecha / hora
prevista.
Por lo tanto, Jaspersoft recomienda que no utiliza fuentes de datos con configuracin de zona horaria en un virtual
fuente de datos.
84
Puede editar una fuente de datos virtual para aadir o eliminar las fuentes de datos que utiliza. Si la fuente de datos virtual es
utilizado por
un dominio, puede agregar fuentes de datos, pero no puede eliminarlos. Extraccin de una fuente de datos a partir de una de
datos virtual
fuente modifica slo la fuente de datos virtual; la fuente de datos que ha extrado permanece en el repositorio.
Para editar una fuente de datos virtual:
2.
Haga clic en Ver> Repositorio y ampliar el rbol de carpetas para buscar la carpeta que contiene el origen de datos.
3.
4.
Haga clic en el origen de datos y seleccione Editar en el men contextual.

Para agregar un origen de datos, busque el origen de datos en el panel Orgenes de datos disponibles y haga doble
clic. Para
eliminar una fuente de datos, seleccione en el panel Orgenes de datos seleccionados y haga clic en la flecha
izquierda.
Haga clic en Guardar. Si usted est tratando de eliminar una fuente de datos a partir de una fuente de datos virtual que es
utilizado por un
Dominio, recibir una advertencia y el origen de datos no se modifica. De lo contrario, la fuente de datos se actualiza en
el repositorio.
5.
4.8.1
Consideraciones sobre el rendimiento

Fuentes de datos virtuales se basan en el motor Teiid manejar mltiples fuentes de datos y combinar los resultados de
ellos. Cmo disear las tablas en cada una de sus fuentes de datos y cmo se combinan en una unin lata de dominio
afectar significativamente el rendimiento.
Hay varias cuestiones a tener en cuenta al disear una solucin que combina varias bases de datos en un virtual
fuente de datos:
La fuente de datos virtual se ejecuta en JasperReports Server y debe asignar memoria y el uso de procesamiento para
manejar
conjuntos de resultados.
El motor Teiid utiliza su propio cache de datos accedidos a travs de una fuente de datos virtual. Puede borrar la Teiid
cach al mismo tiempo que la cach de Ad Hoc, como se describe en "Ad Hoc administracin del cach" en la pgina 184.
La fuente de datos virtual puede empujar hacia abajo ciertas operaciones (se une, filtros y agregaciones) a las bases de
datos,
otros se deben realizar en la memoria. Cuanto ms se puede empujar hacia abajo, el ms pequeo de los conjuntos de
datos que se debe manejar
en la memoria
Usted debe disear su esquema para que la mayor parte del procesamiento en la consulta puede ser empujado hasta el
base de datos, y de manera que la fuente de datos virtual maneja la menor cantidad de datos en una unin entre fuentes de
datos. si crea una copia duplicada de una tabla de dimensiones fecha en ambos de sus fuentes de datos, que pueden ser
Por ejemplo,
unido mucho ms eficiente. Si esta tabla exista en una sola base de datos, el motor Teiid necesitara para recuperar
todas las filas de la otra base de datos y realizar la unin en s. Con esta tabla en ambas bases de datos, la Teiid
motor puede empujar hacia abajo todo el tiempo-dimensin se une a las bases de datos individuales y llevar a cabo una final se
unen en
conjuntos de datos mucho menor.
Para obtener ms informacin acerca de la optimizacin de sus datos para su uso en Teiid, consulte
http://www.jboss.org/teiid/.
4.8.2
Inicio de sesin para orgenes de datos

virtuales
Si usted tiene problemas con sus conexiones de datos a travs de grandes fuentes de datos virtuales, puede habilitar el
registro en el
siguientes clases:
com.jaspersoft.jasperserver.api.common.virtualdatasourcequery.VirtualDataSourceQueryService
com.jaspersoft.jasperserver.api.engine.common.virtualdatasourcequery.teiid.TeiidEmbeddedServer
Para obtener informacin sobre cmo habilitar el registro, consulte "Configuracin de registros del
sistema" en la pgina 192.
85
4.9
Conectores grandes datos para los orgenes de datos

virtuales
A partir de JasperReports Servidor 5.6, las fuentes de datos virtuales tambin pueden conectarse a varios
sabores de grandes datos:
Cassandra
Hadoop Hive-1, 2, y Impala
MongoDB
Fuentes de datos virtuales utilizan el motor de consulta Teiid internamente para unirse a los datos de diversas fuentes, y para
el acceso
tiendas grandes de datos. En el caso de grandes datos, la fuente de datos virtual extrae la informacin de conexin de la
origen de datos existente y usa un conector Teiid interna para datos de acceso. Los conectores Teiid mapa los diversos
estructuras utilizadas en cada modelo de datos grande para un modelo relacional con tablas y campos. Este conector es
distinto
de lo que se llaman las fuentes de datos nativas para grandes datos. Por esta razn, cuando una fuente de datos para los
datos grande
envuelto
Los conectores
de de
Cassandra,
Hadoop,
MongoDB
y en
las fuentes
delas
datos
virtualeslimitaciones:
no soportan parmetros de consulta
en una fuente
datos virtual,
la fuente
de datos
resultante
tiene
siguientes
($ P y $ X). Por lo tanto, si utiliza un conector de datos grande envuelto en una fuente de datos virtual como el origen de
datos
para una consulta, informe independiente o tema, no se puede incluir parmetros para crear controles de entrada. Cuando
se utiliza en
Dominios y luego visitas ad hoc, puede definir filtros para reemplazar esta funcionalidad.
El conector de Cassandra para fuentes de datos virtuales no admite las funciones de agregacin.
El conector MongoDB para fuentes de datos virtuales no admite la operaciones de bsqueda, agregacin o mapa
reducir funciones que la fuente de datos MongoDB nativa permite.
El conector MongoDB para fuentes de datos virtuales no se puede utilizar en informes o temas independientes. Debe ser
utilizado en un dominio y se accede a travs de una vista especial o informe.

Sin embargo, hay ventajas significativas en el acceso a grandes volmenes de datos a travs de fuentes de
datos virtuales:
Cuando envuelto en una fuente de datos virtual, puede acceder a Cassandra, Hadoop, y MongoDB a travs de un
Dominio, Tema de dominio, Ad Hoc vista, y Ad Hoc informe.
Una fuente de datos virtual puede contener cualquier combinacin de JDBC, JNDI, y conectores de datos grandes. Cuando
se define un
Dominio usando esta fuente de datos, puede acceder a las tablas de cada tienda y definir combinaciones entre
campos compatibles.
Fuentes de datos virtuales que utilizan un gran conector de datos de optimizacin de consultas de soporte, a diferencia de
las fuentes de datos nativos

para grandes datos. De hecho, los grandes conectores de datos de fuentes de datos virtuales apoyan la optimizacin de
consultas en Ad Hoc
vistas e informes basados en temas independientes, y en visitas e informes ad hoc basados en dominios. El
campos nicas excepciones son calculados, los cuales no pueden ser optimizados cuando se utiliza en vistas o informes Ad
Hoc
que se basan en temas o dominios. Para obtener ms informacin acerca de la optimizacin de consultas, consulte Consulte
"Ad Hoc
ParaPolticas
obtener ms
informacin
acercadatos
de Teiid,
consulte
de datos
para grandes
"en la
pgina 181.
http://www.jboss.org/teiid/.
4.9.1
Crear Conectores Big Data

Para crear una fuente de datos virtual que tiene acceso a una fuente de datos para grandes datos:
1. Cree una fuente de datos nativa de datos grandes, o comprobar que se ha creado como se describe en una de las
siguientes
secciones:
"Fuentes de datos Cassandra" en la pgina 75
"Hadoop Hive-Fuentes de datos" en la pgina 78
"Fuentes de datos MongoDB" en la pgina 80

En el caso de una fuente de datos MongoDB, debe especificar el esquema de las tablas en las que los datos
ser asignada. Si no ha definido el esquema de tabla, puede modificar el origen de datos para agregar uno, pero
86
2.
3.
4.
4.9.2
debe reiniciar JasperReports Server despus de cualquier modificacin en el valor de esquema. Para
obtener ms
informacin, consulte "Esquema relacional para MongoDB Connector" en la pgina 87.
Crear una fuente de datos virtual como se describe en "Fuentes de datos virtuales" en la
pgina 82.
En el dilogo de creacin de fuente de datos virtual, seleccione la gran fuente de datos de datos que cre en el primer
paso,
y guardar la fuente de datos virtual. Puede seleccionar una o ms fuentes de datos grandes, o cualquier mezcla de datos
grandes,
Fuentes
datos JDBC
y JNDI.
Crear
unde
dominio,
especifique
el origen de datos virtual que acaba de crear, y luego seleccione las tablas grandes de datos
cuando
se crea el esquema de dominio. Los datos de la fuente de datos se asignan a tablas y campos en el dominio
que puede utilizar para crear une, filtros, y todas las dems caractersticas de un dominio.
Esquema relacional para MongoDB Conector

Este esquema define una estructura relacional de las tablas y columnas para los datos en la instancia MongoDB. El
siguiente URL da la sintaxis del texto de esquema:
https://docs.jboss.org/author/display/TEIID/MongoDB+Translator
El siguiente ejemplo muestra un documento de la coleccin denominada cliente en MongoDB con un
documento incrustado llamado Direccin. El lado derecho muestra el esquema correspondiente para uso en el de datos virtual
conector de fuente.
{
"_id": 10,
"Name": "John Doe",
"Edad": 27,
"Gnero": "macho",
"Direccin": {
"_id": 10,
"Calle": "123 de Sesame St.",
"Ciudad": "Ciudad X",
"Estado": "Rhode Island",
"Zip": 12.345
}
CREATE TABLE customer EXTERIOR (

_id entero PRIMARY KEY,
nombre varchar (255),
nmero entero edad,
varchar de gnero (50))
OPCIONES (ACTUALIZABLE 'TRUE');
CREAR direccin MESA EXTERIOR (
_id entero PRIMARY KEY,
varchar calle (255),
varchar ciudad (100),
varchar estado (25),
Entero postal,
FOREIGN KEY (_id) Referencias de clientes (_id),)
OPCIONES (actualizable 'True',
teiid_mongo: MERGE "cliente");
Al escribir su esquema, tenga en cuenta las siguientes cuestiones:
Para las relaciones incrustadas en MongoDB (ambos 1-a-1 y-1-a-muchos), el documento incrustado debe tener la
mismo ID que el documento principal.
El traductor MongoDB admite la asignacin automtica de tipos de datos Teiid en tipos de datos MongoDB.
No se admiten todos los tipos de datos MongoDB. Actualmente, los siguientes tipos no son compatibles:
MongoDB Arrays
MongoDB :: OID
Expresiones regulares
MongoDB :: Cdigo
MongoDB :: Minkey y MongoDB :: MaxKey
Como resultado, sus documentos deben utilizar identificadores enteros y no MongoDB :: OID.
Cuando se cambia el mapeo o aadir una nueva coleccin en el esquema, debe reiniciar JasperReports
Server.
87
4.10 Fuentes de datos de frijol

El tipo de fuente de datos de frijol es una extensin clave, ya que le permite hacer uso de las costumbres o los datos extica
que es posible que tenga que informar. Fuentes de datos de frijol sirven como puente entre un grano y una primavera-definido
JasperReport. El frijol de primavera es responsable de proporcionar los datos o parmetros que llenan el informe.
Para utilizar un origen de datos de frijol, primero debe configurar el frijol de primavera subyacente y ponerla a disposicin en
el
contexto de la aplicacin web del servidor. Por ejemplo, debe agregar una definicin de frijol a uno de los WEBINF / ApplicationContext * Xml.
El frijol se debe resolver en un ReportDataSourceService ejemplo, ya sea directamente o por medio de una fbrica nomtodo argumento. Se puede utilizar cualquier mtodo de instancias primavera (por ejemplo, un constructor o de la fbrica) y
frijol
alcance (por ejemplo, singleton o prototipo) para el frijol servicio de origen de datos.
El ReportDataSourceService instancia es responsable de suministrar parmetros de la fuente de datos para la
JasperReport. Custom ReportDataSourceService implementaciones pueden seguir dos enfoques:
Si la implementacin puede proporcionar los datos que se utiliza para llenar un informe, que necesita para envolver los
datos en una
adecuado JRDataSource aplicacin y pasar los datos utilizando el REPORT_DATA_SOURCE informe
parmetro.
Si los datos proceden de la consulta de informe por medio de un ejecutor de consultas JasperReports, el servicio de fuente
de datos
debe establecer los valores de los parmetros de conexin definidos por el ejecutor de consultas. Los parmetros de
conexin son
generalmente
a partir
de las propiedades
instancia
de servicio
de fuente
datos.en una fbrica de
Por ejemplo,
usted obtenido
podra poner
en prctica
un servicio de
de la
fuente
de datos
Hibernate
que sede
inyecta
sesiones.
La fbrica creara una sesin de Hibernate que se pasa como un valor para la HIBERNATE_SESSION
parmetro. El ejecutor de consultas JasperReports Hibernate utiliza entonces el parmetro para ejecutar el informe de
consultas
HQL.
El ReportDataSourceService
interfaz contiene dos mtodos: setReportParameterValues y
closeConnection. El primero proporciona valores de los datos y parmetros de conexin; este ltimo se requiere para cerrar
y liberar los recursos o conexiones creadas durante la llamada a setReportParameterValues.
Una vez que el grano de servicio de origen de datos est disponible a travs de la primavera, se puede aadir la fuente
de datos de frijol a la
repositorio.
Para crear una fuente de datos de frijol:
3.
Datos
sugerida es
Orgenes de datos.
Aparece la pgina de nuevo origen de datos, como se muestra en la siguiente
figura.
En el campo Tipo, seleccione Frijol de origen de datos.
4.
La informacin en la pgina cambia para reflejar lo que se necesita para definir una fuente de datos de
frijol.
5.
Si el servicio de fuente de datos es que se crea una instancia a travs de un mtodo de fbrica del grano de primavera,
usted debe tambin
introduzca el nombre del mtodo.
Haga clic en Prueba de conexin para validar la fuente de datos.
2.
Si la validacin falla, asegrese de que los valores que ha entrado no son correctos y que el grano est en la ruta de
clases.
88
6.
Cuando la prueba es correcta, haga clic en

Guardar.
Figura 4-18 Frijol datos fuente de la pgina
89
90
CAPTULO 5 OTROS RECURSOS EN LA

GUARDAMUEBLES
El captulo anterior present fuentes de datos que son necesarios para crear cualquier informe. Pero tambin el repositorio
tiendas a otros recursos que son necesarios para los informes. En este captulo se entra en detalles sobre cmo crear consultas,
de entrada
controles y recursos de archivo. Estos son los recursos que los usuarios hacen referencia al cargar un archivo JRXML para crear
un JasperReport.
Hay dos escenarios para la administracin de JasperReports Server, dependiendo de cmo los usuarios finales crear y
consumir informes.
Si tiene usuarios que son competentes en la creacin de sus propios informes en Jaspersoft Studio o iReport, que pueden
subirlos como JasperReports al servidor. En este caso, los administradores deben trabajar con los usuarios para preparar
la
recursos requeridos por sus informes.
En el segundo escenario, los administradores crear y subir JasperReports al servidor para su menos tcnico
usuarios. Administradores todava tienen que definir todos los recursos para los informes que solicitan sus usuarios.
5.1
Consultas
Tipos de datos
Listas de valores
Controles de entrada
Los controles de entrada basados en
consultas
Cascading Controles de entrada
De recursos de archivo
Consultas
JRXML informa utilizar una consulta para seleccionar los datos que deben volver de la fuente de datos. La consulta se puede
definir en
la propia JRXML, o se puede guardar en el repositorio. Una consulta en el repositorio puede ser re-utilizado por mltiples
JasperReports. Ver las consultas de ejemplo en la carpeta / Supermart Demo / Comn en el repositorio.
La reutilizacin de una consulta le permite adaptar los informes a los diferentes pblicos. La consulta devuelve los mismos
datos de la
misma fuente de datos cada vez, pero cada informe presenta los datos de una manera diferente. La reutilizacin de un
simplifica la consulta
mantenimiento de los informes, as, ya que todos los informes devuelven los mismos datos. Adems, la separacin de la
consulta de la
91
JRXML hace que sea ms fcil de mantener un gran nmero de informes cuando se cambia la fuente de los datos y las
necesidades de consulta
ser actualizado.
Consulte la Gua del usuario del servidor JasperReports para obtener instrucciones completas sobre cmo usar informes
JRXML. Por otro medio
de adaptar los informes a diferentes audiencias, consulte el captulo de Dominios en ese manual.
Recursos de consulta tambin se pueden utilizar para rellenar los controles de lista de entrada, como se describe en "Los
controles de entrada basados en consultas"
en la pgina 99 y "Cascading Controles de entrada" en la pgina 105.
Para crear un recurso de consulta reutilizable:
1. sesin como administrador.
2.
Haga clic en Ver> Repositorio y ampliar el rbol de carpetas para localizar la carpeta en la que desea crear la
consulta. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.
3.
Haga clic derecho en la carpeta y seleccione Agregar recurso> Consulta en el men contextual.
Aparece la pgina Agregar consulta.
Figura 5-1 Agregar consulta - Nombre de la pgina de consulta

4.
92
Introduzca un nombre y una descripcin opcional para la consulta y haga clic en Siguiente. El identificador de
recurso se rellena
automticamente.
El enlace aparece una pgina de origen de datos.
Figura 5-2 Aadir Consulta - Link a Pgina de orgenes de datos

5.
Seleccione el origen de datos y haga clic en Siguiente. Para este ejemplo, deje el valor predeterminado, pero otras
opciones se presentan:
No vincular un origen de datos. Si no hay ninguna fuente de datos se asocia con la consulta, el servidor utiliza los
datos
fuente que est asociado con el informe que hace referencia a esta consulta.
Crear un nuevo origen de datos. Puede definir una fuente de datos local dentro de este recurso de consulta que no es
accesible a cualquier otro recurso. Esta nueva fuente de datos invalida cualquier origen de datos especificado en los
informes
que utilice esta consulta.
Seleccione la fuente de datos del repositorio. Esto crea una referencia a un origen de datos en el repositorio. El
fuente de datos que seleccione anula cualquier origen de datos especificado en los informes que utilizan esta
consulta.
Despus de hacer clic A continuacin, Definir el que aparezca la
pgina de consultas.
Figura 5-3 Agregar consulta - Definir la pgina de consulta

6.
7.
Seleccione SQL como el lenguaje de consulta.

El lenguaje de consulta de dominio (sl) se selecciona al abrir consultas basadas en dominio creado en versiones de la
servidor anteriores a la 3.7. Se utiliza slo para compatibilidad con versiones anteriores y no se debe elegir para el nuevo
de Dominio
consultas basadas.
Introduzca la siguiente prueba en el Cadena de consulta
campo:
93
* SELECT FROM pedidos
8.
Haga clic en Guardar.
De forma predeterminada, JasperReports Server soporta SQL, HQL (Hibernate), HiveQL (Hadoop-Hive), MongoDB, y
Consultas de dominio, mientras que JasperReports apoya varios ms (como EJBQL, xPath y MDX). Sin embargo,
JasperReports Server se admite consultas en lenguajes de consulta adicionales si hay una consulta configurado
correctamenteaplicacin albacea para cada idioma adicional cuando se despliega el servidor.
Una fuente de datos de frijol especializado puede ser utilizado para soportar mltiples lenguajes de consulta. Para obtener
informacin acerca de frijol
fuentes de datos, se refieren a "Fuentes de datos de frijol" en la pgina 88. Otra opcin es aadir nuevos tipos de fuentes de
datos para
el servidor, para as ampliar el alcance de la plataforma JasperReports servidor mediante el aprovechamiento de una de su
extensin principal
puntos. Fuentes de datos personalizada se describen en la Ultimate Guide servidor JasperReports.
5.2
Tipos de datos
Los tipos de datos son recursos que definen el formato de un control de entrada de un solo valor, por ejemplo texto o numrico
valor. El tipo de datos determina qu usuarios pueden introducir en el campo de texto para que se corresponda con el tipo de la
parmetro en el informe. Adems, el tipo de datos puede restringir el valor, por ejemplo el establecimiento de un rango para un
nmero
o la fecha, o la aplicacin de un patrn, como una direccin de correo electrnico en las cadenas. Todo esto se controla a travs
del tipo de datos
asociado con el control de entrada.
Los tipos de datos pueden representar uno de cuatro
tipos:
Texto
Nmero
Fecha
Fecha / hora
Para crear un recurso de tipo de datos:

2.
tipo de datos. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.
3.
Haga clic derecho en la carpeta y seleccione Agregar recurso> tipo de datos en el men contextual.
Aparece la pgina Agregar tipo de datos.
94
Figura 5-4 Aadir Datatype Pgina

4.
5.
Escriba un nombre y una descripcin opcional para el tipo de datos. El identificador de recurso se rellena
automticamente.
Seleccionar el tipo de el tipo de datos, as como informacin relacionada con el tipo.
En este ejemplo, seleccione Texto como el tipo de nuestro tipo de datos; usted tiene otras opciones
tambin:
Texto - Para los tipos de datos de texto, se puede especificar una expresin regular en el Patrn campo. La expresin
es
utilizado para validar el texto que el usuario enva. Por ejemplo, puede introducir una expresin que pone a prueba para
direcciones de correo electrnico.
Nmero - Con los tipos de datos numricos, se puede controlar el rango de valores aceptables especificando
los valores mnimo y mximo, y si los valores especificados son ellos mismos aceptable (mnimo
es estricta / mxima es de estricta casillas de verificacin). Si un Estricto casilla de verificacin est seleccionada, el
valor especificado es no
aceptable.
Por ejemplo, para un campo por ciento, es posible especificar un mnimo de 0y un mximo de 100. Si lo hace
No quieren aceptar el 0 por ciento, que le echa Mnimo es estricta. Si desea aceptar el 100 por ciento,
usted desea borrar Mximo es estricta.
6.
Fecha y Fecha / Hora - Para estos tipos de datos, hay un widget de calendario en el que se puede seleccionar el
valores mnimos y mximos y para asegurarse de que la fecha configurada y fecha / hora deseada formatos son
utilizado. Para utilizar el calendario, haga clic en el icono de calendario.
Cuando haya definido las propiedades de su tipo de datos, haga clic en Guardar. El recurso de tipo de datos aparece en la
repositorio.
En este ejemplo se crea un tipo de datos muy bsicos para cualquier tipo de
entrada de texto.
5.3
Listas de valores
Lista de valores son los recursos que definen una lista esttica de valores para los controles de entrada de seleccin nica o de
seleccin mltiple. Para
cada seleccin en la lista, la lista define una etiqueta se presenta al usuario y el valor pasado al informe cuando
carreras. Dependiendo del tipo de control de entrada, el usuario final selecciona una o ms de estas etiquetas como botones de
radio,
casillas de verificacin, o listas desplegables.
95
Para crear una lista de valores de recursos:

2.
lista de valores. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.
3.
Haga clic derecho en la carpeta y seleccione Aadir recursos> Lista de valores en el men contextual.
Aparece la pgina Agregar lista de valores.
Figura 5-5 Aadir Lista de valores Pgina

4.
5.
6.
5.4
Escriba un nombre y una descripcin opcional para el tipo de datos. El identificador de recurso se rellena
automticamente.
Introduzca el nombre y el valor de cada elemento de la lista y haga clic en
Aadir.
El nombre y el valor son a la vez tratan como cadenas. Los usuarios slo ven la etiqueta en un control de entrada que
utiliza el
lista, y el informe slo recibe el valor. Para eliminar un elemento, haga clic en Eliminar al lado de su valor.
Cuando haya definido todos los valores de la lista, haga clic en Enviar. La lista de valores de recursos aparece en el
repositorio.
Controles de entrada
Cualquier JasperReport se puede parametrizar de manera que su salida generada es una funcin de los valores dado en
tiempo de ejecucin
(filtros de consulta), ms o menos que su trazado se cambia para adaptarse a diferentes usuarios (tales como el cambio del
ttulo).
Al escribir JRXML, se puede declarar parmetros y dar cabida a cualquier valor de tiempo de ejecucin que necesita ser
superado
en el ejecutor de consultas, el motor de renderizado, o el motor de clculo. Sin embargo, la informacin de parmetros en
un archivo JRXML no proporciona todo JasperReports Server necesita para construir una interfaz de usuario completa y
solicitan a los usuarios los valores. Tambin debe definir un recurso de control de entrada que define lo siguiente:
El rango de valores posibles o la lista de valores discretos que se permiten.
El tipo de entrada, por ejemplo de seleccin nica o mltiple de seleccin, y el widget para mostrar los valores posibles,
por ejemplo, en la lista desplegable o casillas de verificacin.
Se requiere opciones de visualizacin, como etiquetas y si el valor.
El nombre del parmetro correspondiente en el JRXML.
96
Cuando un usuario ejecuta el informe, el servidor utiliza la informacin anterior para solicitar al usuario que introduzca un valor y
validar la entrada. Por ejemplo, considere un informe que devuelve los datos de ventas de todos los productos de la empresa; el
usuario
puede introducir el nombre de un producto para ver al seleccionar el nombre del producto en la lista.
JasperReports Server es compatible con varios tipos de controles de entrada, cada uno de los cuales puede asignar a ciertos
tipos de
parmetros en JRXML del informe. El control de entrada tambin determina el tipo de control que el usuario interacta con:
Boolean - Representada como una casilla de verificacin. Estos controles de entrada devuelven un java.lang.Boolean oponerse
a la
reportar el motor en respuesta a la seleccin del usuario. Controles de entrada booleanas devuelven Boolean.TRUE o
Boolean.FALSE como valores, dependiendo de si la casilla est marcada.
Valor nico - Se representa como un cuadro de texto de forma libre. Debe especificar un tipo de datos, por ejemplo, texto o
valor numrico, y la entrada del usuario se valida en contra de este tipo de datos.
Single-select - Representada como una lista desplegable o un conjunto de botones de radio. Un control de entrada de
seleccin nica
devuelve un solo valor.
Seleccin mltiple - Representada como una lista de valores (desplazables) o un conjunto de casillas de verificacin. A la
entrada de seleccin mltiple

el control devuelve una coleccin de valores.
Una caracterstica avanzada de los controles de entrada de seleccin nica o de seleccin mltiple es que los valores que se
presentan pueden ser el
resultado de una consulta dinmica. La consulta recupera los valores reales de la fuente de datos antes de presentarlos como
opciones para el usuario. Estas consultas pueden contenerse parmetros, por ejemplo basados en el usuario que ha iniciado
sesin en o
la seleccin de un control de entrada anterior. Los parmetros de consulta se describen en el ltimo servidor JasperReports
Gua.
Los controles de entrada se basan en otros recursos en el repositorio, como tipos de datos, listas estticas de valores, o
consultas. Usted
puede gestionar estos recursos de la misma manera a manejar otros recursos; puede definir localmente (disponible
slo para el control de entrada) o hacer referencia a ellos externamente (la reutilizacin de un recurso en el repositorio). Para
obtener ms
informacin, consulte "Recursos Locales y referencias externas" en la pgina 47.
Ad Hoc vistas basan en Dominios y Temas de dominio siempre utilizan los controles de entrada definidos localmente que son
creado automticamente en funcin de los filtros elegidos. Ellos no pueden hacer referencia a controles de entrada
almacenados en la
repositorio, y no se debe modificar. Para obtener ms informacin, consulte la JasperReports usuario del servidor
Gua.
Algunos controles de entrada se basan en consultas para poblar sus opciones. Estos controles ms complejos se describen
en "Los controles de entrada basados en consultas" en la pgina 99.
El recurso de control de entrada determina el funcionamiento de control de entrada y aparece. Al igual que con otros recursos,
controles de entrada pueden ser creados localmente como parte de una JasperReport, en cuyo caso no se pueden ver fuera de
la
JasperReport, o que se puede crear por separado en el repositorio y se hace referencia en varios informes.
Para utilizar un control de entrada en un informe, el control debe cumplir con dos
condiciones:
El nombre del parmetro en el control de entrada debe coincidir con el nombre del parmetro en el informe. No
error se produce si hay una falta de coincidencia en los nombres, pero en tiempo de ejecucin, NULL se pasa como el valor
de la
parmetro en lugar de los valores reales.
El control de entrada y su parmetro correspondiente deben ser de tipos de datos compatibles (por ejemplo, ambos deben
ser del tipo de texto o tipos de fecha). Si hay una discrepancia, el informe falla y se devuelve una excepcin.
En esta seccin se explica cmo crear un recurso de control de entrada en el repositorio. Para hacer referencia a controles de
entrada en una
JasperReport, ver la Gua del usuario de JasperReports Server.
Para crear un recurso de control de entrada:
97
2.
control de entrada. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.
3.
Haga clic derecho en la carpeta y seleccione Agregar recurso> Control de entrada en el men contextual.
Aparece la pgina Agregar control de entrada.
Figura 5-6 Agregar control de entrada Page

4.
5.
Seleccione el tipo de control de entrada de la Tipo lista.

En este ejemplo, seleccione Valor nico.
Ingrese el mensaje para mostrar a los usuarios que explican cmo utilizar el control.
Para este ejemplo, utilice el smbolo Seleccione el texto para el ttulo del informe.
6.
En la prctica, el texto del mensaje suele ser el mismo que el parmetro, por lo que el nombre del parmetro es
automticamente llenado
en el texto del mensaje. Si ha utilizado un indicador diferente, seleccione el nombre automtico y reemplazarlo withe
el nombre exacto del parmetro asociado con el control. Recuerde, el nombre del parmetro debe ser el
igual que en los informes que utilizan este control de entrada.
Para este ejemplo, el nombre del parmetro es ttulo. La descripcin es opcional.
7.
Seleccione las opciones para el control.

En este ejemplo, seleccione Obligatorio y Visible; usted tiene otras opciones tambin:
Obligatorio - Obliga al usuario final para proporcionar un valor.
Slo lectura - Muestra el valor del parmetro sin permitir que el usuario final para modificarlo.
Visible - Hace que el control de entrada visible en el dilogo de opciones de informe.
Haga clic en Siguiente.
8.
Las pginas subsiguientes dependen del tipo de control de entrada que eligi
anteriormente:
Tipos de Boole no requieren ms informacin.
Los de una valor requieren un recurso de tipo de datos para caracterizar lo que el usuario puede
introducir.
Tipos de seleccin nica y de seleccin mltiple basados en listas estticas requieren una lista de los
valores de los recursos.
98
9.
Tipos de seleccin nica y de seleccin mltiple basados en consultas requieren un recurso de consulta.
En este ejemplo de un solo valor, aparece la pgina Ubicar tipo de datos. Elija la opcin de seleccionar un tipo de datos de
el repositorio y haga clic en Examinar. Desde el dilogo de repositorio que aparece, seleccione
/ Tipos de datos / TextGeneralDatatype, Que es similar al tipo de datos que hemos creado en "Tipos de datos" en la
pgina 94.
Si usted elige para definir un tipo de datos, el asistente le guiar a travs del mismo procedimiento que en el
seccin "Tipos de datos" en la pgina 94. A continuacin, puede definir cualquier tipo de datos que necesita, pero es
local a la
el control de entrada y no reutilizable en otros controles de entrada.
Figura 5.7 Localizar un tipo de datos para un control de entrada

10. Click Siguiente. El recurso de control de entrada se crea en el repositorio.
11 Localice el control de entrada en el administrador de repositorio. Observe que el texto de la solicitud que introdujo en
paso 5 tambin se utiliza como el nombre para el recurso.
5.5
Los controles de entrada basados en

consultas
Controles de entrada basados en consultas muestran un conjunto dinmico de valores para el usuario para elegir. Son de
control de entrada
recursos en el repositorio, pero en lugar de estar basado en un tipo de datos o una lista esttica de valores, realizan un
consulta para recuperar una lista de valores. Por ejemplo, un informe podra tener un parmetro de la ciudad, y la entrada
basado en consultas
control podra mostrar la lista de ciudades que existen en los datos. Debido a que las consultas utilizan la sintaxis estndar,
puede
incluir filtros en una clusula WHERE. En el ejemplo anterior, podra limitar la lista de ciudades en cierta
pas.
5.5.1
Crear un control de entrada basado en consultas

En este primer ejemplo, se crea un control de entrada basado en la consulta que devuelve una lista de todas las ciudades para
que el usuario elija
desde.
2.
Explorar el repositorio y seleccione la carpeta donde desea crear el control de entrada basado en consultas.
3.
Haga clic derecho en la carpeta y seleccione Agregar recurso> Control de entrada. Aparecer el cuadro de dilogo Agregar
control de entrada:
99
Figura 5-8 Adicin de un control de entrada - Nombrando

4.
5.
6.
Seleccione el tipo de control de entrada basado en consultas de la lista desplegable Tipo. Esta eleccin determina cmo el
control de entrada muestra a los usuarios, ya sea en forma de lista desplegable, un conjunto de botones de radio, una lista
de seleccin mltiple, o un conjunto de
casillas de verificacin. En este ejemplo, elegimos una seleccin nica de control de entrada basado en consultas.
Especifique el texto del mensaje, nombre de parmetro, descripcin opcional y opciones de apariencia de la misma
manera
como en la definicin de un control de entrada regular.
Haga clic en Siguiente. Debido a que hemos seleccionado uno de los tipos basados en consultas, aparece la
pgina Ubicar Consulta:
Figura 5-9 Adicin de un control de entrada - Localizacin de la consulta
7.
100
Si usted tiene un recurso de consulta adecuados definidos en el repositorio, puede seleccionarlo aqu como externa
referencia. En este ejemplo, vamos a definir un recurso de consulta a nivel local dentro del recurso de control de
entrada.
Haga clic en Siguiente para definir la consulta de recursos local. Aparecer el cuadro de
dilogo de nombres consulta:
Figura 5-10 Adicin de un control de entrada - Nombrar la consulta

Aunque el recurso de consulta no es visible en el repositorio, todava puede tener un nombre, ID y opcional
Descripcin de recursos dentro de la consulta. Sin embargo, los valores de estos campos no son importantes.
8.
Introduzca el nombre y el ID se rellena automticamente. Luego haga clic en Siguiente. Aparece la pgina de enlace de la
fuente de datos:
Figura 5-11 Adicin de un control de entrada - Vinculacin a un origen de datos
9.
Al igual que con todos los recursos de consulta, el recurso de consulta dentro del control de entrada puede,
opcionalmente, un enlace a los datos
fuente, ya sea en el repositorio, o su propio definido internamente. Si est vinculado ninguna fuente de datos, la consulta
en
el control de entrada utiliza la misma fuente de datos para el informe. En este ejemplo, tomamos la seleccin por defecto
de
no clic en Siguiente. Aparecer la pgina de definicin
Haga
vincular
a una fuente de datos.
de la consulta:
101
Figura 5-12 Adicin de un control de entrada - Definicin de la consulta

10. Seleccione el lenguaje de consulta, en este ejemplo de SQL, e introduzca una cadena de consulta. La instruccin SELECT
debe
contendr los nombres de todos los campos que se utilizan en la pantalla, el valor, o un filtro para el control de entrada. En
este ejemplo, la
consulta devuelve tres campos, pas, estado y ciudad, y el campo de pas se utiliza para limitar los valores a un
solo pas. La clusula ORDER BY se asegura de que los valores de la consulta se ordenan alfabticamente
cuando aparecen en el control de entrada.
Para ver un ejemplo de un lenguaje de consulta diferente, consulte "Las consultas basadas en el
dominio" en la pgina 104.
11 Haga clic en Guardar para completar la definicin de consulta. Aparece la pgina de valores de
parmetros:
Figura 5-13 Adicin de un control de entrada - Configuracin de los valores de los

parmetros
En la pgina de valores de los parmetros, se define qu campo en los resultados de la consulta se muestran, y que
campo contiene valores que se convierten en el valor del parmetro cuando elegido.
a.
102
En primer lugar, especifique la columna de valor, que es el campo cuyo valor se pasa al informe. El tipo de datos de
el campo debe coincidir con el tipo del parmetro correspondiente en el informe.
b.
A continuacin, especifique las columnas visibles, que son los campos cuyos valores aparecen en el control de entrada
que
el usuario elige entre. En el caso ms simple, introduzca mismo campo que la columna de valor. Si agrega mltiples
campos a las columnas visibles, el control de entrada muestra los campos juntos, en el orden indicado, separados
por una barra vertical (|). En este ejemplo, el usuario puede ver y elegir entre:
Los Angeles | CA
San Francisco | CA
Denver | CO
Slo el valor de la ciudad (sin el Estado) se pasa al informe. Mostrando campo adicional de esta manera puede
ayudan a los usuarios a encontrar el valor que quieren en largas listas de resultados.
Las columnas de valores y de visualizacin tambin puede ser totalmente diferente, por ejemplo, mostrar el nombre
completo de
un representante de ventas, pero el uso de la identificacin de empleado como el valor devuelto por el control de
entrada. El nico
restriccin es que todos los campos que se utilizan en la lista de valores o exhibicin deben ser seleccionados por la
consulta.
5.5.2
Parmetros incorporadas para controles de entrada basados en

consultas
El LoggedInUser y LoggedInUserName parmetros estn siempre disponibles para los controles de entrada de consultas; Ellos son
siempre disponible para los informes, as, incluso si un control de entrada no est definido para ellos. Los parmetros estndar
son
Tambin estableca que los informes si se definen como parmetros en la JRXML.
Tabla 5-1 Parmetros incorporadas para controles de entrada basados en consultas
Nombre del parmetro
Tipo
Notas
LoggedInUser
Usuario
El usuario que ha iniciado sesin. Este parmetro no est

disponible en controles de entrada de consulta, pero se utiliza como un
parmetro en el informe.
LoggedInUserName
Cadena
El nombre de usuario del usuario actual.
LoggedInUserFullName
Cadena
El nombre completo del usuario actual.
LoggedInUserEmail
Direccin
Cadena
La direccin de correo electrnico del usuario

actual.
LoggedInUserEnabled
Boolean
Indica si el usuario actual est habilitada.
LoggedInUserExternally
Definido
Boolean
Indica si el usuario actual est autenticado

externamente.
LoggedInUserTenantId
Cadena
En las ediciones comerciales, el nombre de la organizacin

del usuario actual.
LoggedInUserRoles
Coleccin
<String>
Las funciones asignadas al usuario actual. Esto es til para

parmetros que utilizan $ X.
103
Nombre del parmetro
Tipo
Notas
LoggedInUserAttributes
Mapa <String,
String>
Los atributos de perfil del usuario conectado. Este

parmetro no es utilizable en los controles de entrada de consulta,
pero es
utilizado como un parmetro para el informe. Si el usuario no tiene
atributos, el parmetro es un mapa vaco.
LoggedInUserAttribute
Nombres
Coleccin
<String>
Los nombres de los atributos del perfil del usuario conectado.

Esto es til para los parmetros que utilizan $ X. Si el usuario tiene
sin atributos, el parmetro es un mapa vaco.
LoggedInUserAttribute
Valores
Coleccin
<String>
Los valores de los atributos del perfil del usuario conectado.

Esto es til para los parmetros que utilizan $ X. Si el usuario tiene
sin atributos, el parmetro es un mapa vaco.
LoggedInUserAttribute_
<Atributo-name>
Cadena
Para el usuario que ha iniciado sesin en, el valor del atributo a juego
el nombre pasa como <Atributo-name> (Como ATT1). Si
no hay ninguna coincidencia, el parmetro est vaca.
Este parmetro slo est disponible si se ha definido en una consulta
o como un parmetro de informe.
5.5.3
Las consultas basadas en el

dominio
En el caso de informes que utilice un dominio como origen de datos (opcin disponible en la edicin profesional de
JasperReports Server), los controles de entrada basados en consultas debe contener una consulta en el dominio. Al definir
la consulta como se muestra en Figura 5-12 en la pgina 102, establecer el lenguaje de consulta para Dominio.
El lenguaje de consulta Dominio ("SL") se selecciona al abrir consultas basadas en dominio creado en
JasperServer 3.5 o anterior. Se utiliza slo para compatibilidad con versiones anteriores y no se debe elegir para el nuevo
Consultas basadas en dominio.
Consultas de dominio tienen su propia sintaxis especial, la misma que se utiliza en el diseo de dominio. Basado en el dominio A
consulta hace referencia a campos, llamados elementos, por sus identificaciones de elemento, junto con cualquier ID de
conjuntos que determinan el camino de la
artculo dentro del dominio. Por ejemplo, si desea que su control de entrada de consulta para devolver una lista de tiendas
ciudades, donde
el campo con ID ej_store_store_city se anida en el set con ID expense_join_store, Utilizara la
consulta siguiente dominio:
<Consulta>
<QueryFields>
<QUERYFIELD id = "expense_join_store.ej_store_store_city" />
</ QueryFields>
</ Query>
La lista que figura en el interior del <QueryFields> etiqueta en una consulta de dominio es equivalente a los campos indicados
en la
Sentencia SELECT de una consulta SQL. Ante la consulta anterior, puede crear un control de entrada para una de Dominio
informe basado que permite al usuario seleccionar una ciudad como parmetro para el informe.
A veces, es posible que desee el control de entrada para mostrar ms informacin de la que el valor real devuelto. Al igual que
con
controles de entrada estndar basados en consultas, puede seleccionar varios campos, y luego mostrar los campos de su
entrada
104
control. Por ejemplo, para hacer la lista de las ciudades sin ambigedades, puede incluir el estado y el pas en su
pantalla. En ese caso, la consulta basado en el dominio tambin debe recuperar esos artculos:
<Consulta>
<QueryFields>
<QUERYFIELD id = "expense_join_store.ej_store_store_state" />
<QUERYFIELD id = "expense_join_store.ej_store_store_country" />
</ QueryFields>
</ Query>
Entonces, al especificar sus columnas de la consulta visibles, como se muestra en "El pas de los controles de entrada" en la
pgina 109, deber aadir los 3 campos a la lista en el orden que desea que aparezcan. Al especificar los campos
en la lista de columnas de la consulta visibles, utilizar toda la ID del campo, incluyendo cualquier ID de conjuntos. Por ejemplo,
la
lista de los campos siguientes:
expense_join_store.ej_store_store_country
expense_join_store.ej_store_store_state
expense_join_store.ej_store_store_city
crea una lista de valores como el siguiente para los usuarios a elegir (el separador | se aade automticamente):
EE.UU.
| CA | Los Angeles
EE.UU.
| CA | San Francisco
EE.UU.
| OR | Portland
EE.UU.
| WA | Redmond
Por ltimo, la consulta basado en el dominio tambin tiene la opcin de filtrar los resultados de la consulta, como se
muestra en la siguiente
ejemplo:
<Consulta>
<QueryFields>
<QUERYFIELD id = "expense_join_store.ej_store_store_country" />
<QUERYFIELD id = "expense_join_store.ej_store_store_state" />
</ QueryFields>
<QueryFilterString> expense_join_store.ej_store_store_country == 'EE.UU.' y
expense_join_store.ej_store_store_state == 'CA'
</ QueryFilterString>
</ Query>
El <QueryFilterString> etiqueta contiene una expresin Domel (Expresin de dominio de idiomas) que las referencias
la ID completa de los campos, incluyendo cualquier ID de conjuntos. Para obtener ms informacin acerca de Domel, consulte
la JasperReports
Gua del usuario de Server. El <QueryFilterString> etiqueta en una consulta de dominio es equivalente a la clusula WHERE de
una consulta SQL. La lista de campos de la <QueryFields> etiqueta debe incluir todos los campos que se hace referencia en el
filtro
cadena.
5.6
Cascading Controles de entrada

Un control de entrada en cascada es uno cuyos valores dependen de la seleccin realizada en un control de entrada anterior.
Controles de entrada en cascada se crean mediante el uso de parmetros en la cadena de consulta de un control de entrada
relacionada. En otra
palabras, el parmetro definido por un control de entrada se pueden utilizar en otro control de entrada basado en consultas.
En el ejemplo basado en consultas de las ciudades y estados como:
105
Los Angeles | CA
San Francisco | CA
Denver | CO
la consulta todava puede generar una lista de cientos de ciudades para recorrer. A pesar de que cada ciudad es fcil de
se identifica con el Estado, el desplazamiento a travs de una larga lista es mucho tiempo. Con los controles de entrada en
cascada, esta
ejemplo puede tener dos controles de entrada, uno para el estado y uno para la ciudad:
Cuando se muestran los controles de entrada, la consulta para el control de entrada de estado devuelve una lista en orden
alfabtico de
nombres de estado nicos.
Cuando el usuario selecciona un estado, la consulta para el control de entrada de la ciudad se dispara y devuelve la lista de
ciudades para
ese estado. Las ciudades se muestran en el control de entrada, y cuando el usuario selecciona uno y lo presenta, el
nombre de la ciudad se pasa como un parmetro para el informe.
El usuario realiza dos selecciones de las listas ms cortas, lo que es ms fcil y ms rpido que usando una larga lista de
municipales y estatales nombres. El segundo control de entrada est vaco, mostrando ninguna seleccin, hasta que al hacer clic
en el primero de los
cascada controles de entrada. Si el usuario cambia el estado en el primer control, la lista de ciudades en el segundo control
actualiza en consecuencia. Si hubiera un nmero especialmente grande de las ciudades, ms controles de entrada en cascada
podran ser
utilizado para reducir la lista, como regin o estado. Se cargan los valores para cada control slo cuando el anterior
de entrada se ha seleccionado, para hacer una experiencia de usuario cmoda y rpida.
Los valores de los parmetros determinados por cada control de entrada en cascada pueden o no se pueden utilizar en el
informe. Para
ejemplo, si el informe slo muestra los datos acerca de una ciudad, el control de entrada pas slo existe para acelerar la
eleccin
de la ciudad. Sin embargo, si el informe tambin muestra informacin como promedio de la ciudad en comparacin con el
promedio de los pases de
dado medida, el parmetro de pas tambin se utiliza en el informe.
5.6.1
Los parmetros en las consultas de control de

entrada
La sustitucin de parmetros en los controles de entrada de consultas sigue el mismo criterio que para las consultas de
JasperReports. Las consultas de
todos los tipos de fuentes de datos pueden utilizar la sustitucin de parmetros, y $ P $ P! y los parmetros de $ X (para las
consultas SQL) son
apoyado.
La notacin $ X tiene dos formas principales explican en la lista siguiente:
$ P {parameter_name}
El valor del parmetro se sustituye en la consulta. En los casos en que el parmetro contiene una cadena, los
mecanismos de sustitucin inserta los caracteres propios de escape para crear SQL vlida. Use esto para con una sola
seleccionar los controles de entrada y operadores de comparacin simples como mayor que o menor que. Por ejemplo:
seleccione el nombre desde EMPLEADOS donde deals_closed> $ {P} OFERTAS
No utilice $ {P} parameter_name con la igualdad, porque el valor del parmetro puede ser nulo, y campo = NULL
no es de SQL vlida. En lugar de utilizar $ {X IGUAL, ...}, como se explica a continuacin.
$ P {parameter_name}
El valor del parmetro se trata como texto sin formato. El servidor sustituye el parmetro con el valor de la
control de entrada sin realizar la comprobacin o el valor de escapar extra. Esto se utiliza en casos complejos en los que la
control de entrada proporciona un pedazo de la consulta o, a veces toda la consulta.
$ {X IGUAL, columna, parameter_name} o $ X {notequal, columna, parameter_name}
Esta sintaxis realiza la verificacin de la igualdad y maneja el caso en que el valor del parmetro es nulo. Utilice esta
todas partes en lugar de la antigua columna = $ P {parameter_name} sintaxis. El $ {X IGUAL ...} sintaxis
realiza la siguiente sustitucin antes de presentar la consulta:
columna = valor_parmetro - cuando valor_parmetro no es nulo
columna es NULL - cuando valor_parmetro es NULL
106
$ X {IN, columna, parameter_name} o $ {X NO EN, columna, parameter_name}
Utilice este parmetro para conectar en cascada con una seleccin mltiple de controles de entrada. Los $ X {EN} ...
operador es cierto cuando el
valor del campo coincide con uno cualquiera de los mltiples valores del control de entrada. En el ejemplo de los pases /
ciudades, nos
puede permitir al usuario elegir cualquier nmero de pases, y mostrar todas las ciudades en los pases seleccionados. El
control de entrada basado en consultas tendra la siguiente consulta:
seleccione la ciudad de CUENTAS donde $ {X IN, pas, pases}
Si el usuario selecciona los valores de Canad, Mxico y Estados Unidos en la seleccin mltiple de control de entrada
PASES, la
$ X {} sintaxis se traduce en la siguiente consulta para el control de entrada CIUDADES:
seleccione la ciudad desde donde CUENTAS pas IN ('EE.UU.', 'Canada', 'Mxico')
Al definir estos parmetros en un informe, no utilice un defaultValueExpression elemento. Debido a una
limitacin en JasperReports Server, estos parmetros son nulos cuando una defaultValueExpression es
proporcionado.
La sintaxis $ X tambin es compatible con los siguientes operadores. Todos ellos estn diseados para manejar la entrada nula
mediante la generacin 0
= 0 cuando el valor del parmetro es nulo:
Sintaxis Parmetro
Significado
$ {X MAYOR, columna, parmetro}
columna> parmetro
$ X {[MAYOR, columna, parmetro}
columna> = parmetro
$ {X MENOS, columna, parmetro}
columna <parmetro
$ {X MENOS], columna, parmetro}
columna <= parmetro
$ X {ENTRE, columna, start_param, end_param}
start_param <column <param final
$ X {ENTRE], columna, start_param, end_param}
start_param <column <= parmetro final
$ X {[ENTRE, columna, start_param, end_param}
start_param <= columna <param final
$ X {[ENTRE], columna, start_param, end_param}
start_param <= columna <= parmetro final
Para obtener ms informacin sobre el uso de $ P $ P! y $ X para construir consultas dinmicas, consulte la JasperReports
ltimo
Gua y el Ultimate Guide iReport.
El nmero de parmetros que se pueden utilizar en una consulta es arbitraria, al igual que el nmero de controles de entrada
que pueden
definirse en un JasperReport es arbitraria. Adems de los parmetros de control de entrada estndar, una entrada en cascada
consulta de control puede utilizar los parmetros integrados descritos en "Parmetros integradas para entrada basados en
consultas
Controles "en la pgina 103.
5.6.2
Crear un control de entrada en cascada

En este ejemplo, vamos a crear un informe sencillo, donde los usuarios seleccionar un pas y luego una ciudad para mostrar
toda la
cuentas de una ciudad, utilizando la base de datos de ejemplo SugarCRM enviado con JasperReports servidor. En este ejemplo
se utiliza
iReport para crear un informe y sus controles de entrada. iReport utiliza el servidor JasperReports plug-in para cargar estos
recursos en el repositorio.
107
Comenzamos por crear un informe con un parmetro denominado CITY y la consulta siguiente informe:
select * from cuentas donde $ {X IGUAL, billing_address_city, CIUDAD}
En la banda de detalle, aadimos tres campos: nombre, shipping_address_city y shipping_address_country. Luego

publicar el informe en el servidor, usando la herramienta del plug-in del servidor JasperReports en iReport Publicar.
Figura 5-14 Informe simple Filtrado por Ciudad

Ahora defina los controles de entrada. Haga clic derecho en el nodo JasperReport en el Repositorio Navigator y agregue el
primero
control de entrada al seleccionar Aadir> Control de entrada. Este control de entrada muestra la lista de pases en los que
cuentas estn presentes. No es un control de entrada en cascada, pero su valor se utiliza en el control siguiente: la que
selecciona la ciudad.
Establezca el nombre de este primer control de entrada a EL PAS (el nombre para mostrar puede ser "Pas"). Establezca la
entrada
Tipo de control de Soltero consulta de seleccin. Editar un recurso local para la consulta, establecer un nombre para l ("query")
y establecer el
lenguaje de consulta para SQL.
108
Figura 5-15 Crear el control de entrada PAS

La consulta es una consulta simple para seleccionar los pases. Por ejemplo:
seleccionar distintos shipping_address_country de CUENTAS
orden por shipping_address_country
Para completar el recurso de consulta local, establecer los recursos del repositorio / datasources / JServerJdbcDS como los
datos de la consulta
fuente. Finalmente, en el Valor y Columnas visibles ficha, establezca la columna Valor para shipping_address_country
y hacerlo (la nica) la columna visible. El primero de control de entrada, que selecciona el pas, est ahora listo.
Figura 5-16 El control de entrada PAS

Ahora que tenemos un pas de control de entrada con nombre, podemos hacer referencia al parmetro PAS en otro
basado en consultas de control de entrada. Esto es lo que vamos a hacer con el segundo control de entrada denominado
CIUDAD. Su
definicin es tambin un Individual Seleccione Queryof Tipo SQL. La consulta para CITY utiliza un $ {X IGUAL, ...,
PAS} parmetro en su donde condicin:
109
seleccionar distintos shipping_address_city de CUENTAS

donde $ {X IGUAL, shipping_address_country, PAS}
orden por shipping_address_city
Esta vez la columna para ser utilizado en el campo Valor y Columnas visibles es shipping_address_city.
Cuando se ejecuta el JasperReport, si todo se ha configurado correctamente, el cuadro de dilogo que se muestra en el
aparece la siguiente figura. Se compone de los dos controles de entrada simples, y el control de la ciudad no es poblada
hasta que el usuario selecciona un pas.
Figura 5-17 en cascada Control de entrada Mostrando Pas y Ciudades
5,7
De recursos de archivo
Los recursos de archivos son los que el administrador crea mediante la subida de un archivo. Al igual que otros recursos en este
captulo,
los recursos de archivos son creados por los administradores para que puedan ser referenciados por Jasper Reports. Servidor
JasperReports
soporta
losTipos
siguientes
archivos:
Tabla 5-2
de recursos
de archivos
110
Tipo de Archivo
Descripcin
CSS
Cascading Style Sheet archivo que ayuda a definir la interfaz de usuario como parte de un tema.
Fuente
Fuente True Type (TTF) Archivo de ampliar el conjunto de fuentes disponibles en un informe y
permitir
la incrustacin de fuentes en el PDF de salida, si es necesario (ver "Fuentes" en la pgina 111).
Imagen
Cualquier formato de imagen con el apoyo de la JVM (Java Virtual Machine), tales como JPEG,
GIF y PNG. Las imgenes pueden ser referenciados en JasperReports, y tambin en los archivos
CSS.
JAR
Las bibliotecas que proporcionan funcionalidad para sus informes (ver "JAR Files" en la pgina 111)
JRXML
La definicin de un informe en un lenguaje de definicin de informe basado en XML JasperReports '.

Un archivo JRXML se puede cargar por separado para su uso en mltiples JasperReports.
Tipo de Archivo
Descripcin
OLAP esquema
Define los datos en un cubo OLAP, incluyendo cmo agregar las dimensiones.
Paquete de Recursos
Un archivo .properties Java que contiene pares de valores clave para la localizacin de los
informes (ver
"Recursos Bundles" en la pgina 111)
Plantilla de estilo
Un archivo JRTX contiene una plantilla de estilo que se puede compartir entre JasperReports.
XML
Archivo XML utilizado en Dominios y anlisis para definir la seguridad a nivel de

datos.
La forma en que las fuentes, los archivos JAR y paquetes de recursos se asocian con los informes se explica con ms detalle
en el
siguientes secciones.
5.7.1
Fuentes
El servidor se basa en la Biblioteca JasperReports como su motor de renderizado contenido, lo que permite producir de alto
calidad, documentos de pxel perfecto. El servidor puede usar cualquier fuente que estn disponibles para su JVM como lgica o
fuentes fsicas. Esta solucin es perfecto para los informes HTML que se almacenan en el servidor.
Sin embargo, cuando se exporta el informe a PDF, puede que tenga que tomar medidas adicionales si el informe incluye
fuentes
que el visor de PDF no reconocer o si el informe requiere fuentes que los usuarios no tienen en su
computadoras. En este caso, debe incrustar la fuente en el archivo PDF en s. Para incrustar una fuente, debe editar el
archivo JRXML principal del informe; la TTF (True Type Font) archivo al que hace referencia el informe deben estar disponibles
para el
servidor en tiempo de ejecucin. Una forma de asegurarse de que el servidor tiene la fuente correcta es subirlo al repositorio
la creacin de un recurso de archivo. A continuacin, el informe puede referirse a URI de la fuente en el repositorio.
Para obtener ms informacin acerca de cmo trabajar con las fuentes y exportacin de PDF, consulte la
documentacin de JasperReports.
5.7.2
JAR Archivos
JasperReports puede aprovechar las API de terceros. Cuando se ejecuta, los informes se pueden hacer llamadas directas a la
API de terceros cdigo
utilizando expresiones JRXML. Esto proporciona una gran flexibilidad para la incorporacin de la lgica de negocio u otra
utilidad
cdigo
en lacasos,
generacin
informes.
En
algunos
ustedde
puede
hacer que el cdigo de terceros disponibles para el proceso de generacin de informe
mediante la adicin de la
libreras necesarias para la aplicacin classpath del servidor cuando se despliega. En otros casos, subir el tercer
partido o archivos JAR adicionales al repositorio mediante la creacin de un recurso de archivo. A continuacin, el informe se
puede consultar el cdigo
haciendo referencia a ellos como los recursos de archivos adicionales.
5.7.3
Paquetes de recursos
Cuando se utiliza una nica plantilla JRXML para generar documentos en varios idiomas, se necesita un paquete de recursos
para acomodar el contenido especfico de la localidad. Si subes dichos paquetes de recursos mediante la creacin de un recurso
de archivo,
sus archivos JRXML pueden referirse a ellos.
El nombre del paquete de recursos creado como un recurso de archivo en el repositorio debe tener .properties como su
archivo
extensin. Por ejemplo, el paquete de recursos predeterminado podra llamarse MyReport.properties, y su francs
MyReport_fr.properties traduccin. Para obtener ms informacin acerca de paquetes de recursos para los informes,
consulte la
111
5.7.4
Creacin de un archivo de recursos

Los administradores deben organizar los recursos de archivos en carpetas en el repositorio para que sean ms fciles de
encontrar cuando
creacin de referencias.
Para agregar un recurso de archivo:
2.
Seleccione Ver> Repositorio y busque la carpeta principal del nuevo recurso en el panel de carpetas del lado izquierdo.
3.
En el panel de carpetas, haga clic en la carpeta principal y seleccione Agregar recurso> Archivo en el men contextual,
a continuacin, seleccione el tipo de recurso que aadir. En este ejemplo, seleccione Aadir Recursos> Archivo> Fuente. El
Add File
Aparece el dilogo.
Ingrese la informacin requerida para el recurso de archivo. En adicin al nombre y la ID, slo los recursos de archivo
requerir que introduzca la ruta de acceso a un archivo o hacer clic Explorar para localizar un archivo en el sistema de
archivos.
La siguiente figura muestra el cuadro de dilogo para agregar un archivo de fuente. Todos los recursos de archivos se
crean mediante la carga de un archivo
de una manera similar.
4.
Figura 5-18 Adicin de un recurso del archivo

5.
5.7.5
Cuando haya terminado, haga clic en Enviar. El nuevo recurso de archivo aparece en la carpeta seleccionada en el panel
Repositorio. A
mensaje de confirmacin de la adicin tambin aparece en la parte superior de la pgina.
Edicin de un archivo de recursos

El siguiente ejemplo muestra cmo editar un recurso de archivo.
Para editar un recurso de archivo:
2.
112
En el repositorio, navegar o buscar el recurso.
3.
Haga clic con el recurso y seleccione Editar en el men contextual. El cuadro de dilogo Editar archivo aparece como el
Cuadro de dilogo Agregar archivo a excepcin de algunas propiedades que no se pueden cambiar. En este ejemplo,
editamos la fuente
recurso creado en "Creacin de un archivo de recursos" en la pgina 112.
Figura 5-19 Edicin de un archivo de recursos

4.
5.
Utilice el cuadro de dilogo Editar para ver o modificar la definicin de los recursos y sus valores. En la figura anterior, se
puede
ver cmo se cambi el campo Descripcin. Tambin puede cambiar el contenido del recurso de archivo por
especificando otro archivo que desea cargar. El campo Va al archivo no es necesario a menos que usted desea volver a
cargar el archivo
desde
el disco.
Haga clic
en Enviar para guardar los cambios.
113
114
CAPTULO 6 TEMAS
Temas en JasperReports Server son un mecanismo para definir y personalizar la interfaz de usuario (UI) a travs de
Hojas de Estilo en Cascada (CSS), el estndar web para definir el aspecto del contenido HTML. Un tema es la
conjunto de todos los archivos CSS e imgenes asociadas que definen la apariencia de la interfaz de usuario. Los temas se
guardan como
presentar los recursos en carpetas en el repositorio, con mens especiales en carpetas temticas para la activacin, cargando,
y
la descarga de un tema. Puede almacenar cualquier nmero de temas en el repositorio, y los administradores pueden cambiar
entre ellos, proporcionando una manera fcil y rpida para cambiar la interfaz de usuario.
Para implementaciones de licencia para utilizar las organizaciones, los administradores pueden establecer el tema de forma
individual en cada
organizacin, o se basan en la herencia del tema a usar el mismo tema en todas partes sin necesidad de configurarlo
explcitamente. El mecanismo de herencia tambin es compatible con una mezcla de ajustes explcitos y heredados, para que
pueda
prevalecer sobre los ajustes o la imagen de una organizacin local, pero heredarn el resto del tema de los padres o por el
sistema
amplia el tema.
El mecanismo es el tema se introdujo en JasperReports Server 4.0, y el conjunto de archivos en el defecto
tema se actualiz en 4.7. Temas personalizados desarrollaron antes de la 4.7 puede requerir la actualizacin con el fin de
trabajar
con el nuevo conjunto de archivos. Para obtener ms informacin, consulte los procedimientos de actualizacin de la
Gua de instalacin.
6.1
Introduccin a los Temas

Cmo funcionan los temas
Administrar Temas
Crear Temas
Trabajar con archivos CSS
Introduccin a los Temas

La interfaz de usuario del servidor JasperReports se muestra en las figuras a lo largo de este libro. La apariencia
predeterminada puede
fcilmente ser modificado para adaptarse a sus necesidades.
115
La interfaz de usuario del servidor JasperReports se basa en CSS (Cascading Style Sheets) archivos que definen los estilos de
los elementos que aparecen en el cdigo HTML, s definen y generan a partir de JSP (JavaServer Pages) y JavaScript.
Un tema es una coleccin de archivos CSS e imgenes asociadas que especifican la apariencia de la totalidad o parte del
usuario
interfaz. Un tema slo controla cmo se muestra la interfaz, por ejemplo, fuentes, colores, espacios, lneas, y la imagen
elementos de la interfaz de usuario. No controla lo que parece, como el contenido de los mens o el efecto de hacer clic en un
botn.
Los temas se definen a nivel mundial en la raz del repositorio y de forma individual en cada organizacin. Cada usuario de un
determinado
organizacin ve el mismo tema, pero diferentes organizaciones puede tener sus propios temas. Slo los administradores
puede establecer el tema. Los administradores pueden aadir, cargar, editar, copiar y borrar los archivos que componen el tema,
slo
al igual que otros recursos en el repositorio. El repositorio ofrece acciones especiales en carpetas temticas para descargar
y subir temas como ZIP (archivo comprimido) archivos, y para activar el tema.
Los temas se integran completamente con la arquitectura multi-organizacin en JasperReports Server. Algunos
caractersticas de los temas tratados en este captulo se aplican slo a las implementaciones que tienen licencia para
utilizar mltiples
organizaciones. Sin embargo, las implementaciones de una sola organizacin utilizan la misma arquitectura, por ejemplo,
hay
son las anulaciones y herencia entre los temas de la organizacin predeterminada nica y la raz del sistema.
El mecanismo de los temas es jerrquica y muy flexible, lo que permite a los administradores cambiar fcilmente el mundial
apariencia o establecidos anulaciones especficos de la organizacin. Por ejemplo, todos los siguientes escenarios son
posibles con
el mecanismo temas:
Escenario
Descripcin
Utilice el tema por defecto

sin cambios.
La interfaz de usuario ha sido actualizada por razones de claridad y espacio. Despus de

un
instalacin estndar, el tema por defecto se establece en el nivel de la raz y es
heredado automticamente por todas las organizaciones para que cada usuario ve la
servidor con esta interfaz. Si el tema por defecto se adapte a sus necesidades, no hay
necesite personalizar o desarrollar nuevos temas.
Modificar rpidamente el tema por defecto.

Puede especificar las anulaciones de reglas CSS individuales o sustituir las imgenes en la
tema del sistema. Es fcil crear o subir los archivos nuevos y activar su
personalizaciones. El mecanismo de herencia asegura que cada
organizacin utiliza este nuevo tema y se actualiza en tiempo real cuando se
modificarlo.
Crear un tema totalmente nuevo.
Con una experiencia de CSS o Jaspersoft Servicios Profesionales, puede cambiar

todo el aspecto y la sensacin del servidor. La interfaz de usuario del servidor puede ser
adaptado a
coincidir o mezclarse con casi cualquier otro diseo web. La herencia
mecanismo asegura una vez ms que cada organizacin utiliza el nuevo tema,
mientras que le permite manejar la interfaz de un nico conjunto de archivos.
Anulacin de temas para personalizar el Usted puede dar a cada organizacin o suborganizacin una personalizacin de la
Interfaz de usuario para todas las
tema predeterminado, por ejemplo, un nuevo logotipo, manteniendo todos los dems
organizaciones.
aspectos de la
el tema del sistema. El beneficio de este enfoque es que el tema del sistema
an se puede modificar y heredado por todas las organizaciones, al tiempo que conserva
las anulaciones a nivel de organizacin.
Este enfoque se puede combinar con la anterior, de modo que anula
se aplican a la tema personalizado.
116
Captulo 6 Temas
Escenario
Descripcin
Crear un nuevo tema en cada

organizacin.
Para los proveedores de SaaS, cada organizacin puede ser un cliente diferente, que
necesita una
interfaz especial. El mecanismo de temas permite a cada organizacin totalmente
definir la interfaz de usuario y an conservan la manivela y la herencia de su
suborganizaciones propios. En tales implementaciones, cada administrador organizacin
puede
modificar o crear la apariencia de su propia interfaz de usuario.
Es importante darse cuenta de que un tema se refiere a dos conceptos de forma

simultnea:
Una carpeta que contiene un conjunto de archivos CSS y archivos de imagen en el lugar adecuado en el repositorio.
Todo el aspecto de la interfaz de usuario despus de la activacin de los archivos del tema. Sin embargo, a travs de
la
mecanismo de herencia, partes de la interfaz se definen en los archivos pertenecientes a otros temas. De hecho,
excepto para el tema predeterminado, toda la interfaz de usuario rara vez se define en un solo tema.
Por ejemplo, un tema muy simple denominada MyLogo contiene un archivo de imagen personalizada para reemplazar el logotipo
de Jaspersoft,
y nada ms. El resto de la interfaz se hereda del tema por defecto o algn tema personalizado. Sin embargo, decimos
que MyLogo es el tema activo, y cada usuario de la misma organizacin ve el tema MyLogo.
6.2
Cmo funcionan los temas

Los temas se guardan en una carpeta llamada Temas especiales que aparecen en la raz del repositorio y en cada
organizacin. Cada carpeta Themes contiene un tema por defecto que no puede ser editada y cualquier nmero de la
costumbre
carpetas temticas. Cada tema se almacena en su propia carpeta y se conoce con el nombre de la carpeta.
La carpeta con el nombre "default" en cada carpeta Themes es un tema especial cuyos contenidos son controlados por el
servidor. En la carpeta Temas en la raz, el tema por defecto contiene la definicin completa de todos los estilos que
constituye el tema por defecto incluido en JasperReports Server. En la organizacin Temas, el valor predeterminado es un
sistema
tema generado que contiene todos los estilos heredados por la organizacin dada. Ninguna de las carpetas del tema por
defecto
pueden ser modificados, incluso por los administradores.
En este captulo se utiliza la siguiente terminologa para distinguir entre los temas a nivel de la raz y de nivel de organi zacin. En
la siguiente tabla, la carpeta principal de cualquier organizacin se llama Organizacin, y -tema activo es el nombre de
la carpeta del tema que ha sido activado:
Nombre
Carpeta
Descripcin
Tema por defecto
root> Temas>
por defecto
La interfaz de usuario no modificada de JasperReports Server, tal como aparece

en la primera instalacin. El tema por defecto se define en la carpeta predeterminada
en
la carpeta Themes en la raz del repositorio.
Tema Sistema
root> Temas>
-tema activo
El tema activo establecido en el nivel raz. Todos los usuarios de todas las
organizaciones
ver este tema a menos que haya un tema especfico de la organizacin que es
activado. El tema del sistema tambin se utiliza para la pgina de acceso.
Cuando JasperReports Server se instala por primera vez, el tema por defecto es
activa, por lo que tambin es el tema del sistema.
117
Nombre
Carpeta
Descripcin
Heredado tema
Organizacin>
Temas> default
La combinacin de todos los temas activos en las organizaciones de padres de un

dada la organizacin, de acuerdo con las reglas de herencia. Para cualquier
propuesta
organizacin, el tema heredado por esa organizacin se almacena en la
carpeta predeterminada de carpeta Temas de esa organizacin.
Tema activo
Organizacin>
Temas> activotema
El tema que los usuarios de una organizacin determinada pueden ver, ya que un
administrador ha hecho que sea activo en el nivel de organizacin o sistema.
Los usuarios ven una combinacin del tema activo y heredada,
dependiendo de los archivos en el tema activo y las reglas de herencia.
No puede modificar los archivos del tema por defecto a travs del repositorio. Si intenta hacerlo por
eludiendo el repositorio, sin darse cuenta, podra cambiar las reglas de tal manera que se convierte en la
interfaz de usuario
inutilizable. En esta situacin, debe volver a instalar JasperReports Server para recuperarse.
La siguiente figura muestra el tema por defecto en la carpeta Themes en la raz del repositorio. El nombre de la
carpeta (y sus subcarpetas) estn en negrita para indicar que es el tema activo.
Figura 6-1 El tema por defecto en la carpeta de temas de raz
6.2.1
Archivos temtico
Un tema completo consta de los archivos de la lista para el tema por defecto, como se muestra en la figura anterior, junto con
todo referenciado imgenes. Adems, el tema por defecto contiene el samples.css archivo que slo es utilizado por el Ver
> IU Muestras la pgina se describe en la seccin "User Las muestras de interfaz "en la pgina 129. Los archivos
overrides_ie7.css
y overrides_ie8.css slo se cargan con las hojas de estilo en el navegador del usuario es Internet Explorer 7 u 8,
respectivamente.
118
Captulo 6 Temas
El conjunto de archivos en el tema por defecto se actualiz en 4.7. Temas personalizados desarrollaron antes de la 4.7
pueden
requerir la actualizacin con el fin de trabajar con el nuevo conjunto de archivos. Para obtener ms informacin,
consulte la actualizacin
procedimientos en el Gua de instalacin del servidor JasperReports.
Las imgenes asociadas a un tema incluyen todos los iconos de la interfaz de usuario y fondos para los botones y
fronteras. Varios iconos y fondos pueden ser almacenados en el mismo archivo llamado sprite. El tema tambin incluye
el archivo favicon.ico que aparece en las pestaas del navegador. Hay aproximadamente 60 archivos de imagen en el tema por
defecto.
Las tiendas temticas predeterminadas referenciados archivos de imagen en una carpeta llamada imgenes. En un tema
personalizado, hay dos maneras de
para cambiar una imagen del tema por defecto:
Utilice una carpeta de imgenes con nombre y un archivo de imagen con el mismo nombre que el que desea
reemplazar.
Modificar las reglas CSS correspondientes a redefinir el lugar donde la nueva imagen se puede encontrar.
Al modificar las reglas CSS, puede utilizar cualquiera de las siguientes maneras para hacer referencia a archivos de imgenes,
o cualquier otro
archivo de ayuda:
Directamente en la carpeta del tema. En este caso, el archivo se hace referencia sin una ruta, por ejemplo "Miarchivo.png" en
CSS.
En cualquier ruta de la carpeta se encuentra en la carpeta del tema. Por ejemplo, el archivo CSS personalizado podra
referirse a
"MisImgenes / miarchivo.png" si crea una carpeta MisImgenes nombrados en la carpeta del tema y subir su
imgenes all.
En cualquier lugar en Internet. Siguiendo el estndar CSS, el CSS personalizado puede referirse a las imgenes, o cualquier
ayudante
presentar, con una direccin URL habitual.
6.2.2
Mecanismo de Herencia
Con el fin de hacer que la interfaz de usuario, Jasper Reports Server debe cargar cada uno de los archivos de tema. Debido a
que cada archivo
se pueden almacenar en mltiples temas, el mecanismo de herencia determina qu archivo a cargar.
El servidor carga cada uno de los archivos CSS que figuran en el Figura 6-1. Para localizar el archivo, el servidor busca en la
siguiente
lugares, en los rdenes enumeran a continuacin.
Para los usuarios de la edicin
profesional:
1. La carpeta del tema activo para la organizacin del usuario.
2.
El tema heredado almacena en la carpeta con el nombre <organizacin> / Temas / default.
Para otros usuarios:

1.
La carpeta del tema activo.
2.
El tema heredado almacena en la carpeta llamada / Temas / default.
Cuando uno de los archivos CSS hace referencia a un archivo de imagen o un archivo de ayuda, incluyendo cualquier ruta a ese
archivo, el servidor
busca que ruta y el nombre en las mismas dos lugares, en el mismo orden. De este modo, cada archivo y la imagen es
resuelto por primera vez en el tema activo, y si no se encuentra, entonces, en el tema heredado.
El tema activo no necesita contener todos los archivos porque el tema hereditaria que es mantenido por el
servidor est garantizado para contener todos los archivos. Mantener el tema heredado en toda organizacin es el segundo
tarea del mecanismo de herencia.
El servidor mantiene el tema heredado en cada organizacin con el mismo algoritmo. Siempre que un
administrador cambia el tema activo o modifica un archivo en el tema activo, el servidor utiliza el mismo algoritmo
para encontrar todos los archivos que definen el tema activo en esta organizacin y hace una copia de los mismos en cada nio
organizacin. Por niveles anidados de las organizaciones, el algoritmo se repite en cada nivel despus de actualizar la copia de
el tema heredado. De esta manera, los cambios se propagan hacia abajo a cada organizacin.
119
La propagacin de los cambios a los temas heredados es computacionalmente intensivas y puede tomar varios momentos
despus de hacer un cambio a un tema. Sin embargo, la determinacin de la herencia cuando se realizan cambios es una
compensacin efectiva para que los archivos CSS para representar la peticin del cliente se resuelven casi al instante.
6.2.3
Esquema Prioridad CSS y anulaciones personalizados

Una vez que el mecanismo de herencia determina qu archivos para cargar, el esquema de prioridades CSS estndar
determina
reglas que son visibles, basado en el orden en que se cargan los ficheros.
Esto conduce a dos formas generales de desarrollo de temas
personalizados:
La forma ms rpida es copiar las reglas CSS individuales de los archivos del tema por defecto, modificar las reglas para
cambiar
la interfaz de usuario, y guardarlos en el archivo overrides_custom.css. Debido overrides_custom.css es siempre el ltimo
CSS
presentar para ser cargado, sus normas prevalecen las mismas reglas en otros archivos. Esto le permite cambiar fcilmente
cualquier
Por
ejemplo,
si desea
aumentar a
eltodos
tamao
textoarchivo.
en todos los botones en el tema por defecto, usted puede hacer esto
nmero
de reglas,
y administrar
en del
un solo
con algunas reglas en el archivo overrides_custom.css. Es posible que necesite ajustar el espaciado de ciertos botones,
pero la idea es que usted slo tendr que cambiar un nmero limitado de reglas.
Si modifica la interfaz de usuario ampliamente, puede utilizar la estructura existente de los archivos CSS en el valor por
defecto
tema. En este caso, copie los archivos relevantes del tema por defecto, hacer sus modificaciones, y guardar el
archivos en su nuevo tema. El mecanismo de herencia utiliza los nuevos archivos al activar el tema.
Un ejemplo de estos grandes cambios sera si desea aumentar el tamao de los propios botones
en el tema predeterminado. Usted tendra que volver a escribir la mayora de las reglas en el archivo buttons.css y crear
imgenes para los nuevos botones. En este caso, es mucho ms fcil copiar el archivo buttons.css que copiar docenas de
reglas en el archivo overrides_custom.css. An se poda utilizar el archivo overrides_custom.css para ajustar el
espaciamiento de los elementos alrededor de los botones, ya que habra menos de esas normas a modificar.
Jaspersoft recomienda utilizar el mtodo de las anulaciones personalizados para la mayora de los temas personalizados. Un
tema personalizado
cambia apariencias simples como colores, tipos de letra y espaciado tiene relativamente pocas reglas y es fcilmente manejable
en un nico archivo. Y muchos cambios se pueden hacer mediante la copia y modificacin de archivos de imagen en el tema
personalizado,
sin necesidad de escribir ningn reglas CSS. Slo si cambia el diseo fundamental o la apariencia de la interfaz de usuario,
Debera considerar la copia y modificacin del otro archivo CSS.
Copia y de los archivos CSS de modificacin es ms propenso a errores, y es ligeramente menos flexibles debido a la basada
en archivos
mecanismo de herencia. Su copia del archivo debe contener todas las reglas CSS que el original. Si una reglamentacin son
accidentalmente borrado o modificado, incluso por un solo personaje, el tema podra no funcionar correctamente. Adems, el
reglas sin modificar en la copia de su archivo ahora anulan las actualizaciones realizadas en el mismo archivo en uno de los
padres
organizacin.
Por ejemplo, si se puede copiar un archivo que define los botones grises con texto plano, y cambia la regla de CSS para
hacer que el texto en negrita, para crear un tema con botones de negrita, de color gris. Sin embargo, si el tema de la
organizacin de padres
o tema del sistema se modifica de manera que los botones son de color azul, su archivo anula el nuevo color heredado, y
todava
tener botones negrita, de color gris. Si usted hubiera definido el texto en negrita como una sola regla en el archivo
overrides_custom.css, su
tema mostrara botones audaces, azul ahora.
6.3
Administrar Temas
Los temas son conjuntos de archivos CSS y de imagen almacenados en una carpeta en el repositorio. La raz del repositorio y
cada
organizacin tiene una carpeta Themes donde se almacenan los temas activos y heredados. En el navegador de repositorios, la
120
Captulo 6 Temas
Temas de carpeta y carpetas temticas individuales tienen acciones especiales para los administradores de manejarlos.
Usted puede
Tambin utilice la bsqueda repositorio para encontrar los archivos CSS y de imagen.
Las carpetas y acciones para el manejo de temas slo son visibles para los administradores. La carpeta Themes tiene Executeslo el permiso para ROLE_USER para que todos los usuarios pueden cargar los archivos del tema y ver la interfaz de usuario,
pero no
acceder a las carpetas y archivos en el repositorio.
Esta seccin ofrece los procedimientos bsicos para la administracin de los temas existentes. Para crear carpetas temticas y
archivos, consulte
"Creacin de Temas" en la pgina 124. Para obtener informacin acerca de cmo trabajar con CSS en temas, consulte "Con
Trabajo
Archivos CSS "en la pgina 127.
6.3.1
Ajustar el tema del sistema

1.
Acceda a JasperReports Server como administrador del sistema ( superusuario en la edicin profesional;
jasperadmin en otras ediciones).
2.
Haga clic en Ver> Repositorio y expandir la carpeta Themes si es necesario.
3.
Haga clic en la nueva carpeta del tema y seleccione Establecer como tema
activo.
Por ejemplo, los datos de ejemplo incluye un dos temas llamados jasper_dark y pods_summer que se puede establecer
como activa.
Figura 6-2 Configuracin de un tema del sistema

Tan pronto como se actualiza la pantalla, se ve el efecto del nuevo tema. Observe cmo el tema pods_summer
cambia los colores y el logotipo en la interfaz de usuario con slo el archivo overrides_custom.css e imgenes.
121
Figura 6-3 El Tema pods_summer Muestra

Debido a que el tema del sistema se establece en el nivel de la raz, el nuevo tema aparece a todos los usuarios en
todas las organizaciones,
a menos que la organizacin tiene su propio tema. Adems, el tema del sistema establecido aqu se aplica a la pgina
de inicio de sesin, como
se muestra en la siguiente figura.
Figura 6-4 La pgina de entrada segn lo visto con el tema Nuevo Sistema
Los siguientes procedimientos se supone que el tema del sistema todava se establece en el tema por
defecto.
6.3.2
Establecimiento de una Organizacin

Temtica
Los usuarios profesionales de edicin pueden dar diferentes temas para sus
organizaciones.
1. Acceda a JasperReports Server como administrador organizacin (jasperadmin).
122
Captulo 6 Temas
2.
En un servidor con licencia para utilizar varias organizaciones, especifique el ID de organizacin o alias en la pgina de
inicio de sesin.
Haga clic en Ver> Repositorio y expandir la carpeta Themes si es necesario. Carpeta del tema de la organizacin es
se muestra en la siguiente figura.
Figura 6-5 Organizacin Temas Visto por Organizacin administracin

3.
Haga clic en el nuevo nombre de la carpeta y seleccione el tema Establecer como tema
activo.
Tan pronto como se actualiza la pantalla, se ve el efecto del nuevo tema. El nuevo tema se aplica a todos
usuarios de la organizacin y es heredado por todos suborganizaciones, en su caso.
Los administradores de la organizacin pueden as personalizar la interfaz de usuario mediante la creacin y activacin de
nuevos temas dentro de su
organizacin.
6.3.3
Restringir el acceso a los temas

Los administradores del sistema pueden desear restringir el acceso a los temas, por lo que todos los temas se controlan
desde el nivel del sistema.
Este procedimiento slo se aplica a los administradores de sistemas. Los administradores de organizacin no puede
modificar el ROLE_
ADMINISTRADOR permiso, incluso en suborganizaciones. Deben solicitar que el administrador de sistema realice
el procedimiento para ellos.
1.
Acceda a JasperReports Server como administrador del sistema ( superusuario o jasperadmin).
2.
3.
4.
Haga clic en Ver> Repositorio. Los usuarios de la edicin Comunidad puede saltar al
paso 5.
Expanda la carpeta Organizaciones.
Busque el nombre de la organizacin en la que desea restringir el acceso a los temas y ampliar su carpeta.
5.
6.
Haga clic en el nombre de la carpeta Temas y seleccione Permisos.

Cambie el permiso para que el ROLE_ADMINISTRATOR de Administrar a Slo ejecucin.
123
Figura 6-6 Restringir jasperadmin Acceso a la Organizacin Temas

Estableciendo Slo ejecucin de acceso, los administradores de la organizacin no pueden ver la carpeta Temas en el
repositorio,
y por lo tanto no puede cambiar los temas o crear un nuevo tema.
No debe cambiar cualquier otro permiso en los temas, incluso si el dilogo de permisos permite. Usted
inadvertidamente podra hacer que la interfaz de usuario inaccesible.
7.
8.
6.4
Para restringir el acceso a todas las organizaciones, repita paso 4 a el paso 6 para cada organizacin en el servidor,
incluyendo
suborganizaciones.
Si usted desea restringir el acceso de la misma manera en todas las organizaciones futuras, repita paso 5 y el paso 6
en el
Plantilla Carpeta de cada organizacin y suborganizacin en el servidor. Para mayor informacin, consulte
"La colocacin de temas en la plantilla de carpeta" en la pgina 127.
Crear Temas
Hay tres formas de crear las carpetas y archivos que componen un tema:
Creacin de carpetas temticas y de recursos de archivo - Crear de forma individual como recursos en el repositorio.
Archivos Cargar Tema postal - Copiar y modificar los temas existentes como ZIP (archive) archivos.
La colocacin de Temas en la plantilla de carpeta - Inicializar temas automticamente en mltiples organizaciones
despliegues.
En esta seccin se explica solamente cmo almacenar archivos CSS en el repositorio. Para obtener informacin acerca de
la creacin de archivos CSS
contenidos, ver "Trabajar con archivos CSS" en la pgina 127.
6.4.1
Creacin de carpetas temticas y de recursos de archivo

Un tema es simplemente una carpeta en el repositorio que contiene los archivos CSS y de imagen, con sub-carpetas opcionales.
Los administradores pueden utilizar los mens de repositorio para crear carpetas temticas. Los administradores del sistema
pueden crear carpetas temticas y
archivos en el nivel de sistema o en cualquier organizacin. Los administradores de la organizacin pueden crear carpetas
temticas y archivos en su
organizacin o cualquier suborganizacin.
124
Captulo 6 Temas
Para crear carpetas temticas y recursos de archivo:

1. Inicie sesin como un administrador con acceso a la ubicacin en la que desea colocar el tema.
2.
Haga clic en Ver> Repositorio y ampliar el rbol de carpetas para ver la carpeta Themes donde desea colocar
el tema.
3.
Haga clic derecho en la carpeta Temas y seleccione Agregar carpeta. Dale a tu carpeta un nombre y una descripcin
opcional como
hara al crear cualquier carpeta. El nombre de la carpeta se utiliza como el nombre del tema.
Carpetas temticas y los archivos se pueden crear, copiar o mover cualquier parte del repositorio, pero slo pueden
Esta entrada se activa, cargada o descargada cuando se coloca correctamente en una carpeta Temas.
4.
5.
6.
7.
Haga clic derecho en la nueva carpeta y seleccione Aadir Recursos> Archivo> CSS, y utilizar el dilogo para cargar un
archivo CSS individual. Con el fin de ser utilizado como parte de un tema, debe ser uno de los nombres de los archivos
mostrados en Figura
6-1.
Para agregar imgenes a su tema, crear todas las carpetas de imgenes y cargar archivos de imagen con Agregar recurso>
Archivo
> Imagen.
Repita paso 4 y paso 5 para crear todos los archivos y las imgenes que usted necesita. Si varios temas utilizan los mismos
archivos o
imgenes, puede copiar y pegar los recursos de archivos o carpetas de imgenes completas de un tema a otro.
Si necesita cambiar el contenido de un archivo CSS o imagen, puede hacer clic en l y seleccione Editar para especificar
otro archivo para la carga y reemplazar el archivo actual.
Si subes archivos CSS y de imagen en el tema activo, los cambios son visibles despus de volver a cargar la pgina
en su navegador.
Interactuar con carpetas temticas y archivos a travs del repositorio es una manera conveniente y flexible para crear una
tema. Sin embargo, este mtodo tiene la limitacin de que, al igual que otros recursos del repositorio, no se puede
descargar los archivos o imgenes para editarlas. Para este propsito, el repositorio de descarga especial y proporciona
subir acciones en carpetas temticas.
6.4.2
Archivos Cargar Tema postal

El proceso de creacin de un tema a menudo comienza con los archivos de un tema existente que modifique con CSS y
editores de imgenes en el ordenador. Para soportar este flujo de trabajo, cada carpeta Themes tiene comandos especiales
para
descarga y carga de temas.
Debido a que un tema se compone de cualquier nmero de archivos y carpetas, JasperReports Server utiliza el archivo
ZIP
formato para almacenar un tema en un solo archivo.
Para descargar un archivo de tema postal:
1. Inicie sesin como un administrador con acceso al tema que desea descargar.
2.
3.
Haga clic derecho en la carpeta del tema que desea descargar y seleccione Descarga el Tema. Esta seleccin de men
aparece slo en carpetas temticas dentro de la carpeta Temas.
4.
El servidor le pide que guarde el archivo con el nombre <tema-name> Zip. Gurdalo en cualquier lugar de su
ordenador.
Utilice una utilidad de archivo o la compresin para extraer los archivos del archivo ZIP y guardarlos en su
ordenador.
5.
Una vez que tenga los archivos de temas extrados en su computadora, usted puede ver el CSS individual y archivos de
imagen
que constituyen el tema. Por ejemplo, para crear su propio tema, comenzar por descargar el tema por defecto de
125
la carpeta raz / Motivos (como superusuario). Guarde el archivo extrado en su equipo y crear el tema personalizado en
otra carpeta, puede copiar y editar los archivos CSS y las imgenes del tema por defecto. Ver "Prioridad CSS
Esquema y anulaciones personalizados "en la pgina 120 para una explicacin de cmo crear un tema.
Cuando haya creado todos los archivos que necesita en su tema, subirlo con el siguiente procedimiento.
Para cargar un archivo ZIP como tema:
1. Coloque los archivos CSS, carpetas opcionales, y archivos de imgenes que constituyen su tema en una carpeta de
su
ordenador.
2. Utilice una utilidad de archivo o de compresin para crear un archivo ZIP estndar de los contenidos de su carpeta de
temas.
El archivo ZIP debe incluir slo el contenido de su tema, no a la carpeta del tema en s.
1.
Inicie sesin como un administrador con acceso a la ubicacin en la que desea cargar el tema.
2.
3.
Haga clic derecho en la carpeta Temas y seleccione Subir un Tema.
Figura 6-7 Carga de un tema en una Organizacin

4.
En el dilogo que aparece, escriba un nombre para el tema, que se convierte en el nombre de su carpeta y navegar
para buscar el archivo ZIP en su ordenador. Haga clic en Sube.
Usted no puede utilizar el dilogo de carga postal para sobrescribir un tema existente. Debe especificar un nombre del
tema
que todava no existe en la carpeta de temas elegidos.
El servidor carga el archivo ZIP y extrae el contenido. Entonces se crea una carpeta para el nuevo tema y
crea los recursos de archivo en la carpeta correspondiente a cada uno de los CSS y las imgenes en el archivo ZIP. Si
tuviera subcarpetas en
su tema, que se crean as. Despus de subir el archivo ZIP tema, puede activarlo para ver
efecto de su tema en la interfaz de usuario.
Creacin de un tema es un proceso interactivo en el que a menudo es necesario hacer cambios hasta que tenga el aspecto y
siente que quiere. Para apoyar este proceso, los archivos ZIP subiendo se pueden combinar con la carga de individuo
recursos de archivo que se describe en "Creacin de carpetas temticas y de recursos de archivo" en la pgina 124. De hecho,
despus de una
carga inicial, es mucho ms fcil de actualizar archivos individuales de esta manera que para crear el archivo ZIP y subirlo
de nuevo.
126
Captulo 6 Temas
6.4.3
La colocacin de Temas en la plantilla de carpeta

En las implementaciones de licencia para utilizar varias organizaciones, se puede colocar un tema en la plantilla de carpeta que
es
utilizado para crear nuevas organizaciones. La carpeta del tema y todos sus contenidos se copian en la carpeta de temas de todo
las nuevas organizaciones que se crean. Tras su creacin, nuevas organizaciones siempre heredan su tema de los padres
organizacin, pero con un tema personalizado ya presente puede ahorrar tiempo al personalizar y activarlo
para la nueva organizacin.
La plantilla de carpeta en cada organizacin contiene una carpeta Temas y una carpeta predeterminada vaca. No
modificar la carpeta predeterminada vaco, pero crear una nueva carpeta de temas en lugar y colocar sus archivos all. Debido a
que el
Plantilla de carpeta no contiene un tema activo, no hay opcin de men Subir Theme en su carpeta Temas.
En lugar de crear la carpeta para su tema y cargar archivos como recursos, o copiar una carpeta completa el tema de la
carpeta de temas de la organizacin matriz.
Si desea restringir el acceso a los temas en organizaciones creadas, tambin puede configurar los permisos en el
Temas de la carpeta en la plantilla de carpeta. Para ello, siga el procedimiento en "Restriccin del acceso a los temas" en la
pgina 123.
6.5
Trabajar con archivos CSS

Esta seccin no es un tutorial CSS sino ms bien una coleccin de trucos y consejos para trabajar con el CSS que hace
los temas en servidor JasperReports. Esta seccin se centra en la forma de probar los temas que se desarrollan y el partido
el CSS a su comportamiento en el servidor de interfaz de usuario JasperReports. Adems, hay muchos editores diferentes para
CSS
y herramientas para probarlo, por lo que las recomendaciones de esta seccin son slo una manera de desarrollar un tema.
6.5.1
Tema Desarrollo Workflow

La eleccin importante para hacer la hora de desarrollar un tema es si utilizar las anulaciones temticos simples o duplicar
y modificar los archivos de tema, como se describe en la seccin "CSS Esquema de prioridades y personalizada anulaciones
"en la pgina 120.
Por lo general, el alcance de las modificaciones determina qu mtodo utilizar.
Una vez que haya tomado esa determinacin, usted est listo para crear su tema. Los principales pasos en un tema
flujo de trabajo de desarrollo son los siguientes:
Paso
Referencia
1. Descargar el tema por defecto para que tenga una copia de la

los archivos y las reglas CSS que desea modificar.
"Descarga e postal Carga Tema Files"

en la pgina 125
2. Crea tus nuevas reglas CSS, archivos CSS y archivos de imagen. "Firebug Plug-in para Firefox" en la pgina 128, una herramienta
para ayudarle a crear reglas CSS
3. Sube tus nuevos archivos a una plataforma de prueba, y activar
el tema o colocarlos en un tema activo.
"Creacin de carpetas temticas y de recursos de archivo"

en la pgina 124
4. Verifique sus cambios dondequiera que se produzcan en la interfaz"Plataforma de prueba" en la pgina 128 y "Usuario
Las muestras de interfaz "en la pgina 129
de usuario.
127
Paso
Referencia
5. Repita paso 2 a travs paso 4 para todos sus cambios hasta

el tema est finalizado.
6. Despliegue su tema a sus usuarios.
6.5.2
"Ajustar el tema del sistema" en la pgina 121 o

"Configuracin de una Organizacin Temtica" en la pgina
122.
Firebug Plug-in para Firefox

Una herramienta para ayudar a encontrar, modificar y reglas CSS en la vista paso 2 anterior es el plug-in Firebug para el
Mozilla
Navegador Firefox. Firebug muestra el cdigo HTML, JavaScript, y las reglas CSS de las pginas web a medida que navega.
Tiene una
interfaz dinmica que le permite seleccionar un elemento de la pgina web, y que muestra las reglas CSS especficas que
aplicar al elemento. Tambin le permite modificar esas reglas e inmediatamente ver el efecto en la pgina web.
La herramienta Firebug es ideal para modificar temas en JasperReports Server. Una vez que encuentre las pginas y elementos
que desea modificar, puede crear prototipos de sus cambios directamente dentro de la herramienta. Por ejemplo, se puede ver
efecto general de cambiar un color o modificar el espaciado.
Si va a implementar el tema a travs de anulaciones personalizados, puede copiar las reglas CSS de Firebug
enmarcar directamente en el archivo overrides_custom.css. Firebug muestra toda la regla de su archivo original, por lo que
el
copia anula exactamente. Si desea modificar otros archivos desde el tema por defecto, Firebug que la muestra
nombre de archivo y nmero de lnea de la regla, de modo que usted puede encontrar fcilmente en su copia del archivo.
Y cuando usted est probando un tema que utiliza redefiniciones, Firebug muestra tanto la regla CSS activa de overrides_
custom.css y el estado original en el archivo de tema regular del tema heredado. La regla original se muestra en
tachado, as que usted puede decir fcilmente que la regla est activa y qu regla anula.
Para obtener ms informacin y descargas, ver el Sitio web Firebug.
6.5.3
Test Platform
Al cargar un tema y que sea activo, es inmediatamente visible a todos los usuarios de la organizacin (si
utilizando la edicin de la comunidad, cada usuario en el servidor), o en el caso de un tema del sistema, a cada usuario en el
servidor. Incluso editar o cargar un archivo en un tema activo se refleja inmediatamente en la interfaz de usuario.
Debido a que el desarrollo de un tema requiere de muchas iteraciones de la carga, la activacin, y las reglas de pruebas de
CSS,
no debe desarrollar temas en un servidor de produccin.
En el caso ms simple, se puede desarrollar y probar sus temas antes de poner su servidor JasperReports en
produccin. Al probar su servidor durante el despliegue, puede desarrollar sus temas sin afectar
usuarios reales.
Para implementaciones multi-organizacin que estn en produccin, puede probar en el servidor de produccin, siempre y
cuando
se crea una organizacin de pruebas. La organizacin de pruebas hereda de la tema del sistema, la creacin de una prueba muy
realista
entorno en el que se puede ver cmo su tema anula el tema heredado. Asegrese de que su organizacin de pruebas
refleja sus organizaciones reales, por ejemplo, que tienen vistas OLAP si sus organizaciones reales realizan OLAP
anlisis. Esto puede ayudarle a probar su tema con los elementos de la interfaz de usuario que sus usuarios de la organizacin
ver ms.
Para las implementaciones de una sola organizacin que no tienen una licencia para crear organizaciones, usted puede probar
sus temas
en una segunda instalacin del servidor. Por ejemplo, usted podra descargar la copia de evaluacin de JasperReports
Servidor e instalarlo en el mismo equipo en el que se desarrolla el tema. Esto le permite ver cmo su tema
128
Captulo 6 Temas
aparece ya sea como un tema del sistema o en la organizacin por omisin. Al igual que en el caso de la organizacin del
ensayo, prueba de su
tema con todas las caractersticas de servidor, por ejemplo, el Ad Hoc Editor, Diseador de paneles, controles de entrada en
informes, programacin, y similares.
Cuando el tema es bien probado-y casi completo, usted debe probar en el servidor de produccin. Cargue su
tema a la carpeta Themes donde tiene la intencin de implementar, pero no lo activa. Inicie sesin como un usuario de prueba
y aadir
el siguiente parmetro a cualquier URL, por ejemplo, la pgina principal de URL:
Y theme = <tema-name>
Esto activa el tema para el usuario de prueba en todas las pginas a las que accede hasta los tiempos de la sesin de usuario
a cabo. Este
le permite navegar toda la aplicacin y ver el efecto de su tema en el entorno de produccin,
sin afectar a otros usuarios.
Para establecer el tema en el valor predeterminado aadir el parmetro & tema a la URL con la cadena por defecto
(Y tema = por defecto). Esto es especialmente til si hay un problema con el tema actual tiene inadvertidamente
deshabilitado ninguna funcionalidad.
En todas estas plataformas de prueba, usted debe buscar en la interfaz de usuario generada por su tema con la misma
navegadores y versiones de navegadores que sus usuarios tienen. Si ve errores, tambin puede usar Firebug para mirar el
Reglas CSS que estn involucrados, aunque los errores no aparecen en Firefox.
6.5.4
Modificacin de la presentacin de Jaspersoft OLAP

Jaspersoft OLAP se basa en un mdulo llamado JPivot para mostrar los datos al realizar el anlisis OLAP. El JPivot
mdulo no utiliza todas las caractersticas del nuevo marco de interfaz de usuario, pero es compatible con algunas
personalizaciones a travs de
temas. Por ejemplo, no utiliza paneles que se pueden ocultar, y las imgenes de los iconos no se almacenan en un tema.
Sin embargo, algunas caractersticas de visualizacin de la tabla de anlisis son controlados por el tema, mediante el uso de la
analysisView Identificacin en el dataDisplays.css archivo de tema.
Por ejemplo, puede cambiar las lneas entre las celdas de la tabla de anlisis con la siguiente regla en su
archivo overrides_custom.css:
td #analysisView {border: delgado slido negro; }
6.5.5
Interfaz de usuario de ejemplo

Al probar su tema, usted debe buscar en su efecto a travs de todas las pginas y cuadros de dilogo de JasperReports Server.
Sus pruebas de organizacin y prueba los usuarios deben tener acceso a todas las funciones del servidor para ver la interfaz de
usuario con la
todas las condiciones. Una prueba adicional es mirar las muestras de interfaz de usuario con el tema que est desarrollando.
La pgina muestra la interfaz de usuario es una nueva pgina que se incluye con el nuevo diseo de la interfaz. Slo es
accesible a
administradores:
1. Inicie sesin como administrador en el entorno de prueba en el nivel donde quieres poner a prueba tu tema
(superusuario o jasperadmin de una organizacin o suborganizacin).
2.
Si no lo ha hecho, cargue su tema a la carpeta Temas en este nivel. Ver "Creacin de

Temas "en la pgina 124.
3.
4.
Seleccione Ver> IU Muestras desde el men principal en cualquier pgina.

Mira todos los componentes de la muestra en cada una de las galeras de la muestra. Por ejemplo, los botones galera
espectculos
todos los diferentes tipos de botones en todos los estados de accin posible.
129
Figura 8.6 Todos los componentes de botn posibles en las galeras de la muestra
5.
Al hacer clic en los diseos estndar, la muestra sustituye a la pgina de ejemplos. Seleccione Ver> IU Muestras
desde el men principal de nuevo para volver a las galeras.
La pgina de muestras se basa en un archivo CSS extra que no se requiere en un tema, pero que puede ser incluido. El
archivo samples.css se encuentra en el tema por defecto en la carpeta Temas de nivel de sistema. Si los elementos de la
muestra
no aparecen como se esperaba, agregar este archivo a su tema y personalizar sus reglas como sea necesario. Las reglas en
este archivo no se utilizan en ninguna otra parte de la interfaz de usuario, por lo que no se debe incluir en su tema final.
Visualizacin de las galeras de la muestra puede ayudarle a encontrar rpidamente los errores en su tema, sobre todo si va a
cambiar
muchas reglas y el reemplazo de archivos enteros en su tema. El uso de estas muestras, junto con los procedimientos de
prueba y
herramientas descritas anteriormente, se puede comprobar que el tema implementa correctamente la interfaz de usuario
personalizada que
que tena planeado. Tener un tema bien probado minimiza las posibilidades de errores al activar el tema en su
servidor de produccin.
130
Y
CAPTULO 7 IMPORTAC
EXPORTAC
IN
IN
Las herramientas de importacin y de exportacin le permiten extraer recursos o agregar recursos a un servidor JasperReports
repositorio. Los servicios pblicos tambin se encargan de las tareas programadas, usuarios y roles que el servidor almacena
internamente. Importacin y
exportacin puede ser til cuando se migra de una versin de JasperReports Server o cuando se mueve entre la prueba
y entornos de produccin.
JasperReports Server proporciona una interfaz de usuario y las utilidades de lnea de comandos para realizar la importacin y la
exportacin. El
funcionalidad en la interfaz de usuario (UI) slo est disponible para los administradores de sistemas ( superusuario por defecto) y la
utilidades de lnea de comandos requieren acceso al sistema de archivos donde est instalado el servidor.
7.1
Importacin y exportacin Catlogos

Importacin y exportacin a travs de la interfaz de usuario
web
Importacin y exportacin a travs de la lnea de comandos
Alternos Scripts Import-Export
Importacin y exportacin Catlogos

La salida del comando de exportacin y la entrada al comando de importacin se llama un catlogo. Se trata de un conjunto de
carpetas
y archivos que representan el contenido de la base de datos interna del servidor, incluyendo organizaciones, usuarios, roles,
trabajos programados y los recursos del repositorio, como los informes y archivos asociados. Cuando usted no necesita la
totalidad
base de datos, puede especificar opciones para exportar slo el contenido que necesita, por ejemplo, una funcin y sus usuarios.
Los recursos en el repositorio menudo tienen dependencias en otros recursos, por ejemplo, un informe que se basa en
imgenes, tipos de datos de entrada, y una fuente de datos. Exportacin de un recurso incluye todas sus dependencias, aunque
se almacenan en carpetas que no se especificaron en el comando de exportacin. Importacin de un catlogo que contiene tales
dependencias se vuelva a crear la misma estructura de carpetas en el repositorio de destino. Una vez importados, puede mover y
redefinir las dependencias de estos recursos.
El catlogo se puede exportar, ya sea como una jerarqua de carpetas y archivos, o como un nico archivo zip (archivo
comprimido)
que contiene la misma informacin. Independientemente del formato de catlogo, el contenido del catlogo no estn destinadas
para el acceso externo. Los objetos en la base de datos, como los usuarios, roles y carpetas, se describen en los archivos XML,
y
recursos del repositorio se almacenan en varios formatos privados que consisten en archivos de datos y subcarpetas. El XML
la sintaxis de los archivos de catlogo no est definido pblicamente, y los archivos de datos no se significa para ser visitada.
Para acceder e interactuar con los objetos internos del servidor, utilice la API REST v2. Este servicio web tiene bien definido
tipos de datos y los descriptores de recursos en formatos XML o JSON y un conjunto completo de los mtodos de lectura y
escribir objetos en el servidor. Para obtener ms informacin, consulte la Gua de Servicios Web JasperReports Server.
131
A partir de JasperReports Server 5.5, las contraseas de usuario y contraseas de origen de datos se cifran en exportada
catlogos, as como en la base de datos interna del servidor. Usted todava debe tomar las medidas apropiadas para asegurar
el archivo de catlogo del acceso no autorizado. Los archivos de catlogo contienen metadatos sensibles como nombres de
usuario,
URL de base de datos, y las organizaciones internas o externas. Los archivos de catlogo tambin pueden contener datos en
forma de
informar de salida, como el PDF de un informe ejecutivo.
7.1.1
Configuracin de la clave de cifrado Import-Export

A partir de JasperReports Server 5.5, todas las contraseas sensibles en catlogos exportados son encriptados para mayor
seguridad. En orden
por dos servidores compartan el contenido cifrado de un catlogo exportado, deben compartir una clave privada. El valor por
defecto
clavecifrado
es unaes
cadena
de 128 bits
almacenada
en uninterna
archivo
configuracin.
Este
independiente
de AES
la propia
encriptacin
deldeservidor.
Todas las contraseas de usuario se almacenan
cifradas en
la base de datos interna, como se describe en "Cifrado de contraseas de usuario" en la pgina 164. El cifrado de importacin y
exportacin
slo se aplica a catlogos de exportacin.
Configuracin de la clave de cifrado Import-Export
Archivo de configuracin
... / WEB-INF / applicationContext-security.xml
Propiedad
Frijol
Descripcin
<Nombre de propiedad = "keyBytes">

<Valor> 0x2b 0x6C 0x34 0x22
0x44 0x42 0x6F 0xb5 0x7f
0x34 0xD3 0x5a 0x1f 0x92
0xCD 0xDC </ value>
</ Propiedad>
ImportExport
Cifrado
Establezca el valor de la propiedad de los keyBytes a la

mismo valor hexadecimal (16 bytes = 128 bits)
en todos los servidores que intercambiarn exportacin
catlogos.
Sin embargo, tenga en cuenta que cuando se cambia una clave privada en el servidor, todas las exportaciones anteriores no se
pueden utilizar.
Por lo tanto, debe configurar su nuevo servidor inmediatamente despus de su instalacin, y usted debe configurarlo con la tecla
de un servidor existente, si tiene uno. De esta manera todos sus servidores y todos los catlogos de exportacin utilizarn el
misma clave y ser compatibles entre s.
7.1.2
Importacin sin cifrar Catlogos

Las versiones anteriores a 5.5 no encriptan las contraseas de los usuarios a la exportacin. Estas contraseas aparecen en
texto simple
dentro de los archivos del catlogo de exportacin. Por compatibilidad con versiones anteriores, an se admiten catlogos sin
cifrar y
se
importarque
a un
cuando se
una
de cifrado. Server 5.5 o posterior tienen cifrado
Laspuede
contraseas
senuevo
cifran servidor,
medianteincluso
una operacin
de configura
exportacin
enclave
JasperReports
marcadores, contraseas para mayores sin los marcadores se pueden detectar y se importan como texto sin formato. Una vez
de texto plano
contraseas se importan, se almacenan internamente con el cifrado, y se cifrarn en cualquier exportacin futuro.
7.2
Importacin y exportacin a travs de la interfaz de

usuario
web
JasperReports
servidor proporciona funcionalidad para importar y exportar recursos y usuarios a travs de la interfaz de
usuario:
132
Exportacin desde la interfaz de usuario del

repositorio
Exportacin desde la interfaz de usuario de
configuracin
Importacin desde la interfaz de usuario de
Cuando la importacin y exportacin a travs de la interfaz web, recuerde lo siguiente:
configuracin
Si va a importar a otro servidor, debe configurar una clave de cifrado en ambos servidores, como
descrito en "Ajuste de la-Export Import clave de cifrado" en la pgina 132. Entonces usted debe entrar en el almacn de
claves
contrasea cuando se le solicite por la operacin de importacin.
Asegrese de que la ubicacin de salida especificada para una exportacin es de escritura al usuario local que ejecuta el
servidor de aplicaciones
contiene JasperReports Server.
7.2.1
Exportacin desde la interfaz de usuario del

repositorio
Para exportar los recursos individuales o toda una carpeta del repositorio:
1. Inicie la sesin como administrador del sistema ( superusuario por defecto).
2.
3.
4.
Seleccione Ver> Repositorio. Tambin puede exportar los informes ad hoc vistas, cuadros de mando, y vistas OLAP desde
la Biblioteca pgina.
Localice el recurso que desea exportar. Seleccione uno o ms recursos (usando Control-y Shift-clic) en el
panel principal, o al ver el repositorio, seleccione una carpeta en el panel de la izquierda.
Haga clic derecho en la carpeta seleccionada o los recursos seleccionados y seleccione Exportacin en el men
contextual.
Aparecer el cuadro de dilogo Recursos de
Exportacin:
Figura 7-1 Exportacin Recursos de dilogo en el Repositorio

5.
Especifique el nombre del archivo zip para el catlogo exportado. Para descargar el catlogo, el dilogo
slo es compatible con el formato de archivo zip.
6.
Especifique las siguientes opciones si lo desea:
7.
Desactive la Incluya los permisos del repositorio casilla para exportar los recursos y carpetas sin permisos.
Tras la importacin, las carpetas y los recursos van a heredar los permisos del repositorio de destino. Por
De forma predeterminada, esta casilla est marcada.
Comprobar Incluye trabajos de informes si desea incluir trabajos de informes programados con los informes incluidos en
la seleccin.
Haga clic en Exportar. El servidor genera el archivo de catlogo zip y su navegador le pide que guarde el archivo.
Dependiendo del tamao del repositorio y las opciones que haya seleccionado, puede tardar varios minutos a
generar el archivo de catlogo.
133
Los recursos se exportan junto con las dependencias, incluso si no se encuentran en la seleccionada
carpetas. Para obtener ms informacin, consulte "Importar y exportar catlogos" en la pgina 131.
7.2.2
Exportacin desde la interfaz de usuario

de configuracin
Para exportar usuarios y roles, adems de, o en lugar de contenido del repositorio, utilice las pginas de configuracin del
servidor para
los administradores del sistema. Esta pgina ofrece ms opciones que la exportacin contextual de la interfaz de usuario
delpartir
repositorio.
A
de JasperReports Server 5.5, todas las exportaciones contienen contraseas encriptadas y si va a importar a un
diferente
servidor, debe configurar una clave de cifrado en ambos servidores. Ver "Configuracin del cifrado Import-Export
Clave "en la pgina 132 para ms detalles.
Para exportar los datos a travs de la interfaz web:
1. Inicie la sesin como administrador del sistema (superusuario por
defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Exportacin en el panel de
la izquierda.
Figura 7-2 Interfaz de usuario para la Exportacin

3.
4.
Especifique el nombre del archivo zip para el catlogo exportado.

La interfaz de usuario web slo admite el formato de archivo
zip.
Utilice las casillas de verificacin y de mltiples listas de seleccin para elegir el contenido de su archivo de
catlogo exportado:
a. Comprobar Exportacin Todo exportar el repositorio completo, incluyendo los permisos y trabajos de informes, como
as como a todas las organizaciones, usuarios y roles. Marque la casilla para Incluye eventos de acceso si quieres
incluir las fechas de modificacin de los recursos.
b.
134
Desactive la casilla para Exportacin Todo y seleccionar slo los usuarios y roles para
exportar.
Si ha desactivado la casilla de Exportacin Todo, debe especificar los usuarios y roles para exportar.
5.
6.
7.2.3
Los botones de seleccin de usuarios y clases, controlan la forma de seleccionar los usuarios y roles para exportar. Usted
puede seleccionar directamente a los usuarios y roles para exportar, o bien puede seleccionar de manera indirecta. Por
ejemplo, si hace clic en el
Exportar usuarios con roles seleccionados botn de radio, puede seleccionar los usuarios para exportar; el servidor tambin
exporta el
roles seleccionar
asignados ausuarios
los usuarios
seleccionados.
Para
y roles
especficos:
a. Seleccione Exportar seleccionado individualmente roles y usuarios.
El Seleccione los usuarios y Seleccione los roles listas se vuelven
activas.
b.
Seleccione los usuarios y roles para exportar.
Para seleccionar las
funciones:
a. Seleccione Exportar usuarios con roles seleccionados.
b. Seleccione las funciones que desea exportar. El servidor tambin exportar los usuarios que se asignan
los roles.
Los usuarios asignados a los roles seleccionados se resaltan.
7.
Para seleccionar los

usuarios:
a. Seleccione Papeles de exportacin asignados a usuarios seleccionados.
b. Seleccione los usuarios que desea exportar. Tambin se exportaron sus
roles.
Las funciones asignadas a los usuarios seleccionados se resaltan.
8.
En ediciones comerciales de JasperReports Server, puede comprobar Incluye eventos de auditora y Incluya
eventos de monitoreo segn sea necesario.
9.
Haga clic en Exportaciones. El servidor genera el archivo de catlogo zip y su navegador le pide que guarde el archivo.
Dependiendo del tamao del repositorio y las opciones que haya seleccionado, puede tardar varios minutos a
generar el archivo de catlogo.
Importacin desde la interfaz de usuario

de configuracin
Las pginas de configuracin para los administradores de sistemas incluyen una interfaz de usuario para simplificar el
procedimiento de importacin.
Esta importacin opera en una instancia en ejecucin de un servidor, y todos los recursos importados son visibles de
inmediato. En
Adems, todos los ajustes de configuracin o de seguridad en el catlogo importado se aplique inmediatamente, sin
necesidad de reiniciar el servidor.
A partir de JasperReports Server 5.5, todas las exportaciones contienen contraseas encriptadas y si va a importar a un
diferente
servidor, debe configurar una clave de cifrado en ambos servidores. Ver Configuracin de la clave de cifrado Import-Export
para ms detalles.
No se puede utilizar la interfaz de usuario de importacin para importar un catlogo de una JasperReports Server 5.2 o
anterior si era
creado con la opcin "exportar todo". Archivos de los temas contenidos en los catlogos de exportacin previos
versiones del servidor se sobrescriben temas nuevos, pero no son compatibles y causan visualizacin HTML
errores. Para importar un catlogo de una versin anterior del servidor, utilice la lnea de comandos de utilidad <JSinstalar> /buildomatic/js-import.bat o .sh con la opcin --skip-temas.
Si usted tiene un tema personalizado para importar, puede utilizar la interfaz de usuario del tema para descargarlo desde el
servidor de origen
y subirlo al servidor de destino. Si su tema contiene la pageSpecific.css archivo, debe eliminarlo de
el archivo ZIP antes de la carga y, a continuacin, rehacer sus cambios en el archivo basado en pageSpecific.css en el
apuntar servidor desde 5.5 o posterior. Para obtener ms informacin, consulte "Descarga e postal Carga Tema Files"
en la pgina 125.
135
Para importar datos a travs de la interfaz web:

1. Inicie la sesin como administrador del sistema ( superusuario por
defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Importacin en el panel de
la izquierda.
Figura 7-3 Interfaz de Usuario para Importacin

3.
4.
5.
Haga clic en Explorar para elegir el archivo de catlogo zip importar. La interfaz de usuario web slo admite el formato de
archivo zip.
Puede importar cualquier archivo de catlogo zip creado por la interfaz de usuario de exportacin o la utilidad de
Utilice
las casillas
de de
verificacin
para cambiar el comportamiento de la operacin
exportacin
de lnea
comandos.
de importacin:
Cuando se activa, el Actualizacin opcin slo importar los recursos que son ms recientes que los que tienen la
misma
URI en el repositorio actual. El Saltar actualizaciones de usuario opcin le permite mantener la definicin actual
de cualquier usuario que tambin existen en el catlogo importado.
Cuando se activa, el Incluye eventos de acceso opcin importa los tiempos de modificacin de los recursos de
el catlogo. Cuando se desactiva, los recursos mantengan sus tiempos de acceso existentes, si ya existen.
En ediciones comerciales de JasperReports Biblioteca, la Incluye eventos de auditora y Incluya el monitoreo
eventos determinar si el acceso y eventos de supervisin del catlogo, si los hay, son importados.
El Incluya la configuracin del servidor opcin determina si la configuracin del sistema se actualiza de la
catlogo. Hay dos requisitos previos con el fin para el catlogo que contiene los valores de configuracin:
La configuracin del servidor originario deben ser modificados a travs de la interfaz de usuario. Por lo tanto, ajustes
slo registro, Ad Hoc
Ajustes, Ajustes de AWS y Configuracin OLAP se ven afectados. Para obtener ms informacin, consulte
"Configuracin
Ajustes en la interfaz de usuario "en la pgina 172
El catlogo debe exportarse con la opcin de "todo" de la interfaz de usuario o el
utilidad de lnea de comandos.
Cuando se importan los valores del servidor, que entran en vigor de inmediato y que aparecen en la interfaz de
usuario de configuracin.
Haga clic en Importar.
El servidor carga el archivo de catlogo zip e importa su contenido en el repositorio. Dependiendo del tamao
del catlogo y las opciones que haya seleccionado, puede tardar varios minutos para realizar la importacin.
136
7.3
Importacin y exportacin a travs de la lnea de comandos

Si ha instalado JasperReports Server desde el instalador binario, se configuraron las utilidades de lnea de comandos
por el instalador. Si ha instalado la distribucin de archivos WAR, debe seguir las instrucciones de "Configuracin de
Importacin-exportacin de utilidades "en la pgina 141 antes de poder ejecutar las utilidades.
Las utilidades de importacin y exportacin son shell scripts localizados en los <js-install> carpeta /
buildomatic:
Ventanas: <js-instalacin> \ buildomatic \ js-import.bat
<Js-instalacin> \ buildomatic \ js-export.bat
Linux: <js-install> /buildomatic/js-import.sh
<Js-install> /buildomatic/js-export.sh
Los ejemplos de este captulo utilizan los comandos de Windows acortado sin la extensin bat opcional en el
lnea de comandos. Si est ejecutando JasperReports servidor en Linux, asegrese de aadir la extensin de archivo .sh.
Al utilizar los servicios de importacin y exportacin, tenga en cuenta lo siguiente:
Servidor JasperReports debe interrumpirse cuando se usan las utilidades de importacin y exportacin. Esto es muy
importante
para la utilidad de importacin para evitar problemas con las memorias cach, configuracin y seguridad.
Todas las opciones de lnea de comandos comienzan con dos guiones (-).
Debe especificar un directorio o un archivo zip para exportar o importar.
Si va a importar a otro servidor, debe configurar una clave de cifrado en ambos servidores, como
descrito en Configuracin de la clave de cifrado Import-Export. A continuacin, debe introducir la contrasea del almacn de
claves cuando
impulsada por el comando de importacin.
Asegrese de que la ubicacin de salida especificada para una exportacin es de escritura para el usuario que ejecuta el
comando.
Todos los URIs son las rutas de repositorios que se originan en la raz. Las rutas de repositorios que se muestran en este
captulo suponen
est utilizando una edicin comercial del servidor. En la edicin de la comunidad, los caminos no son organizaciones,
por ejemplo:
Ediciones comerciales: / Organizaciones / organization_1 / informes / interactive / CustomersReport
Proyecto de la Comunidad:/ Informes / interactive / CustomersReport
7.3.1
Exportacin desde la lnea de comandos

Uso: js-exportacin [OPCIONES]
Jaspersoft recomienda que deje la instancia del servidor antes de ejecutar la utilidad de exportacin. Para obtener
instrucciones
ver el Gua de instalacin del servidor JasperReports.
Especifica los recursos del repositorio, tales como informes, imgenes, carpetas y tareas programadas para exportar al
sistema de archivos.
Tambin puede exportar las definiciones internas de los trabajos programados, usuarios, roles, adems de datos de auditora
existentes. El
exportacin de salida es conocido como un repositorio de catlogo; o bien es un archivo o un conjunto de archivos en una
estructura de carpetas:
137
Tabla 7-1 Opciones en js-exportacin Comando

Opcin
Explicacin
--everything
Exportar todo excepto de auditora y datos de seguimiento: todos los recursos del repositorio,
permisos, informe de empleo, usuarios y roles. Si ninguna configuracin de servidor han sido
modificado en la interfaz de usuario, los estn incluidos tambin.
Esta opcin es equivalente a:
--uris --repository-permisos --Informe-jobs --calendars --users --roles
--help
Muestra una breve informacin sobre las opciones disponibles.
--include-access-eventos
Los eventos de acceso (fecha, hora y nombre de usuario de la ltima modificacin) se

exportan.
--output-dir
Ruta de acceso de un directorio en el que se crear la carpeta del catlogo de

salida.
--output-zip
Ruta de acceso y nombre de archivo del archivo de catlogo zip de

salida para crear.
--Informe-jobs
Comma lista de informes repositorio de unidades y carpetas URIs separados para que informe
puestos de trabajo de la unidad deben ser exportados. Para una carpeta URI, esta opcin exporta
la programada
puestos de trabajo de todos los informes de la carpeta y todas las subcarpetas de forma recursiva
en.
Cuando se especifica, la exportacin incluir todas y todos los calendarios de todo tipo (fiestas,
recurrente, ...) definida en el planificador. Cuando calendarios estn presentes en una exportacin
catlogo, siempre se procesan y agregan a la importacin.
--calendars
--repository-permisos
Cuando esta opcin est presente, los permisos del repositorio se exportan junto con cada
carpeta y recursos exportados.
Esta opcin slo debe utilizarse en conjuncin con --uris.
--roles
Comma lista de funciones a la exportacin separado; si no hay papeles estn especificados con
esta opcin,
todos los papeles se exportan.
--role usuarios
Cuando esta opcin est presente, cada exportacin funcin activa la exportacin de todos los
usuarios
pertenencia a la funcin. Esta opcin slo debe utilizarse en conjuncin con --roles.
--uris
Comma lista de carpetas o recursos URIs separados en el repositorio.
--users
Lista separada por comas de los usuarios a la exportacin separado; si ningn usuario se
especifican con este
opciones, todos los usuarios se exportan. Exportacin de un usuario incluye todos los atributos de
usuario y,
con el fin de mantener la coherencia, tambin exporta todos los roles asignados al usuario. Cuando
especificando
los usuarios,
debe dar su
ID organizacin...si es aplicable, por ejemplo:
--users superusuario,
"jasperadmin
| organization_1",
--include-auditora-eventos
Incluya datos de auditora de todos los recursos y usuarios en la

exportacin.
--include-Monitoring
eventos
Incluya datos de seguimiento de todos los recursos y usuarios en la exportacin.
Las contraseas de usuario estn encriptados durante la exportacin por defecto, pero catlogos exportados
pueden contener
datos sensibles. Tome las medidas apropiadas para asegurar el archivo de catlogo del acceso no autorizado.
138
Ejemplos:
Exportar todo en el repositorio:

js-exportacin --everything mi_exportacin --output-dir
Exportar el informe CustomersReport unidad / / interactive / informe a una carpeta de

catlogo:
js-exportacin --uris / organizaciones / organization_1 / informes / interactive /
Mi_exportacin CustomersReport --output-dir
Exportar los / las imgenes y / carpetas de

fuentes:
js-exportacin --uris / organizaciones / organization_1 / imgenes / organizaciones / ORGANIZATION_
1 / informes --output-dir mi_exportacin
Exportar todos los recursos (salvo los usuarios, roles y horarios de trabajo) y sus permisos a un catlogo zip:
js-exportacin --uris / --repository-permisos --output-zip myExport.zip
Exportar todos los recursos y las tareas de

informe:
js-exportacin --uris / --Informe-empleo / mi_exportacin --output-dir
Exportar los trabajos de informes de la unidad / informes / informe interactivo /

CustomersReport:
js-exportacin --Informe-jobs / organizaciones / organization_1 / informes
/ / CustomersReport mi_exportacin --output-dir interactivo
Exportar todos los roles y usuarios:
Exportar los papeles ROLE_USER y ROLE_ADMINISTRATOR junto con todos los usuarios que pertenecen a
cualquiera
papel:
mi_exportacin js-exportacin --roles --users --output-dir
js-exportacin --roles ROLE_USER, ROLE_ADMINISTRATOR --role usuarios --output-dir mi_exportacin
El --uris opcin le permite especificar uno o ms URIs de recursos. Un URI puede especificar un recurso como un
informe. En este caso, todos los recursos asociados (tales como imgenes, subinformes, fuentes de datos, paquetes de
recursos y de clase
archivos) se exportan. Un URI tambin puede especificar una carpeta. Si se especifica una carpeta, la operacin de exportacin
exporta todo
recursos y carpetas contenidos en la carpeta. Adems, recursivamente a travs de todas sus subcarpetas.
La carpeta denominada Temp en la raz y en todas las organizaciones es una carpeta especial. Ninguna de las carpetas o
recursos en una carpeta Temp se exportan.
7.3.2
Importacin desde la lnea de comandos

Ver "Importacin y exportacin a travs de la lnea de comandos" en la pgina 137 de directrices al ejecutar el
utilidades de lnea de comandos.
Cuando se utiliza la utilidad de lnea de comandos js-importacin, el servidor debe ser detenido para evitar problemas con
cachs,
configuracin y seguridad. Consulte las instrucciones en el Gua de instalacin del servidor JasperReports.
Uso: js-importacin [OPCIONES]

Lee un catlogo repositorio del sistema de archivos y crea el recurso con nombre en el servidor JasperReports
repositorio. El catlogo repositorio debe haber sido creado por la interfaz de exportacin o el js-exportacin comando,
ya sea como un archivo ZIP o una estructura de carpetas.
139
A partir de JasperReports Server 5.5, todas las exportaciones contienen contraseas encriptadas y si va a importar a un
diferente
servidor, debe configurar una clave de cifrado en ambos servidores. Ver Configuracin de la clave de cifrado Import-Export
para ms detalles.
Tabla 7-2 Opciones en js-importacin Comando
Opcin
Explicacin
--help
Muestra una breve informacin sobre las opciones disponibles.
--input-dir
Sendero para importar un catlogo de un directorio.
--input-zip
Ruta de acceso y nombre de archivo para importar un catlogo de un

archivo zip.
--update
Recursos en el catlogo sustituyen a las del repositorio si sus URIs y tipos

partido.
--skip-user-update
Cuando se utiliza con --update, los usuarios del catlogo no se importan o se actualizan. Uso
esta opcin para importar catlogos sin sobrescribir los usuarios definidos actualmente.
--include-access-eventos
Restaura los eventos de acceso (fecha, hora, nombre de usuario y de la ltima

modificacin) en
recursos importados.
--include-auditora-eventos
Edicin Professional. Importa los datos de auditora que existe en el catlogo.
--include-Monitoring
eventos
Edicin Professional. Importa los datos de vigilancia que existe en el catlogo.
--include-servidor-settings
Determina si la configuracin del sistema se actualiza desde el catlogo. Hay

son dos requisitos previos con el fin para el catlogo que contiene los valores de configuracin:
La configuracin del servidor de origen deben ser modificados a travs de la interfaz de usuario
(Ajustes del registro,
Ad Hoc Configuracin Ad Hoc cach y Configuracin OLAP). Para obtener ms informacin,
consulte "Configuracin Ajustes en la interfaz de usuario "en la pgina 172.
El catlogo debe exportarse con la opcin de "todo" por parte del usuario
interfaz o la utilidad de lnea de comandos.
Cuando se importan los valores del servidor, que entren en vigor tan pronto como el servidor
es
comenzado.
--skip-temas
Se requiere esta bandera al importar un catlogo que incluye un tema, como por ejemplo
cuando se utiliza --export-todo, desde una versin de servidor 5.2 o antes a la versin 5.5
o posterior. Si usted tiene un tema personalizado para importar, puede utilizar la interfaz de usuario
Tema de abajo
cargarlo desde el servidor de origen y subirlo al servidor de destino. Si tu cin tema
contiene la pageSpecific.css archivo, debe quitarlo desde el archivo ZIP antes
cargar y, a continuacin, rehacer sus cambios en el archivo basado en pageSpecific.css en
el servidor de destino desde 5.5 o posterior. Para obtener ms informacin, consulte "Descarga y
Cargar postal Tema Archivos "en la pgina 125.
Ejemplos:
Importe el archivo de almacenamiento catlogo

myExport.zip:
js-importacin --input-zip myExport.zip
140
Importar la carpeta del catlogo MYDIR, en sustitucin de los recursos existentes si sus URIs y tipos coinciden con los
encontrados en
el catlogo:
js-importacin --input-dir MYDIR --update
Importe el archivo de almacenamiento catlogo myExport.zip pero ignorar cualquier usuario que se
encuentran en el catlogo:
js-importacin --input-zip myExport.zip --update --skip-user-update
Importar la carpeta del catlogo MYDIR con eventos de acceso:

js-importacin --input-dir MYDIR --include-access-eventos
El comportamiento por defecto cuando un recurso se encuentra en el repositorio de destino que tiene el mismo URI como el
recurso que
que est intentando importar es saltarse la operacin de creacin y dejar el recurso existente sin cambios (sin
sobrescritura). Para eliminar el recurso existente y reemplazarlo con uno nuevo (del mismo tipo y con la
misma URI), utilice el --update opcin. Tenga en cuenta que, si el recurso en el catlogo de exportacin es de un tipo diferente de
el recurso existente, el servidor devuelve un error y se salta la operacin de actualizacin.
Al importar un usuario, si existen sus papeles en el repositorio, el usuario recibe estos papeles. Las propiedades de usuario
son
importado con el usuario.
Al importar los eventos de acceso, la fecha y hora de la ltima modificacin antes de la exportacin se restaura en la
importacin
para cada recurso. La carpeta de catlogo se debe haber creado con eventos de acceso. Si no realiza la importacin de
acceso
eventos, o si no existen en los archivos importados, se utilizan la fecha y hora de la importacin.
7.3.3
Configuracin de Importacin-Exportacin
Utilidades
Si ha instalado JasperReports Server desde el instalador binario, las utilidades de importacin y exportacin se han configurado
por el
instalador. Si ha instalado la distribucin de archivos WAR, debe configurar varios archivos antes de poder utilizar el
servicios de importacin y exportacin.
Otra opcin es utilizar el "Scripts Alternos Import-Export" en la pgina 142 porque no requieren ningn
configuracin, independientemente del mtodo de instalacin.
1.
Dependiendo de la base de datos que utilice, copie el archivo de configuracin de la

instalacin:
de: <js-install> / buildomatic / sample_conf / <base de datos> _master.properties
a: <js-instalar> /buildomatic/default_master.properties
2.
Editar el archivo default_master.properties para establecer los valores especficos de su instalacin. Para obtener ms
informacin acerca de
la configuracin de este archivo, ver el Gua de instalacin del servidor JasperReports.
Usuarios de Oracle pueden establecer el sysUsername y sysPassword para el mismo nombre que dbusername y
dbPassword en los default_master.properties. No se requiere el nombre de usuario y contrasea del sistema
porque js-importacin y exportacin-js no hacen cambios al esquema de base de datos.
3.
Ejecute el siguiente comando:

js-hormiga limpia-config gen-config
Este comando generar los siguientes archivos con los valores agregados a los default_master.properties
archivo:
4.
<js-install> /buildomatic/build_conf/default/js.jdbc.properties
<js-install> /buildomatic/build_conf/default/js.quartz.properties (slo para DB2 y PostgreSQL)
Asegrese de que el controlador JDBC para la base de datos se encuentra en la carpeta siguiente:
<Js-install> buildomatic / conf_source / iePro / lib
Si es necesario, se pueden encontrar enlaces para descargar los drivers JDBC desde el sitio web de Jaspersoft
Comunidad:
base de datos de los conductores http://community.jaspersoft.com/wiki/downloading-y-instalar-
141
7.4
Alternos Scripts Import-Export

Independientemente de su mtodo de instalacin, JasperReports Server proporciona una tercera forma de ejecutar la
importacin-exportacin
los comandos. Buildomatic es otro script de lnea de comandos que se basa en la Apache Ant herramienta para automatizar
instalaciones. Incluye metas (sub-comandos) para realizar operaciones de importacin y exportacin con las mismas opciones
como los scripts. Los siguientes ejemplos comparan los dos comandos:
Scripts de Shell: js-export.sh --everything --output-file = js-catlogo-exp.zip
Buildomatic:
js-ANT-exportacin todo -DexportFile = js-catlogo-exp.zip
Ambos tipos de scripts se encuentran en el <Js-instalacin> / buildomatic carpeta.
7.4.1
Correr Importar de Buildomatic

El importacin objetivo para hormiga tiene la siguiente sintaxis:
Ventanas: js-hormiga importacin -DimportFile = <nombre de archivo> [-DimportArgs = "<importacin-options>"]
Linux y ./js-hormiga importacin -DimportFile = <nombre de archivo> [-DimportArgs = \ "<importacin-options> \"]
Mac OSX:
El archivo importado se maneja como un archivo ZIP si su nombre termina en zip, si no se maneja como un directorio. El
importArgs argumento es opcional y puede contener ms de una opcin de importacin. En Linux, todas las comillas dobles
marcas (") Debe ser escapado con una barra invertida ( \).
Al realizar una gran importacin utilizando js-hormiga, el servidor debe ser detenido (o sea puesto en un modo con
reduccin de la carga) para evitar problemas con las memorias cach, configuracin y seguridad.
Los ejemplos siguientes son comandos tpicos de importacin en Windows:

js-import-help-pro
js-hormiga importacin -DimportFile = mi-reports.zip
js-hormiga importacin -DimportFile = my-datasources -DimportArgs = "- Actualizacin"
Los ejemplos siguientes son comandos tpicos de importacin en Linux:
./js-import-help-pro
./js-hormiga importacin -DimportFile = mi-reports.zip
./js-hormiga importacin -DimportFile = mi-datasources.zip -DimportArgs = \ "- update \"
7.4.2
Ejecucin de las Exportaciones de

Buildomatic
El exportacin objetivo para hormiga tiene la siguiente sintaxis:
Ventanas: exportacin js-hormiga -DexportFile = <nombre de archivo> -DexportArgs = "<-opciones de exportacin>"
Linux y ./js-hormiga exportacin -DexportFile = <nombre de archivo> -DexportArgs = \ "<-opciones de exportacin> \"
Mac OSX:
El formato de archivo de exportacin es un archivo ZIP o un conjunto de archivos con un nuevo nombre de directorio. Si se
especifica la extensin zip
para su archivo de salida, un archivo ZIP se crea automticamente. De lo contrario, un directorio con los archivos y subdirectorios se crea como un conjunto de archivos sin comprimir.
142
El exportArgs argumento requiere comillas dobles (") Y pueden contener ms de una opcin de exportacin, como
se muestra en estos ejemplos de Windows:
js-hormiga de exportacin-help-pro
exportacin js-hormiga -DexportFile = mi-domains.zip
-DexportArgs = "- URI / organizaciones / organization_1 / Dominios"
js-hormiga exportacin -DexportFile = mis-informes-y-users.zip
-DexportArgs = "- URI / organizaciones / organization_1 / informes
--users jasperadmin | organization_1, joeuser | organization_1 "
exportacin js-hormiga -DexportFile = my-fuentes de datos
-DexportArgs = "- URI / organizaciones / organization_1 / datasources --roles ROLE_USER"
js-hormiga exportacin -DexportFile = js-everything.zip -DexportArgs = "- todo"
En Linux, todas las comillas dobles (") Y otros personajes, como la barra vertical ( |), Que separa de inicio de sesin
nombres de usuario y organizacin deben ser escapados con una barra invertida ( \). Adems, al enumerar los nombres de
usuario, incluya
la lista entre comillas simples ('), Como se muestra en este ejemplo Linux:
./js-hormiga de exportacin-help-pro
./js-hormiga exportacin -DexportFile = mis-informes-y-users.zip
-DexportArgs = \ "- URI / organizaciones / organization_1 / informes
--users 'jasperadmin \ | organization_1, joeuser \ | organization_1' \ "
143
144
CAPTULO 8 Seguridad de aplicaciones

En este captulo se describen las opciones de configuracin que protegen JasperReports Server y sus usuarios de
acceso no autorizado. Las propiedades de configuracin aparecen en dos ubicaciones:
Algunas propiedades deben configurarse durante la fase de instalacin e implementacin, para que los usuarios accedan a
la
servidor. Estas opciones se configuran a travs de los archivos utilizados por los scripts de instalacin. Estos ajustes slo
disponibles al realizar una instalacin de archivo WAR.
Otras propiedades estn ubicadas en archivos en diferentes carpetas despus de la instalacin. Archivos de las rutas de
configuracin son en relacin
al directorio <js-install>, que es la raz de la instalacin de JasperReports Server. Para cambiar el
configuracin, editar estos archivos y reiniciar el servidor.
Debido a la ubicacin de los archivos que se describen en este captulo varan con el servidor de aplicaciones, las rutas
especificadas en
este captulo son en relacin con el archivo WAR desplegado para la aplicacin. Por ejemplo, el applicationContext.xml
archivo se muestra como que reside en la carpeta WEB-INF; si utiliza el servidor de aplicaciones Tomcat incluido con el
instalador, la ruta predeterminada para esta ubicacin es:
C: \ Archivos de programa \ jasperreports-servidor-5.6.1 \ apache-tomcat \ webapps \ JasperServer-pro \
WEB-INF
Tenga cuidado al editar las propiedades descritas en este captulo. Cambios involuntarios pueden provocar
errores inesperados en todo JasperReports Server que puede ser difcil de solucionar. Antes de cambiar
los archivos, copia de seguridad en un lugar fuera de la instalacin de JasperReports Server.
No modifique la configuracin que no se describen en la documentacin. A pesar de que algunos ajustes puede
Parece sencillo, valores distinto al predeterminado puede no funcionar correctamente y causar errores.
El cifrado de contraseas en los archivos de configuracin

Configuracin de opciones de contrasea de usuario
Configuracin del usuario Sesin inactiva
Prevencin CSRF Configuracin
Configuracin de validacin de entrada
La restriccin de la subida de archivos
Cmo ocultar los mensajes de seguimiento de pila
Definicin de una poltica de varios dominios para Flash
El cifrado de las contraseas de usuario
El cifrado de sesin de usuario Inicio de sesin
145
8.1
El cifrado de contraseas en los archivos de configuracin

En JasperReports Server versin 5.5 o mayor, una nueva caracterstica permite a los administradores ofuscan contraseas que
aparecer en los archivos de configuracin. Esto satisface los requisitos de auditora de seguridad y protege las contraseas de
ser
observado por personas no autorizadas. Por lo general, las siguientes son encriptados:
La contrasea para la base de datos interna de JasperReports Server ( JasperServer).
Las contraseas de las bases de datos de muestra ( foodmart y sugarcrm).
En Tomcat y tcServer, contraseas en definiciones de recursos JNDI.

Tambin puede cambiar la configuracin para cifrar los siguientes:
La contrasea para el servidor de correo utilizado por el planificador ( quartz.mail.sender.password)

La contrasea para la autenticacin LDAP externo.
Las contraseas en archivos de configuracin se cifran durante la instalacin JasperReports Server. Si la instalacin
despliega en el servidor de aplicaciones Tomcat, la contrasea de la base de datos se encriptan automticamente en el
JNDI
configuracin tambin (en el context.xml archivo).
Seguridad de la contrasea completa no se puede garantizar desde dentro JasperReports Server. Un usuario con suficiente
privilegios y conocimiento de JasperReports Server puede obtener acceso a las claves de cifrado y la
contraseas de configuracin. Mientras que uno puede pedir contraseas en cada reinicio del servidor, no es prctico para
mayora de los usuarios. La nica forma prctica de garantizar la seguridad de las contraseas es a travs de la copia de
seguridad y restriccin de
el acceso al archivo de propiedades del almacn de claves.
8.1.1
El cifrado de contraseas de configuracin en Tomcat (o primavera tcServer)

Para cifrar las contraseas en una instalacin de Tomcat o tcServer, modificar el procedimiento de instalacin de la
siguiente manera:
1. Dependiendo de la base de datos que utilice, copie el archivo de configuracin de la instalacin
como de costumbre:
de: <js-install> / buildomatic / sample_conf / <base de datos> _master.properties
a: <js-instalar> /buildomatic/default_master.properties
2.
Editar el archivo default_master.properties:
3.
Introduzca los valores especficos a su instalacin.

Introduzca la contrasea en texto plano.
Activar el cifrado de archivos de configuracin descomentando la encrypt = true propiedad. Usted no tiene
descomentar alguna de las otras propiedades de cifrado porque todos tienen los valores predeterminados que se
muestran.
Excepto, si est utilizando Oracle, elimine propsToEncrypt y ponerlo a dbPassword, sysPassword.
Opcionalmente, especifique las propiedades adicionales para cifrar como se describe en "Codificacin de Propiedades
adicionales
en default_master.properties "en la pgina 147.
Opcionalmente, cambie la configuracin de cifrado de archivos de configuracin como se describe en "Opciones de cifrado"
en la pgina 149.
Ejecutar el script de instalacin buildomatic (JS-instalacin) y todos los dems pasos de la instalacin de acuerdo con la
Gua de instalacin del servidor JasperReports. Esto tendr los siguientes efectos:
a.
Las contraseas de texto sin formato en default_master.properties son sobrescritos con sus equivalentes cifrados.
No hay ninguna advertencia al ejecutar js-instalar con encrypt = true.
b.
Las contraseas encriptadas se propagan a todos los archivos de

configuracin.
Los ingresos y los archivos de instalacin se copian en sus ubicaciones finales.
c.
4.
Despus de la instalacin, las contraseas se cifran en los siguientes lugares:
146
En todos los archivos de configuracin del servidor en ... / WEB-INF /

applicationContext * .xml.
En las definiciones de JNDI en ... / META-INF / context.xml.

En los archivos default_master.properties que permanece despus de la
instalacin.
Si usted tiene un error como el siguiente al reiniciar el servidor:
javax.naming.NamingException: KeystoreManager.init nunca fue llamado o hay errores
crear instancias de una instancia
puede que tenga que agregar lo siguiente a sus propiedades de inicio del servicio de
Tomcat:
-Duser.home = C: \ Users \ <TomcatUser>
8.1.2
El cifrado de contraseas de configuracin en los servidores de la

empresa
La mayora de los servidores de la empresa, como JBoss, Glassfish, WebSphere, WebLogic, y tienen formas de propiedad para
establecer
cifrado de la contrasea. Debe utilizar estos mtodos de encriptacin. JasperReports Server no establece automticamente
contraseas cifradas para estos servidores durante el despliegue. En este caso, puede adems cifrar la
contraseas en el archivo buildomatic despus de la implementacin:
1. Implementar JasperReports Server para el servidor de la empresa tal como se especifica en el Instalacin del servidor
JasperReports
Gua. La instancia de servidor JasperReports resultante tendr las contraseas de origen de datos JNDI sin cifrar. Si
desea encriptar estas contraseas, consulte la documentacin de su servidor de aplicaciones.
2. Despus de que el servidor se ha configurado correctamente, cifrar los archivos de configuracin del servidor
JasperReports como
de la siguiente manera:
a. En default_master.properties, activar el cifrado descomentando encrypt = true.
b.
Ejecute el objetivo js-hormiga de refresco-config, Lo que eliminar y volver a crear todos los archivos de configuracin
sin implementarlos en el servidor de aplicaciones. Ahora los archivos buildomatic tendrn la base de datos
contraseas encriptadas. An debe ser capaz de ejecutar la importacin / exportacin u otros scripts.
No ejecute js-instalar o js-ant deploy-webapp-pro. Estos comandos se sobreponen a los archivo de la guerra
creado en el paso 1 y hacer que las fuentes de datos del servidor inaccesible. Si tiene que volver a desplegar el archivo WAR,
restablecer la contrasea (s) base de datos a texto sin formato en sus default_master.properties y empezar de nuevo con el
paso 1.
8.1.3
Cifrar propiedades adicionales en default_master.properties

Puede cifrar propiedades adicionales en el archivo default_master.properties. Para que funcione correctamente, estas
propiedades
necesario descifrar cuando se utilizan. Actualmente, el descifrado es compatible con las propiedades que se cargan en
el contexto de aplicacin a travs de la primavera propertyConfigurer frijol en applicationContext-webapp.xml.
Si una propiedad se define a travs de JNDI, recomendamos que seala que hay frente a la
encriptacin:
<Property name = "password">
<Jee: jndi-lookup JNDI name = "java: comp / env / emailPassword" />
</ Propiedad>
El siguiente ejemplo de cdigo muestra el propertyConfigurer frijol en applicationContext-webapp.xml:
147
<Bean id = class = "com.-" propertyConfigurer "

jaspersoft.jasperserver.api.common.properties.DecryptingPropertyPlaceholderConfigurer ">
<Nombre de propiedad = "lugares">
<Lista>
<Valor> /WEB-INF/hibernate.properties </ value>
<Valor> /WEB-INF/js.quartz.properties </ value>
<Valor> /WEB-INF/js.spring.properties </ value>
<Valor> /WEB-INF/js.scheduling.properties </ value>
<Valor> /WEB-INF/mondrian.connect.string.properties </ value>
<Valor> /WEB-INF/js.diagnostic.properties </ value>
<Valor> /WEB-INF/js.aws.datasource.properties </ value>
<Valor> /WEB-INF/js.config.properties </ value>
<Valor> /WEB-INF/js.externalAuth.properties </ value>
</ List>
</ Propiedad>
...
</ Bean>
</ Pre>
Debido Jaspersoft extendi primavera de PropertyPlaceholderConfigurer clase como

DecryptingPropertyPlaceholderConfigurer, Todas las propiedades cargadas se analizan en busca de la marca especial
ENC- <valor> -. Si ese marcador se encuentra en torno al valor de la propiedad, esa propiedad se descifra antes de ser cargado
en contexto primavera.
Para determinar si su propiedad es escaneado por propertyConfigurer, Buscar en los archivos de propertyConfigurer'S
lugares para ver si se define en uno de estos archivos.
Por ejemplo, suponga que desea cifrar el contrasea propiedad de la reportSchedulerMailSender frijol
en applicationContext-report-scheduling.xml:
<Bean id = clase "reportSchedulerMailSender" = "org.springframework.mail.javamail.JavaMailSenderImpl">
<Propiedad nombre = valor "host" = "$ {report.scheduler.mail.sender.host}" />
<Propiedad nombre = valor "nombre de usuario" = "$ {report.scheduler.mail.sender.username}" />
<Propiedad nombre = valor "password" = "$ {report.scheduler.mail.sender.password}" />
<Property name = "protocolo" value = "$ {report.scheduler.mail.sender.protocol}" />
<Propiedad nombre = valor "puerto" = "$ {report.scheduler.mail.sender.port}" />
<Nombre de propiedad = "javaMailProperties">
<Props>
<Apuntalar key = "mail.smtp.auth"> false </ prop>
</ Accesorios>
</ Propiedad>
</ Bean>
$ {Report.scheduler.mail.sender.password} le dice que report.scheduler.mail.sender.password

es ms probable que se define a travs de la propertyConfigurer frijol. Buscar a travs de la propertyConfigurer ubicaciones
para verificar. Esta propiedad se define en /WEB-INF/js.quartz.properties de la siguiente

manera:
report.scheduler.mail.sender.password = $ {} quartz.mail.sender.password .
Una vez que haya verificado que el quartz.mail.sender.password propiedad puede ser encriptado usando defaultmaster.properties, se encripta antes de la instalacin de la siguiente manera:
1.
Establezca la contrasea deseada para quartz.mail.sender.password en default-master.properties:

quartz.mail.sender.password = xxyyzz
2.
148
3.
Elimine el comentario de la encrypt = true propiedad en el mismo

archivo.
Elimine el comentario propsToEncrypt = dbPassword en default-master.properties.
4.
Aadir quartz.mail.sender.password a propsToEncrypt:
quartz.mail.sender.password = xxyyzz
encrypt = true
propsToEncrypt = dbPassword, quartz.mail.sender.password
8.1.4
5.
Configurar e instalar su instalacin guerra JasperReports Server como se describe en el JasperReports Servidor
Gua de instalacin.
6.
Compruebe que report.scheduler.mail.sender.password fue cifrada en ambos-master.properties defecto

y en /WEB-INF/js.quartz.properties.
Contrasea de cifrado para la autenticacin externa

A partir de JasperReports Servidor 5.6, es posible cifrar las contraseas en la autenticacin externa
archivos de configuracin de LDAP y la autenticacin de base de datos externa. Para ello, hemos introducido propiedades de
contexto
a la configuracin de ejemplo los archivos en lugar de cadenas simples. Por ejemplo, si usted est usando LDAP para la
autenticacin,
el archivo de configuracin de ejemplo contiene lo siguiente:
<Bean id = "ldapContextSource"
class = "com.jaspersoft.jasperserver.api.security.externalAuth.ldap.JSLdapContextSource">
<valor-constructor arg = "$ {external.ldap.url}" />
<Propiedad nombre = valor "userdn" = "$ {external.ldap.username}" />
<Propiedad nombre = valor "password" = "$ {external.ldap.password}" />
</ Bean>
Los valores referenciados por la $ {...} formato se definen en el archivo js.externalAuth.properties y son importados
en su contexto a travs de la primavera propertyConfigurer. Por ejemplo, las propiedades se definen en LDAP
js.externalAuth.properties la siguiente manera:
external.ldap.url = $ {} external.ldapUrl
external.ldap.username = $ {} external.ldapDn
external.ldap.password = $ {} external.ldapPassword
El $ {...} valores se pueden configurar en default_master.properties antes de la instalacin o actualizacin. La siguiente

ejemplo muestra la sintaxis de las propiedades en el archivo default_master.properties:
external.ldapUrl = ldap: // nombre de host: 389 / dc = ejemplo, dc = com
external.ldapDn = cn = Administrador, dc = ejemplo, dc = com
external.ldapPassword = contrasea
Para cifrar la propiedad de contrasea, usted tambin establecer lo siguiente:

external.ldapPassword = xxyyzz
encrypt = true
propsToEncrypt = dbPassword, external.ldapPassword
8.1.5
Opciones de cifrado
En los scripts de instalacin buildomatic, las contraseas se encriptan de forma simtrica: la misma clave secreta se utiliza para
tanto el cifrado y el descifrado. La clave y el archivo de almacn de claves que contiene son generados al azar en cada
mquina durante la primera instalacin JasperReports Server. Todas las posteriores instalaciones JasperReports Server
en el mismo servidor confiar en el mismo almacn de claves; que no se regeneran la tecla.
149
El almacn de claves es un archivo cifrado que se utiliza para almacenar de forma segura claves secretas. Para acceder a los
almacenes de claves, JasperReports
Server accede a las propiedades del almacn de claves. Tanto los archivos de almacenes de claves y almacenes de claves
propiedades se crean de forma predeterminada en el
directorio de inicio del usuario. Por otra parte, antes de ejecutar js-instalar, puede especificar diferentes ubicaciones para el
almacn de claves
Por
defecto,
contraseas
bases de
cifrados
con
el algoritmo
en el modo
Cipher Block Chaining con
y archivos
delas
propiedades
delde
almacn
dedatos
clavesestn
a travs
de las
variables
ks y AES-128
ksp ambientales,
respectivamente.
Relleno PKCS5. El algoritmo AES es el estndar de encriptacin de la industria actual. Usted puede optar por modificar la
nivel de cifrado, seleccionando un algoritmo diferente, un tamao de clave ms larga secreto (por ejemplo, AES-256), o
un modo de cifrado diferente.
Edite las siguientes propiedades en sus default_master.properties establecidas estas opciones. Si una propiedad est
comentada,
el valor por defecto se utiliza:
Propiedad
Descripcin
Por defecto
build.key.algo
Algoritmo utilizado para cifrar las propiedades de los archivos de

configuracin.
AES
build.key.size
Tamao de la clave de cifrado como en AES-128.
128 (bits)
Para aumentar el tamao de la clave, si no se ha hecho antes, es posible que tenga

instalar "Unlimited Poltica Jurisdiccin Fuerza Archivos" en el sitio de Oracle
para su versin de Java. Para instalar los archivos, descargar US_export_policy.jar
y local_policy.jar. DESPUS copias de seguridad de los archivos antiguos, extraer los
frascos en
% JAVA_HOME% / jre / lib / security.
Alternativamente, usted puede descargar uno de los proveedores de renombre tales
como
Castillo Hinchable (viene con JasperReports Server). Usted tendra que
agregar el proveedor de Castillo Hinchable para que la lista de
Archivo% JAVA_HOME% / jre / lib / security / java.security:
security.provider. <nmero ss> =
org.bouncycastle.jce.provider.BouncyCastleProvider
enc.transformation
El llamado modo de cifrado. Ver el ver de Java javax.crypto docdocumenta- para entender los modos y las carnes de mejor.
AES / CBC
/ PKCS5
Relleno
enc.block.size
El tamao del bloque que se cifra. Texto cifrado puede contener muchos
bloques. Por lo general, el bloque se cambia junto con el Algoritmo de cifrado
rithm.
16 (bytes)
propsToEncrypt
Una lista separada por comas de las propiedades para cifrar.
dbPassword
8.2
Configuracin de opciones de contrasea de

usuario
Las opciones de contrasea del usuario determinar si las contraseas pueden ser recordados por el navegador, si los usuarios
pueden
cambiar sus propias contraseas, y si los cambios de contrasea son obligatorios u opcionales.
Por defecto, las contraseas se almacenan en un formato cifrado en la base de datos privada del servidor. Para obtener
informacin
acerca de cmo cambiar la forma contraseas estn encriptadas, consulte "Cifrado de contraseas de usuario" en la pgina
164
150
8.2.1
Configuracin de la memoria Contrasea

La mayora de los navegadores tienen una funcin de "recordar contraseas" que almacena las contraseas para el usuario.
puede enviar la propiedad autocomplete = "off" para indicar que las contraseas de sus usuarios no deben almacenarse o llenos
en forma automtica. Los usuarios deben introducir su nombre de usuario y la contrasea completa cada vez que se conecten.
Como poltica general de seguridad, contraseas sensibles no deben ser almacenados en los navegadores. La mayora de los
navegadores no protegen
las contraseas con una contrasea maestra por defecto, lo que los hace vulnerables. Configuracin de autocompletar en off
ayuda a asegurar que los usuarios de JasperReports Server no almacenan sus contraseas, evitando de esta manera que esto
sea posible la seguridad
riesgo. Comportamiento real depende de la configuracin del navegador del usuario y cmo el navegador responde a la
autocomplete = "off" propiedad.
Entrar cifrado se describe en la seccin "Cifrado Usuario Sesin Registro "en la pgina 167 no es compatible con
memoria contrasea en el navegador. Independientemente de la configuracin de autocompletar, el cdigo JavaScript que
implementa el
cifrado de sesin despeja el campo de la contrasea antes de enviar la pgina. Como resultado, la mayora de los navegadores
no lo har
aviso para recordar la contrasea de inicio de sesin cuando el cifrado est habilitado, incluso si el usuario dispone de una
memoria de contrasea
habilitado en su navegador.
Cuando autoCompleteLoginForm Es cierto, como en la instalacin por defecto, usted debe asegurarse de que todos los de su
los usuarios tienen una contrasea maestra en su navegador.
Memoria contrasea en el navegador

... / WEB-INF / JasperServer-servlet.xml
8.2.2
Propiedad
Valor
Descripcin
autoCompleteLoginForm
cierto <Default>
falsa
Cuando es false, el servidor establece autocomplete = "off"

en la pgina de inicio de sesin y los navegadores no llenarn
en o
mensaje para guardar contraseas de Jaspersoft. Cuando
true, la propiedad de autocompletado no se enva a
todos, y el comportamiento del navegador depende de
usuario
configuracin.
Habilitar caducidad de la contrasea

Si las polticas de seguridad requieren que los usuarios que cambien sus contraseas a intervalos regulares, puede activar
caducidad de la contrasea. En este caso, JasperReports Server solicita a los usuarios que cambien sus contraseas en el
intervalo
usted especifique. Por ejemplo, si se establece la caducidad de contrasea de 90 das, el servidor solicita que sus usuarios
cambien
sus contraseas cada tres meses. Cuando la contrasea de un usuario caduca, el usuario no puede iniciar sesin hasta que
cambie de
Cuando
se activa
el servidor
activa
la Cambiar
la contrasea
opcinno
ense
lales
pgina
de inicio de
su contrasea.
El esta
valoropcin,
por defecto
es 0; en
esteautomticamente
caso, las contraseas
no caducan
y los usuarios
solicita.
sesin,
aunque allowUserPasswordChange se establece como falsa.
Si los usuarios son autenticados externamente, por ejemplo, con LDAP, no activar esta opcin.
151
Opcin Administracin de contraseas

... / WEB-INF / JasperServer-servlet.xml (controla la pgina de Inicio de
sesin)
... / WEB-INF / applicationContext-security-web.xml (controla los servicios web)
8.2.3
Propiedad
Valor
Descripcin
passwordExpirationInDays
0<Default>
<Cualquier otro valor>
Establezca el valor a cualquier valor positivo, distinto de cero

para
especificar el nmero de das despus de que un
contrasea caduca.
Permitir que los usuarios cambien sus contraseas

Para permitir que los usuarios cambien sus contraseas, esta configuracin hace que la Cambiar la contrasea enlace aparece
en la
Pgina de registro. Por defecto, esta opcin es falsa, y un administrador debe definir contraseas de usuario por primera vez o
restablecer una
contrasea olvidada. Habilitar la opcin de caducidad de la contrasea (que se describe en la seccin anterior)
automticamente
permite la capacidad de los usuarios a cambiar sus contraseas.

... / WEB-INF / JasperServer-servlet.xml
8.2.4
Propiedad
Valor
Descripcin
allowUserPasswordChange
falsa <Default>
cierto
Establezca el valor en cierto para permitir que el Cambiar

Contrasea enlace. Cualquier otro valor deshabilita.
Hacer cumplir Contrasea Patrones

Si permite que los usuarios o de la fuerza para cambiar sus contraseas, puede cumplir las pautas contraseas vlidas. Tal
patrones de contrasea se utilizan normalmente para asegurar contraseas fuertes, como una longitud mnima y una mezcla de
maysculas, minsculas y nmeros. El patrn predeterminado acepta cualquier contrasea de cualquier longitud, incluyendo un
vaco
contrasea.
152

... / WEB-INF / applicationContext.xml
Propiedad
Frijol
Descripcin
allowedPasswordPattern
userAuthority
Servicio
Una expresin regular que coincide vlida

contraseas. El patrn por defecto ^. * $ partidos
cualquier contrasea. Cambie la expresin regular
para hacer cumplir los patrones tales como:
Longitud mnima y mxima de la contrasea
Ambos caracteres en maysculas y minsculas
Al menos un nmero o un carcter especial
Asegrese de que su patrn permite espacios en blanco

y caracteres internacionales si es necesario por su
usuarios.
Al cumplir un patrn contrasea, debe establecer el siguiente mensaje para informar a los usuarios por qu su contrasea
fue rechazada. Asegrese de ajustar el mensaje en todos los lugares que se utilizan.

... / WEB-INF / bundles / jsexceptions_messages [_locale] .properties
8.3
Propiedad
Descripcin
exception.remote.weak.password
Mensaje muestra a los usuarios cuando la contrasea

coincidencia de patrones falla.
Configuracin del usuario Sesin inactiva

El tiempo de espera de sesin de usuario es la longitud de tiempo de la sesin de un usuario puede permanecer inactiva
antes de que el servidor
registra automticamente la salida de usuario. JasperReports Server ahora implementa un recordatorio emergente que indica
a los usuarios su
sesin est a punto de expirar y les da la oportunidad de continuar sin ser desconectado.
Usuario Sesin inactiva
... / WEB-INF / web.xml
153
Usuario Sesin inactiva

Propiedad
Valor
Descripcin
<Session-config>
<Session-timeout>
20 <Default>
Ajuste el nmero de minutos que una sesin de usuario

puede permanecer inactivo antes de la desconexin
automtica. Set
el valor a 0 (cero) para evitar que las sesiones de
alguna vez se agote el tiempo.
Tenga en cuenta que el tiempo de espera de sesin tambin se aplica a la duracin de una sesin permanece en la memoria
despus de una llamada de servicios web
acabados. Si hay otra llamada de servicio web con las mismas credenciales dentro del perodo de tiempo de espera, el
servidor
reutiliza la misma sesin. Si el tiempo de espera es demasiado corto para este caso, es posible que tenga problemas de
rendimiento causados por un
A
la carga
inversa,
el llamadas
tiempo dedeespera
es web.
demasiado largo, una sesin de usuario puede permanecer activo durante mucho tiempo
alta
desilas
servicio
(incluso indefinidamente con un
tiempo de espera de 0) si un usuario sale de su navegador abierta. El riesgo de permitir largas sesiones es que el perodo de
sesiones en memoria
no se actualiza con los cambios de roles hasta que el usuario se desconecta de forma manual (que finaliza el perodo de
sesiones) y registra de nuevo
(La creacin de una nueva sesin).
8.4
Prevencin CSRF Configuracin

Cross-Site Request Forgery (CSRF) es un exploit en el que el atacante se hace pasar por una sesin de usuario vlido para
poder tener
informacin o realizar acciones en nombre del atacante. En JasperReports Server, el marco de seguridad protege
cada pgina con un token CSRF en el encabezado de mensaje, por ejemplo:
JASPER_CSRF_TOKEN: BVSY-UBBJ-K8E9-L4NZ-5866-Z4P2-ZG75-KKBW-U53Z-I833-V0OJ-BRK5-OFG5ZL6X
En la configuracin predeterminada del servidor, la prevencin de CSRF est activo. Jaspersoft no recomienda cambiar
este ajuste:
Prevencin CSRF
... / WEB-INF / classes / ESAPI / security-config.properties
8.5
Propiedad
Valor
Descripcin
security.validation.csrf.on
cierto <Default>
falsa
Resulta prevencin CSRF encendido o apagado. De forma

predeterminada,
Prevencin CSRF est encendido. Cualquier otro valor
adems de maysculas y minsculas "false" es equivalente a
verdadera.
Configuracin de validacin de entrada

Para bloquear las amenazas de seguridad potenciales, tales como cross-site scripting y de inyeccin SQL, el marco de
seguridad tiene un
poderoso mecanismo para validar todas las entradas de usuario y valores pasados a los informes. Validacin de entrada
impide valores
154
con efectos secundarios peligrosos, tales como scripts maliciosos y consultas. Los administradores pueden controlar los
registros del servidor a
buscar evidencias de violaciones a la seguridad intentos.
Sin embargo, de entrada que fue permitido en la versin anterior del servidor se puede bloquear, y los usuarios pueden ver
los errores
al introducir valores. En particular:
Nombres y valores de los parmetros no pueden tener etiquetas ( <y >). Si sus datos de negocio contiene etiquetas, es
necesario
actualizar la configuracin de seguridad para permitir que ellos.
Consultas SQL deben comenzar con SELECT y no pueden tener comentarios. Varias consultas separadas por semi
dos puntos (;) Tambin estn prohibidos. Si sus informes o dominios tienen este tipo de consultas, es necesario o bien
cambiarlos
o actualizar la configuracin de seguridad para permitir que ellos.
Si los usuarios ven los errores recurrentes, los administradores pueden examinar los registros para determinar que no se
permite la entrada. Preferiblemente,
los usuarios deben modificar su entrada para eliminar caracteres especiales que son riesgos de seguridad. Si eso no es factible,
los administradores pueden configurar el marco de seguridad para modificar las normas de seguridad o desactivar las
restricciones de seguridad,
en funcin de su nivel de amenaza percibida.
Se agregaron reglas de validacin de entrada para cumplir con las pautas de seguridad para aplicaciones web. Desactivacin
de entrada
validacin o modificacin de las reglas de validacin puede hacer que el servidor sea ms vulnerable a los ataques web.
Validacin de entrada es un mecanismo complejo que se configura en los siguientes archivos:

Archivo
Contenido
<Js-webapp> / WEB-INF / classes / ESAPI / seguridadconfig.properties
Configuracin de nivel superior para la habilitacin o deshabilitacin

de entrada
validacin.
<js-webapp> /WEB-INF/bundles/security.properties
Texto de los mensajes de error de validacin se muestra a los

usuarios.
<Js-webapp> / WEBINF / classes / ESAPI / security.properties
Define las reglas de validacin de entrada para cada campo de la

pginas web del servidor y de entrada del reporte.
<Js-webapp> / WEBINF / classes / ESAPI / validation.properties
Define las expresiones regulares utilizadas en las normas de

seguridad.
Validacin de entrada se basa en UTF-8 entrada codificada. Haga servidor de su solicitud de que se ha configurado para
UTF-8 URIs como se describe en la seccin "UTF-8 Configuracin "en la pgina 256.
Validacin de entrada est activada por defecto al instalar JasperReports Server. Para desactivar uno o ms de los
caractersticas de proteccin:
Validacin de entrada
155
Validacin de entrada
Propiedad
Valor
Descripcin
security.validation.input.on
cierto <Default>
falsa
Activa la validacin de entrada en el campo o fuera de la

aplicacin web del servidor. Cualquier otro valor
adems de maysculas y minsculas "false" es equivalente a
verdadera.
security.validation.sql.on
cierto <Default>
Activa la validacin de consultas SQL o desactivar en el

servidor. Cualquier otro valor adems de casos
insensible "false" es equivalente a verdadero.
falsa
8.5.1
Mensajes de Error del Seguro

Cuando los bloques de validacin de entrada de entrada que viola una regla de seguridad, el servidor muestra un error. Por
defecto, el
mensajes de seguridad son intencionalmente genrica para que los atacantes potenciales no son conscientes de que han
provocado un
error
de seguridad.
Jaspersoft
recomienda encarecidamente que los despliegues externos personalizar los mensajes de error de seguridad al ser
nico, sin embargo,
siendo genrico. Usted puede cambiar el mensaje y el nmero de error. Elija cualquier combinacin de nmeros o
cartas de manera que los administradores pueden buscar fcilmente los registros para detectar violacines de seguridad.
Mensajes de validacin de entrada
... / WEB-INF / bundles / security.properties
Propiedad
Valor
message.validation.input
Se ha producido un error. Por favor, pngase en contacto con su sistema

administrador. (5321) <default>
message.validation.sql
Se ha producido un error. Por favor, pngase en contacto con su sistema

administrador. (6632) <Default>
Establezca estas propiedades a los mensajes y cdigos de error que coinciden con el resto de la aplicacin. El objetivo es
mostrar una
mensaje que los atacantes no reconocern como un error de seguridad, sin embargo, que los administradores pueden identificar
de forma exclusiva en el
troncos.
Si traduce su aplicacin a otros idiomas, asegrese de crear una copia de la configuracin regional especfica de este
archivo y
traducir estos mensajes tambin.
8.5.2
Edicin de entrada reglas de validacin

Reglas de validacin de entrada determinan lo que se permite la entrada cuando los usuarios envan informacin al servidor.
Este
informacin general consiste en pares de valores de parmetros, por ejemplo, los campos de un formulario de entrada. Para
cada conocida
regla
de validacin
de entrada
lo siguiente:
par parmetro-valor,
Qu caracteresuna
estn
permitidos
en el nombre
del define
parmetro.
156
Qu caracteres estn permitidos en el valor de entrada.

La longitud mxima permitida para el nombre del parmetro y el valor de la entrada (el mismo lmite se aplica tanto
por separado).
Ya sea que el valor puede estar en blanco.
Los caracteres permitidos son determinados por una expresin regular llamado un validador. Los validadores se nombran
regulares
expresiones que se pueden utilizar en cualquier nmero de reglas de validacin de entrada. A pesar de que los validadores
se pueden utilizar en
varias
reglas,
regla de
de entrada
validacin
deben ser en
lo ms
especfico servidor
posible aestn
la entrada
permitida.
Las reglas
de cada
validacin
predefinidos
JasperReports
diseados
para permitir que todos los datos y
usuario normal
de entrada, mientras que el bloqueo de ataques potenciales en el servidor. Si sus datos o su entrada de usuario hace que los
errores de seguridad (falsa
positivos),
puede
optar por
modificar
las reglas de validacin
de entrada
permitir
suelentrada.
1. Busque
el mensaje
"FALLO
DE SEGURIDAD"
en sus registros
que para
fue creado
por
error de seguridad. Para obtener ms
informacin sobre los registros, consulte "Configuracin de registros del sistema" en la pgina 192. El mensaje de registro
contiene el nombre
del parmetro y el contexto en el que se usa el parmetro.
2. Haga una copia de seguridad del archivo <js-webapp> /WEB-INF/classes/esapi/security.properties, luego abrirlo para
edicin.
3.
Busque el nombre del parmetro y el contexto. Por ejemplo, esta es la regla de validacin de entrada para las
entidades
parmetro en la pgina Administrar funciones:
Entidades = Alpha, AlphaNumPunctuation, 5000, verdaderos, entidades-Manage_Roles_context
La regla de validacin de entrada tiene el siguiente formato:

<Parmetro> = <nameValidator>, <valueValidator>, <charLimit>, <blankAllowed>, <parmetro> [!] <Context> _context
4.
Modifique la regla para permitir su entrada:

a.
b.
Por lo general, es necesario cambiar el validador valor a uno que permite a los caracteres de entrada. Seleccionar un
valor
validador del archivo <js-webapp> /WEB-INF/classes/esapi/validation.properties que permite a su entrada,
o crear uno como se describe en la siguiente seccin.
Si su entrada es atpicamente larga, aumentar el lmite de caracteres.
c.
No cambie ninguna otra parte de la regla.
5.
Guarde los cambios y volver a implementar la aplicacin web JasperReports Server o reiniciar el servidor de
aplicaciones.
Recomendaciones:
Trate de mantener el lmite de caracteres tan cerca del valor esperado como sea posible.
Trate de usar un validador que es lo ms cercano a los valores esperados como sea posible. Si el valor de un parmetro se
espera que
sean slo nmeros, a continuacin, utilizar el validador numrico.
La mayora de los validadores estn listas blancas que especifican patrones de caracteres que se permiten. Un validador
puede estar precedida
por un signo de exclamacin ( !) Para indicar que todo, pero se permiten esos valores. Cuando se utiliza con un
validador que coincide con caracteres o palabras, esta sintaxis implementa una lista negra. Algunas de las reglas son ms
fciles de
definir como listas blancas, otros como listas negras.
Si un parmetro puede tener valores radicalmente diferentes o el mismo parmetro se utiliza en diferentes situaciones, a
continuacin,
se puede aplicar ms de una regla para ese parmetro. Para ello, basta con copiar una regla de parmetros y aadir
enteros
incrementales en el nombre del parmetro. Por ejemplo:
standAlone = Alfa, Alfa, 50, es cierto, standAlone-Report_PopupMenu_context
Actualizado al:
standAlone = Alfa, ALPHANUM, 50, es cierto, standAlone-Report_PopupMenu1of3_context
Autnoma2 = Alfa, JSONObject, 50000, cierto, standAlone-Report_PopupMenu2of3_context
157
standAlone3 = Alfa, JSONArray, 500000, es cierto, standAlone-Report_PopupMenu3of3_context

Con varias reglas para el mismo parmetro, cada regla se aplica en el orden indicado hasta que se pasa
(Equivalente a un OR lgico). Si todos ellos fallan, entonces la entrada se bloquea y se notifica al usuario con la
mensaje de error genrico. Las reglas que no siguen apareciendo como las advertencias de seguridad en los registros.
Use la numeracin
en los nombres de contexto, como se muestra arriba, para identificar fcilmente estos mensajes falsos positivos. Cuando
se utiliza
varias reglas, definen la norma ms utilizada o la norma ms permisiva primera para optimizar la validacin
y reducir los mensajes de registro de falsos positivos.
8.5.3
Creacin de expresiones Validator

Los validadores estn basadas en Java expresiones regulares que especifica qu caracteres estn permitidos (lista
blanca) o
prohibido (lista negra), dependiendo de cmo se utiliza en una regla de validacin.
No modificar las expresiones de validacin por defecto se proporcionan con el servidor. Estas expresiones han sido
probado a fondo por Jaspersoft para proporcionar seguridad razonable de validacin de entradas permitiendo al mismo tiempo
el
uso general de la aplicacin. Tambin, un validador se puede utilizar en varias reglas de validacin de entrada, por lo que la
modificacin
ellos pueden tener consecuencias no deseadas. Debieras siempre crear nuevos validadores con nuevos nombres.
1.
Haga una copia de seguridad del archivo <js-webapp> /WEB-INF/classes/esapi/validation.properties, luego abrirlo para
edicin.
2.
Localice el validador se utiliza en la regla de validacin de entrada que desea modificar, por ejemplo, el validador Alfa
expresin permite ninguna carta en cualquier idioma:
3.
Copie toda la regla en una lnea nueva y darle un nuevo nombre con el siguiente formato:
Validator.Alpha = ^ [\\ p {L} \\ p {M}] * $
Validador. <ValidatorName> = <RegularExpression>

Recuerde utilizar dobles barras invertidas ( \\) En las propiedades de archivos para una barra invertidas en la expresin.
Usted
Tambin debe utilizar el \ P {} sintaxis para que coincida con las cartas internacionales y sus acentos, por ejemplo:
Validator.AlphaDotSpace = ^ [\\ p {L} \\ p {M} \\. \\ S] * $
4.
5.
8.5.4
Utilice el nuevo nombre del valor validador en su regla de validacin de entrada, tal como se describe en el
procedimiento anterior.
aplicaciones.
Validando parmetros nuevos de entrada

Si personaliza JasperReports Server para aceptar los nuevos parmetros de entrada, se debe aadir la entrada
correspondiente
reglas de validacin a fin de mantener la seguridad del servidor.
1. Haga una copia de seguridad del archivo * <js-webapp> /WEB-INF/classes/esapi/security.properties*, luego abrirlo para
edicin.
2.
Crear una nueva regla de validacin de entrada que tiene el siguiente formato:
<Parmetro> = <nameValidator>, <valueValidator>, <charLimit>, <blankAllowed>, <parmetro> - <context> _
contexto
El contexto es la cadena que aparecer en el registro cuando se produce un error de validacin de seguridad, as que
debe
contener el nombre exacto del parmetro.
158
3.
4.
8.5.5
Mira las normas existentes en el archivo <js-webapp> /WEB-INF/classes/esapi/validation.properties para encontrar

validadores para el nombre del parmetro y el valor que permita que su nueva entrada. Si es necesario, cree un nuevo
validador
expresiones, como se describe en el procedimiento anterior.
aplicaciones.
Validacin de consulta
Validacin de consulta es un caso especial de validacin de entrada, donde el servidor se asegura de que todas las consultas
se emiten por
el servidor cumple con un patrn preestablecido para una consulta de seguridad. Cuando la validacin de consultas est
habilitada, todas las consultas en informes y
Los dominios
utilizan las
validador:\\ S + [^;] + $
Validator.ValidSQL
= ^siguientes
\\ s * ((i) seleccionar?)
Como resultado:
Comentarios de SQL estn prohibidos.

Asegrese de que tiene slo una sentencia de consulta ejecutable por consulta. Varias consultas separadas por semi
dos puntos (;) Sern rechazadas. El siguiente ejemplo har que un error de seguridad:
F1 SELECT, f2 DESDE DONDE tbl_1 f1 = f2; SELCT f3 de tbl_2;
Oferta de los informes deben recuperar datos nica, es decir, slo utilizan la instruccin SELECT. La siguiente
declaraciones estn prohibidos:
DROP, INSERT, UPDATE, DELETE
Si desea utilizar procedimientos almacenados, debe agregar la siguiente validador para el archivo <js-webapp> / WEBINF / classes / ESAPI / validation.properties:
Validator.ValidSPROC = ^ \\ s * \\ (((i) llamada) \\ s + [^;]? + \\) $
Y a continuacin, modificar la regla de validacin para el parmetro correspondiente o campo en el que desea permitir
procedimiento almacenado llama. Si desea permitir las llamadas a procedimientos almacenados, adems de seleccionar
las declaraciones, especifique
mltiples reglas de validacin como se muestra en la seccin "Edicin de Reglas de validacin de entrada "en la pgina
156.
Cuando
falla la validacin SQL, los registros contienen el mensaje descrito en "Error Personalizacin de Seguridad
Mensajes "en la pgina 156, tales como los siguientes:
2011-11-21 13: 54: 28,007 ERROR ValidatorImpl, "http-bio-8090" -exec-12: 48 - Un error ha
ocurrido. Por favor, pngase en contacto con el administrador del sistema. (6632)
org.owasp.esapi.errors.ValidationException: SQL_Query_Executor_context: no vlido
de entrada. Por favor, cumplir con regex ^ \ s * ((i) seleccionar?) \ S + [^;] + $ con una longitud mxima de
50000
8.5.6
Configuracin adicional
Los archivos de configuracin contienen algunos ajustes predeterminados diversos para el marco de seguridad. En particular, se
definir la accin por defecto para la entrada que no tiene reglas de validacin. Cambiar estos valores predeterminados es posible,
pero no
recomienda:
159
Validacin avanzada de entrada

Propiedad
Valor predeterminado
Descripcin
log.msg.security.off
SEGURIDAD para [% s] es OFF
Si la seguridad est desactivado, este

se registrar el mensaje. Este
mensaje en los registros puede alertar
administradores si la seguridad
configuracin ha sido manipulado
con.
msg.no.rule
No hay ninguna regla para el parmetro [% s].Si un parmetro de peticin no es

Utilizando
anteriormente conocido, este mensaje es
validacin por defecto en la entrada = [% s]. conectado.
msg.cannot.load
Configuracin de seguridad [% s]
no se pueden cargar.
Si hay un error en la seguridad

archivos de configuracin, este mensaje es
conectado. Este es un error grave y
debe ser resuelta por el
administrador.
... / WEB-INF / classes / ESAPI / security.properties
8.6
Propiedad
Valor predeterminado
Descripcin
DEFAULT
Alfa, AlphaNumPunctuation
Soportes, 200000, es cierto, DEFAULT
Si un parmetro de entrada no
tener alguna regla de validacin definida,
se aplica esta regla de validacin. El
validador para los valores,
AlphaNumPunctuationSoportes es bastante permisiva, y
puede ser cambiado a algo
ms restrictiva. El DEFAULT
nombre de la propiedad es una palabra clave y
nunca debe ser cambiado.
La restriccin de la subida de
archivos
Varios cuadros de dilogo en JasperReports Servidor piden al usuario cargar un archivo al servidor. Para obtener un
rendimiento y
razones de seguridad, es posible que desee limitar la subida de archivos por nombre y tamao.
El siguiente procedimiento es el lmite global de carga de archivos para todo el servidor. Cualquier nica carga que supera
este
lmite provocar un error y un mensaje de seguimiento de la pila. Se pretende que sea un mximo absoluto para evitar un
peor error de falta de memoria que afecta a todo el servidor.
160
Global Tamao del archivo lmite de

subida
... / WEB-INF / js.config.properties
Propiedad
Valor
Descripcin
file.upload.max.size
-1
<Default>
El tamao mximo de bytes permitidos para cualquier carga de archivos. El

valor predeterminado, -1, significa que no hay lmite para el tamao del
archivo, y un
archivo lo suficientemente grande podra causar un error fuera de la memoria
en el
JVM. Algunas cargas de archivos, como la importacin a travs de la interfaz
de usuario son
necesariamente grande y debe ser tomado en cuenta. Establezca este
valor ms grande que su importacin esperado ms grande y menos de
la memoria disponible.
Los siguientes ajustes se aplican a la mayora de los cuadros de dilogo de carga de archivos en la interfaz de usuario, tales
como la carga de un JRXML o una
Archivo JAR para crear un JasperReport en el repositorio. Estos ajustes en la fileResourceValidator frijol restringir
el tamao del archivo y el patrn de nombre de archivo.
Subir archivo Restricciones
... / WEB-INF / fluye / fileResourceBeans.xml
Propiedad
Valor
Descripcin
maxFileSize
-1
<Default>
El tamao mximo en bytes permitido para un archivo subido a travs de

la mayora de los cuadros de dilogo de la interfaz de usuario. Si un proceso
de carga excede este lmite, el servidor
muestra un mensaje de error tiles. El valor predeterminado, -1,
significa que no hay lmite para el tamao del archivo, y una carga podra
alcanzar el lmite global si se establece, o un error de falta de memoria.
Por lo general, los archivos requeridos en recursos son ms pequeos, y un
lmite de
10 MB es razonable.
fileNameRegexp
^. + $
<Default>
Una expresin regular que coincide con nombres de archivo permitidos. El

expresin por defecto coincide con todos los nombres de archivo de uno o
ms
personajes. Una expresin ms restrictiva, como [a-zA-Z0-9]
{1200} \. [A-zA-Z0-9] {1,10} limitara subidas en el alfanombres numricos con una extensin.
nomArchivo
ValidationMessageKey
<Null />
<Default>
El nombre de una clave de propiedad Java cuyo valor es una costumbre

mensaje que se mostrar cuando el nombre del archivo subido no
partido fileNameRegexp. Por ejemplo, puede agregar el
siguiendo la lnea de WEB-INF / js.config.properties:
my.filename.validation = El nombre de la subida
nombre del archivo debe contener slo caracteres alfanumricos
personajes y tienen una extensin vlida.
161
El siguiente procedimiento restringe la extensin del archivo cargado. Los cuadros de dilogo de carga de slo buscar archivos
con las extensiones dadas. Aadir o eliminar extensiones para cambiar las restricciones de tipo de archivo:
Subir archivo Extensiones

<JasperServer-pro-guerra> /scripts/resource.locate.js
8.7
Propiedad
Valor
ALLOWED_FILE_
RESOURCE_EXTENSIONS
Por defecto, las siguientes extensiones estn permitidos:

"Css", "ttf", "jpg", "jpeg", "gif", "bmp", "png", "jarra",
"Jrxml", "propiedades", "jrtx", "xml", "agxml", "docx", "doc",
"Ppt", "pptx", "xls", "xlsx", "SAO", "odt", "odp", "pdf",
"Rtf", "html"
Cmo ocultar los mensajes de

seguimiento
deJasperReports
pila
Por defecto, muestra
Server pila huellas en ciertos mensajes de error. Seguimientos de pila revelan
algunos
informacin acerca de la aplicacin, y expertos en seguridad recomiendan que una aplicacin no los muestra.
El siguiente procedimiento se apaga seguimientos de pila en los mensajes de error. Sin embargo, los mensajes de error ms
graves siguen mostrando
Las excepciones de Java sin el seguimiento de la pila.
Cmo ocultar los mensajes de seguimiento
de pila
... / WEB-INF / applicationContext-security-web.xml
Propiedad
Frijol
Descripcin
showStacktrace
Mensaje
webAppSecurity
Filtro
Establezca este valor a false para evitar seguimientos de pila de

que aparece en los mensajes de error.
Reinicie el servidor de aplicaciones o volver a implementar la aplicacin web JasperReports Server para que este cambio
surta efecto.
8.8
Definicin de una poltica de varios dominios para

Flash
Por razones de seguridad, una animacin Flash jugar en un navegador web no est autorizado a acceder a los datos que reside
fuera del dominio web exacta donde se origin el SWF. JasperReports Server utiliza Flash para el avanzado
Cartas basado en la fusin como medidores y mapas.
Como resultado, los servidores incluso en subdominios no pueden compartir datos con un servidor en el dominio principal a
menos que definen
una poltica de varios dominios que permite explcitamente. El archivo crossdomain.xml, situado en la raz del servidor
contiene los datos, define qu dominios pueden acceder a los datos sin preguntar al usuario para permitir el acceso en un
162
de dilogo de seguridad. Por lo tanto, el servidor donde se encuentran los datos determina qu otros servidores pueden
acceder a la
datos.
El siguiente ejemplo de crossdomain.xml slo permite el acceso desde el dominio de ejemplo o cualquiera de sus subdominios.
Este ejemplo est diciendo que el servidor con el archivo, nicamente confa example.com utilizar sus datos.
<? Xml version = "1.0"?>
<! DOCTYPE SISTEMA cross-domain-policy
"Http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd">
<-Domain-policy cruz>
<Allow-access-from = dominio "example.com" />
<Allow-access-from domain = "*. Example.com" />
</ Cross-domain-policy>
Detrs de un firewall, servidores y usuarios a menudo se refieren a otros equipos en el mismo dominio sin utilizar el dominio
nombre. Flash considera que es un dominio diferente y bloquea el acceso a los datos a menos que el nombre del equipo se da en
el
poltica:
<Allow-access-from domain = "myserver.example.com" />
<Allow-access-from domain = "miservidor" />
Al utilizar los servicios web, utilice el allow-http-request-headers-desde elemento de modo que las acciones codificados en
el encabezado de solicitud estn permitidos. El siguiente ejemplo permite solicitudes estndar y solicitudes de servicio web de
cualquier subdominio de example.com.
<De control de sitio permitidos-cross-domain-polticas = "master-only" />
<Allow-access-from domain = "*. Example.com" />
<Allow-http-request-headers-de dominio = "*. Example.com" headers = "*"
asegurar = "true" />
Para obtener una descripcin de todas las propiedades posibles, consulte la especificacin de archivo
de poltica entre dominios.
Para definir una poltica de varios dominios para los informes basados en Flash, cree un archivo, como los anteriores en el
servidor que
est accediendo contiene los datos. Asegrese de colocar el archivo crossdomain.xml en la raz del espacio de archivos que
se
de ser servido. Por ejemplo, si utiliza Apache Tomcat, coloque sus archivos en las siguientes ubicaciones:
Archivo
Ubicacin
crossdomain.xml
<Pgina web-B-tomcat-dir> /webapps/ROOT/crossdomain.xml
Datos XML (* xml)
<Pgina web-B-tomcat-dir> / webapps / ROOT / <any-dir> / *. Xml
Componente de Flash (swf *)
<Pgina web-A-tomcat-dir> / webapps / <nombreapl> / <any-dir>
163
8.9
El cifrado de las contraseas de

usuario
Las contraseas de usuario se almacenan junto con los perfiles de usuario en propia base de datos privada de JasperReports
Server. De forma predeterminada,
cifrado de la contrasea est habilitada en JasperReports Server y contraseas se almacenan como texto cifrado en la base de
datos.
Con el siguiente procedimiento, los administradores del sistema pueden activar o desactivar el cifrado de la contrasea del
usuario, o cambiar el
algoritmo
de cifrado
y especifique
la clavedel
deusuario:
sal que se usa para iniciar el algoritmo de cifrado.
Para
configurar
la contrasea
de cifrado
1. Como precaucin, debe realizar copias de seguridad del servidor privado JasperServer base de datos. Para una copia de
seguridad por defecto
Base de datos PostgreSQL, visite <js-install> directorio y ejecutar el siguiente comando:
postgres pg_dump -U JasperServer> js-backup.sql
2.
3.
Para una copia de seguridad de DB2, Oracle, Microsoft SQL Server, MySQL y bases de datos, se refieren a su
producto de base de datos
documentacin.
Ahora puede detener el servidor de aplicaciones. Usted debe salir de su base de datos en
ejecucin.
Exporta todo el contenido del repositorio, lo que incluye los perfiles de usuario y sus contraseas, con el
siguientes comandos. Tenga en cuenta que hay dos guiones (-) Delante de las opciones de comandos:
Ventanas: cd <js-instalacin> \ buildomatic
js-export.bat --everything --output-dir js-backup-catlogo
Linux:
cd <js-instalacin> / buildomatic
js-export.sh --everything --output-dir js-backup-catlogo
En la operacin de exportacin, las contraseas se descifran utilizando los sistemas de cifrado de contrasea de usuario
existentes y re-codificadas
con la clave de cifrado de importacin-exportacin. Este es un cifrado independiente que asegura que las contraseas nunca
estn en
texto plano, incluso cuando ste se exporte. Para obtener ms informacin, consulte "Ajuste de la-Export Import clave de
la
4. cifrado"
Edite lasen
propiedades
en la tabla siguiente para configurar diferentes sistemas de cifrado. Tanto el servidor como el de
pgina
132
importaciones
scripts de exportacin acceder a los perfiles de usuario y deben ser configurados de manera idntica. Realice los mismos
cambios en ambos
Tablaarchivos:
8-1 Configuracin de usuario Contrasea Encryption
Archivos de configuracin
<JasperServer-pro-guerra> /WEB-INF/applicationContext-security.xml
<Js-install> /buildomatic/conf_source/iePro/applicationContext-security.xml
164
Propiedad
Frijol
Descripcin
allowEncoding
passwordEncoder
Con la configuracin por defecto de verdadera, contraseas de los

usuarios son
cifrada cuando se almacena. Cuando falso, contraseas de usuario
se almacenan en texto sin cifrar en JasperReports Servidor de
base de datos privada. Jaspersoft no recomienda
cambiar esta configuracin.
keyInPlainText
passwordEncoder
Cuando verdadera, la secretkey valor se da como una llanura

cadena de texto. Cuando falso, el valor es un secretkey
representacin numrica que puede ser analizado por Java
Mtodo Integer.decode (). Por defecto, este ajuste es
falso, y la secretkey es en notacin hexadecimal
(0xAB).
secretkey
passwordEncoder
Este valor es la sal usada por el algoritmo de cifrado

para hacer valores cifrados nico. Este valor puede ser un
cadena de texto o una representacin numrica dependiendo
el valor de keyInPlainText.
secretKeyAlgorithm
passwordEncoder
El nombre del algoritmo usado para procesar la llave, por

por defecto Desede.
cifrado
Transformacin
passwordEncoder
El nombre de la transformacin de cifrado utilizada para cifrar

contraseas, de forma predeterminada Desede / CBC / PKCS5Padding.
Usted debe cambiar el secretkey valor, de modo que es diferente de la predeterminada.
El secretkey,secretKeyAlgorithm, Y cipherTransformation propiedades deben ser consistentes con

El uno al otro. Por ejemplo, la secretkey debe ser de 24 bytes de longitud en notacin hexadecimal o 24 caracteres en
texto plano para el cifrado por defecto (desede / CBC / PKCS5Padding). Diferentes algoritmos esperan diferente clave
longitudes. Para obtener ms informacin, consulte Java javax.crypto documentacin.
5.
6.
A continuacin, deje caer su existente JasperServer base de datos, donde las contraseas tenan la antigua codificacin, y
recrear
un vaco JasperServer base de datos. Siga las instrucciones de su servidor de base de datos:
Cadas y Recreando la base de datos en PostgreSQL
Cadas y Recreando la base de datos en MySQL
Cadas y Recreando la base de datos en Oracle
Cadas y Recrear en la base de datos en Microsoft SQL Server
Importa tus contenidos del repositorio exportados con los siguientes comandos. La operacin de importacin se restaurar
el contenido de la base de datos privada de JasperReports Server, incluidos los perfiles de usuario. Como los perfiles de
usuario son
importado, las contraseas se cifran utilizando la nueva configuracin de cifrado.
Tenga en cuenta que hay dos guiones (-) Delante de las opciones de comandos:
Ventanas: cd <js-instalacin> \ buildomatic
js-import.bat --input-dir js-backup-catlogo
Linux:
cd <js-instalacin> / buildomatic
js-import.sh --input-dir js-backup-catlogo
8.
Durante la operacin de importacin, las contraseas se descifran con la clave de cifrado de importacin-exportacin y
vuelva a
cifrada en la base de datos con la nueva configuracin de cifrado de contrasea de usuario. Para obtener ms
informacin, consulte
"Ajuste
deun
la-Export
Import
de cifrado"
enHerramienta
la pgina 132.
El uso de
cliente de
baseclave
de datos
como la
de ardilla, comprobar el contenido de la JIUser tabla
en la
JasperServer base de datos y verificar que los valores de las columnas contrasea estn cifrados.
Reinicie el servidor de aplicaciones. Su base de datos ya debe estar en ejecucin.
9.
Acceda a JasperReports Server para verificar que el cifrado funciona correctamente durante el registro en el proceso.
7.
165
8.9.1
Cadas y Recreando la base de datos en PostgreSQL

1.
Cambie el directorio a <Js-instalacin> / buildomatic / install_resources / sql / postgresql.
2.
Iniciar psql usando una cuenta de administrador como postgres:

psql -U postgres
3.
La cada de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema:
caer JasperServer base de datos;
crear base de datos de codificacin JasperServer = 'utf8';
\ C JasperServer
\ I js-pro-create.ddl
\ I quartz.ddl
8.9.2
Cadas y Recreando la base de datos en MySQL

1.
Cambie el directorio a <Js-instalacin> / buildomatic / install_resources / sql / mysql.
2.
Acceda a su cliente de MySQL:

mysql-u root-p
3.
Elimine la base de JasperServer, crear uno nuevo y cargar el esquema JasperServer:

mysql> drop JasperServer base de datos;
mysql> create database conjunto de caracteres utf8 JasperServer;
mysql> use JasperServer;
mysql> js-pro-create.ddl de origen;
mysql> quartz.ddl fuente;
8.9.3
Cadas y Recreando la base de datos en Oracle

1.
Cambie el directorio a <Js-instalacin> / buildomatic / install_resources / sql / oracle.
2.
Acceda a su cliente SQLPlus, por ejemplo:

sqlplus sys / sys as sysdba
3.
La cada de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema:
SQL>
SQL>
SQL>
SQL>
SQL>
8.9.4
166
caer JasperServer usuario cascada;

crear JasperServer usuario identificado por contrasea;
conectar JasperServer / contrasea
@ Js-pro-create.ddl
@ Quartz.ddl
Cadas y Recrear en la base de datos en Microsoft SQL Server

1.
Cambie el directorio a <Js-instalacin> / buildomatic / install_resources / sql / sqlserver.
2.
La cada de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema por medio de la
Utilidad sqlcmd:
cd <js-instalacin> \ buildomatic \ install_resources \ sql \ sqlserver

sqlcmd-S ServerName -Usa -Sal
1> DROP DATABASE [JasperServer]
2> GO
1> CREATE DATABASE [JasperServer]
2> GO
1> USE [JasperServer]
2> GO
1>: r js-pro-create.ddl
2> GO
1>: r quartz.ddl
2> GO
8.10 de cifrado de sesin de usuario Inicio de

sesinDe forma predeterminada, JasperReports Server realiza no permitir que el protocolo Secure Socket Layer / Transport Layer
Security (SSL / TLS) para
cifrar todos los datos entre el navegador y el servidor, tambin conocido como HTTPS. Habilitacin de HTTPS, tal como se
documenta en
la JasperReports ltima gua Server, requiere un certificado y una configuracin cuidadosa de sus servidores.
Jaspersoft recomienda implementar HTTPS, pero reconoce que no siempre es factible.
Sin HTTPS, todos los datos enviados por el usuario, incluyendo contraseas, aparecen sin cifrar en el trfico de red.
Dado que las contraseas nunca deben ser visibles, JasperReports Server proporciona un mecanismo independiente para
la encriptacin de los valores de contrasea sin utilizar HTTPS. El mecanismo de cifrado se utiliza en la siguiente
casos:
Las contraseas enviadas desde la pgina de acceso.

Las contraseas enviadas desde el cuadro de dilogo de cambio de contrasea (vase "Opciones de contrasea
Configuracin de usuario" en la
pgina 150).
Las contraseas enviadas desde las pginas de administracin de usuarios por un administrador.
Cuando un navegador solicita una de estas pginas, el servidor genera un par de claves pblica-privada y enva el pblico
clave junto con la pgina. Una JavaScript en la pgina solicitada cifra la contrasea cuando los mensajes de los usuarios a la
servidor. Mientras tanto, el servidor guarda su clave privada y la utiliza para descifrar la contrasea cuando llega. Despus
descifrar la contrasea, el servidor contina con los mtodos usuales de autentificacin.
Cifrado de sesin no es compatible con la memoria contrasea en el navegador. Con independencia de la funcin de
autocompletar
configuracin se describe en la seccin "Configuracin de Memoria contrasea "en la pgina 151, el cdigo JavaScript que
implementa
cifrado de sesin despeja el campo de la contrasea antes de enviar la pgina. Como resultado, la mayora de los
navegadores nunca se
La
desventaja
de cifrado
de inicio de
sesin es el procesamiento adicional y la complejidad aadida de los servicios web de
aviso
para recordar
la contrasea
cifrada.
inicio de sesin.
Por compatibilidad con versiones anteriores, el cifrado de inicio de sesin est desactivado por defecto. Para habilitar el cifrado
de inicio de sesin, establezca la
siguientes propiedades. Despus de hacer los cambios, vuelva a implementar la webapp JasperReports Server o reiniciar el
servidor de aplicaciones.
Si el cifrado de inicio de sesin est habilitada, los servicios web y los parmetros de URL tambin deben enviar encriptado
contraseas. Las aplicaciones deben obtener primero la clave del servidor y luego cifrar la contrasea
antes de enviarlo. Consulte la Gua de Servicios Web JasperReports Servidor y JasperReports Servidor ltimo
Gua, respectivamente.
167
Entrar Encryption
Propiedad
Valor
Descripcin
encryption.on
truefalse
<Default>
encryption.type
RSA <Default>
Activa el cifrado de inicio de sesin o desactivar. El cifrado

es
desactivada de forma predeterminada. Cualquier otro valor
adems de casos
insensible "false" es equivalente a verdadero.
Algoritmo de cifrado; Actualmente, slo el RSA es
apoyado.
encryption.key.length
potencia entera de 2
1024 <Default>
La longitud de las claves de cifrado generadas.

Esto afecta a la fuerza de cifrado y la
longitud de la cadena cifrada.
encryption.dynamic.key
cierto <Default>
falsa
Cuando es verdadero, una clave se generar por cada

solicitud nica. Cuando es false, la clave ser
generada una vez por instalacin de la aplicacin.
Vea las descripciones en Dinmica de clave de encriptacin
y Esttica clave de cifrado a continuacin.
Cifrado tiene dos modos, dinmicas y estticas, tal como se determina por el encryption.dynamic.key parmetro.
Estos modos proporcionan diferentes niveles de seguridad y se describen adicionalmente en las siguientes secciones.
8.10.1
Dinmica de clave de encriptacin

La ventaja de la encriptacin de la contrasea al iniciar sesin es para evitar que sea visto, sino tambin para evitar que se
que se utiliza. Para el cifrado de contraseas para lograr esto, la contrasea debe estar encriptada de manera diferente cada vez
que se
enviado. Con el cifrado de clave dinmico, el servidor utiliza un nuevo par de claves pblica y privada con cada solicitud de inicio
de sesin.
Cada
vez que alguien inicia una sesin, el servidor genera un nuevo par de claves y enva la nueva clave pblica al JavaScript
en la pgina que enva la contrasea. Esto asegura que la contrasea cifrada es diferente cada vez que se enva,
y un potencial atacante no ser capaz de robar la contrasea cifrada para acceder o enviar una solicitud diferente.
Debido a que es ms seguro, cifrado de clave dinmico es el valor por defecto cuando se activa la codificacin. El
desventaja de claves dinmicas es que la generacin de claves se ralentiza cada inicio de sesin, aunque no es generalmente
visible para
usuarios. Otro efecto de cifrado de clave dinmico es que no permite recordar las contraseas en el navegador.
Si bien esto puede ser un inconveniente, en realidad es ms seguro para no almacenar las contraseas en el navegador (donde
que pueden verse comprometidos) y requieren teclear la contrasea para cada inicio de sesin (porque las computadoras
pueden ser
robado). Ver "Configuracin de Memoria contrasea" en la pgina 151.
8.10.2
Esttica clave de cifrado

Si no se desea el cifrado de clave dinmico, JasperReports Server tambin admite el cifrado de clave esttica. En este caso, una
par de claves nico es generado automticamente en el primer inicio de sesin del usuario y sigue siendo el mismo para todo el
servidor
168
instalacin. Debido a que la clave es siempre el mismo, el valor cifrado de la contrasea de un usuario es siempre el mismo.
Esto significa que un atacante podra robar la contrasea cifrada y utilizarlo para acceder al servidor.
Cifrado de clave esttica es muy inseguro y slo se recomienda para la instalacin del servidor de intranet donde el
trfico de la red es ms protegido. La nica ventaja de cifrado esttica sobre ningn cifrado en absoluto es que
contraseas no pueden ser descifrados y se utilizan para atacar otros sistemas en los que los usuarios puedan tener la misma
contrasea.
Antes de configurar encryption.dynamic.key = false utilizar el cifrado esttica, tambin debe configurar el seguro
archivo llamado almacn de claves, donde se mantiene el par de claves. Asegrese de personalizar los parmetros de
almacn de claves que figuran en el
siguiente tabla para hacer que su archivo de almacn ms nico y seguro.
Por razones de seguridad, siempre cambiar las contraseas del almacn de claves por defecto inmediatamente
despus de instalar el
servidor.
Configuracin del almacn de claves (cuando encryption.dynamic.key = false)
Propiedad
Valor
keystore.location
keystore.jks
Descripcin
<Default>
keystore.password
jasper123 <Default>
keystore.key.alias
jaspe <Default>
keystore.key.password
jasper321 <Default>
Ruta de acceso y nombre del archivo de almacn de claves.

Este
parmetro es una ruta absoluta o un archivo en
la ruta de clase webapp, por ejemplo
<Tomcat> / webapps / JasperServer-pro / WEBINF / classes>. Por defecto, el archivo es keystore.jks
se entrega con el servidor y no contiene
ninguna tecla.
Contrasea para el archivo de almacn de claves conjunto.

Este
contrasea se utiliza para verificar la integridad del almacn
de claves.
Nombre por el que se recupera la clave nica de
almacn de claves. Si se especifica un nuevo alias y hace
no corresponde a una clave existente, una nueva clave
ser generado e insertado en el
almacn de claves.
Contrasea para la clave cuyo alias se especifica

por keystore.key.alias.
Al cambiar el alias de clave, no se eliminar la vieja llave; que puede ser utilizado de nuevo restableciendo el seudnimo de
claves.
Adems, una vez clave ha sido creado con una contrasea, no podr cambiar la contrasea a travs del almacn de claves
configuracin. Para eliminar las claves o cambiar una contrasea de almacn de claves, el administrador del servidor debe
utilizar el Java
keytool.exe utilidad en el directorio bin del JRE o JDK. Si cambia la contrasea del almacn de claves o la tecla
contrasea, la configuracin de almacn de claves anterior debe reflejar los nuevos valores o de inicio de sesin fallar para
todos los usuarios.
169
170
CAPTULO 9 CONFIGURACIN DEL

SISTEMA
Puede cambiar el comportamiento predeterminado de JasperReports servidor editando la configuracin del sistema. El
configuracin se define por un conjunto de propiedades y sus valores. Las propiedades de configuracin se almacenan en
dos
lugares:
Todas las propiedades se almacenan en archivos de configuracin ubicados en varias carpetas bajo las <js-install>
directorio,
que es la raz de la instalacin JasperReports Server. Para cambiar la configuracin, puede editar estos archivos
y luego reiniciar el servidor.
Algunas de las propiedades editado ms comunes estn disponibles para el administrador de sistema a travs de la interfaz
de usuario
(UI). Los cambios en estas propiedades surtan efecto inmediatamente, se almacenan en el repositorio, y anulan el
valores equivalentes almacenan en archivos, incluso despus de reiniciar el servidor (en la versin 5.0).
En este captulo se describe un subconjunto de las propiedades en los archivos de configuracin. Los ajustes que afectan a la
seguridad
cubierto en "Seguridad de aplicaciones" en la pgina 145. Configuracin de la funcin de auditora est cubierta en
"Configuracin de Auditora y Supervisin" en la pgina 223. Ms opciones se describen en la JasperReports Servidor
Gua de instalacin.
Debido a la ubicacin de los archivos que se describen en este captulo varan con el servidor de aplicaciones, las rutas
especificadas en
este captulo son en relacin con el archivo WAR desplegado para la aplicacin. Por ejemplo, el applicationContext.xml
archivo se muestra como que reside en la carpeta WEB-INF; si utiliza el servidor de aplicaciones Tomcat incluido con el
instalador, la ruta predeterminada para esta ubicacin es:
C: \ Archivos de programa \ jasperreports-servidor-5.6.1 \ apache-tomcat \ webapps \ JasperServer-pro \
WEB-INF
Tenga cuidado al editar las propiedades descritas en este captulo. Cambios involuntarios pueden provocar
errores inesperados en todo JasperReports Server que puede ser difcil de solucionar. Antes de cambiar
los archivos, copia de seguridad en un lugar fuera de la instalacin de JasperReports Server.
No modifique la configuracin que no se describen en la documentacin. A pesar de que algunos ajustes puede
Parece sencillo, valores distinto al predeterminado puede no funcionar correctamente y causar errores.
Adems de la configuracin descrita en este captulo, tambin puede configurar Liferay Portal o JBoss Portal
para mostrar los informes almacenados en la instancia JasperReports Server. Puede descargar los JasperReports
Portlets Server para estos ambientes desde el Portal de soporte Jaspersoft. Para obtener informacin sobre cmo
desplegar el portlet, consulte la documentacin en el paquete de descarga de portlets.
171
9.1
Ajustes de configuracin en la interfaz de usuario

Configuracin para el uso de proxies
Configuracin para la persistencia de sesin
Configuracin Ad Hoc
Habilitacin de datos instantneas
Configuracin de registros del sistema
Configuracin de servicios Web de Amazon
Configuracin de los dominios
Configuracin de JasperReports Biblioteca
Configuracin del funcionamiento del control de entrada
Configuracin del Programador
Configuracin del latido del corazn
Configuracin de la Ayuda en lnea
Ajustes de configuracin en la interfaz de usuario

Desde la versin 5.0, los cambios en los ajustes de configuracin en las interfaces de usuario JasperReports Server son
persistentes
a travs de los reinicios del servidor. Anteriormente, los cambios en la configuracin de la interfaz de usuario no se guardan, y al
reiniciar,
ajustes de configuracin se revertir a los valores almacenados en los archivos de configuracin.
Para realizar cambios de configuracin persistentes a travs de la interfaz de usuario del servidor JasperReports:
1. Inicie la sesin como administrador del sistema ( superusuario por defecto).
172
2.
Seleccione Administrar> Configuracin del

servidor:
3.
Seleccione una categora de ajustes o acciones de administrador desde el panel izquierdo de la

Configuracin:
Figura 9-1 La interfaz de usuario para los valores de configuracin

4.
Encontrar el ajuste que desea cambiar y editar su valor de configuracin. En el caso de los niveles de registro, el nuevo
valor entra en vigor inmediatamente. En el caso de otras configuraciones, haga clic en Cambiar junto a la configuracin
individual.
Estos ajustes y acciones de los administradores estn documentados en sus respectivas
secciones:
Ajustes
Documentacin
Configuracin del
registro
"Configuracin de registros del sistema" en la pgina

192
Ad Hoc Ajustes
"Ajustes de consulta ad hoc" en la pgina 178
Ad Hoc cach
"Ad Hoc administracin del cach" en la pgina 184
Configuracin OLAP
Gua del usuario de Jaspersoft OLAP
Configuracin de AWS
"Configuracin de Amazon Web Services" en la pgina 197
Importacin
"Importacin desde la interfaz de usuario de configuracin" en

la pgina 135
Exportacin
"Exportacin desde la interfaz de usuario de configuracin" en

la pgina 134
Al ver o modificar los valores de configuracin que aparecen en la interfaz de usuario (Ajustes del registro, Ad Hoc
Ajustes y Configuracin OLAP), tener en cuenta las siguientes pautas:
Las pginas de configuracin de la pantalla de un subconjunto de las opciones de configuracin que estn disponibles en
los archivos de configuracin.
Por lo tanto, tambin existen todos los ajustes en la interfaz de usuario en un archivo de configuracin.
Por defecto, las pginas de configuracin de la pantalla los valores de configuracin que existen en la configuracin
correspondiente
presentar. Si modifica los archivos y reiniciar el servidor, la nueva configuracin de archivos tengan efecto en el servidor
y son
visible en la interfaz de usuario.
173
Cuando se cambia un valor en las pginas de configuracin, la nueva configuracin surta efecto inmediatamente, pero el
nuevo
valor es no escrito en el archivo de configuracin correspondiente. En su lugar, se almacena en un recurso especial en la
repositorio, llamado el GlobalPropertiesList. El GlobalPropertiesList se encuentra en las propiedades del sistema
carpeta en la raz del repositorio y slo es visible para el administrador de sistema ( superusuario).
Propiedades Figura 9-2 El Sistema Folder Visible a Sistema de administradores
Slo los ajustes de configuracin que tienen un valor modificado en las pginas de configuracin de la interfaz de
usuario se almacenan y
hecho persistente en la GlobalPropertiesList.
Cuando se reinicia el servidor, los valores de la GlobalPropertiesList tienen prioridad sobre los valores de la misma
ajustes en los archivos de configuracin. Sin embargo, cada ajuste es independiente, por lo que un valor que no se haya
modificado
la interfaz de usuario de configuracin se lee desde el archivo correspondiente.
Las pginas de configuracin de la pantalla los valores de configuracin que estn en vigor en el servidor. Por lo tanto,
ajustes en el
GlobalPropertiesList aparece en las pginas de configuracin en el que se pueden cambiar de nuevo si es necesario.
Tenga en cuenta que los valores de configuracin que aparecen en las pginas de configuracin son posiblemente
una mezcla de
valores cargados desde los archivos de configuracin y de la GlobalPropertiesList persistente.
174
Haga clic con el GlobalPropertiesList y seleccione Editar para ver los valores de configuracin que almacena. Si un ajuste
se ha modificado en la interfaz de usuario, aparece en esta lista para que el ajuste es persistente. Si desea restablecer un
ajuste de forma que toma su valor del archivo de configuracin en su lugar, haga clic en Retire junto a ese ajuste y
a continuacin, reinicie el servidor. De lo contrario, Jaspersoft no recomienda modificar esta lista de valores directamente.
Figura 9-3 El GlobalPropertiesList contiene los valores de configuracin persistentes
9.2
El GlobalPropertiesList tambin incluye controladores JDBC configurados durante la instalacin oa travs de los datos
asistente de creacin de fuente. Para obtener ms informacin, consulte "Gestin de Controladores JDBC" en la pgina 68.
El almacenamiento de los valores de configuracin en el GlobalPropertiesList en el repositorio permite exportarlos
a los servidores o los re-importacin diferente despus de una actualizacin del servidor. Para obtener ms informacin,
consulte "Importacin desde la
Configuracin de la interfaz de usuario "en la pgina 135,

Al configurar JasperReports Server para utilizar un servidor proxy, hay dos configuraciones adicionales para que en el
configuracin del servidor. JasperReports servidor expone algunas URLs a s mismo a travs de la interfaz de usuario y al usar
el
planificador para enviar mensajes de correo electrnico. Cuando se utiliza un proxy, esas URLs se deben configurar para que
exponga el deseado
URL, no URL real de la instancia del servidor.
Cambie las siguientes configuraciones para que JasperReports servidor expone la URL del proxy.
175

Propiedad
Descripcin
deploy.base.url
Establezca esta propiedad en la direccin URL completa para la

exposicin de la
JasperReports ServerUI a travs del proxy. Esta URL
debe incluir el nombre de la aplicacin, por ejemplo:
http://bi.example.com/jasperserver-pro
... / WEB-INF / js.quartz.properties
9.3
Propiedad
Descripcin
report.scheduler.web.deployment.uri
Esta es la URL base utilizada por el planificador de

generar enlaces a los informes en los correos electrnicos.
Establezca esta propiedad
la direccin URL completa, incluyendo nombre de la aplicacin, que
exponer a travs de su proxy. Debe ser el mismo que
deploy.base.url.
Configuracin para la persistencia de sesin

Muchos servidores de aplicaciones tienen la capacidad de almacenar las sesiones de usuario, mientras que una aplicacin
web est en lnea, por ejemplo, cuando
cambiar los archivos de configuracin JasperReports Server. El servidor de aplicaciones se acuerda de toda la informacin
acerca de un usuario de
sesin, como el identificador de sesin y en qu pgina se est viendo, y cuando se reinicia la aplicacin web, el usuario
sesin se restaura. El usuario no tiene que conectarse de nuevo, y muchas veces ni siquiera se dar cuenta de que el servidor
se
disponible temporalmente. Esto se llama persistencia de sesiones.
Las sesiones no se conservan cuando la redistribucin de una aplicacin web en el servidor de aplicaciones, slo al
reiniciar
la aplicacin web.
JasperReports Server es compatible con una forma limitada de persistencia de sesiones. Cuando la persistencia de sesin en
habilitado en el
servidor de aplicaciones para JasperReports Server, las sesiones de usuario se puede restaurar en los siguientes casos:
Navegar por el repositorio, expandiendo las carpetas en el rbol del repositorio y la visualizacin de contenido de la carpeta.
Buscando el repositorio, incluyendo todos los filtros de bsqueda y resultados.
Dilogo de permisos del repositorio, incluyendo el estado y las selecciones.
Cuadro de dilogo Agregar carpeta.
Aadir dilogos de recursos, incluyendo la adicin o edicin de una fuente de datos, JasperReport, y otros objetos del
repositorio.
Copiar, cortar y pegar los recursos en el repositorio.

Programacin de un informe que incluya toda la informacin como un calendario y notificaciones.
Si el servidor no est disponible cuando se usan las pginas o cuadros de dilogo anterior, el usuario ver una pausa slo
cuando
realizar una accin en estas pginas, como por ejemplo la presentacin. Cuando el servidor ha terminado de reiniciarse, el
usuario puede
continuar interactuando con estas pginas o cuadros de dilogo. Si el usuario no realiza ninguna accin mientras el servidor
est
Sin
embargo,
otros dilogos
interactivos
en JasperReports
Server, el Estado es demasiado grande como para almacenar
disponible,
quepara
ni siquiera
puede notar
que hubo
un fracaso.
en la sesin del usuario.
Las siguientes funciones no son compatibles con la persistencia de sesin:
176
Ad Hoc editor - El estado del diseo del informe y los datos en el editor de Ad Hoc no puede ser restaurado, por lo que
cualquier
los cambios no guardados se pierden.
Diseador de paneles - El contenido y el estado de la tela no puede ser restaurado, por lo que los cambios no guardados
son
perdido.
Visor de informes interactivo - Los datos en el informe, as como el estado de la columna de clasificacin y filtrado no puede
ser salvos, por lo que se pierden los cambios no guardados.
Diseador de dominio - Las tablas, combinaciones, filtros, campos calculados, y nombres de pantalla no se puede restaurar,
y as
los cambios no guardados se pierden.
Visor OLAP - Los datos de la vista OLAP y expresin MDX actual no puede ser restaurado, por lo que cualquier
tendran que ser creado de nuevo los cambios no guardados.
Dilogos de administracin (al crear o editar una organizacin, un usuario o rol) - La informacin introducida en
un dilogo de administracin no puede ser restaurada si no se present.
En los casos mencionados anteriormente, el trabajo del usuario se interrumpe, y cualquier trabajo no guardado se pierde. Sin
embargo, cuando el servidor
se reinicia, el usuario no tiene que volver a iniciar sesin, el servidor muestra un mensaje acerca de la sesin que no pudo ser
totalmente restaurada, y el servidor redirige al usuario a la pgina principal. El usuario debe relanzar la caracterstica interactiva
y volver a crear cualquier trabajo no guardado.
Persistencia de sesiones tambin afecta a las llamadas de servicio web. La API REST apoya un inicio de sesin para almacenar
un ID de sesin, y con
persistencia permitido, que identificador de sesin seguir siendo vlida cuando se reinicia el servidor de aplicaciones. Esto
simplifica el
cdigo que necesitan para manejar los tiempos de espera. En general, las llamadas de servicio web no apoyan el trabajo
interactivo, como
el diseo de una vista especial, un tablero de instrumentos, un dominio, o explorar los datos en OLAP, para que no sean
Informe
afectados
porde
laejecucin - Todos API asncrona exige correr y exportacin de informes se basan en la gran
Objeto
JasperPrint
que no puede
persistir.
el servidor
se reinicia,
llamadas
volvern
falta de persistencia de sesiones
en esos
casos.Cuando
Sin embargo,
las llamadas
delas
servicio
webasincrnicas
se ven afectados
en elerrores
siguiente
caso:porque los informes no se pudieron guardar en la sesin. Su aplicacin debe detectar este error y
incluir el cdigo para volver a ejecutar el informe.
JasperReports Server tambin soporta la replicacin de sesin entre varias instancias del servidor en un
cluster. Sin embargo, la repeticin de sesiones tiene las mismas limitaciones, ya que se basa en la persistencia de sesiones.
Para obtener ms informacin, consulte la Ultimate Guide servidor JasperReports.
El siguiente procedimiento muestra la configuracin en JasperReports Server y la aplicacin Apache Tomcat

servidor para habilitar la persistencia de sesiones. Para otros servidores de aplicaciones, consulte la documentacin de ese
servidor.
Para configurar JasperReports Server y Apache Tomcat para la persistencia de sesin:
1. Editar el archivo <web-app> /META-INF/context.xml que comente la propiedad Administrador de la siguiente
manera:
<-! Ruta Gerente = "" / ->
2.
Editar el archivo <web-app> /WEB-INF/web.xml para realizar los siguientes cambios.

a.
Localice el oyente de la clase RequestContextListener y sustituirlo por el oyente de la clase

TolerantRequestContextListener. La nueva clase de escucha se da en los comentarios que usted necesita
descomentar la siguiente manera:
<Oyente de clase> com.jaspersoft.jasperserver.core.util.TolerantRequestContextListener

</ Oyente de clase>
<-! Oyente de clase> org.springframework.web.context.request.RequestContextListener
</ Oyente de clase ->
b.
Busque el ClusterFilter que se da en los comentarios y descomentar la siguiente manera:
177
<Filtro>
<Filter-name> ClusterFilter </ filter-name>
<-Clase de filtro> com.jaspersoft.jasperserver.war.TolerantSessionFilter </ clase de filtro>
</ Filter>
c.
Busque la asignacin correspondiente para la ClusterFilter y elimine tambin. Tambin debe

descomentar la <Distribuible> elemento que hay debajo de la siguiente manera:
<Filter-mapping>
<Filter-name> ClusterFilter </ filter-name>
<Url-pattern> / * </ url-pattern>
</ Filter-mapping>
<Distribuible />
3.
Aadir la siguiente propiedad a su entorno JVM:

-Dorg.apache.catalina.session.StandardSession.ACTIVITY_CHECK = True
4.
9.4
Reinicie el servidor de aplicaciones Apache Tomcat.
Configuracin Ad Hoc
Ad Hoc funcionalidad slo est disponible para los usuarios de la edicin profesional JasperReports
Server.
Ad Hoc ajustes ayudan a afinar el Ad Hoc Editor y las vistas que crea. Usted debe estar conectado como usuario
con ROLE_SUPERUSER para administrar la configuracin ad hoc y cach. En esta seccin se tratan los siguientes aspectos a
configurar Ad Hoc:
9.4.1
Ad hoc
Ad hoc
Ad hoc
Ad hoc
Ad hoc
Ad hoc
Ad hoc
Configuracin de la consulta
Polticas de datos
Polticas de datos para Big Data
Plantillas de informe y Generadores
Administracin del cach
Configuracin de filtros OLAP
Ad Hoc Configuracin de la
consulta
Los ajustes Ad Hoc se aplican a Ad Hoc vistas basados en temas o dominios. Ad Hoc vistas basadas en OLAP
conexiones, use los ajustes de OLAP que se describen en el Gua del usuario de Jaspersoft OLAP.
Los ajustes ad hoc incluye lo siguiente:
178
Configuracin general para modificar la interfaz de usuario Ad Hoc editor:

Configurar Vista Consulta. Determina si los usuarios pueden ver un botn en el Editor Ad Hoc para mostrar
la consulta SQL o MDX generado para la vista. Esto puede ser til para usuarios avanzados, pero debe
considerar su seguridad de los datos antes de habilitar esta. Sistema de administradores siempre pueden ver las consultas
en el Ad Hoc
Cach (ver "Ad Especial de Gestin de cach "en la pgina 184).
Visualizar Null como Zero. Determina la aparicin de valores nulos en tablas de referencias cruzadas y grficos de series de
tiempo. Por
De forma predeterminada, esta opcin est deshabilitada y los valores nulos se muestran como celda vaca de referencias
cruzadas o desaparecidos
puntos en los grficos de series de tiempo (lo que causa intervalos irregulares). Cuando se activa, se muestran los valores
nulos
como cero en tablas de referencias cruzadas y en series de tiempo (creando intervalos regulares). Independientemente de
este ajuste, los valores nulos
siempre se muestran como cero en todos los otros tipos de grficos.
Lmites de la consulta para preservar los recursos utilizados por las consultas cuando visitas Ad Hoc se disean y ejecutan:
Especial Filtro de lista de valores lmite de filas. El nmero mximo de elementos que se debe mostrar en
el Editor de condiciones cuando el usuario define filtros para una vista especial que se basa en un dominio. Si este
lmite se excede cuando los usuarios definir filtros, JasperReports Server muestra un mensaje en ese sentido.
Ajuste a un valor ms bajo puede mejorar el rendimiento.
Especial Lmite fila del conjunto de datos. El nmero mximo de filas que una vista Ad Hoc solicitar en un
consulta. Tenga en cuenta que JasperReports Server trunca los datos mostrados en el informe cuando el lmite es
alcanzado. Ajuste a un nmero inferior puede mejorar el rendimiento, pero sus informes puede no reflejar el
conjunto de datos.
Especial Tiempo de espera de consulta. El nmero de segundos que el servidor debe esperar el tiempo de espera antes de
un Grupo Especial
ver mientras se ejecuta la consulta. Ajuste a un nmero inferior puede prevenir excepciones cuando los usuarios ejecutan
Ad Hoc vistas. Ajuste a un nmero mayor puede prevenir los clculos complejos de tiempo de espera, pero
puede usar ms conexiones de base de datos.
Polticas de datos que determinan cmo JasperReports Server maneja la carga de datos y el procesamiento de ciertos tipos
Ad Hoc de visitas. Ver Ad Hoc Polticas de datos en la siguiente seccin.
Para configurar los ajustes de consultas ad hoc:

defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Ad Hoc Ajustes en el panel de la
3. izquierda.
Establezca los valores de configuracin como se describe anteriormente.
4. Haga clic en Cambiar al lado de cada valor ha modificado para hacer los cambios efectivos. O haga clic Cancelar para
restablecerlo
con el valor guardado previamente.
A partir de JasperReports Server versin 5.0, Ad Hoc ajustes realizados a travs de la interfaz de usuario son persistentes,
incluso si se reinicia el servidor. Para obtener ms informacin, consulte "Ajustes de configuracin en la interfaz de usuario"
en la
pgina 172.
9.4.2
Ad Hoc Polticas de datos

Instantneas de datos, descritos en Datos Snapshots y habilitacin Datos Snapshots, aplicar nicamente a los informes
aparece en el visor de informes. Esta seccin cubre las polticas de datos que slo se aplican a las vistas en el Ad Hoc
Editor.
Polticas de datos determinan cmo los datos estn en cach y donde se producen determinados clculos. Todo el trabajo Ad
Hoc se basa en
una consulta, ya sea desde un tema de dominio o de dominio, o desde el JRXML de un tema sencillo. Polticas de datos
determinan
si el motor de Ad Hoc se utiliza la consulta tal y como son y procesar los datos en la memoria, o si se vuelve a escribir el
consulta para que los datos y declaraciones de los procesos de base de datos slo lo Ad Hoc tiene que mostrar.
Por defecto, los datos consultados por los informes basados en dominio se agrupan, ordenados, y se agregan en la base de
datos, en lugar
de tener el proceso del servidor en la memoria. Al hacerlo, el servidor recupera slo las columnas que aparecen en
el informe en lugar de todo el conjunto de campos en el dominio. A partir de JasperReports Server 5.5, los campos calculados
son
tambin procesada por la base de datos. Para consultas Tema basado en JDBC (y JNDI) fuentes de datos, el comportamiento
por defecto
es solicitar todo el conjunto de resultados y procesar las columnas para la visualizacin en la memoria. El registro de entrada
independiente
cajas controlan el comportamiento: uno para dominios y otro para fuentes de datos JDBC.
179
Cuando se borran estas casillas de verificacin, el servidor carga todo el conjunto de campos que tengan relacin con un tema
o dominio
en la memoria, y luego aplica los clculos necesarios, agrupacin, clasificacin y agregacin. Este es tambin el
caso de Ad Hoc opiniones que no dependen de Dominios o fuentes de datos JDBC; En estos casos, los procesos de servidor
los datos en la memoria.
Generalmente, Jaspersoft recomienda que se habilitan estas opciones, especialmente cuando se trabaja con grandes conjuntos
de datos. En
decidir si JasperReports Server debe procesar los datos en la memoria o empuje que el procesamiento de la
base de datos, tenga en cuenta estos factores:
El tamao y la complejidad de sus informes. Informes con campos calculados, clasificacin costosa, agrupacin o
agregacin puede funcionar mejor cuando el servidor optimiza las consultas de forma que la base de datos realiza la
trabajo.
La cantidad de datos en las fuentes de datos. Si sus fuentes de datos incluyen una gran cantidad de datos, informes contra
ellos pueden funcionar mejor cuando el servidor optimiza las consultas.

El nmero de usuarios de la edicin y ejecucin de Ad Hoc visitas. Si usted tiene un gran nmero de usuarios que crean y
correr Ad Hoc vistas, el rendimiento puede ser mejor cuando el servidor optimiza las consultas. Implementaciones
con un menor nmero de usuarios puede funcionar mejor cuando las opciones estn desactivadas.
Las caractersticas de rendimiento de la fuente de datos. Si la base de datos u otro origen de datos est ajustada para
mximo rendimiento, Ad Hoc vistas puede funcionar mejor cuando el servidor optimiza las consultas.
Si el origen de datos es recibido por MySQL, Jaspersoft recomienda que mantenga el valor por defecto (sin marcar) para
la Optimizar consultas para informes basados en JDBC ajuste. MySQL tiene malos resultados con el anidado
consulta que este ajuste generara.
La cantidad de memoria asignada a la mquina virtual Java de JasperReports Server (JVM). Si la JVM del
servidor de aplicaciones que aloja JasperReports Server se asigna un montn de memoria, Ad Hoc opiniones pueden
realizar
mejor cuando JasperReports servidor optimiza las consultas. Esto es especialmente cierto si el origen de datos tiende a
ser lento.
Para decidir si JasperReports Server debe optimizar las consultas para visitas ad hoc, Jaspersoft recomienda
desactivacin de la configuracin, abrir y guardar algunos informes representativos, y probar su rendimiento. Si el
el rendimiento mejora, deje la configuracin discapacitados y abrir y guardar los informes restantes.
Las polticas de datos que se pueden configurar
son:
Optimizar consultas para informes basados en JDBC. Cuando se activa, Ad Hoc reescribe la consulta para calcular,
filtro, grupo, columnas especie, y agregados al utilizar temas basados en fuentes de datos JDBC y JNDI.
De lo contrario, las consultas se ejecutan campos inalterados y calculados, filtrar, agrupar, clasificar, y toma la agregacin
colocar en la memoria.
Optimizar las consultas para los informes basados en el dominio. Cuando se activa, Ad Hoc reescribe la consulta para
calcular
filtro, grupo, columnas especie, y agregados al utilizar Dominios o Temas de dominio. De lo contrario, las consultas
corren campos inalterados y calculados filtrar, agrupar, ordenar y agregacin tienen lugar en la memoria.
Estas configuraciones de directiva de datos no se actualizan de forma retroactiva los informes existentes creados a partir
de Ad Hoc vistas en
su repositorio. Para cambiar la poltica de datos para un informe existente, seleccione el ajuste de la poltica apropiada,
abrir la vista correspondiente en el Editor Ad Hoc, y guardar el informe de nuevo.
Para configurar las polticas de datos de anuncio:

defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Ad Hoc Ajustes en el panel de la
izquierda.
3. Seleccione Optimizar consultas para informes basados en JDBC para optimizar y volver a escribir las consultas para
basado en JDBC
Temas.
180
4.
5.
Seleccione Optimizar las consultas para los informes basados en el dominio para optimizar y volver a escribir las consultas
para basado en dominio
informes.
Haga clic en Cambiar al lado de cada valor ha modificado para hacer los cambios efectivos. O haga clic Cancelar para
restablecerlo
con el valor guardado previamente.
A partir de JasperReports Server versin 5.0, Ad Hoc ajustes realizados a travs de la interfaz de usuario son persistentes,
incluso si se reinicia el servidor. Para obtener ms informacin, consulte "Ajustes de configuracin en la interfaz de usuario"
en la
pgina 172.
9.4.3
Ad Hoc Polticas de datos para Big Data

Cuando el manejo de grandes conjuntos de datos (Big Data) de una fuente de dominio en el Editor Ad Hoc, campos resumidos
por
recuento diferente son computacionalmente intensivos. Usted puede acelerar la visualizacin de sus datos mediante la solicitud
de distinta
contar clculos de la fuente de datos, en contraposicin a la realizacin de los clculos en la memoria. Servidores de bases de
datos
por lo general estn optimizados para estos clculos, lo que mejora el rendimiento general del Editor Ad Hoc.
Especial para Big Data
... / WEB-INF / applicationContext-adhoc.xml
Propiedad
Frijol
Descripcin
CalcMethod
Distinto
Cuente
Cambie esta propiedad desde value = "sqlGroupBy" (la

predeterminado) a value = "sqlUnionAll". El UnionAll es la
consulta modificada que proporciona recuento diferente
calculado por la base de datos.
Despus de hacer este cambio, vuelva a implementar la aplicacin web JasperReports Server o reiniciar el servidor
de aplicaciones.
Realizacin de los agregados de recuento diferente en la base de datos slo se aplica en los siguientes
casos:
Tablas de contingencia basados en dominios contienen medidas referidas a una cuenta distinta.
Tablas basadas en Dominios contienen grupos agregados por recuento diferente, pero no hay filas de
detalle.
Este ajuste no tiene ningn efecto cuando hay un grupo de filas o columnas que implica un tiempo, fecha y hora o la fecha. En
este caso,
Ad Hoc realiza los clculos de resumen de recuento diferente en la memoria, independientemente de la CalcMethod ajuste.
9.4.4
Especial Plantillas de informe y Generadores

JasperReports Server 5.5 introdujo Ad Hoc plantillas y generadores de informes. Plantillas Ad Hoc son archivos JRXML
en el repositorio que definir el formato de los informes generados a partir de Ad Hoc visitas. Los generadores de informes son
personalizados
frijoles que producen salida personalizado de visitas ad hoc.
En la interfaz de usuario, los usuarios pueden seleccionar la plantilla predeterminada, busque una plantilla diferente, o
seleccione una
generador de informes, si se ha definido. Para obtener ms informacin sobre la interfaz de plantilla de informe, consulte la
Gua del usuario de JasperReports Server. En esta seccin se explica cmo configurar estos controles.
181
9.4.4.1 Cambio de la plantilla por defecto Ad Hoc

El Ad Hoc plantilla predeterminada crea un informe que se asemeja a la interfaz de usuario Ad Hoc. Est dirigido a lnea
visualizacin y no restringir el tamao de los contenidos para la impresin. Para configurar una plantilla diferente, modifique
el
siguiente propiedad:
Por defecto Plantilla Especial
Propiedad
Frijol
Descripcin
defaultTemplateUri
util: mapa
id = "informe
Generador
DefaultConf "
Especifique la ruta al repositorio de su nuevo default

plantilla. Asegrese de que la plantilla tiene permisos para
que sea accesible a todos los usuarios. El valor por defecto es
/public/templates/actual_size.510.jrxml.
9.4.4.2 Modificacin de la Plantilla Ad Hoc Carpetas

Plantillas ad hoc deben ser subidos a carpetas especficas en el repositorio. Las carpetas predeterminadas son / templates (en
cada organizacin) y / public / templates. Para establecer diferentes carpetas, modificar la siguiente propiedad:
Especial Carpetas Plantilla

Propiedad
Frijol
Descripcin
templateURIParent
SQLPatternList
adhocEngine
Servicio
Agregar, cambiar o eliminar los valores de esta lista para

especificar las carpetas en el repositorio en el que el servidor
busca plantillas Ad Hoc.
El Ad Hoc ubicaciones de plantillas por defecto contiene la plantilla predeterminada. Si mueve o elimina esas carpetas en la
repositorio, asegrese de actualizar la definicin del defecto Ad Hoc plantilla como se describe en la seccin anterior.
Adems, las plantillas de organizacin incluyen la carpeta adhoc / templates para que aparezca en cada nueva organizacin.
Usted debe actualizar todas las plantillas de la organizacin si se cambia o elimina el valor% / templates. Para obtener ms
informacin, consulte "Carpetas predeterminadas para las Organizaciones" en la pgina 28.
9.4.4.3 Adicin Generadores Ad Hoc de informe
Por defecto, el servidor no tiene generadores de informes personalizados definidos, y ninguno aparece en la interfaz
de usuario.
Para agregar un generador de informes personalizados:
1. Crear una clase Java que implementa la interfaz com.jaspersoft.ji.adhoc.service.AdhocReportGenerator.
182
2.
Compile la clase y colocar el archivo JAR resultante en <js-webapp> / WEB-INF / lib.
3.
Abra el archivo ... / WEB-INF / applicationContext-adhoc.xml para editar y registrar su clase como un grano de primavera
como se muestra en el siguiente ejemplo:
<Bean id = clase "myCustomReportGenerator" = "com.example.myCustomReportGenerator">

<Nombre de propiedad = valor "id" = "mi-custom-generador" />
<Property name = "..." value = "..." />
...
</ Bean>
4.
En el mismo archivo, actualizar el reportGeneratorFactory frijol para incluir su generador frijol personalizada:
<Bean id = class = "com.-" reportGeneratorFactory "
jaspersoft.ji.adhoc.service.ReportGeneratorFactoryImpl ">
<Nombre de propiedad = "reportGenerators">
<Lista>
<Ref frijol = "myCustomReportGenerator" />
<-! <Bean ref = "actualSizeReportGenerator" /> ->
<-! <Bean ref = "letterPortraitReportGenerator" /> ->
<-! <Bean ref = "letterLandscapeReportGenerator" /> ->
<-! <Bean ref = "a4PortraitReportGenerator" /> ->
<-! <Bean ref = "a4LandscapeReportGenerator" /> ->
</ List>
</ Propiedad>
</ Bean>
5.
Edite el WEB-INF paquetes archivo ... / / / adhoc_messages.properties aadir una etiqueta de interfaz de usuario para su
generador personalizado.
La clave tiene la forma ADH_REPORT_GENERATOR_ <generador-id>. Aadir la misma clave para otro idioma
paquetes si usted quiere apoyar a otros idiomas.
ADH_REPORT_GENERATOR_my-custom-generador = Plantilla de las empresas
6.
9.4.5
Reinicie el servidor o volver a implementar la aplicacin web JasperReports Server. La etiqueta para su generador
personalizado
aparece en la lista de generadores de informes cuando los usuarios crear y guardar un informe de una vista
especial.
Ad Hoc del archivo de configuracin

Las siguientes propiedades se encuentran entre los que se puede configurar en el directorio WEB-INF /
applicationContextarchivo adhoc.xml:
Tabla 9-1 Propiedades configurables en WEB-INF / applicationContext-adhoc.xml
Propiedad
Descripcin
JrxmlScriptURI
La ubicacin en el sistema de archivos de la secuencia de comandos state2jrxml.js, que genera la

Informe JRXML basado en las selecciones actuales Ad Hoc Editor. Por defecto, este archivo
se encuentra en la carpeta / adhoc del repositorio.
realmsURI y
realmsURIParent
SQLPatternList
Las ubicaciones de repositorio donde Temas deben residir. Los valores

predeterminados son
/ Adhoc / temas y / / adhoc / temas pblicos.
DefaultTheme
El nombre del estilo por defecto para las vistas Ad Hoc. Este nombre debe coincidir con un
estilo
definido tanto en una CSS y un archivo JRXML. El valor predeterminado es predeterminado.
183
Propiedad
Descripcin
aruFolder
La ubicacin del repositorio donde los usuarios pueden guardar sus puntos de vista Ad Hoc. El
predeterminado es /. Esto permite a sus usuarios guardar Ad Hoc vistas en cualquier lugar. Si
usted tiene un
carpeta especficamente para contenido del usuario, especifique esta carpeta; Por ejemplo, /
userviews.
La ubicacin del repositorio donde JasperReports Server guarda los informes creados a partir de
Ad Hoc vistas. El valor predeterminado es / temp relativo a la raz y para todas las
organizaciones.
El servidor permite a los usuarios con ROLE_ADMINISTRATOR o ROLE_SUPERUSER
para ver las carpetas temporales y sus contenidos. El servidor gestiona estos
archivos temporales de forma automtica, pero los archivos pueden acumularse en ciertos casos.
Como parte
de mantenimiento regular, debe eliminar peridicamente los archivos de estas carpetas.
tempFolderName
maxSafeGroupMembers
El nmero mximo de grupos de filas y grupos de columnas de una tabla de referencias

cruzadas puede mostrar
antes de que el editor solicita al usuario la confirmacin. Este lmite es una salvaguarda para
evitar problemas de rendimiento al agrupar un campo con demasiados valores. El
predeterminado es 100 Set nivel ms alto para permitir que ms grupos aparezcan sin
preguntar
usuarios.
createColumn
CrosstabHeaders
Esta propiedad se encuentra en el actualSizeReportGenerator frijol. Con el

configuracin predeterminada de falso, encabezados de grupo aparecen en la columna de la
vista ad hoc, pero
no en el informe generado a partir de la vista (este es el comportamiento histrico). Cuando
ajustado a verdadera, encabezados de grupo aparecen en la columna tanto la vista ad hoc y en el
informe generado. Cuando encabezados de grupo de columnas se incluyen en una tabla de
referencias cruzadas, una
se aade fila adicional por debajo de los encabezados de columna para el espaciamiento.
Las ubicaciones URI del repositorio son en relacin con todos y cada organizacin en la instancia del servidor. Para
ejemplo, para un usuario de la organizacin predeterminada, la URI / adhoc en realidad se refiere a
/ Organizaciones / organization_1 / adhoc.
9.4.6
Ad Hoc administracin del cach

El cach Especial se aplica a Ad Hoc vistas basados en temas o dominios, y los informes generados a partir de
esos Ad Hoc vistas. Visitas del anuncio hoc basadas en conexiones OLAP utilizan el cach OLAP. Para una comparacin
de las dos cachs, consulte "La comparacin con Jaspersoft OLAP cach" en la pgina 188. Para obtener instrucciones sobre
ajuste de la cach OLAP, consulte la Gua del usuario de Jaspersoft OLAP.
JasperReports Server puede cach temporalmente ad hoc conjuntos de resultados de la consulta para su reutilizacin. La cach
se rellena por la
datos que resulten de las consultas al crear o ejecutar Ad Hoc visitas. Los conjuntos de datos se identifican de forma nica por
un
clave
que hace referencia
a lareduce
propia las
consulta,
y los parmetros
utilizados
cuando
se emiti
la consulta.
El
almacenamiento
en cach
cargasladefuente
basesde
dedatos
datosURI,
y entrega
conjuntos de
datos para
el usuario
utiliza
con
frecuencia-rpidamente. El almacenamiento en cach se aplica cuando
informes se crean, as como cuando se ejecutan. JasperReports Server versin 5.0 introduce una nueva cach
184
aplicacin llamada Ehcache que permite al administrador ver la cach de tamao de memoria de entrada y establecer lmites en
uso de la memoria. Puede configurar el cach Ad Hoc para optimizar el uso de memoria y tiempo de respuesta para su
los patrones de uso.
9.4.6.1 Ajuste de la cach Granularidad
De forma predeterminada, los conjuntos de datos para cada usuario se almacenan en cach por separado; un parmetro de la
clave de cach identifica al usuario. Este
por usuario de almacenamiento en cach puede dar lugar a conjuntos de datos duplicados cuando diferentes usuarios ejecutan
la misma consulta, perjudicando el rendimiento.
Puede configurar JasperReports Server para compartir conjuntos de datos en cach a travs de los usuarios editando el / WEBArchivo / applicationContext-datarator.xml INF.
El siguiente cdigo configura el cacheKeyInterceptor frijol ignorar las credenciales de los usuarios registrados cuando
la creacin de las claves de cach:
<Nombre de propiedad = "ignoredParameters">
<Lista>
...
<Valor> LoggedInUser </ value>
<Valor> LoggedInUserName </ value>
</ List>
</ Propiedad>
Reinicie JasperReports Server despus de guardar el archivo

modificado.
9.4.6.2 Configuracin de la cach
El almacenamiento en cach mejora el rendimiento general de la recuperacin de datos y la clasificacin, pero los conjuntos
de datos no utilizados puede consumir memoria
y los datos almacenados en cach puede estar pasado. Para abordar estas preocupaciones, la cach elimina
automticamente los conjuntos de datos
peridicamente. Por defecto, los conjuntos de datos se eliminan de la memoria cach si no se accede durante 30 minutos.
Ellos son
Para
configurar
la frecuencia
la minutos,
que la memoria
cach se borradeautomticamente,
edite
el archivo
de configuracin siguiente:
Tambin
despejado
despus con
de 90
independientemente
la forma en que se
accedi
recientemente.
Ad Hoc de caducidad de cach
... / WEB-INF / adhoc-ehcache.xml
Propiedad
Valor predeterminado Descripcin
maxBytesLocalHeap
300m
El uso de memoria mximo de toda la memoria cach, por

por defecto 300 MB. Uso kpara kilobytes, mpara megabytes, y
gpara gigabytes.
Si se deja sin lmites, la cach Ad Hoc puede utilizar todo
memoria disponible en su JVM. Establezca este valor de acuerdo
la memoria disponible de su servidor, el tamao de su
conjuntos de datos, y el nmero de entradas de cach que esperas
basado en el uso concurrente Ad Hoc y los ajustes de tiempo
a continuacin. Jaspersoft recomienda establecer este valor a cerca de
mitad del tamao mximo del montn que ha configurado para el
JVM (ajuste -Xmx).
185
Ad Hoc de caducidad de cach

timeToIdleSeconds
1800
El nmero de segundos de espera despus de un conjunto de datos se

ha
visitada antes de sacarla de la cach. El valor por defecto
es equivalente a 30 minutos. Utilice 0 (cero) para ningn lmite.
timeToLiveSeconds
5400
El tiempo mximo que un conjunto de datos se almacena en la memoria

cach,
incluso si se est accediendo repetidamente. Asegura que rancio
datos se reemplazan peridicamente. El valor predeterminado es
equivalente a
90 minutos. Utilice 0 (cero) para ningn lmite.
Reinicie JasperReports Server despus de modificar estos valores.

9.4.6.3 Borrar manualmente el cach
Los administradores tambin pueden utilizar la interfaz de servidor para ver las consultas cuyos conjuntos de datos estn en la
memoria cach.
Los administradores pueden ver la consulta completa, pero nunca el contenido del conjunto de datos. La pgina Hoc Ad cach
tambin
pantallas RENDIMIENTO Los datos sobre cada consulta. Esta informacin puede ser til cuando se trata de resolver problemas
de rendimiento
Edad (min: seg) - Tiempo desde el conjunto de datos se almacenan primero en la cach.
cuestiones.
La interfaz
muestra
varios valores
parade
cada
consulta:
Query (ms)
- Tiempo
en milisegundos
a partir
cuando
la consulta fue enviado a la fuente de datos (base de datos) hasta
el primer
se recibi fila.
Fetch (ms) - Tiempo en milisegundos desde que se recibi la primera fila del origen de datos (base de datos) hasta
se recibi la ltima fila.
Memoria utilizada (MB) - Tamao en megabytes del conjunto de datos resultante se almacena en la entrada de la cach.
La pgina Hoc Ad cach tambin permite a los administradores para eliminar manualmente los conjuntos de datos si es
necesario. Extraccin de una
conjunto de datos de la cach de fuerza al servidor a obtener nuevos datos la prxima vez que crea un usuario o se ejecuta
una vista Ad Hoc
con esa consulta.
Para ver consultas y borrar manualmente la cach Ad Hoc:
1. En JasperReports Server, inicie la sesin como administrador del sistema ( superusuario por
defecto).
2. Haga clic en Administrar> Configuracin del servidor y seleccione Ad Hoc cach en el panel de la
izquierda.
Aparece la pgina de Ad Hoc Cache, que muestra todos los conjuntos de datos que se encuentran en la
memoria cach, clasificadas por edad.
186
Figura 9-4 Especial Conjunto de datos de almacenamiento en cach de

Administracin Web
3.
4.
5.
6.
Como se muestra en la figura anterior, cada conjunto de datos aparece en la lista por su correspondiente fuente de
consulta y datos. Recall
que los temas Ad Hoc tienen consultas definidas por el usuario, por lo que tienden a ser cortos, mientras que la consulta
para dominios son
generada a partir del diseo del Dominio y las selecciones del usuario en el cuadro de dilogo Data Selector. El Ad Hoc
Pgina
Cachtodos
slo muestra
las primeras
lneas
una
as en
como
el origen
de de
datos.
Para eliminar
los conjuntos
de datos,
hagadeclic
enconsulta,
Borrar todo
la parte
inferior
la pgina de Ad Hoc cach. Esto
tambin borra la Teiid
cach utilizado por las fuentes de datos virtuales, incluyendo una fuente de datos virtual que envuelve una fuente de datos
Para
eliminar
conjunto de datos especficos de la cach, y haga clic en Claro junto a la consulta
para los
datosun
grandes.
correspondiente.
Para encontrar una entrada de cach especfico, puede cambiar la clasificacin en la parte superior izquierda haciendo clic
La edad, el ltimo uso
Tiempo, memoria utilizada, o URI de origen de datos.
Para ver los detalles de una consulta especfica, incluyendo la cadena de consulta completa, haga clic en la propia consulta
en el Query &
Columna de origen.
Aparecer la pgina de detalles, que muestra informacin adicional para la consulta seleccionada, tales como el nmero
de
filas en el conjunto de datos en cach.
187
Figura 9-5 Conjunto de datos tpico en Ad Hoc cach

9.4.6.4 Comparacin con Jaspersoft OLAP cach
En la siguiente tabla se contrastan las caractersticas clave de la cach Ad Hoc en JasperReports Server y Jaspersoft
OLAP.
Tabla 9.2 Ad Hoc Caching en JasperReports Server y Jaspersoft OLAP
Cach de funciones
Jaspersoft OLAP
Estructura de cach
Cachs de Resultados se llevan a cabo en la consulta

Cachs de Resultados se llevan a cabo en el anlisis
nivel: texto de la consulta y el lenguaje, adems de
nivel
los de conexin: esquema de base de datos ms
datos
conexin.
URI de origen y los parmetros de consulta.
Compartir
No por defecto, pero se puede habilitar como

descrito en Configuracin de la cach
Granularidad, anteriormente.
Seguridad
Aplicado a la cach de control de manera que los usuarios no se les permite ver los datos
privilegiados.
Poblar
Consultas pueblan la memoria cach. Tambin puede programar informes para rellenar previamente la
memoria cach
fuera de las horas.
Tamao
Limitado por la memoria JVM disponibles (montn). No configurable.
Slo hay una cach; se comparte a travs de

todas las consultas y los usuarios.
Se est quedando sin memoria es inusual. Slo puede ocurrir si una sola consulta devuelve demasiados
elementos para la memoria disponible. El informe de falla con un error de falta de memoria.
188
Cach de funciones
Jaspersoft OLAP
De tiempo automtico
Configurable, como se describe en
poltica de cach basado Configuracin de la cach anteriormente.
En situaciones de poca memoria, elementos

almacenados en cach son
eliminado automticamente por JVM basura
coleccin; los artculos usados menos recientemente-son
limpiado primero. No hay manera de eliminar
de datos basado en el tiempo que ha estado en
memoria.
Clearing seleccionado
Configurable, como se describe en
conjuntos de datos de forma
seccin manualmente Borrar la cach
manual
anteriormente.
Regiones de cach pueden ser definidas y borran

programacin con API.
Borrado de toda
Configurable, como se describe en Manualmente En JasperReports Server, seleccione Gestionar>
conjuntos de datos de forma
Borrar la cach anteriormente.
Configuracin del servidor, a continuacin, seleccione
manual
OLAP
Ajustes y haga clic en Flush cach OLAP. Para
mtodos adicionales, ver la Jaspersoft
Ultimate Guide OLAP.
9.4.6.5 Desactivacin de la Ad Hoc cach

Desactivacin sea cach es una configuracin de todo el servidor que se aplica a todas las fuentes de datos o conexiones
utilizadas en cualquier
Ad Hoc vista. Asegrese de que otros puntos de vista no se ven afectados negativamente por este cambio.
Hay dos razones para considerar la desactivacin de la cach Ad Hoc:
Usted tiene una base de datos de alto rendimiento que devuelve resultados tan rpido que el almacenamiento en cach
adicional en el servidor hace
no mejora los tiempos de respuesta. En este caso, la ligera sobrecarga de la memoria cach en realidad puede afectar al
rendimiento.
Su base de datos gestiona los datos en tiempo real, y crear Ad Hoc vistas que presentan up-to-the-minute
informacin de esta fuente de datos. En este caso, usted no desea recuperar los datos antiguos fuera de la cach.
Para desactivar la cach Especial para Temas y Dominios, establezca el valor de maxBytesLocalHeap a 1 (1 byte). Para
instrucciones, consulte "Configuracin de la cach" en la pgina 185. Esto definitivamente desactiva la cach para que cada
consulta
se recupera directamente de la fuente de datos.
Para desactivar la cach OLAP para conexiones OLAP utilizado en el Editor Ad Hoc, compruebe el
mondrian.rolap.star.disable-Caching establecer en la Gestionar> Configuracin del servidor> Configuracin OLAP
pgina. Para obtener ms informacin, consulte la Gua del usuario de Jaspersoft OLAP.
Adems, si ha modificado ninguna de estas tres propiedades en applicationContext-adhoc.xml, los puso de vuelta
false:
<Property name = "applyQueryFilterInMemory" value = "false" />
<Property name = "applySecurityFilterInMemory" value = "false" />
<Property name = "applyDynamicFilterInMemory" value = "false" />
9.4.7
Ad Hoc Configuracin de filtros OLAP

Cuando el uso de filtros en Ad Hoc OLAP, el servidor consulta la base de datos para mostrar una lista de valores para
seleccionar. Para
evitar problemas de rendimiento, hay un lmite en el nmero de artculos en un filtro. De forma predeterminada, el lmite es de 250
posibles
valores.
189
Si sus filtros llegan a este lmite y su lista de valores se trunca, primero debe considerar el uso de un filtro diferente
operacin. Por ejemplo, en lugar de "la ciudad es una de <lista>," uso "de la ciudad comienza con <letra>." Si usted todava tiene
que
cambiar este lmite, modifique la siguiente propiedad:
Especial Lmite Filtro OLAP
... / WEB-INF / applicationContext-adhoc-dataStrategy.xml
9.5
Propiedad
Frijol
Descripcin
maxFilterValues
mdxDataStrategy
Establezca el valor en el nmero mximo de filtro que valora

esperar. Al establecer este valor ms alto que el valor por defecto de
250
puede causar problemas de rendimiento.
Habilitacin de datos instantneas

La funcin de instantnea de datos se introdujo en JasperReports Server versin 4.7 a los datos del informe en el servidor de
la tienda.
Instantneas de datos crean un cambio significativo en la experiencia del usuario:
Sin instantneas de datos - Cada vez que el usuario ejecuta un informe, el servidor consulta la fuente de datos y muestra el
datos ms recientes. Cuando el mismo informe se ejecuta una y otra vez, la fuente de datos a menudo se vuelve a los
mismos datos cada
y cada vez. Este es el comportamiento de todas las versiones anteriores a la 4.7, y el comportamiento por defecto de la
liberacin 4.7.
Con instantneas de datos - La primera vez que un informe se ejecuta, se consulta la fuente de datos y almacena una copia
de los datos
con el informe en el repositorio. Los usuarios que vean el informe ms adelante ver los datos de la instantnea guardada,
no
de consultar el origen de datos. Los informes que se accede a travs de las API de servicios web tambin se basan en el
salvado
instantnea. Para informes grandes o informes que ve frecuentemente, la instantnea PERSISTED proporciona una
significativa
ganancia en el rendimiento y reduce la carga en los orgenes de datos. Cada usuario que tenga acceso al informe ver
los datos de la misma instantnea. Para los usuarios que as lo requieran, el visor de informes proporciona un botn de
Jaspersoft alienta permite instantneas de datos con las siguientes recomendaciones:
forma manual
actualizar
la instantnea
datos ende
cualquier
momento.
Adems,
cuando el planificador
ejecuta un para
trabajo
en un el
informe
Si
usted tiene
una nueva de
instalacin
JasperReports
Server,
a continuacin,
habilitar instantneas
obtener
que siempre
actualiza
servidor
completo
la
instantnea.En
Instantneas
deinstantneas
datos se implementan
en JasperReports
4.7, pero
estar habilitadas
funcionalidad.
el futuro, las
de datos persistentes
puedenServidor
ser activadas
pordeben
defecto.
manualmente.
Si
est actualizando desde una versin anterior 4.7, primero proceder con el procedimiento de actualizacin y verificar la
resultado, como se indica en la Gua de instalacin del servidor JasperReports. Entonces, antes de habilitar los datos
instantneas, notifiquen a los usuarios sobre esta nueva funcionalidad.
Instantneas de datos se almacenan en el repositorio del servidor, que debe tener una capacidad adecuada. Si usted tiene
una gran
nmero de informes o reportes muy grandes, considere el rendimiento de la base de datos de repositorio antes
permitiendo a las instantneas. Si los usuarios se basan en datos que cambian con frecuencia o si esperan para ver los
datos en tiempo real
al abrir un informe, no habilite las instantneas. Como alternativa, puede desactivar las instantneas de forma selectiva
como
describe a continuacin.
9.5.1
Configuracin Global Snapshot de datos

La configuracin de nivel de servidor determina si la funcin de instantnea est disponible o no en el servidor:
190
Configuracin del servidor de nivel de datos de instantneas

... / WEB-INF / applicationContext-data-snapshots.xml
Propiedad
Frijol
Descripcin
instantnea
Persistencia
Activado
dataSnapshot
Servicio
Cuando se establece en verdadera, permite que el informe JasperReports

servidor
espectador para guardar instantneas de datos en el repositorio y abierta
la prxima vez que se ejecute el informe. Por defecto, est ajustado a
falsa.
Tambin hay una propiedad llamada snapshotRecordingEnabled que cachea una instantnea en el informe
visor de memoria cuando la clasificacin y columnas de filtracin de forma interactiva. Esto permite que el visor de
informes para
actualizar la pantalla sin la consulta de la base de datos cada vez. Independientemente de la persistencia,
snapshotRecordingEnabled mejora la visualizacin de rendimiento de los informes y disminuye la carga de base de datos,
y por lo tanto debe permanecer ajustado en verdadera.
9.5.2
Informe a nivel de configuracin de instantnea de

datos
En el nivel de informe, la propiedad que se puede especificar para desactivar las instantneas en un informe especfico al
establecer
la siguiente propiedad en JRXML del informe:
net.sf.jasperreports.data.cache.persistable = false
Esta propiedad de nivel de informe depende del mecanismo de instantneas en JasperReports Server. Este
propiedad no tiene efecto en otros visores de informes sin un mecanismo de este tipo, como el espectador
integrado en Jaspersoft iReport Designer.
Hay dos maneras de controlar las instantneas en el nivel de informe. En el caso anterior:
Instantneas de datos estn habilitadas en el servidor, por lo que la mayora de los informes de los usan.
Si hay algunos informes que no se benefician de instantneas de datos, los informes pueden deshabilitar de forma
explcita
instantneas en su propio JRXML.
Al igual que con todas las propiedades de nivel de informe, puede configurar los valores por defecto a nivel de servidor,
como se describe en "Configuracin de
JasperReports Biblioteca "en la pgina 206:
Datos instantneas predeterminada Configuracin de informes de
nivel
... / WEB-INF / classes / jasperreports.properties
Propiedad
Descripcin
net.sf.jasperreports.data.cache.
con persistencia = false
Cuando se establece en falso, el predeterminado para todo el servidor de

informes es
No utilice instantneas de datos, sin embargo, todava estn disponibles si
un
informe anula este valor a true en su propia JRXML.
191
Debido a que la propiedad de nivel de informe tienen prioridad sobre la propiedad a nivel de servidor, lo que permite una
segunda manera de
instantneas de control:
Instantneas de datos estn habilitadas en el servidor.
Pero el defecto a nivel de servidor se establece en false, por lo que la mayora de los informes no se utilicen.
Si hay algunos informes que se benefician de instantneas de datos, esos informes se permiten explcitamente
instantneas en
su propio JRXML con:
net.sf.jasperreports.data.cache.persistable = true
9.5.3
Datos instantneas en el Programador

Las tareas planificadas siempre ejecutar el informe mediante el acceso a la fuente de datos, y por lo que tienen hasta-al minuto
de datos cuando
que generan la salida. Cuando instantneas de datos estn habilitados en los informes, el trabajo siempre actualiza la
instantnea de datos
con estos nuevos datos despus de que se ejecuta. De esta manera, cuando se programa un informe, tambin se actualiza la
instantnea de datos
Cuando
instantneas
depor
datos
estn
el servidor,
la interfaz
de programador
tiene una opcin adicional para los
peridicamente,
ya sea
hora,
da,habilitadas
semana, o en
lo que
se adapte
a sus necesidades
de datos.
datos de salida
instantnea. Al seleccionar esta opcin, tal como se muestra en la siguiente figura, genera una copia del informe con el nuevo
instantnea de datos. Esta copia se almacena en el repositorio como un JasperReport, idntico al informe que se est
ejecutando. Over
tiempo, esto crear un archivo de los datos del informe.
Si desactiva la opcin Formato de salida de datos de instantneas, ninguna copia del informe se guarda con la nueva instantnea
de datos,
pero la instantnea de datos en el informe original todava se actualiza cuando se ejecuta el trabajo. Adems, debe seleccionar al
menos un
otro formato de salida con el fin de programar el informe.
Opcin de salida Figura 9-6 La Data Snapshot en el Programador

Por ltimo, cuando las instantneas de datos estn habilitadas, tambin puede actualizar a travs de llamadas de servicios
web REST. Cuando
especificando el informe para funcionar con el servicio rest_v2 / reportExecutions, puede agregar argumentos explcitamente
actualizar o no actualizar la instantnea de datos asociada. Para obtener ms informacin, consulte la Web JasperReports
Servidor
Gua de Servicios.
9.6
Configuracin de registros del

sistema
En esta seccin se describen los ajustes que controlan la informacin JasperReports Server escribe en sus registros.
Los archivos de registro contienen informacin importante acerca de cmo se est ejecutando el servidor. Utiliza
JasperReports servidor del
Apache log4j paquete para generar archivos de registro. Jaspersoft utiliza la slf4j fachada para envolver log4j.
El archivo de registro predeterminado es WEB-INF \ logs \ jasperserver.log.
El archivo de configuracin de registro predeterminado es WEB-INF \

log4j.properties.
192
9.6.1
Gestin de Configuracin del

registro
Para establecer los niveles de registro actuales:
defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Configuracin del registro en el panel de la izquierda.
3. En el panel de Configuracin de registro que aparece, utilice los selectores desplegables para cambiar el nivel de registro
para cada clase
y estando conectado.
Configuracin del registro del sistema 9-7

Figura
La pgina se enumeran algunos de los registradores habilitados actualmente (los que normalmente necesitan que sus niveles de
registro ajustado de
vez en cuando) con su nivel de registro. Cualquier cambio en los niveles de registro entra en vigor inmediatamente, sin
reiniciar JasperReports Server.
Estos niveles de registro anulan los niveles del archivo log4j.properties. Desde la versin de servidor JasperReports
5.0, estos ajustes se mantendrn incluso si se reinicia el servidor. Por lo tanto los valores de la configuracin del registro
pgina que estn en vigor en el servidor puede ser diferente de la configuracin del archivo log4j.properties. Para obtener
ms informacin, consulte
"Ajustes de configuracin en la interfaz de usuario" en la pgina 172.
Los cuatro niveles de registro indican el tipo de evento que se registra por un registrador:
Ajuste
Nivel de Informacin
ERROR
Escribe una informacin mnima para el registro de la descripcin de las fallas de los
programas serios.
WARN
Escribe mensajes de error y de advertencia en el registro. Los mensajes de advertencia contienen

cautelar
informacin para ayudarle a decidir si los eventos registrados requieren su atencin.
193
Ajuste
Nivel de Informacin
INFO
Escribe error, de aviso e informativos en el registro. Mensajes informativos describen

acontecimientos importantes, como los que afectan al rendimiento de la aplicacin.
DEBUG
Escribe error, advertencia, informativos y mensajes adicionales en el registro. Los mensajes de depuracin son
muy detallado y, a menudo voluminosos. Utilice este ajuste slo para diagnosticar un problema. DEBUG puede
el rendimiento del sistema de impacto y no debe utilizarse en entornos de produccin. Si varios
madereros se establecen en DEBUG, el servidor puede generar enormes troncos, y el rendimiento puede verse
afectado.
Ajuste predeterminado registrador raz de JasperReports Server es ERROR, como se ha configurado en log4j.properties. Un
maderero que
no tiene un valor asignado hereda la configuracin de su padre en log4j.properties.
La siguiente tabla muestra el nombre de cada registrador tal como aparece en la pgina Configuracin de registro, el
identificador que se utilizar para encontrar un
especial de registro en el archivo de registro, as como una descripcin del registrador.
Logger Nombre
Identificador Conectarse
Descripcin
Ejecutor de consultas SQLJRJdbcQueryExe cuter
Registros de texto y valores de los parmetros de SQL para las

consultas que
son dirigidas por el ejecutor de consultas SQL.
Valor de control de entradavalueQueryLog

consultas
Texto y valores de parmetros de registros de SQL para las

consultas
asociado con los controles de entrada.
Entrada en cascada
parmetro de control
resolucin
Registros de actividad asociada con la entrada en cascada

controles. Controles de entrada de consulta impulsados pueden
conectar en cascada
cuando una consulta tiene un parmetro cuyo valor viene
de otro control de entrada. Cuando el valor del parmetro
se cambia, la consulta se vuelve a ejecutar automticamente,
posiblemente
cambiar la lista de valores para su control de entrada.
FilterCore
Entrada en cascada
TokenControlLogic
resultado de la consulta de
control
almacenamiento en cach
Registros de uso de la memoria cach de resultados de la entrada

en cascada
consultas de control.
Hibernate SQL
Registros de SQL que se ejecutan por la capa de Hibernate para

acceder a la
JasperReports servidor de base de datos del repositorio. Este
registrador genera un gran volumen de registro que
pueden afectar su rendimiento.
SQL
Ad Hoc poltica de datos CommonDomaintala

DataStrategy
SubFilterInputControlGenerador
Registros de las diferentes actividades de la poltica de datos Ad

Hoc
implementaciones, que utilizan las consultas SQL o en especie
operaciones de memoria para obtener conjuntos de datos para
visitas ad hoc.
Otros
SQL generado para
Consultas de dominio
194
JdbcBaseDataSet
Consultas SQL generadas a partir de los registros de consultas

utilizando un
Dominio.
Logger Nombre
Descripcin
Conexin
el manejo de
Dominios
DataSourceResolverImpl
Registros de uso de conexiones JDBC utilizados por Dominios a

ejecutar consultas SQL.
Expresin a JSON
convertidor
ExpressionJSON
Converter
Registra informacin acerca de la conversin entre

Domel y JSON, que es utilizado por los filtros de Ad Hoc.
Basado Domainpruebas de seguridad
SemanticLayerSecurityResolver
Impl
Registros de actividad relacionada con la Columna de dominio y

de fila
seguridad de nivel.
Entrada en cascada
resolucin de control
para dominios
DomainFilterResolver
Registra la misma actividad que el registrador FilterCore

(Cascading resolucin parmetro de control de entrada)
anterior, pero aade informacin especfica de dominio
consultas.
Ad Hoc cach
actividad
CachedData
Registra informacin acerca del ciclo de vida de los conjuntos de

datos que
se almacenan en cach en la memoria cuando visitas Ad Hoc son
visitada.
Momento para SQL

JsConconsultas ejecutadas por trolledJdbcQueryExecuter
informes
Registra el tiempo que tarda una consulta dirigida por la consulta

SQL
ejecutor para regresar los datos a un informe.
Ad hoc
WorkingDataSet
WorkingDataSet
Registros de actividad para el WorkingDataSet, utilizado por el Ad

Hoc Editor para realizar en memoria de datos
transformaciones de resultados de la consulta.
Contralora General
AdhocAjaxController
Registros de actividad del Editor Ad Hoc.
Controlador de tabla de
referencias cruzadas
AdhocCrosstabAjaxController
Registros de actividad adicional de la especfica ad hoc Editor

tabla de referencias cruzadas a los informes.
Cdigo Groovy
generacin de
conjuntos de datos de
memoria
GroovyGenerator
Registros clases Groovy generados a partir de Domel

expresiones utilizadas por el Editor Ad Hoc para los filtros y
campos calculados.
Ad Hoc AJAX
peticiones
adhocAjaxRequests
Registra la informacin acerca de AJAX solicitudes realizadas por

Ad
Editor Hoc y el Diseador de paneles, incluido el informe
parmetros y tiempos de respuesta. Activar este ajuste
cuando se quiere entender el Editor Ad Hoc y
Diseador de paneles o si usted ha encontrado un
error o tiempos de respuesta lentos.
195
Logger Nombre
Descripcin
Ad Hoc cach
actividad
com.jaspersoft.commons.
datarator.CachedData
Rastrea el ciclo de vida de los conjuntos de datos gestionada por el

Ad
Hoc cach mientras hacen la transicin entre estados. Este registro
salida incluye informacin de la Ad Hoc cach en
un formato que se presta a la solucin de problemas. Utilice esta
ajuste para entender cmo los tiempos de respuesta de consulta
contribuir a la capacidad de respuesta de rendimiento y
el Editor Ad Hoc. Debido a que no registra las consultas
s, lo utilizan en conjunto con el SQL Query
Ajuste de registro Executer.
Usted puede agregar otros registradores a la pgina Configuracin de registro si usted sabe sus
nombres de las clases.
Para agregar un registrador a la pgina desde la interfaz web:
defecto).
2. Seleccione Administrar> Configuracin del servidor y seleccione Configuracin del registro en el
3. panel de la izquierda.
Desplcese hasta la parte inferior de la pgina.
4. Ingrese nombre de clase de logger en el campo de texto. Ver otras propiedades en la pgina de la gua, para
ejemplo:
com.jaspersoft.ji.adhoc.action.AdhocCrosstabAjaxController
5.
Utilice la lista desplegable para establecer el nivel de

registro.
El ajuste del registrador es persistente, incluso cuando se reinicie el servidor. Sin embargo, el ajuste del registrador no puede
aparecer en
la pgina de Configuracin de registro de nuevo. Para obtener informacin sobre cmo agregar los madereros a esta pgina en
forma permanente, consulte "Adicin de un
Logger a la pgina Configuracin de registro "en la pgina 197.
9.6.2
Los archivos de registro de

configuracin
Puede editar el archivo de configuracin de registro para establecer leadores, niveles, y registrar la salida, pero debe
reiniciar el
servidor para que los cambios surtan efecto.
Sin embargo, si se han realizado modificaciones en la configuracin del registro de la interfaz de usuario, los ajustes son
persistentes en el repositorio,
son no escrito a los archivos de configuracin, y tienen prioridad sobre los archivos de configuracin. Sin embargo, cada
ajuste es independiente, por lo que un valor que no se haya modificado la interfaz de usuario Configuracin de registro se toma
de la correspondiente
presentar. Para obtener ms informacin, consulte "Ajustes de configuracin en la interfaz de usuario" en la pgina 172.
Nombres de registrador se definen en la fuente de Java. Los madereros pueden tener cualquier nombre, pero la convencin
Jaspersoft es
darles sus nombres de clase completos. En el archivo de propiedades de log4j, el nombre de clase debe estar precedida por
log4j.logger.
Por ejemplo, el nombre de clase org.acegisecurity.intercept est representado en el archivo de log4j.poperties como
log4j.logger.org.acegisecurity. intercepto. Si desea agregar un nuevo registrador, encontrar su nombre de clase en el
fuente.
Dependiendo de su si est configurando el registro del servidor o el registro durante la importacin y exportacin, editar un
archivo diferente.
196
Funcionalidad para iniciar

sesin
Ubicacin del archivo
Importar / Exportar
<Js-instalacin> \ buildomatic \ conf_source \ iePro
WEB-INF \ log4j.properties en la instalacin del servidor JasperReports
Si el registrador se define en el archivo de configuracin, pero est comentada, basta con quitar el carcter de comentario (#)
aadir el registrador. De lo contrario, agregar nombre de clase de logger y configurarlo para que el nivel de registro deseado.
La forma de una definicin registrador debe ser:
log4j.logger. <logger-classname> = <nivel Registro>, <tipo de salida>
donde:
<Logger-classname> es el nombre de la clase que desea supervisar.

<Log-level> es ERROR,WARN,INFO, O DEBUG
<Tipo de salida> es un tipo de salida estndar, tales como stdout. Por ejemplo:
log4j.logger.org.springframework.webflow = DEBUG, stdout, FileOut
Reinicie el servidor para que los cambios surtan efecto.
9.6.3
Adicin de un registrador a la pgina Configuracin de

registro
Si usted sabe de un registrador de log4j que utiliza JasperReports Server, puede agregarlo a la pgina Configuracin de
registro disponible
para el superusuario. Para agregar un registrador, editar un archivo de configuracin.
Debido a editar archivos de texto puede ser propenso a errores, Jaspersoft recomienda agregar los madereros de la web
interactuar introducindolos en el campo de texto en la pgina de Configuracin de registro. Slo editar el archivo de
configuracin si
necesitar agregar permanentemente el registrador.
Para editar la lista de registradores que se mostrarn en la pgina:

1. Editar el archivo logger_descriptions_pro.properties encontrado en WEB-INF / paquetes en su servidor JasperReports
instalacin.
2.
Aadir una nueva lnea y especificar nombre de clase de logger y una breve descripcin del
mismo.
Los trabajos deben ser en forma <Logger-classname> = <description>.
Ver otras propiedades en el archivo de la gua, por ejemplo:
controlador com.jaspersoft.ji.adhoc.action.AdhocCrosstabAjaxController = Matriz
3.
Reinicie el servidor para que los cambios surtan efecto.

El archivo logger_descriptions_pro.properties controla las etiquetas para la configuracin regional Ingls. Puede especificar
etiquetas para otras configuraciones regionales mediante la edicin del archivo de propiedades Descripcin logger para ese
idioma. Por ejemplo, para aadir
la etiqueta en francs, aada una entrada al archivo logger_descriptions_pro_fr.properties. Para obtener ms informacin
sobre
apoyo a otros idiomas, consulte "Localizacin" en la pgina 253.
9.7
Configuracin de servicios Web de Amazon

Si tiene acceso a los datos almacenados en Amazon Web Services (AWS) fuentes de datos, los siguientes parmetros
controlan cmo
JasperReports servidor interacta con su entorno de Amazon:
La pgina de configuracin de AWS permite cambiar la configuracin del grupo de seguridad sin necesidad de
reiniciar el servidor.
El archivo de configuracin AWS permite cambiar el controlador JDBC se utiliza con fuentes de datos de AWS.
Para obtener ms informacin acerca de las fuentes de datos de AWS, consulte "Fuentes de datos
de AWS" en la pgina 73.
197
Para cambiar la configuracin del Grupo de Seguridad de AWS:

defecto).
2. Haga clic en Administrar> Configuracin del
servidor.
El Configuracin del registro Aparecer la
pgina.
3. Haga clic en Configuracin de AWS en el men de la
izquierda.
Aparece el panel de configuracin de AWS:
Figura 9-8 Configuracin de AWS Pgina

4.
Modifique los siguientes ajustes:

Hemos creado un grupo de seguridad de AWS DB (mediante direccin IP) en cada zona RDS, por JasperReports
Instancia de servidor. El grupo de seguridad permite conexiones desde el servidor JasperReports especfica
y la instancia de base de datos de AWS especificado.
198
Activar Cambios Grupo de Seguridad AWS: Esta casilla de verificacin generalmente se deja marcada. Cuando se
activa la
JasperReports Server utilizar las credenciales de instancia que asuma el papel de IAM de reconocerse
acceso a los servicios de datos RDS y Redshift. Por ejemplo, usted deja la instancia EC2 con JasperReports
Servidor del viernes. Reinicia el lunes, y la instancia para crear una nueva direccin IP. JasperReports
Servidor luego re-subvenciones en s de acceso a RDS. Si desea administrar los grupos de seguridad de forma manual,
desempleo
marque esta casilla.
Seguridad Nombre del grupo: Cuando JasperReports Server crea grupos de seguridad para respaldar los datos de AWS
fuentes en este caso, se utilizar este nombre que la base del nombre del grupo de seguridad. Cuando el
Ejemplo JasperReports Server se ejecuta en EC2, se aadir el identificador de instancia EC2. Cuando se ejecuta
fuera de EC2, debe asegurarse de que el nombre es nico entre instancias JasperReports Server (es decir,
cada uno de ellos debe tener su propio nombre), de modo que las direcciones IP se conceden adecuadamente el acceso
a la
instancias de bases de datos apropiadas.
Grupo de Seguridad Descripcin: Este texto ser utilizado para el campo de descripcin junto al grupo de seguridad o
grupos en la consola AWS.
Security Group entrada IP Pblica: La mayora de los usuarios sobre EC2 deben dejar el campo en blanco.
JasperReports Server determina la direccin IP automticamente. Si est ejecutando JasperReports Servidor
fuera de EC2, entonces usted debe determinar su direccin IP e ingresarla en este campo. Es tambin
posible con topologa EC2 complejo que implica Nubes Privadas Virtuales (VPC) que usted necesita para
proporcionar su direccin IP manualmente.
Reprimir Credenciales EC2 Advertencia: Si la instancia de JasperReports Server se ha creado sin
Papel IAM, cuando vas al asistente de fuente de datos para agregar un origen de datos con credenciales EC2 habr
ser un mensaje de advertencia diciendo que no hay juego de rol apropiado. Al marcar esta casilla suprime la advertencia y
desactiva la opcin.
Haga clic en Cambiar despus de cada modificacin. Los cambios sern efectivos inmediatamente en el servidor.
5.
Para cambiar el controlador JDBC se utiliza con fuentes de datos de AWS:
1. Abra el archivo ... / WEB-INF / applicationContext-webapp.xml para su edicin.
2.
Busque el jdbcConnectionMapbean y la clave de su tipo de base de datos de AWS dentro de ella. Modificar esta tecla
para especificar un controlador JDBC diferente. Por ejemplo, el controlador predeterminado para bases de datos MySQL se
establece en el
MariaDB conductor:
<Clave de entrada = "mysql">

<Util: mapa>
...
<Clave de entrada = valor "JDBCURL" = "jdbc: mysql: // $ [dbhost]: $ [dbPort] / $ [dbName]" />
<Clave de entrada = valor "jdbcDriverClass" = "org.mariadb.jdbc.Driver" />
...
</ Util: mapa>
3.
9.8
Guarde el archivo y reinicie JasperReports Server.
Configuracin de los dominios

Para usos avanzados de Dominios, hay algunas configuraciones usted puede considerar:
Deshabilitar la validacin de dominios Comprobar

Optimizacin del copo de nieve de esquema se une
Configuracin del funcionamiento del Dominio de
Dependencia
Al utilizar dominios con ciertas construcciones de bases de datos especficas, puede que tenga que configurar
JasperReports
Servidor:
Habilitacin de Oracle sinnimos
Habilitacin campos CLOB
Habilitacin Tipos de propiedad
La extensin de JDBC de tipo Mapping
Acceso a vistas materializadas
199
9.8.1
Deshabilitar la validacin de dominios Comprobar

De forma predeterminada, JasperReports Server valida un Dominio en contra de su fuente de datos para asegurarse de que el
diseo de dominio
mapas adecuadamente a las tablas subyacentes. Esta validacin se produce cuando un archivo de diseo de dominio se carga
en el
servidor. Si el origen de datos es muy grande y compleja, esta validacin puede llevar mucho tiempo. Si la validacin
lleva demasiado tiempo, puede desactivarla. En este caso, JasperReports Server supone el diseo de dominio es vlida, y
simplemente lo sube sin el cheque. Usted puede desactivar la validacin mediante la edicin del archivo de configuracin
siguiente:
Configuracin de la validacin de dominios
Comprobar
... / WEB-INF / applicationContext-semanticLayer.xml
Propiedad
Frijol
Descripcin
skipDomainDatabase
Validacin
slConfig
De forma predeterminada, esta propiedad se establece en FALSE;

en este caso,
JasperReports Server valida los diseos de dominio
en contra de sus fuentes de datos. Pngalo en TRUE desactivar
esta comprobacin de validacin.
Si no existen las tablas y campos que se hace referencia en el diseo de dominio en el origen de datos cuando
skipDomainDatabaseValidation se establece en TRUE, el asistente de dominio no detectar el problema, pero
el asistente Elegir datos devuelve errores cuando los usuarios finales trabajan utilizar el dominio.
9.8.2
Optimizacin del copo de nieve de esquema se

une
Al crear un dominio en la parte superior de un esquema de copo de nieve, el defecto se une genera cuando se utiliza el dominio
en
el editor de Ad Hoc puede llevar mucho tiempo e incluye dimensiones que no se utilizan en el informe. Por ejemplo, una
esquema con ms de un centenar de tablas de medidas sobre todo conectado a un subconjunto de 10.5 tablas de hechos
puede causar tales
comportamiento. El siguiente procedimiento puede ser habilitado para optimizar las uniones generado por una base de datos
como copo de nieve
esquema. La configuracin por defecto tiene un mejor rendimiento en los casos ms comunes con menos mesas.
Configuracin de dominio nete Optimization
200
Propiedad
Frijol
Descripcin
specialOptimizationOn
grfico
Operaciones
El ajuste predeterminado de falsa maneja los casos tpicos

Dominios de 10-100 basado en tablas. Para copo de nieve
esquemas que normalmente tienen 100 o ms tablas, o
para topologas de base de datos que causan lenta unen
actuacin en vistas Ad Hoc, establece esta propiedad a
cierto para optimizar las uniones en el editor de Ad Hoc.
9.8.3
Configuracin del funcionamiento del Dominio de

Dependencia
Al modificar un dominio que ya est en uso por visitas Ad Hoc, cheques JasperReports Server para ver si alguno de
estas vistas dependientes se ven afectados. Por ejemplo, si una vista Ad Hoc utiliza un campo, no debera ser eliminado de
el dominio. Sin embargo, si ese campo no est en uso por cualquier vista dependiente, puede ser retirado del dominio,
y de la lista de campos en cada vista.
A los efectos de dependencia, un campo est "en uso" por una visin especial si ese campo aparece en el gestor de inicio (en
cualquier fila, columna o grupo), si se utiliza en cualquier filtro, o si se utiliza en cualquier frmula de campo calculado, si el
campo calculado est en uso o no.
Al modificar los campos de un dominio, JasperReports Server siempre comprueba todas las vistas que dependen del dominio
y siempre notifica al usuario de cualquier campo de uso. Hay dos ajustes para configurar la dependencia de Dominio
comportamiento despus de la verificacin:
defaultDomainDependentsBlockAndUpdate - Este ajuste activa o desactiva el comportamiento que asegura Ad
Vistas Hoc siguen siendo coherentes con sus dominios. Cuando est activado, se garantice la coherencia ya sea por
bloqueo
Cambios en el dominio que afectan a los campos en uso por cualquier dependencia, o mediante la actualizacin de las
dependencias cuando hay
hay campos en uso. Al actualizar una dependencia, que elimina el campo de la lista de campos disponibles (a la izquierda
panel de la mano en el editor de Ad Hoc). Cuando est apagado, que permite que los cambios de los Dominios que
causarn errores en cualquier
dependiente de la vista. Si un campo est en uso por una visin, y esta configuracin est apagado y permite que el dominio
que se suprima ese
campo, la vista har una excepcin cuando se abre. Si un campo no est en uso por un punto de vista, y este ajuste est
fuera, el campo no se elimina de la lista de campos disponibles. Si un campo eliminado aparece en la lista de disponibles
El
nico escenario
para
desactivar
este
ajuste
es cuando
se en
elimina
un campo
del origen
de datos, y la
campos,
la vista an
se pueden
abrir,
pero
cualquier
accin
ese campo
provocar
un error.
Dominio no puede ser modificado porque el campo est siendo utilizado por algunas dependencias. A continuacin,
deber
editar manualmente las dependencias de modo que no causen errores.
defaultAddToDomainDependents - Este ajuste determina si un campo que se aade a un dominio es
aadido automticamente a cada vista dependiente Ad Hoc. Cuando est activado, cualquier nuevo campo agregado a un
dominio se aade
a la lista de campos disponibles en cada vista dependiente. Cuando este ajuste o el ajuste permeable est apagado,
vistas dependientes no se actualizan con nuevos campos de dominio.
Volviendo Cheques dominio de dependencia Activar o
Desactivar
Propiedad
Frijol
Descripcin
defaultDomainDependents
BlockAndUpdate
configuracin
Frijol
El ajuste predeterminado de cierto significa que dominio

modificacin se bloquear si cualquier vista Ad Hoc
utiliza los campos modificados. Si no hay Ad Hoc usos vista
los campos modificados, la modificacin de Dominio
ingresos, y todos los puntos de vista del Anuncio Especial se
actualizan con
el cambio.
Cuando se establece en falso, Modificaciones de dominio no son
ser bloqueados cuando el campo est en uso, y
vistas dependientes no se actualizan cuando los campos estn
no est en uso. Cualquier vista Ad Hoc puede llegar a ser
inutilizable si se hace referencia a un campo que se elimina de
un dominio, mientras que este ajuste es falsa.
201
Configuracin Adiciones dominio de dependencia

Propiedad
Frijol
Descripcin
por defecto
AddToDomainDependents
configuracin
Frijol
Cuando defaultDomainDependents
BlockAndUpdate est ajustado a cierto Y este ajuste
es cierto (Por defecto), cualquier campo que se aade a una
Dominio se agrega a cada vista dependiente Ad Hoc.
Puede que no sea posible agregar un campo a un Grupo
Especial
vista si el campo est agregando no pertenece a
la isla de datos que se utiliza en la vista Ad Hoc.
Cuando defaultDomainDependents
BlockAndUpdate est ajustado a falsa O este ajuste es
falso, vistas dependientes Ad Hoc no se actualizan
con los campos que se agregan a un dominio. El nuevo
campos no estarn disponibles cuando un usuario abre un
vista ad hoc dependiente.
9.8.4

De forma predeterminada, los dominios no puede acceder a sinnimos en una base de datos Oracle. Establezca la siguiente
propiedad para habilitarlos.
Si accede a la base de datos de Oracle a travs de JNDI, tambin es necesario para configurar la conexin JNDI.
Tenga en cuenta que el servicio de metadatos de Oracle funciona mucho ms lento cuando son sinnimos en su
alcance.
Propiedad
Frijol
Descripcin
includeSynonyms
ForOracle
jdbcMeta
Configuracin
Establezca el valor en true:
... \ META-INF \ context.xml
202
<Valor> true </ value>

Propiedad
Frijol
Descripcin
accessToUnderlying
ConnectionAllowed
<ResourceName =
"Jdbc / oracle" ...
Si utiliza JNDI, aada el siguiente

Inmueble:
accessToUnderlying
ConnectionAllowed = "true"
9.8.5
Habilitacin campos CLOB

Apoyo a CLOB campos (Character Large Object) depende de su base de datos y se debe habilitar manualmente.
Si desea acceder a los campos CLOB en JasperReports Server, debe configurar las siguientes opciones de acuerdo a
su base de datos.
Utiliza la implementacin del controlador JDBC de Oracle la CLOB Tipo JDBC para los campos
CLOB.
Apoyo CLOB para Oracle
Propiedad
Frijol
Descripcin
jdbc2JavaType
Mapping
jdbcMeta
Configuracin
Esta propiedad contiene un mapa de campo de base de datos

tipos a tipos Java. Busque la lnea de CLOB es
comentado:
<-! Clave de entrada = valor "CLOB" = "" / ->
Modificarlo de la siguiente
manera:
<Clave de entrada = "CLOB" value = "java.lang.String" />
Utiliza la implementacin del controlador JDBC de MySQL, ya sea la CLOB Tipo de JDBC, la LONGVARBINARY Tipo JDBC, o
tanto para representar campos CLOB, dependiendo de su longitud.
Apoyo CLOB para MySQL

203
Apoyo CLOB para MySQL

Propiedad
Frijol
Descripcin
jdbc2JavaType
Mapping
jdbcMeta
Configuracin
Esta propiedad contiene un mapa de tipos de campo de base de

datos
a tipos Java. Encuentra las siguientes lneas:
<-! Clave de entrada = valor "CLOB" = "" / ->
<-! Clave de entrada = valor "LONGVARBINARY" = "" / ->
Y modificar de la siguiente manera:

<Clave de entrada = "CLOB" value = "java.lang.String" />
<Clave de entrada = "LONGVARBINARY"
value = "java.lang.String" />
9.8.6
Habilitacin Tipos de propiedad

JasperReports Server proporciona una correlacin de tipos JDBC a Java para todos los tipos estndar de columna JDBC
para su uso en
Dominios. Sin embargo, algunas bases de datos tienen los tipos de propiedad, como NVARCHAR2 en Oracle. Puede
asignar
estos
con una
configuracin
especial. debe ser lgicamente equivalente a una de las clases de Java
Comotipos
requisito
previo,
el tipo de propiedad
siguientes:
java.lang.Boolean
java.lang.Float
java.lang.String
java.sql.Timestamp
java.lang.Byte
java.lang.Integer
java.math.BigDecimal
java.util.Date
java.lang.Character
java.lang.Long
java.sql.Date
java.lang.Double
java.lang.Short
java.sql.Time
Hay dos maneras de crear una asignacin para un tipo de propiedad, como se muestra en la siguiente tabla:
Modificar la asignacin genrica para tipos numricos. De forma predeterminada, cualquier tipo numrico que no coincide
con uno de
los otros tipos se asignan a BigDecimal.
Crear una correlacin de secundaria en la otra llave especial, donde la clave secundaria puede ser su costumbre
escriba el nombre.
Propietario Database Type Mapping
204
Propietario Database Type Mapping

Propiedades
Frijol
Descripcin
jdbc2Java
TypeMapping
jdbcMeta
Configuracin
Para modificar la asignacin genrica, editar esta lnea:
<Clave de entrada = "NUMERIC" value = "java.math.BigDecimal" />
Aadir cualquier tecla secundaria a la otra clave, siguiendo este

ejemplo:
<Clave de entrada = "OTRO">

<Mapa>
<Clave de entrada = valor "NVARCHAR2" = "java.lang.String" />
</ Map>
</ Entry>
Java 1.6 soporta java.sql.Types.NVARCHAR, por lo tanto,

debe agregarlo como una asignacin genrica, no bajo OTROS:
<Clave de entrada = valor "NVARCHAR" = "java.lang.String" />
9.8.7

Algunos tipos de bases de datos no estn an asignan a un tipo JDBC. En particular, Oracle utiliza el TIMESTAMP CON
TIME ZONE y TIMESTAMP WITH TIME ZONE LOCAL que debe ser asignado con el fin de aparecer en
JasperReports Server. Si hay otros tipos en su base de datos, usted podr modificar o ampliar el tipo JDBC
mapeo con la siguiente configuracin:

Propiedad
Frijol
Descripcin
codeToJdbcType
Mapping
jdbcMeta
Configuracin
Esta propiedad contiene un mapa de tipo de base de datos

cdigos a tipos JDBC. Por defecto, los cdigos de
Tipos TIMESTAMP Oracle se asignan:
<Clave de entrada = "- 101" value = "TIMESTAMP" />
<Clave de entrada = "- 102" value = "TIMESTAMP" />
Agregar o reemplazar estas entradas para mapear adicional

tipos de base de datos.
9.8.8

Dominios acceso tablas y vistas por omisin, pero algunas bases de datos compatibles con otras estructuras como
materializado
vistas. Estas estructuras de tabla suplentes no aparecen por defecto, pero a menudo se pueden configurar para Dominios
mostrar y acceder a ellos.
205
Si el controlador JDBC para la base de datos asigna un identificador de tipo de tabla estndar a la vista materializada, puede
acceder a l en Dominios, Ad Hoc vistas e informes. Para saber el tipo de tabla, utilice un cliente JDBC, como el SQuirreL
herramienta para ver el esquema de base de datos. En SQuirreL, utilice la ficha "Objetos" para buscar las tablas y vistas
organizadas
por tipo de tabla. Busque su vista materializada y tenga en cuenta que es tipo de tabla.
Los valores de tipo de tabla se definen en el DatabaseMetaData.html.getTables () documentacin. Cuando usted sabe
la cadena correspondiente a su tipo de tabla, agregue el valor siguiente configuracin:

Propiedad
Frijol
Descripcin
tableTypes
jdbcMeta
Configuracin
Elimine el comentario de el tipo de tabla JDBC correspondiente

a la vista materializada u otra estructura de la tabla en
sus bases de datos, por ejemplo:
<Valor> LOCAL TEMPORAL </ value>
9.9
Configuracin de JasperReports Biblioteca

Caractersticas de informes de JasperReports Server se basa en la biblioteca JasperReports, que est incrustado en el servidor.
Muchas de las opciones que puede configurar para cambiar la funcionalidad del servidor son en realidad JasperReports
Biblioteca
opciones. Las opciones de configuracin pueden controlar muchos aspectos de la conducta del servidor, desde la forma en que
los informes son
exportados en diferentes formatos de archivo, a la fuente predeterminada para su uso.
Estas opciones se pueden ajustar a diferentes niveles de granularidad: Global (se aplica a todos los informes generados por el
servidor),
Informe (definido en el JRXML y se aplica a un informe especfico), y Element (definido en el JRXML y aplica
a elementos especficos del informe). Propiedades globales se definen en el ... / WEBINF file / classes / jasperreports.properties.
Para obtener ms informacin sobre la configuracin JasperReports Library,
consulte
http://jasperreports.sourceforge.net/config.reference.html.
Las siguientes secciones destacan algunas de las opciones disponibles:
9.9.1
Extendiendo JasperReports Biblioteca

Cambiar el lmite de referencias cruzadas
El establecimiento de un Chart Tema Global
Desactivacin de interactividad en el Visor de informes
Habilitacin de las XHTML o HTML Exportadores
Activacin de Flash o HTML5 para Pro Charts
Configuracin de un motor de JavaScript para la grfica de representacin de
informes
Extendiendo JasperReports Biblioteca

Puede extendJasperReports Biblioteca mediante la implementacin de las interfaces pblicas que
expone.
206
Tal implementacin normalmente se almacena en un archivo JAR (Java Archive) que contiene un archivo llamado jasperreports_
extension.properties, especifica una clase de fbrica. La clase especificada utiliza para crear instancias de un registro de
extensin. El
registro de extensin especifica uno o ms objetos de extensin, cada una de las cuales corresponde a una biblioteca
JasperReports
punto de extensin representada por una interfaz Java.
Coloque esta JAR en la classpath JasperReports Library, y su extensin est disponible automticamente.
Para obtener ms informacin, consulte JasperReports ltima gua Biblioteca.
9.9.2
Cambiar el lmite de referencias

cruzadas
Si utiliza informes de referencias cruzadas, puede experimentar errores de memoria insuficiente si los informes son muy
grandes o complejas.
Puede configurar JasperReports Server para devolver un mensaje en lugar de errores de memoria cuando los usuarios ejecutan
tales
tablas de referencias cruzadas. Para ello, active la net.sf.jasperreports.crosstab.bucket.measure.limit la propiedad y el conjunto
su valor mximo. Para ello, edite el archivo de configuracin siguiente:
Opcin informe de tabla cruzada de configuracin
Propiedad
Descripcin
net.sf.jasperreports.
crosstab.bucket.
measure.limit
Este valor representa el nmero mximo de clulas multiplicado por

el nmero de medidas en la tabla de referencias cruzadas. El valor por defecto es
100000.
Introduzca valores grandes para permitir a sus usuarios crear ms grande,
ms
crosstabs complicados; introducir valores pequeos para restringir ellos.
Si usted experimenta OutOfMemoryExceptions despus de cambiar esta
valor, pruebe a ajustarla a un nmero menor, o configurar la JVM para
permitir ms memoria que se utilizar.
9.9.3
El establecimiento de un Chart Tema

Global
Temas Grfico de controlar el aspecto y el tacto de los grficos generados por JasperReports Server. Grfico de temas
pueden ser
aplicada en el nivel de el servidor o el informe individual:
Para aplicar un tema a nivel del informe, seleccinelo en el diseo del informe en Jaspersoft iReport Designer.
Tenga en cuenta que tambin se puede aplicar un tema a elementos de grfico individuales, tambin. Tenga en cuenta que
un tema grfico puede ser
incluido en una unidad de informe como un recurso; en este caso, el tema slo est disponible para grficos en esa unidad
de informe.
Para aplicar un tema a nivel de servidor, copie la tabla JAR tema a la ubicacin correcta y editar su
archivo de configuracin.
Un tema grfico es un archivo JAR que define la apariencia de un grfico. Una vez que haya creado la tabla JAR tema
archivo, copiarlo en el directorio WEB-INF \ lib. Grfico de temas en esta ubicacin estn disponibles para cualquier tipo de
grfico en el
instancia del servidor; tambin pueden establecerse como el tema grfico global.
Para establecer un tema como el tema grfico predeterminado, edite el archivo de
configuracin siguiente:
207
Global Informe sobre el Tema

Propiedad
Descripcin
chart.ChartTheme
El nombre de un tema grfico que se encuentra en la ... / WEB-INF /

lib
directorio.
Jaspersoft recomienda crear sus temas grfico en Jaspersoft iReport Designer. Haga clic en Archivo> Nuevo> Grfico
Temtica, a continuacin, utilizar Jaspersoft iReport Designer para archivar el nuevo tema grfico como un JAR.
Grfico de temas no se aplican a Ad Hoc vistas de cartas.
9.9.4
Desactivacin de interactividad en el Visor de informes

S por defecto, la interactividad del informe del visor est activado: informes con elementos interactivos (como la mesa
componente) son interactivos cuando se ejecutan en el servidor web y se muestran en el visor. Si usted no quiere
sus informes a ser interactiva, puede desactivar la interactividad a travs de todo el servidor mediante la edicin de una
configuracin
presentar.
Interactividad en el Visor de informes
Propiedad
Descripcin
components.table.interactive
De forma predeterminada, esta propiedad se establece en verdadera; en

este caso,
interactividad est activada en el visor de informes. Pngalo en falsa
desactivar la interactividad.
Al cambiar esta configuracin en este archivo de configuracin cambia el comportamiento de todo el servidor. Tambin
puede
configurar este comportamiento en el informe, tabla o nivel de columna al superar propiedades JRXML del informe.
9.9.5
Habilitacin de las XHTML o HTML Exportadores

De forma predeterminada, JasperReports servidor exporta en formato HTML con un exportador basado en HTML. A diferencia
de la opcin predeterminada
los exportadores de las versiones anteriores del servidor ( HTML y xhtml), El nuevo exportador HTML (html2) Es ms
informes al exportar perdonar que tienen elementos superpuestos tiempo que evita que el texto se desconecte
debido a problemas de medidas de fuente.
Esta configuracin afecta a todos los casos cuando se exporta HTML, incluyendo cuando los informes se exportan desde
el informe
espectador y cuando estn programados para producir una salida HTML.
208
Para utilizar un exportador HTML mayores en JasperReports Server, edite el archivo de configuracin
siguiente:
Exportadores HTML
Propiedad
Descripcin
com.jaspersoft.jasperreports.
export.html.type
Determina cul de los exportadores HTML se utiliza. Vlido

valores son:
html2 es el exportador HTML predeterminado. Maneja

elementos de informe superpuestos con ms gracia que la
otros exportadores.
xhtml era el exportador HTML por defecto en las versiones de

4,5 de 5,0. Jaspersoft contina apoyando este exportador.
Se ocupa de los elementos del informe se superponen con ms gracia
que el HTML exportador. Sin embargo, est sujeta a la fuente
desajustes mtricas entre los exploradores del cliente, que puede
resultado en texto que se cort.
HTML era el exportador HTML por defecto en las versiones de

JasperReports Server anterior a la 4.2. Jaspersoft contina
para apoyar este exportador. No maneja la superposicin
elementos con tanta gracia como los dems exportadores.
Tenga en cuenta que las propiedades son mutuamente excluyentes; slo puedes tener uno sin comentarios a la
vez.
A partir de JasperReports Server versin 5.5, si sus informes incluyen elementos interactivos como la tabla
componente (que apoya a ordenar y filtrar en el visor de HTML), debe utilizar el html2 exportador en
fin de que las caractersticas interactivas; la HTML y xhtml exportadores no los apoyan.
9.9.6
Activacin de Flash o HTML5 para Pro Charts

De forma predeterminada, JasperReports servidor hace Charts Pro (los basados en Fusion Charts) utilizando Adobe Flash. Si
Flash
no se encuentra en el entorno de cliente, el servidor hace que el grfico utilizando HTML5, en su lugar. Por ejemplo, Pro
Grficos que aparecen en los dispositivos que ejecutan iOS de Apple el sistema operativo se representa utilizando HTML5, ya
que Flash
no est disponible. Tenga en cuenta que no todos los navegadores soportan HTML5.
Tenga en cuenta que Pro Charts slo estn disponibles en la edicin profesional de JasperReports
Server.
Puede configurar el servidor por defecto a HTML5 al visualizarse Pro Charts. En este caso, si su navegador
no es compatible con HTML5, el grfico no se rindi.
Rendir Pro Listas usando HTML5, edite el archivo de configuracin siguiente:
209
Pro Grficos Procesador

Propiedad
Descripcin
fusion.charts.render.type
Determina cul de los siguientes procesadores es

utilizado:
Flash es el procesador predeterminado para Pro Charts.

Si Flash no est disponible, el servidor intenta
hacer que el grfico en HTML5.
html5 es el ms nuevo procesador para Pro Charts.

salo si no puede ser compatible con Flash.
Tenga en cuenta que esta propiedad slo se aplica a los informes que se basan en Pro Grficos y slo afecta a la vista previa
HTML y
exportacin.
Normalmente, esta propiedad se establece en el nivel de servidor; para anular la configuracin de nivel de servidor para un
Chart Pro especfica
informe, debe establecer esta propiedad en el nivel de informe, y tambin especificar una segunda propiedad como se
muestra:
net.sf.jasperreports.print.transfer.fusion = com.jaspersoft.jasperreports.fusion
Esto permite que el motor de informes (JasperReports Library) para reconocer la configuracin de fusin. Si esta propiedad no
es
establecido, la com.jaspersoft.jasperreports.fusion.charts.render.type propiedad se omite en el informe
nivel.
9.9.7
Configuracin de un motor de JavaScript para la grfica de representacin de

informes
Dependiendo de las circunstancias, un elemento grfico determinado (por ejemplo, un grfico, un mapa, o un widget) en un
informe puede
ser dictada en dos formas:
Cuando se ejecuta directamente en la interfaz de usuario web, el navegador en s hace que el grfico.
Cuando est programado para ejecutarse fuera de plazo o ejecuta en segundo plano, un motor interno hace que
el grfico.
Por defecto, el motor de JavaScript interno de JasperReports Server es Rhino, que es una excelente solucin para la mayora
casos; la mayora de los usuarios de JasperReports Server pueden aceptar este valor predeterminado. Sin embargo, bajo
ciertas circunstancias, es posible que
que desee utilizar un motor diferente. Investigar el uso de un motor diferente si se encuentra con alguno de los siguientes
cuando
ejecutar
basados
en la tabla
fondo o
cuando
estngrandes
programados:
Bajoinformes
rendimiento
al generar
tablaseno el
grficos
que
contienen
volmenes de datos complejos.
Fuera de mensajes de memoria.
Escala incorrecta cuando se imprimen ciertos informes Pro Grfico.
Los resultados que no coinciden con los que se generan cuando el informe se ejecuta directamente en la interfaz de
usuario web. Por ejemplo, el texto
elementos pueden ser incorrectamente dimensionados o colocados.
En tales casos, Jaspersoft recomienda utilizar PhantomJS como el motor para ejecutar JavaScript cuando
la generacin de informes grficos que se ejecutan en segundo plano o se programan. PhantomJS es un WebKit sin cabeza
con API JavaScript. Para utilizar PhantomJS, debe descargar e instalar la versin correcta para su
medio ambiente. Descargar PhantomJS e instalarlo en el equipo que hospeda JasperReports Server. A un alto nivel,
instalar PhantomJS incluye la ampliacin de un archivo. Para obtener instrucciones de instalacin, consulte la documentacin
proporcionado con PhantomJS.
210
Una vez PhantomJS est instalado, debe apuntar JasperReports Server para su ubicacin. Puede configurar varios
opciones independientemente: Highcharts generacin, Pro generacin Grficas, Pro generacin de widgets y Pro Mapas
generacin.
Estos son los ajustes a nivel de servidor. En un servidor determinado, todas las cartas del mismo tipo (Highcharts o
Fusin
(Charts Pro, Mapas Pro, o Aplicaciones Pro)) debe utilizar el mismo motor de JavaScript.
No se puede utilizar para hacer PhantomJS JFreeCharts. Tales informes se generan siempre por Rhino cuando
ejecutarse en segundo plano o programada.
Para configurar JasperReports Server para utilizar PhantomJS para Highcharts, editar las siguientes propiedades:
Configuracin del motor de JavaScript para Highcharts
Propiedad
Descripcin
highcharts.phantomjs.
executable.path
Esta propiedad apunta a que el motor debe utilizar el servidor de

generar grficos Highcharts basada en los informes que se ejecutan en el
fondo o se han programado.
Por ejemplo, si est usando Windows y se expanda la
PhantomJS archivo 1.8.1 ZIP en la raz de la unidad C::
com.jaspersoft.jasperreports.highcharts.
phantomjs.executable.path = C: \\ phantomjs-1.8.1phantomjs.exe ventanas \\
tempdir.path
El directorio temporal donde PhantomJS almacena su salida. Por

De forma predeterminada, JasperReports Server espera esta salida en la
ubicacin
definido por Java java.io.tmpdir propiedad del sistema.
executable.timeout
El nmero mximo de milisegundos de espera para la salida desde

PhantomJS. Despus de ese tiempo, los tiempos de trazar. El
por defecto es 3000.
Para configurar JasperReports Server para utilizar PhantomJS para Charts Pro (Fusion), editar las siguientes
propiedades:
Configuracin del motor de JavaScript para Pro Grficos (Fusion)
211
Configuracin del motor de JavaScript para Pro Grficos (Fusion)

Propiedad
Descripcin
fusion.phantomjs.
executable.path
Esta propiedad apunta a que el motor debe utilizar el servidor de

generar Charts Pro (basado en la fusin) en los informes que se ejecutan en
el fondo o se han programado.
Por ejemplo, si est usando Windows y se expanda la
PhantomJS archivo 1.8.1 ZIP en la raz de la unidad C::
com.jaspersoft.jasperreports.fusion.
phantomjs.executable.path = C: \\ phantomjs-1.8.1phantomjs.exe ventanas \\
fusion.phantomjs.
tempdir.path
El directorio temporal donde PhantomJS almacena su salida. Por

De forma predeterminada, JasperReports Server espera esta salida en la
ubicacin
definido por Java java.io.tmpdir propiedad del sistema.
fusion.phantomjs.
executable.timeout
El nmero mximo de milisegundos de espera para la salida desde

PhantomJS. Despus de ese tiempo, los tiempos de trazar. El
por defecto es 3000.
Por defecto, cuando los informes basados en la fusin se ven en la interfaz web, que se generan como elementos de Flash.
Puede configurar la interfaz de usuario web para generar sus informes usando HTML5 en lugar. Para obtener ms
informacin, consulte "Habilitacin
Flash o HTML5 para Pro Listas "en la pgina 209.
9.10 Configuracin del funcionamiento del control de

entradaAl definir los controles de entrada de texto, el comportamiento por defecto del servidor permite cadenas vacas, incluso si ha
configurado
una expresin regular y se controla la entrada obligatoria. Utilice este ajuste para hacer cumplir la expresin regular
incluso en cadenas vacas, lo que obliga al usuario que proporcione un valor conforme para el control de entrada.
Del funcionamiento del control de
entrada
... / WEB-INF / applicationContext-cascade.xml
Frijol
Descripcin
applyRegexpToEmptyString
El valor por defecto de falsa da el comportamiento tradicional: incluso si un

expresin regular se define, no se aplica a cadenas vacas.
Si usted quiere hacer cumplir estrictamente la expresin regular, incluso en
cadenas de entrada vacas, establezca esta propiedad en verdadera.
212
9.11 Configuracin del Programador

Los informes ejecuta la programacin en el fondo de acuerdo con un cronograma definido por el usuario (tambin llamado un
trabajo). Usted puede
configurar los siguientes aspectos del planificador:
Configuracin de la directiva de fallo de encendido
Scheduler
Configuracin del Programador notificaciones de error
La restriccin de salida del sistema de archivos
Extraccin Opciones Notificar Programacin de intervalo

Adicin de un Holiday Exclusin Calendario
9.11.1
Configuracin de la directiva de fallo de encendido

Scheduler
Un fallo de encendido del programador se produce cuando el programador no puede ejecutar un informe a la hora designada,
por ejemplo, porque
JasperReports Server es fuera de lnea, su base de datos est en lnea, o el nmero de hilos es limitado. En este caso, usted
puede
configurar
el comportamiento
planificador
para reintentar
el para
informe
o saltarse
esta ejecucin
programada.
Puede establecer
una poltica del
de fallo
de encendido
diferentes
cada
tipo de horario
de trabajo:
solo trabajo, trabajo de
repetir, y trabajo calendario.
Polticas de falla de encendido se definen en la documentacin Scheduler cuarzo y otros recursos en lnea:
http://quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-leccin-05
http://quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-leccin-06
http://nurkiewicz.blogspot.com/2012/04/quartz-planificador-fallo de encendido-instructions.html
Configuracin Scheduler Poltica fallo de encendido

... / WEB-INF / js.quartz.properties
Propiedad
Descripcin
report.quartz.misfirepolicy.
singlesimplejob
Establece la poltica de fallo de encendido para los trabajos individuales a

una de las siguientes:
SMART_POLICY
MISFIRE_INSTRUCTION_FIRE_NOW
MISFIRE_INSTRUCTION_IGNORE_MISFIRE_POLICY
213
Configuracin Scheduler Poltica fallo de encendido

repeatingsimplejob
Establece la poltica de fallo de encendido para repetir trabajos a una de las

siguientes
valores:
SMART_POLICY
calendarjob
9.11.2
MISFIRE_INSTRUCTION_FIRE_NOW
MISFIRE_INSTRUCTION_RESCHEDULE_NEXT_WITH_
EXISTING_COUNT
MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_
EXISTING_REPEAT_COUNT
MISFIRE_INSTRUCTION_RESCHEDULE_NOW_WITH_
REMAINING_REPEAT_COUNT
Establece la poltica de fallo de encendido para los trabajos con recursividad

calendario para una de
los siguientes valores:
SMART_POLICY
MISFIRE_INSTRUCTION_FIRE_ONCE_NOW
MISFIRE_INSTRUCTION_DO_NOTHING

Por defecto, si un informe programado se ejecuta, pero se produce un error, el programador enva un correo electrnico al
propietario horario
y para todos los administradores de JasperReports Server en la misma organizacin. Esto es adems de cualquier falla
direcciones de notificacin especificados en el Notificaciones ficha del asistente programador. Para recibir estos
las alertas de error del programador, los administradores deben tener un correo electrnico vlido definido en sus cuentas de
usuario.
Tambin puede configurar el programador para enviar notificaciones de error a diferentes usuarios en funcin de los roles, o
apague
notificaciones de error.
... / WEB-INF / applicationContext-report-scheduling.xml
214
Llave de la entrada
Frijol
Descripcin
administrador
Papel
cuarzo
Programador
Este ajuste determina la funcin a la que el fracaso planificador

se enviarn las notificaciones. Todos los usuarios de la organizacin con este
papel y una direccin vlida de correo electrnico se define en su perfil de
usuario
recibir la notificacin por correo electrnico. Por defecto, este ajuste es
ROLE_
ADMINISTRADOR.
9.11.3
disableSending
AlertToAdmin
cuarzo
Programador
Determina si las notificaciones de error se envan a la funcin en la

la configuracin anterior. Por defecto, este ajuste es falso, significando
que las notificaciones se envan. Establezca este valor en cierto desactivar
notificaciones de error de programador que se envan a los administradores (o
el papel se ha definido anteriormente).
disableSending
AlertToOwner
cuarzo
Programador
Determina si las notificaciones de error se envan a la schedpropietario ule. Por defecto, este ajuste es falso, lo que significa que
notificacin
caciones se envan. Establezca este valor en cierto desactivar planificador
notificaciones de error que se envan al propietario horario.
La restriccin de salida del sistema de

archivos
Las salidas del planificador de informes a travs de varios canales. La mayora de los informes se envan por correo electrnico,
pero los informes tambin se pueden escribir
a FTP carpetas. Tambin puede configurar el programador para escribir informes al sistema de archivos local del servidor. Esta
opcin
est desactivado por defecto por razones de seguridad.
Si activa la salida del sistema de archivos del planificador, asegurarse de que los derechos de acceso de usuario y carpetas
que haya configurado
para asegurarse de que los archivos maliciosos no se pueden escribir en el sistema de archivos. El proceso que escribe los
archivos es
el mismo usuario que ejecuta el servidor de aplicaciones que aloja JasperReports Server.
Output File System Scheduler
Propiedades para actualizar
Descripcin
enableSaveToHostFS
Establezca el valor de "False" (El predeterminado) a "True".

Cuando es verdadero, la interfaz de usuario para el planificador mostrar campos
activos
que permiten que el creador calendario para especificar una carpeta en el archivo del
servidor
sistema. El programador escribir archivos a este lugar cada vez que se ejecuta
el calendario para el presente informe.
Esta propiedad tambin determina el acceso general del planificador para el archivo
sistema. Cuando es verdadero, cualquier horario configurado con una carpeta de
sistema de archivos
se escribir en el sistema de archivos. Cuando es false, no hay informes programados
escribirn
salida para el sistema de archivos (FTP y correo electrnico de salida no se ven
afectados).
Sin embargo, cualquier salida del sistema de archivos se especifica en un horario sigue
siendo
definida y otra vez activar la salida del sistema de archivos cuando esta propiedad es
verdadero de nuevo.
215
9.11.4
Extraccin Opciones Notificar Programacin de intervalo

Cuando los usuarios programan informes, pueden especificar que el informe ejecuta peridicamente a intervalos regulares.
Para sencilla
recidiva, el intervalo predeterminado se puede expresar en das, horas o minutos. Si es necesario evitar que los usuarios
de la programacin de informes frecuentes, puede limitar los intervalos de das o de horas editando el siguiente
fichero de configuracin:
Programacin de opciones de intervalo
... / WEB-INF / fluye / reportJobBeans.xml
Seccin actualizar
Descripcin
recurrenceIntervalUnits
Comente los intervalos que desea desactivar.
Para eliminar un intervalo temporal, incluya el frijol correspondiente en caracteres de comentario. Por ejemplo, para mantener
los usuarios de la programacin de informes en intervalos de un minuto, comentan que el frijol que contiene el
INTERVAL_MINUTE
campo:
<! <Clase bean = "com.jaspersoft.jasperserver.war.dto.ByteEnum">
<Property name = "code">
<Util: constante esttica-field = "com.jaspersoft.jasperserver.api.engine.scheduling.
domain.ReportJobSimpleTrigger.INTERVAL_MINUTE "/>
</ Propiedad>
<Property name = "labelMessage">
<Valor> job.interval.unit.minute.label </ value>
</ Propiedad>
</ Bean>
->
9.11.5
Adicin de un Holiday Exclusin Calendario

El calendario de exclusin apoyo planificador que especifique das o tiempos cuando se debe ejecutar ningn informe, incluso
si el
horario se activa entonces. Por ejemplo, puede que no desee un informe para ejecutarse en un da festivo cuando la
datos financieros no tendran sentido.
El planificador mantiene una lista de calendarios con nombre, y la interfaz de usuario permite al creador calendario para
seleccionar un
calendario cuyas fechas sern excluidos de la programacin.
Actualmente, el nico mtodo para definir un calendario de vacaciones es a travs de la API REST. Se puede utilizar
cualquier navegador
plug-in que acta como un cliente REST y pueden enviar peticiones PUT a JasperReports Server. El uso de un plug-in de
este tipo,
redactar y enviar la solicitud REST siguiente (cabecera y cuerpo) a su servidor:
PONER http: // <host>: <puerto> / JasperServer [-pro] / rest_v2 / trabajos / Calendarios / 2014FrenchHolidays
Content-Type: application / xml
216
<? Xml version = "1.0" encoding = standalone "UTF-8" = "s"?>

<ReportJobCalendar>
<CalendarType> vacaciones </ calendarType>
<Description> 2014 Holidays franceses </ description>
<ExcludeDays>
<ExcludeDay> 01/01/2014 </ excludeDay>
</ ExcludeDays>
<Zona horaria> GMT + 01: 00 </ Zona horaria>
</ ReportJobCalendar>
Por ejemplo, utilizando el Cartel plug-in para Firefox, usted puede enviar esta solicitud, como se muestra en la siguiente figura.
La figura tambin muestra la respuesta exitosa desde el servidor.
Figura 9-9 Creacin de un calendario de vacaciones con REST Web Services
217
Entonces usted debe ver su nuevo calendario en la lista de calendario en la ficha Programacin.
Figura 9-10 Seleccin de un calendario personalizado de vacaciones en el Programador

La API de REST es compatible con otros tipos de calendarios, sin embargo, la interfaz de usuario slo se enumeran los
calendarios de tipo
vacaciones. Uso de la API REST, sin embargo, puede crear y administrar cualquier nmero de calendarios y actualizar cualquier
programar para utilizarlos. Para obtener ms informacin, consulte la Gua de Servicios Web JasperReports Server.
9.12 Configuracin del latido del corazn

Durante la instalacin (o la primera vez que un administrador inicia sesin en), se le solicitar una vez para participar en
Programa Heartbeat de Jaspersoft, que reporta informacin tcnica a Jaspersoft sobre su aplicacin,
tales como el sistema operativo, JVM, servidor de aplicaciones, base de datos (tipo y versin), los tipos de fuentes de datos,
y
Edicin del servidor JasperReports y nmero de versin.
Si cambia de opinin, puede cambiar el comportamiento de los latidos del corazn mediante la edicin del archivo de
configuracin siguiente:
Opciones Heartbeat
Propiedad
Descripcin
heartbeat.enabled = true
Cuando esta propiedad se establece en verdadera, JasperReports

Servidor
reporta informacin sobre el entorno de Jaspersoft
una vez a la semana. Cuando se establece en falso, informacin no es
enviado.
heartbeat.askForPermission.enabled
Determina si se le pide al administrador (la

prxima vez que inicie sesin en la interfaz web) sobre si se debe
permitir
datos de los latidos del corazn que se enven. Tpicamente, nunca hay
causa
editar esta propiedad directamente.
Indica si un usuario ha concedido el servidor
permiso para enviar datos de ritmo cardaco. Al establecer esta
propiedad
a falsa impide el envo de datos.
heartbeat.permissionGranted.enabled
Todos estos ajustes son propiedades que son sustituidos en el heartbeatBean en el ... / WEBArchivo / applicationContext-heartbeat.xml INF.
218
9.13 Configuracin de la Ayuda en lnea

JasperReports Server Edition profesional incluye un sistema de ayuda en lnea que describe la interfaz web. Si su
los usuarios no tienen conexin a Internet, o si usted no desea proporcionar acceso a este sistema, puede configurar
el servidor para ocultar los vnculos de ayuda completamente.
Opciones de configuracin de Ayuda en lnea

... / WEB-INF / applicationContext-webHelp.xml
Propiedad
Frijol
Descripcin
showHelp
WebHelp
Determina si los enlaces de ayuda se muestran en las JasperReports

Interfaz de usuario Web Server. Los valores vlidos son cierto y falsa.
El Ayuda enlace aparece en la esquina superior derecha de las pginas de la
interfaz de usuario web.
hostURL
WebHelp
Indica el nombre del equipo que aloja el servidor web donde el

ayuda se est ejecutando. El valor depende de la versin de JasperReports
Server. No cambie este valor.
pagePrefix
WebHelp
Define el nombre de la pgina por defecto para pasar al servidor web que aloja el
sistema de ayuda. El nico valor vlido es Default_CSH.htm para esta propiedad.
helpContextMap
WebHelp
Mapas contextos en la aplicacin de los identificadores de temas en el sistema de ayuda.

Muchas pginas de la aplicacin web se configuran para la sensibilidad al contexto.
Cuando un usuario hace clic Ayuda en una pgina de este tipo, JasperReports Server
carga un
tema especfico en el sistema de ayuda. El tema que aparece est determinada por
un mapa en el archivo applicationContext-webHelp.xml. Los nicos valores vlidos
son los valores por defecto.
219
220
CAPTULO 10 diagnsticos de Server

JasperReports Server proporciona amplias de diagnstico de manera que los administradores pueden controlar la salud y
el rendimiento del servidor que ejecuta. En la versin 5.0, el servidor aumenta el registro de auditora con los datos de vigilancia
que es ms fcil informar en contra. La versin 5.0 tambin introduce diagnstico que proporcionan informacin en tiempo real
acerca de
el servidor en ejecucin, tales como el uso de memoria. Todas estas herramientas pueden ayudarle a solucionar problemas y
analizar
rendimiento.
Tiendas de Auditora eventos clave que son de inters para los administradores de sistemas, tales como nombre de usuario
/ tiempo de cierre de sesin, el usuario,
informe generado, detalles del informe y tamaos de objetos. Los eventos auditados se pueden guardar y se mudaron a un
archivo
automticamente despus de un nmero determinado de das.

El monitoreo se basa en eventos de auditora y proporciona un dominio multidimensional para crear Ad Hoc visitas.
Esto le ayuda a generar informes que contienen las mtricas clave, tales como los informes que utilizan la mayor cantidad
de recursos. Este
le permiten encontrar lugares para optimizar sus fuentes de datos y los informes.
Diagnstico proporcionan datos en tiempo de ejecucin que da la salud general de la instancia del servidor. Por ejemplo, se
incluye valores tales como usuarios registrados, actualmente en ejecucin, informes regulares y el uso de memoria y
desempeo en la cach Ad Hoc. Los datos de diagnstico se expone en una fuente de datos personalizada y puede ser
fcilmente
ve en contiene
un informe
integrado con
consolas de administracin estndar de la industria.
Este se
captulo
lasosiguientes
secciones:
Eventos que se audita y monitoreados

Configuracin de Auditora y Supervisin
El uso de los datos de auditora
Uso de la Monitorizacin de Datos
Importacin y exportacin de datos de eventos
Tiempo Real Diagnsticos
La exposicin de Diagnstico A travs de un agente JMX de
Jaspersoft
El uso de los datos de diagnstico en los Informes
Excluyendo Atributos de diagnstico
Desactivacin de Tiempo Real Diagnsticos
221
10.1 Eventos que se audita y monitoreados

En trminos generales, un evento de auditora es cualquier operacin atmica que puede ser registrada por el sistema de
auditora. Propiedades de eventos
y los atributos son caractersticas del evento; que pueden ser definidos internamente o en el cdigo personalizado. Auditora y
vigilancia se basan en el mismo registro de eventos, por lo que los eventos de auditora tambin estn disponibles en el
seguimiento de las fuentes de datos,
Dominios e informes.
La siguiente tabla muestra los eventos de auditora definidas y la informacin que se recopila sobre ellos. Por cada
evento grabado, JasperReports Server registra el momento en que ocurri y el usuario que lo inici. Consulte la
archivo de configuracin applicationContext-audit.xml para la especificacin completa de los eventos.
Evento
Informacin recopilada
Inicia la sesin o cerrar

sesin
El tiempo y el ID de usuario (registrado por cada evento)
Entrar como
Usuario conectado como
Ejecutar informe o ejecutar un informe integrado

dentro de cualquier
otro informe
Informe de referencia
Fuente de datos referenciada
Parmetros y valores de informe
Consultas de informes (por ejemplo, SQL, dominio, HQL, SQL generado)
Inicio de ejecucin, extremo
Tiempo de ejecucin de la consulta (en

milisegundos)
Informe de tiempo de representacin (en
milisegundos)
Parmetros de almacenamiento
en cach
Los errores que se produjeron
Planificacin de informe creado, eliminado o

actualizado
Informe de referencia
Parmetros y valores de Programacin
Informe de ejecucin
programada
Informe de salida
Parmetros de Informe de entrega (como el correo

electrnico)
Mismos parmetros que cuando se ejecuta el informe
Campo aade como una columna
Campo aade como un grupo
Crear informe en Ad Hoc Editor
Recursos visitada por cualquier motivo (por ejemplo,

Referencia de Recursos
como punto de vista, utilizado en el informe, etc)
Tipo de recurso
Recursos aadido o actualizado
222
Referencia de Recursos
Tipo de recurso
Recursos o carpeta eliminada
Recursos o carpeta referenciada
Permisos aadido, actualizados o borrados
Recursos o carpeta referenciada
Permisos anteriores (antes de la actualizacin)
Evento
Informacin recopilada
Usuario agregado, actualizado o borrado, tambin

cambio de contrasea de usuario
Papel aadido, actualizado o borrado
Organizacin aadido, actualizado o borrado
ID (identificacin)
de usuario
Nombre de usuario
Email
Bandera Activado
Bandera externa
Atributos del perfil
Identificacin de
roles
Nombre de la funcin
Organizacin Rol
Organizacin ID
Descripcin Organizacin
10.2 Configuracin de Auditora y Supervisin

Las funciones de auditora y de supervisin se basan en el mismo subsistema en JasperReports Server. Los ajustes para
Configuracin de la auditora y la supervisin estn ubicados en el archivo / applicationContext-audit.xml WEB-INF. El
se utilizan los frijoles y las propiedades de este archivo para habilitar la auditora y la supervisin, establezca las opciones de
archivo y seleccione
que se registran los eventos.
10.2.1
Habilitacin de Auditora y Supervisin

Debido a que la auditora y la supervisin comparten el mismo subsistema, hay una opcin de configuracin master para
encender la
subsistema, y los ajustes individuales para la auditora y monitoreo. Esto le permite activar cada funcin
independiente, o apagar el subsistema completo para evitar cualquier sobrecarga de una funcin no utilizada.
De forma predeterminada, la auditora y la supervisin subsistema
est apagado.
Habilitacin de Auditora y Supervisin Opciones
Propiedad
Descripcin
audit.enabled = false
Establezca esta propiedad cierto para permitir la auditora y

subsistema de supervisin. Dado el valor por defecto de la otra
configuracin, slo la auditora est activada cuando este ajuste es primer set
a verdadera.
223
Habilitacin de Auditora y Supervisin Opciones

monitoring.enabled = false
Una vez audit.enabled = true, establecer esta propiedad en cierto a

habilitar la supervisin. Ms precisamente, este valor controla la
registro de los acontecimientos en las tablas utilizadas por el monitoreo
Dominio.
audit.sizeof.enabled = false
De forma predeterminada, los objetos de gran tamao de impresin de la

memoria no son das
confi- porque eso puede afectar al rendimiento. Si desea temralmente habilitar la auditora para el uso de la memoria de los objetos de
impresin
en los informes, establezca este valor en verdadera.
... / WEB-INF / applicationContext-audit.xml
Propiedad
Frijol
Descripcin
isAuditPersistence
Activado
auditora
Servicio
Establezca esta propiedad falsa para deshabilitar el registro de eventos en el

tablas utilizadas por el dominio de auditora. Esto le permite apagar
datos de auditora, manteniendo los datos de seguimiento.
Evite apagar el seguimiento y la auditora de la persistencia.
En su lugar, apague todo el subsistema con
audit.enabled = false.
10.2.2
Opciones de copia de Auditora

El archivo es un mecanismo para mover los datos de auditora a las tablas de bases de datos separadas. Por ejemplo, si crea
informes para
uso semanal o mensual del servidor basado en el dominio de auditora, que nunca acceder a registros de auditora ms de una
semana
o meses. Debido a que los datos de auditora pueden ser bastante grandes, los datos antiguos se incrementar el tiempo
necesario para escribir nuevos datos
y datos de la consulta para el informe. Archivar mueve automticamente los datos de auditora a las tablas de bases de datos
separadas despus de un
cierto tiempo. Si desea crear informes sobre los datos de auditora histricos, Jaspersoft proporciona tambin un dominio para el
acceso
Usted debe establecer el intervalo de archivado a un nivel que equilibre su necesidad de registrar y auditar el acceso a datos con
los
registros dede
auditora
archivados.
Tambin
configurar
la funcin
de auditora
para suprimir
datos archivados
antiguos
el rendimiento
su servidor
en grandes
tablaspuede
de auditora.
Utilice
los siguientes
parmetros
de configuracin
para cambiar
el
ms
tiempo
si
no
archivo
necesitarlo.
comportamiento.
... / WEB-INF / applicationContext-audit.xml
224

Propiedad
Frijol
Descripcin
maxAudit
EventAge
ToArchive
auditService
maxAudit
EventAge
auditService
El nmero de das que se conservan los datos de auditora en el

activo
base de datos. El valor predeterminado es 30 Los datos anteriores se
mueve a la
archivo.
El nmero de das que se guardan los datos. Se eliminan los datos ms.
El valor predeterminado es 0 (cero), lo que significa que los datos de edad
nunca es
suprimido.
cronExpression
auditEvent
ArchiverTrigger
Define la frecuencia del trabajo archivado en cron sintaxis.

El valor predeterminado, 0 0 5 *?, es cada da a las 05 a.m.
cronExpression
auditEvent
PurgerTrigger
Define la frecuencia de la auditora delete (purga) de empleo en cron

sintaxis. El valor predeterminado, 0 0 3 *?, es cada da a las 3 a.m.
El cronExpression propiedades utilizan un Planificador cuarzo expresin cron que especifica el gatillo repitiendo como
segundos, minutos, horas, das del mes, mes, da de la semana.
10.2.3
Desactivacin de eventos y propiedades

Por defecto, todos los eventos y propiedades se registran. Para habilitar o deshabilitar el registro de un evento o propiedad
dada, utilice
el archivo de configuracin applicationContext-audit.xml. Eventos que se registran son utilizados tanto por la auditora y
seguimiento de los subsistemas, por lo tanto, para desactivar un evento hace que no est disponible tanto para la auditora y
monitoreo.
En el archivo, tipos de eventos y sus propiedades se enumeran en <Util: mapa id = "enabledEventsMapping">. El
mapa tiene tres partes:
WEB_SERVICES - tipos de eventos relacionados con el acceso JasperReports Server a travs de un servicio
web.
Tipos de eventos para el acceso a travs de la interfaz de usuario - GUI.
Tipos de eventos utilizados por el propio servidor, como cuando se ejecuta un informe programado - INTERNO.
Para desactivar un evento, como comentario. Por ejemplo:

<-! <Clave de entrada = valor "CreateFolder" = "Nombre de carpeta, folderLabel, folderDescription" /> >
Para deshabilitar una propiedad, utilice cualquiera de estas

medidas:
Eliminar la propiedad. Por ejemplo, quite folderDescription, Resultando en:

<Clave de entrada = valor "CreateFolder" = "Nombre de carpeta, folderLabel, excepcin" />
Desactivar con la |sintaxis. Por ejemplo:

<Clave de entrada = valor "CreateFolder" = "Nombre de carpeta, folderLabel, | folderDescription, excepcin"
/>
Utilice la opcin "Todos excepto" * | sintaxis para especificar slo la propiedad discapacitados. Todos los dems se
registran. Por ejemplo:
<Clave de entrada = valor "CreateFolder" = "* | folderDescription" />
225
10.3 Uso de los Datos de Auditora

JasperReports Server hace que los datos disponibles para los administradores de auditora a travs de dominios y varios
preparados
vistas e informes. Estos se encuentran en la carpeta / Public / Auditora del repositorio.
Figura 10-1 Informes de Auditora en el Repositorio

Hay dos dominios y dos conjuntos de informes creados para acceder a los datos de auditora:
Auditar los informes de auditora y de dominio - Utilice estos para ver los datos de auditora en curso; van en contra de la
activa
base de datos de auditora.
Informes de auditora archivados Auditora Archivo Dominio y - Utilice estos para generar informes de los datos
archivados; corren
contra la base de datos de archivo.
Los contenidos de ambos dominios y los informes son idnticos-que slo se diferencian en las tablas de base de datos que se
tiene acceso
en cada caso.
Para crear un Grupo de Accin View basado en los Dominios de auditora, seleccione Crear> Especial View, seleccionar el
Dominios
ficha en el Selector de Datos, y expandir las carpetas para seleccionar uno de los Dominios de auditora.
226
Figura 10-2 Seleccin de un dominio de Auditora para Crear un Grupo Especial Ver
Para obtener instrucciones sobre el uso de dominios en los informes, consulte el captulo especial en Gua del usuario de
JasperReports Server. Para
documentacin de Dominios en general, consulte el captulo Dominios en el mismo manual.
Las siguientes secciones explican los contenidos de los dominios y los informes que se proporcionan.
10.3.1
Auditar Artculos de dominio

Los Dominios de auditora exponen los campos de las tablas de registro de auditora almacenados en la base de datos interna
del servidor. Al igual que con
todos los mbitos, las tablas de la base estn unidas, y los campos se presentan como elementos que se pueden utilizar en el
modo Ad Hoc
vistas.
Las siguientes tablas describen los elementos de ambos dominios de auditora (Auditora de dominio y Auditora Archivo de
dominio).
Estos artculos corresponden a la informacin que se registra para cada evento. Al crear una vista basada en cualquiera
Dominio, elegir los elementos que se corresponden con el tipo de evento que desea informar.
Artculos de dominio en la siguiente tabla se utilizan en eventos generales, as como los eventos del
repositorio:
Dominio de artculo
Descripcin
Fecha
Fecha del evento ocurrido.
Prop largo Valor
clob valor de la propiedad de evento, tales como consulta.
Tipo Prop
Tipo de inmueble evento, como la carpeta de destino, segn mapa de eventos en

archivo de configuracin.
Valor Prop
string valor de la propiedad de evento, tales como nombre de la

carpeta.
Tiempo
Evento Hora en que ocurri.
227
Dominio de artculo
Descripcin
Tipo de evento
Tipo de evento, como ahorrar recursos, segn mapa de eventos en el archivo de

configuracin.
Tipo de solicitud
Repositorio tipo de peticin de evento.
Tipo de recurso
Tipo de repositorio de recursos acceder en evento.
URI de recursos
URI de recursos del repositorio.
Artculos de dominio en la tabla siguiente se registran para los eventos de

usuario:
Dominio de artculo
Descripcin
E-mail
Direccin de correo electrnico de usuarios de eventos (usuario en

tiempo de evento).
Activado
Ya sea de usuarios de eventos es actualmente un

usuario.
Externo
Si el usuario evento fue un usuario externo.
Nombre completo
Nombre completo del usuario

evento.
Contrasea cambiada
Ya sea evento fue un cambio de contrasea
Organizacin
Organizacin de usuarios de eventos.
Nombre de Usuario
ID de usuario del usuario de

eventos.
Artculos de dominio en la siguiente tabla se registran los eventos de rol:

Dominio de artculo
Descripcin
Externo
Si el papel se define en un sistema externo.
Nombre de funcin
Nombre de la funcin en el evento.
Organizacin
Organizacin de la funcin en el evento.
Artculos de dominio en la tabla siguiente se registran cuando se genera un informe:
228
Dominio de artculo
Descripcin
Fecha
Fecha que se genere el informe.
Tiempo
El tiempo se genere el informe.
URI de recursos
URI de recursos repositorio accesible para el informe.
Tipo de recurso
Tipo de repositorio de recursos para acceder informe.
10.3.2
Dominio de artculo
Descripcin
Origen de datos URI
URI de la fuente de datos accesible para el informe.
Tiempo de ejecucin de la
consulta
Tiempo de ejecucin de la consulta en la base de datos.
Informe Rendering
Tiempo para preparar resultados de la consulta para la

exhibicin.
Informe de Ejecucin Hora
Tiempo total para ejecutar la prestacin informe (informe de ejecucin de la consulta + +

gastos generales). Overhead incluye tareas como recursos del repositorio de carga
(Unidad de informe, la fuente de datos, etc) y la obtencin de una conexin DB partir de los
datos
fuente.
Consulta
Especificacin de la consulta del informe.
Nombre de Usuario
ID de usuario del usuario de

eventos.
Organizacin
Organizacin de usuarios de eventos.
Tabla de referencias cruzadas

Grupo Campo
Nombre del campo utilizado en tabla de

referencias cruzadas
Informes de Auditora y Ad Hoc Vistas

Los informes de auditora y sus puntos de vista son blanco de forma predeterminada, ya que la auditora est desactivada
de forma predeterminada y no
existen datos de auditora. Para ver estos informes, primero habilitar la auditora como se describe en "Auditora de
Configuracin y
Monitoring "en la pgina 223, luego esperar a que la actividad del usuario para generar eventos.
Un nmero de Ad Hoc vistas e informes basados en los Dominios de auditora estn dentro de la / Auditora / Auditora
Pblica
Carpeta Informes. Los mismos puntos de vista y los informes tambin se proporcionan en el Archivo de Informes de Auditora
subcarpeta. Estos
informes son idnticos, excepto que utilizan el dominio de Auditora Archivo y corren en contra de los datos de auditora
archivados. Como
Los
estn diseados
para
cubrir
las necesidades
de auditora
comunes
y pueden utilizarse tal cual. Cuando est
con informes
todo el material
de auditora,
estos
informes
slo son visibles
para los
administradores.
habilitada la auditora y
se graban los eventos de auditora, que contendrn up-to-the-minute registros de eventos en el servidor. Usted puede
ejecutar los informes o programarlos segn sea necesario.
La vista ad hoc usado para crear cada informe se incluye tambin. Puede abrir estos en el editor de Ad Hoc para
explorar los datos de auditora en tiempo real. Tambin puede modificar estos puntos de vista en el Editor Ad Hoc para
generar nuevos
informes para satisfacer sus requisitos de auditora.
Los siguientes puntos de vista y los informes se
proporcionan:
Informe de auditora - Ejemplo genrico de un informe de una auditora que muestra eventos comnmente auditados.
Rendimiento informe de tabla cruzada - Una tabla de referencias cruzadas que muestra el rendimiento promedio de
los informes que se ejecutaron.

Performance Report - Genera una lista de los informes que se ejecutaron y ordenados por el tiempo de ejecucin
para identificar lenta
informes.
Repositorio de Recursos Informe - Muestra los recursos del repositorio y sus eventos asociados.
Ejecucin de Recursos Report - Genera una lista de los informes que se ejecutaron.
Usuario Informe de actividades - Genera una lista de los informes dirigidos por un usuario especfico.
229
10.4 Uso de la Monitorizacin de Datos

JasperReports Server hace los datos de seguimiento disponibles para los administradores a travs de un varios y de
dominio
vistas e informes preparados. Estos se encuentran en la carpeta / Public / Monitoreo del repositorio.
Figura 10-3 Informes de Seguimiento en el Repositorio

Para crear un Grupo de Accin View basado en los Dominios de auditora, seleccione Crear> Especial View, seleccionar el
Dominios
ficha en el Selector de Datos, y expandir las carpetas para seleccionar el dominio de monitoreo. Para obtener instrucciones
sobre el uso de
Los dominios en los informes, consulte el captulo especial en Gua del usuario de JasperReports Server. Para la
documentacin de
Las
siguientes
secciones
explican
losdecontenidos
dominios
y los informes que se proporcionan.
Dominios
en general,
ver el
captulo
Dominios de
en los
el mismo
manual.
10.4.1
Monitoreo Artculos de dominio

El dominio monitoreo expone los campos de los cuadros de seguimiento almacenados en la base de datos interna del servidor.
Como
con todos los dominios, las tablas de la base estn unidas, y los campos se presentan como elementos que se pueden utilizar
en el modo Ad
Vistas
En estahoc.
versin de JasperReports Server, los campos de monitoreo se limitan a los que la ejecucin record report
eventos:
Dominio de artculo
Descripcin
Da
Da del mes, el informe termina de ejecutarse.
Edicin de Accin
El Ad Hoc paso de edicin que el usuario acaba de realizar (nulo para la ejecucin del informe):
insertDimensionInAxisWithChild - Se aadi una dimensin.
addMeasure - Se aadi una medida.
setProperty - Una propiedad se ha

establecido.
moveDimension - Una dimensin se conmovi.
230
Dominio de artculo
Descripcin
Contexto Evento
El contexto que provoc la ejecucin del informe. Los valores posibles son:
Tipo de evento
10.4.2
ui - El informe corri de forma interactiva desde la interfaz de usuario.
servicios web - El informe se ejecuta a travs de servicios web.
interna - El informe se desarroll entre un proceso interno, por lo general el planificador.
El tipo de informe que se ha ejecutado. Los valores posibles son:
ejecucin de informes - Un informe que iba desde el repositorio.
edicin ad hoc - Un informe que iba desde un punto de vista especial que se est
editando.
Hora
Hora que el informe termine de ejecutarse.
Identificaci
n del
Nmero de ID del evento de monitoreo.
Minuto
Minute que el informe termine de ejecutarse.
Mes
Mes que reportan terminado de ejecutarse.
Tiempo de ejecucin de la
consulta
El tiempo dedicado a ejecutar la consulta SQL en la base de datos.
Informe Rendering
El tiempo dedicado a rendir el informe despus de recibir los resultados de la consulta

(conjunto de datos).
Informe URI
Ruta de repositorio del informe que se ejecut.
Time Stamp
Tiempo y fecha que el informe se termina de ejecutarse, incluyendo milisegundos.
Informe de ejecucin total

Tiempo
El tiempo total empleado que ejecuta el informe. Normalmente, este es un poco ms que el
suma de la ejecucin de la consulta y la representacin de informes veces, debido a los gastos
generales.
Overhead incluye tareas como recursos del repositorio de carga (unidad de informe, los datos
fuente, etc) y la obtencin de una conexin DB desde la fuente de datos.
Nombre de Usuario
El usuario que ejecut el informe.
Organizacin usuario
La organizacin que contiene el usuario que ejecut el informe.
Ao
Ao que el informe termine de ejecutarse.
Los informes de seguimiento y Ad Hoc Vistas

Los informes de seguimiento y sus vistas son blanco de forma predeterminada, ya que el subsistema de auditora que el
monitoreo
depende est desactivada por defecto y no existen datos de auditora. Para ver estos informes, primero habilitar la auditora
como se describe en la seccin "Configuracin de Auditora y Supervisin "en la pgina 223, luego esperar a que la actividad
del usuario a
generar eventos.
Un nmero de Ad Hoc vistas e informes basados en el dominio de vigilancia estn dentro de la

/ Monitoreo / Vigilancia Pblica Informes carpeta.
231
Los informes estn diseados para cubrir las necesidades comunes de seguimiento y se puede utilizar tal cual. Cuando se activa
la monitorizacin
y se registran los eventos de auditora, los informes contendrn hasta al minuto los registros de eventos en el servidor.
Puede ejecutar los informes o programarlos segn sea necesario.
La vista ad hoc usado para crear cada informe se incluye tambin. Puede abrir estos en el editor de Ad Hoc para
explorar los datos de monitoreo en tiempo real. Tambin puede modificar estos puntos de vista en el Editor Ad Hoc para
generar
nuevos informes para satisfacer sus requisitos de supervisin.
Los siguientes puntos de vista y los informes se
proporcionan:
Informe de Seguimiento de Recursos Informe - Proporciona una lista de todos los informes que se han ejecutado y muestra
su promedio y
tiempos de ejecucin de alto bajas.
Informe de Seguimiento de detalles Notificar - Una tabla de referencias cruzadas que muestra los tiempos de ejecucin de
informes en un eje y muchos
dimensiones, tales como una jerarqua de tiempo, el usuario y la organizacin, y el tipo de evento en el otro eje ,.
Figura 10-4 Monitoreo Ver Ad Hoc con el anlisis multidimensional
10.5 Importacin y exportacin de datos de eventos

Los datos de auditora y monitoreo pueden ser importados y exportados con las utilidades descritas en el captulo "Importar
y exportacin "en la pgina 131.
Para
los datos de auditora de exportacin, utilizan la --include-auditora-eventos opcin en el comando de exportacin.
Para
usuario de los datos de vigilancia de las exportaciones del --include-monitoreo-eventos opcin en el comando de exportacin.
Para
datos de auditora importacin, la importacin del catlogo que contiene los datos de auditora con el --include-auditoraPara opcin.
eventos
datos de monitoreo para las importaciones, importar el catlogo que contiene los datos de auditora con el --includeMonitoring
eventos opcin.
Los datos en las carpetas temporales no se
exporta.
232
10.6 Real-Time Diagnstico

Con JasperReports Server 5.0, Jaspersoft introduce la instrumentacin completa del servidor para que pueda proporcionar real
informacin de diagnstico el momento en que el uso de memoria, informes concurrentes que se est ejecutando, las
estadsticas de cach, y mucho
Ms. Mientras que la auditora y la supervisin proporcionan un registro histrico de eventos en el servidor, se muestran los
diagnsticos
el estado actual del servidor y su Virtual Machine (JVM) entorno Java.
Por ejemplo, puede utilizar la informacin de diagnstico para ajustar la configuracin de JVM para optimizar la memoria basado
en
el tamao de los conjuntos de datos tpicos de la memoria cach Ad Hoc. Y debido a que los datos de diagnstico est
disponible a travs de un tema,
puede crear vistas Ad Hoc que le ayuden a analizar el rendimiento de su servidor e identificar el desempeo
cuellos de botella antes de que sucedan.
La funcin de diagnstico se basa en el estndar de Java Management Extensions (JMX) de la industria para reunir en
tiempo de ejecucin
de datos y lo exponga a otras interfaces de administracin. JasperReports Server implementa varios elementos de la
Arquitectura JMX:
Nueva JMX logr frijoles que se utilizan para recopilar y mantener los datos de diagnstico, tales como el nmero de
concurrentes
informes.
Su propio agente JMX, como un servidor, que responde a las solicitudes JMX y expone la informacin de la
beans gestionados.
Las conexiones a los frijoles JMX logrado existentes en otros componentes como Ehcache para incluir su
datos de diagnstico.
Las conexiones con otros agentes JMX como agente JVM para recopilar diagnsticos del sistema.
Para obtener ms informacin acerca de JMX, consulte

http://docs.oracle.com/javase/tutorial/jmx/.
Hay dos maneras de utilizar los datos de diagnstico de JasperReports del
servidor:
Si usted tiene una consola de gestin externa que puede conectarse a un agente JMX, puede utilizarlo para conectarse a
agente JMX del servidor. Es probable que tambin desee conectarse a agente JMX de la JVM tambin. Usted puede
a continuacin, ver el tiempo real de los datos de diagnstico de servidor JasperReports integrados con los datos de su otro
servidores de la consola de administracin. Consolas de administracin a menudo ofrecen ms funcionalidad, como
umbrales y alarmas que se pueden definir en los datos desde cualquier JMX bean gestionado.
Jaspersoft proporciona una fuente de datos personalizado en el servidor que recoge la misma informacin desde el
beans gestionados en el servidor y en la JVM. A continuacin, puede crear JasperReports que acceden a esta fuente de
datos
y presentar estos datos de diagnstico en un informe que se adapte a sus necesidades. Jaspersoft tambin proporciona un
informe y un anuncio
Tema Especial para demostrar esto.
10.7 La exposicin de Diagnstico a travs del agente JMX de Jaspersoft

De forma predeterminada, la caracterstica de diagnstico est configurado para permitir el acceso a los datos de diagnstico a
travs de un mando a distancia
consola de gestin que soporte JMX. Esto le permite integrar el diagnstico de JasperReports Server con
su estrategia global de gestin de TI. Alternativamente, el kit de desarrollo de Java proporciona la herramienta JConsole que
utiliza JMX y se puede utilizar para supervisar el servidor de forma remota. Todas estas consolas de administracin acceder al
JMX
agente dotado de JasperReports Server, y el acceso est garantizado por los mismos usuarios, contraseas y roles utilizados
por
la interfaz web del servidor.
10.7.1
Conexin con el agente JMX

Para conectar la consola de administracin de agente JMX del JasperReports Server, iniciar una nueva conexin desde
la consola y especifique la siguiente cadena de conexin:
servicio: jmx: rmi: // localhost / jndi / rmi: // <host>: <puerto> / <connectionName>
233
donde:
<Host> es el equipo donde se ejecuta JasperReports Servidor

<Puerto> es el puerto JMX, por defecto 10990
<ConnectionName> es el nombre del agente JMX, por defecto JasperServer
Por lo tanto, la cadena de conexin por defecto es:

servicio: jmx: rmi: // localhost / jndi / rmi: // <host>: 10990 / JasperServer
Si tiene un servidor de seguridad implementado en el ordenador que aloja JasperReports Server, tendr que
abrir el puerto JMX (10990 por defecto) antes de conectar.
Cuando se le pida que introduzca un nombre de usuario y contrasea, debe dar a un usuario con las siguientes
funciones:
Ediciones comerciales:
ROLE_SUPERUSER, en consecuencia, por defecto, el superusuario usuario
Proyecto de la Comunidad: ROLE_ADMINISTRATOR, en consecuencia, por defecto, el jasperadmin usuario
Las siguientes secciones explican cmo modificar los valores por defecto de conexin para:
10.7.2
El nombre de la conexin
El puerto JMX
Los roles necesarios
Configurar el nombre del puerto y la conexin

El nombre de la conexin es el nombre registrado para el agente JMX con la invocacin del mtodo remoto (RMI)
servicio. Si usted tiene ms de una instancia JasperReports Server en un solo servidor de aplicaciones, es necesario cambiar la
nombre de la conexin registrada para todos excepto el primero.
Hay veces que usted puede desear cambiar el puerto de defecto (10990) a otro puerto, por ejemplo, si otro
servicio est configurado para utilizar el puerto por defecto. Por ejemplo, cambiar el puerto si tiene JasperReports Servidor
que se ejecuta en un segundo servidor de aplicaciones en el mismo equipo.
Para cambiar el puerto o el nombre de la conexin, editar uno de los archivos
siguientes:
En la distribucin de archivos WAR antes de la instalacin: <js-instalar> /buildomatic/default_master.properties
En el archivo WAR instalado antes de iniciar el servidor: <js-guerra> /WEB-INF/js.diagnostic.properties

Encuentre las lneas siguientes y editar los valores para el nmero de puerto y la conexin nombre deseado:
diagnostic.jmx.port = 10990
diagnostic.jmx.name = JasperServer
10.7.3
Configurar funciones para conexiones JMX

Si desea permitir que otros usuarios establecer la conexin JMX desde una consola de administracin remota, debe
configurar JasperReports Server para permitir otras funciones:
Para las ediciones comerciales, edite el archivo WEB-INF / applicationContext-Diagnostic-pro.xml y modificar el

siguiente configuracin:
<Util: lista id = "diagnosticAllowedRolesPro">
<Valor> ROLE_SUPERUSER </ value>
</ Util: lista>
234
Para los proyectos de la comunidad, edite el archivo WEB-INF / applicationContext-Diagnostic.xml y modificar el

siguiente configuracin:
<Util: lista id = "diagnosticAllowedRolesCe" value-type = "java.lang.String">
<Valor> ROLE_ADMINISTRATOR </ value>
</ Util: lista>
En ambos casos, se puede cambiar la funcin existente o aadir lneas adicionales que contienen alternativo <Valor>
ROLE_
nombre </ value>.
10.7.4
Desactivacin de conexiones remotas a la agente JMX

De forma predeterminada, las conexiones remotas a un agente JMX estn habilitados y configurados como se describe en
"Conexin a la
JMX Agent "en la pgina 233.
. Para deshabilitar las conexiones remotas, edite el archivo applicationContext-diagnostic.xml y hacer la siguiente
cambios:
ComentarioSalida
la totalidad JMXAuthenticator frijol.
ComentarioSalida
la totalidad jMXregistry frijol.
ComentarioSalida
la totalidad jasperJMXServerConnector frijol.
ComentarioSalida
o eliminar la propiedad depende-en = "jMXregistry" en el jasperJMXServer frijol.
Para comentar una seccin de este archivo XML, lo rodean con <! - y -> etiquetas.
10.7.5
Conexin alternativa a travs del servicio del servidor de aplicaciones

JMX
La mayora de los servidores de aplicacin tambin tienen un agente JMX, y si se configuran correctamente, pueden
descubrir el
Agente y JasperReports servidor JMX exponer la informacin de diagnstico. Sin embargo, esta conexin tiene algunos
importantes implicaciones de seguridad:
Cuando el servidor de aplicaciones descubre y se conecta con el agente JMX, tiene pleno acceso al diagnstico
informacin.
Si el agente JMX del servidor de aplicaciones est configurado para el acceso remoto, el administrador remoto tambin tiene
acceso a la
el agente JasperReports servidor JMX - sin necesidad de proporcionar el nombre de usuario JasperReports Server y
contrasea. En otras palabras, al confiar en el servidor de aplicaciones para acceder a la informacin de diagnstico, usted
tambin
permitiendo que cualquier persona que confe el servidor de aplicaciones se conecten.
La conexin entre los dos agentes JMX es recproca. Si el acceso remoto sigue activado en la
Agente JasperReports servidor JMX, un gerente remoto que se conecta a l tambin ve el contenido de la aplicacin
servidor de agente JMX. En otras palabras, el agente JMX del servidor de aplicacin tambin es confiar en cualquier persona
que confiamos para conectar
a nuestro agente JMX (con nuestro nombre de usuario y contrasea).
Para conectarse automticamente al agente JMX del servidor de aplicaciones, suponiendo que haya alguno
disponible, edite el default_
master.properties archivo antes de implementar la aplicacin web del servidor JasperReports, y aadir la siguiente
lnea:
diagnostic.jmx.usePlatformServer = true
Si el servidor de aplicaciones Apache Tomcat es, por ejemplo, una conexin JMX local llamada Catalina parece a nadie
el acceso a la agente JasperReports servidor JMX.
235
10.8 Uso de los datos de diagnstico en los Informes

Adems de las conexiones JMX remoto, JasperReports Server hace de los datos de diagnstico disponibles para
administradores de informes internos. Los siguientes recursos son visibles para el administrador de sistema ( superusuario
por
por defecto) en el repositorio:
/ Public / diagnstico / Diagnostic Data Source - Una fuente de datos personalizado que devuelve todos los campos de
diagnstico.
/ / / Informe de Diagnstico Diagnstico Pblica - Un informe que muestra casi todos los campos de diagnstico individual.
/ Public / Ad Hoc Componentes / Temas / Tema Diagnstico - Un recurso JRXML que se puede utilizar como un tema de
crear una vista especial de la utilizacin de campos de diagnstico.
Figura 10-5 Informe de Diagnstico en el Repositorio

El tema de diagnstico y el informe se basan en el origen de datos de diagnstico. Esta es una fuente de datos personalizada
que
encapsula la informacin JMX y la hace disponible como fuente de datos para los informes. Adems, hay una
Datos de diagnstico interno Tipo de fuente que se puede utilizar para crear una nueva fuente de datos. Si elimina
accidentalmente el
fuente de datos de diagnstico, seleccione Crear> Origen de datos, establecer el tipo de diagnstico interno de origen de datos, y
establecer
La
siguiente
figura
muestra
el volver
principio
del informe de diagnstico. Este informe muestra casi todos los campos que es
el nombre
y la
ubicacin
para
a crearla.
disponible a travs de JMX y el subsistema de diagnstico. Este informe sirve como una referencia para los datos de diagnstico.
El informe tambin es muy til cuando la configuracin del servidor, ya que muestra muchas opciones de configuracin del
servidor
as como la informacin del sistema, como el uso de memoria. Usted puede utilizar esta informacin para afinar el rendimiento
de la instancia de JasperReports Server.
236
Figura 6.10 Contenido del Informe de Diagnstico
Atributos 10.9 Excluyendo diagnstico

La funcin de diagnstico JasperReports servidor expone un conjunto de beans gestionados (MBeans), cada uno con un nmero
de
Atributos JMX. Por defecto, todos los atributos de todos los MBeans estn disponibles. Si desea limitar lo que se expone,
puede excluir ninguno de los atributos o frijoles enteros a travs del archivo de configuracin siguiente:
... / WEB-INF / applicationContext-diagnostic.xml
Para excluir un atributo, busque los MBean donde se define y descomentar desde el
excludedDiagnosticAttributes propiedad. Por ejemplo, si desea ocultar la informacin sensible sobre
su base de datos interna, modificar la diagnosticRepositoryDatabaseInfoCe MBean como sigue:
237
<Bean id = clase "diagnosticRepositoryDatabaseInfoCe" =

"Com.jaspersoft.jasperserver.api.logging.diagnostic.jmx.DiagnosticDynamicMBean">
<Nombre de propiedad = "diagnosticServices">
<Set>
<Bean ref = "repositoryDatabaseInfo" />
</ Set>
</ Propiedad>
<Nombre de propiedad = "excludedDiagnosticAttributes">
<Set>
<Valor> DatabaseProductName </ value>
<Valor> DatabaseProductVersion </ value>
<Valor> DriverName </ value>
<Valor> SQLKeywords </ value>
<Valor> URL </ value>
<Valor> Nombre de usuario </ value>
<Valor> JDBCMajorVersion </ value>
<Valor> JDBCMinorVersion </ value>
<! <Valor> MaxRowSize </ value>
<Valor> MaxStatementLength </ value>
<Valor> MaxConnections </ value>
<Valor> MaxCharLiteralLength </ value>
<Valor> MaxColumnsInTable </ value>
<Valor> MaxColumnsInSelect </ value>
<Valor> MaxColumnsInGroupBy </ value>
<Valor> MaxColumnNameLength </ value>
->
</ Set>
</ Propiedad>
</ Bean>
Para excluir todo un frijol, como comentario o quitarlo de la lista de los granos en el
diagnosticExportingMBeansMap. Por ejemplo, en lugar de excluir atributos seleccionados, usted podra
eliminar todo el MBean de base de datos del repositorio de la siguiente manera:
<Util: mapa id = "diagnosticExportingMBeansMap">

<entrada key = "JasperServer: name = Usuarios" valor ref = "$ {bean.diagnosticUsers}" />
<Clave de entrada = "JasperServer: name = Informes" valor ref = "$ {bean.diagnosticReports}" />
<Clave de entrada = "JasperServer: name =" Programador de valor ref = "$ {bean.diagnosticScheduler}" />
<clave de entrada = "JasperServer: name =" Ajustes de valor ref = "$ {bean.diagnosticSettings}" />
<Clave de entrada = "JasperServer: name =" Repositorio de valor ref = "$ {bean.diagnosticRepository}" />
<Clave de entrada = "JasperServer: name = Acerca de" valor ref = "$ {bean.diagnosticJSAbout}" />
<Clave de entrada = "JasperServer: name = HibernateStatics"
valor ref = "$ {bean.diagnosticHibernate}" />
<Clave de entrada = "JasperServer: name = EhCache"
valor ref = "$ {bean.diagnosticEhCache}" />
<Clave de entrada = "JasperServer: name = ExternalInfo"
valor ref = "$ {bean.diagnosticExternalInfo}" />
<! <Clave de entrada = "JasperServer: name = RepositoryDatabase"
valor ref = "$ {bean.diagnosticRepositoryDatabaseInfo}" />
->
</ Util: mapa>
238
10.10Disabling Tiempo Real Diagnsticos

Por defecto, el subsistema de diagnstico JMX siempre est activada, pero el acceso externo est protegido con
contrasea y
requiere la apertura del puerto de diagnstico en el servidor de seguridad como se describe en "Diagnstico exponindolo
con
JMX Agent de Jaspersoft "en la pgina 233. Si desea desactivar todos los accesos externos, consulte "Remote
Desactivacin
Internamente,
subsistema
diagnstico
es pasivo
Las conexioneselcon
el agentedeJMX
"en la pgina
235. y no tiene ningn impacto en el rendimiento hasta que se accede en un
informe
a travs de la fuente de datos de diagnstico. Sin embargo, si desea desactivar diagnsticos en tiempo real completamente,
cambiar el nombre o
los siguientes archivos:
eliminar
applicationContext-diagnostic.xml
applicationContext-diagnstico-pro.xml
En ese caso, la fuente de datos de diagnstico, el informe muestra, y la muestra Tema describen en "Uso de la
Datos de diagnstico en los informes "en la pgina 236 no funcionar bien. Ellos pueden ser borrados del repositorio.
239
240
APNDICE A RESOLUCIN DE
PROBLEMAS
Este apndice contiene las siguientes secciones:
Nmero de usuarios ha superado el

Se acaba de conexiones de base de datos
Los campos no mencionados en Ad Hoc Editor
Nombres de campo Desaparecer en Ad Hoc Editor
Especial filtro con todos los valores que causan error
Ad Hoc dimensiones demasiado grandes
URLs personalizados No se cargan en Dashboards
Imprimir No Viendo en Dashboards
Scheduler Enviar varios mensajes de correo electrnico
Programador Ejecucin de Tareas eliminadas
Grficos que no aparece en Excel de Exportacin
Trabajar con fuentes de datos
Hadoop Hive-Reports no se ejecuta
Volviendo a la pgina inicial Antiguo
A.1 Nmero de usuarios ha superado el

Cuando hay ms usuarios definidos en el servidor y su licencia lo permite, la pgina de inicio de sesin muestra una
advertencia;
los usuarios pueden iniciar sesin. Despus de un perodo de gracia de 24 horas, se enva un correo al administrador y los
usuarios ya no pueden
sesin. Ventas
funcionalidad
mayora
est
volver
a habilitarAllainstalar
funcionalidad
delicencia,
servidor:el servidor
iniciar
Contacto
Jaspersoft
paraservidor
la compra
dedesactivada.
licencias de Para
usuario
adicionales.
la nueva
sea completamente funcional para todos los usuarios.
Retire los usuarios hasta que el nmero de cuentas de usuario en el servidor est de acuerdo con su licencia. Cuando el
servidor
funcionalidad est desactivada, los administradores pueden iniciar sesin y seleccionar Gestionar> Usuarios para eliminar
el usuario
cuentas. Para obtener ms informacin, consulte "Gestin de usuarios" en la pgina 29.
241
Correr A.2 Fuera de Conexiones de base de datos

JasperReports Server administra un grupo de conexiones para cada fuente de datos JDBC. El nmero predeterminado de
conexiones es de 20, pero si ejecuta muchos informes simultneamente en contra de la misma fuente de datos que pueden
llegar a la
lmite de conexin y ver el rendimiento sea menor. En particular, utilizando las API de servicios Web, clientes resto puede
lanzar fcilmente muchas ejecuciones de informes al mismo tiempo y alcanzar el lmite.
El tamao de agrupacin de conexiones est limitado para evitar tener demasiada memoria permanentemente asignado a las
conexiones.
Pero si usted necesita ms conexiones concurrentes sobre una base regular, usted puede aumentar el lmite con el siguiente
configuracin:
La reduccin del lmite de tamao para Ad Hoc Dimensiones
Propiedad
Frijol
Descripcin
<Constructor-arg
type = "int"
value = "20" />
dataSource
ObjectPool
Fbrica
Cambie el valor por defecto para que coincida con su concurrente

conexiones. Asegrese de que tiene suficiente memoria para
manejar las conexiones y el informe concurrente
ejecuciones.
Si est utilizando fuentes de datos JNDI, puede configurar el nmero de conexiones en el servidor de aplicaciones. Para
ms informacin, consulte las secciones sobre JNDI en "Trabajar con fuentes de datos" en la pgina 247.
A.3 Los campos no mencionados en Ad Hoc Editor

El editor de Ad Hoc slo es compatible con determinados tipos de datos. Si un tema contiene un campo con un tipo no admitido,
el
campo no aparece al abrir el tema en el editor de Ad Hoc. Los siguientes tipos de datos son compatibles con
el editor de Ad Hoc:
java.lang.String
java.lang.Byte
java.lang.Short
java.lang.Integer
java.lang.Long
java.lang.Float
java.lang.Double
java.lang.Number
java.util.Date
java.sql.Date
java.sql.Time
java.sql.Timestamp
java.math.BigDecimal
java.math.BigInteger
java.lang.Boolean
java.lang.Object
Tipos de datos no compatibles pueden ocurrir durante la edicin de Temas manualmente, ya veces con fuentes de datos para los
datos grandes,
en particular, MongoDB. El conector para MongoDB usa el tipo de datos de un valor dado en el ltimo documento
que contiene ese valor, y los errores en los archivos de entrada puede causar tipos inesperados. Por ejemplo, omitiendo el nico
cotizaciones en el formato JSON provoca un tipo de cadena debe ser interpretado como un tipo numrico.
Si sus campos Tema o dominio no aparecen en el editor de Ad Hoc, se puede habilitar el registro en la siguiente
clase para ver los detalles de los campos con los tipos de datos no soportados:
com.jaspersoft.ji.adhoc.metadata.AdhocTopicMetadata
242
Para obtener informacin sobre cmo habilitar el registro, consulte "Configuracin de registros del
sistema" en la pgina 192.
A.4 nombres de campo Desaparecer en Ad Hoc Editor

Algunos campos con caracteres internacionales en sus nombres para mostrar desaparecen cuando el campo se arrastra en el
lienzo del editor de Ad Hoc. Esto es causado por caracteres no Unicode utilizados en el nombre del campo en el JRXML
subyacente al tema seleccionado.
Para hacer que los caracteres internacionales aparecen en Ad Hoc etiquetas visin de campo, utilizan el mecanismo de
paquete de recursos:
1. Crear un paquete de recursos (* .properties) y asociar cada uno de su etiqueta de campo con una clave nica. Uso
Secuencias de escape Unicode como \ U0153 para el personaje: para insertar caracteres internacionales en su etiqueta
valores.
2.
Utilice la sintaxis $ R en el tema para especificar la tecla adecuada para la etiqueta de cada campo deseado.
3.
Sube el paquete de recursos como un recurso del Tema.
Al abrir el tema en el Editor de Ad Hoc, las etiquetas se muestran correctamente en el paquete de recursos.
Este mtodo tiene la ventaja de que se puede crear un paquete de recursos para cada idioma que el tema tiene que
apoyo, y los usuarios ver las etiquetas para la configuracin regional que se establecen en su navegador.
Para obtener ms informacin acerca de la localizacin de JasperReports Server, consulte "Localizacin" en
la pgina 253.
A.5 Ad Hoc de filtro con todos los valores que causan error
Al utilizar filtros en el editor de Ad Hoc, su navegador enva listas de valores para el servidor con una operacin POST.
Si filtra un campo con decenas o cientos de miles de valores distintos, y luego selecciona todos los valores, su
navegador enviar megabytes de datos en la operacin POST. Algunos servidores de aplicaciones estn configurados para
rechazar
tan grande de entrada por defecto.
Por ejemplo, si selecciona 100 000 valores en un filtro especial en una instalacin predeterminada en Tomcat, Tomcat
registrar un error y redirigir al usuario a la pgina principal de JasperReports Server. El registro de errores Tomcat puede
contener el
siguiente entrada:
2013-09-30 15: 12: 33,847 ERROR errorPage_jsp, http-8080-6: 559 - seguimiento de la pila de
excepcin que redirige a errorPage.jsp
java.lang.NullPointerException
Si aplica filtros para campos con un gran nmero de valores distintos, asegrese de que su servidor de aplicaciones est
configurado para
aceptar gran entrada. La siguiente tabla muestra cmo configurar Apache Tomcat. Para otros servidores de aplicaciones,
consulte
la documentacin de su servidor de aplicaciones sobre las operaciones POST.
Configure Apache Tomcat para aceptar grandes valores de filtro
<Tomcat> /conf/server.xml
243

Propiedad
Descripcin
<Port = protocolo de conectores "8080" = "HTTP / 1.1"

connectionTimeout = "20000"
redirectPort = "8443"
URIEncoding = "UTF-8"
MaxPostSize = "0" />
Aadir la MaxPostSize parmetro para ajustar el nmero de

bytes aceptado por el servidor de aplicaciones; "0" indica que hay
no hay lmite. Para obtener ms informacin, consulte la Tomcat
documentacin.
A.6 Ad Hoc dimensiones demasiado grandes

Una dimensin de la columna o fila en una tabla de referencias cruzadas Ad Hoc es el equivalente de un grupo de filas en una
tabla especial. El
miembros de una dimensin o grupo son los valores nicos que se utilizan para agregar los datos. Algunas dimensiones y grupos
puede tener cientos o miles de miembros. Aun cuando se derrumbaron las dimensiones, el motor interno debe
calcular y almacenar los valores para todos los miembros de la dimensin y todas las clulas.
Algunas bases de datos contienen los campos que hacen enormes dimensiones del orden de decenas de miles o cientos de
miles de miembros. Estos campos estn destinados generalmente a filtrar, pero si se insertan en la tabla de referencias cruzadas
antes de filtrar o por accidente, van a desencadenar una gran operacin de base de datos y una gran carga de procesamiento en
el anuncio
Editor Hoc. Para limitar este impacto, se puede configurar un lmite en el nmero de miembros en cualquier dimensin.
El proceso interno que calcula grupos, dimensin, y los miembros se llama el categorizador. Cambie el
siguiente configuracin para reducir este lmite y evitar problemas de rendimiento con grandes dimensiones de
cardinalidad.
La reduccin del lmite de tamao para Ad Hoc Dimensiones
... / WEB-INF / applicationContext-catFactory.xml
Propiedad
Frijol
Descripcin
maxMembers
baseCategorizer
Por defecto, el lmite se establece en 100.000 miembros por

dimensin. Cuando se alcanza el lmite, todos los dems
miembros se agrupan en un miembro denominado "Otros".
Establezca esta propiedad en un valor ms bajo en base a su
datos tpicos y redaccin de informes.
Adems, las dimensiones y los grupos pueden estar anidados en varios niveles, por ejemplo, Pas, Provincia y Ciudad. Si
sus datos fila tiene 100 pases, y cada pas tiene 10 provincias y cada provincia cuenta con 10 ciudades,
habr 100 x 10 x 10 = 10.000 filas en la tabla cruzada completa. Si usted tambin tiene dos dimensiones columna, cada
con 10 miembros, habr 100 columnas en la tabla de referencias cruzadas y un milln de clulas cuando todas las dimensiones
son
completamente expandido. Este escenario tiene varias implicaciones:
244
Dimensiones anidadas y dimensiones altas de cardinalidad crear rpidamente grandes tablas de

referencias cruzadas.
Enormes tablas cruzadas tienen un impacto en el rendimiento y toman mucho tiempo para mostrar y
actualizar.
Considere si es posible para los usuarios leer e interpretar en realidad una gran tabla de referencias
cruzadas tal.
Evite dimensiones con ms de 10 miembros y evitar la anidacin muchos niveles en cada eje.
Utilice filtros como controles de entrada en lugar de su escondite y dimensiones en expansin en la tabla
de referencias cruzadas.
Por ejemplo, es poco probable que un usuario puede leer los datos ampliado para ms de un pas a la vez. La gran
informe en este ejemplo puede ser reemplazado con dos informes, uno que slo tiene la dimensin y permite que el pas
usuario comparar los valores agregados de todos los pases, y otro que muestra todas las provincias y ciudades para un
solo pas seleccionado de una lista de filtro desplegable. Ambos informes se ejecutar mucho ms rpido que el nico informe
general,
y el usuario no se bloquear esperando el informe para actualizar.
A.7 URLs personalizados No se cargan en Dashboards

Dashboards permiten especificar los marcos que contienen las pginas web cargadas desde URLs personalizados
especificados cuando
el diseo del salpicadero. Estas direcciones URL pueden incluso incluir parmetros de los controles de entrada. Sin embargo,
si la URL
toma
demasiado
tiempo
para cargar,
Server
mostrar
un10
mensaje
de error
en cambiar
lugar delelcontenido.
Si usted
espera que
la direccin
URL JasperReports
personalizada para
tomar
ms de
segundos,
puede
tiempo de espera
predeterminado de la siguiente manera:
Configuracin del cuadro de mandos URL Cargando Tiempo de
espera
... / scripts / dashboard.designer.js
Propiedad
Descripcin
CUSTOM_URL_IFRAME_TIMEOUT
Tiempo en milisegundos que el servidor permitir una costumbre

URL para cargar en un tablero de instrumentos antes de mostrar un error.
El valor surte efecto inmediatamente cuando se guarda el archivo,
no hay necesidad de reiniciar el servidor.
A.8 Imprimir No Viendo en Dashboards

Si no puede visualizar la vista de impresin de un cuadro de mandos, puede haber un problema con el tamao del control de
entrada
valores. Los valores de control de entrada se pasan como parmetros de la URL de esta pgina, y el servidor de aplicaciones
pueden limitar la
longitud
de este
la direccin
queun
incluye
los parmetros.
Para
evitar
lmite y URL
permitir
gran nmero
de valores de control de entrada en la vista de impresin salpicadero, edite la
siguiente
archivo de configuracin, o su equivalente en el servidor de aplicaciones.
<Tomcat> /conf/server.xml
Propiedad
Descripcin
<Port = protocolo de conectores "8080" = "HTTP / 1.1"

connectionTimeout = "20000"
redirectPort = "8443"
MaxPostSize = "0"
maxHttpHeaderSize = 65535 />
Aadir la maxHttpHeaderSize parmetro para ajustar el

nmero de bytes aceptados en la URL por el servidor de aplicaciones;
"65535" equivale a 64 KB. Para obtener ms informacin, consulte
la Documentacin de Tomcat.
245
Programador A.9 Enviar varios mensajes de correo

electrnico
En caso de que usted tiene un clster de instancias JasperReports Server accedan al mismo repositorio, los programadores
en cada caso, a veces pueden entrar en conflicto y enviar varios mensajes de correo electrnico. El comportamiento depende del
tiempo de ejecucin de la
informes estn planificados, debido a que un informe largo puede causar el programador en otro nodo para tratar de ejecutar el
mismo informe antes de que finalice la primera nodo.
Para cambiar este comportamiento, establezca el siguiente parmetro en <WAR-file> /WEBINF/js.quartz.base.properties:
org.quartz.jobStore.clusterCheckinInterval = 900000
En caso de que un trabajo falla en el primer nodo, el intervalo de registro de entrada est destinada a garantizar que el trabajo
se ejecute en un segundo nodo
despus de este retraso. Debido a que los programadores no se comunican directamente, el segundo planificador no puede
distinguir
entre un nodo que tena un fracaso y un nodo que todava se est ejecutando un trabajo. El valor predeterminado se
corresponde con 15
Este
parmetro se puede ajustar de la siguiente
minutos.
manera:
Si ha programado los informes que tardan mucho tiempo en ejecutarse, ms de 15 minutos, es posible que vea mltiple
mensajes de correo electrnico. Aumentar este parmetro en un intervalo ms largo de lo esperado de tiempo de ejecucin
de su informe ms largo.
Por otro lado, si usted tiene pequeos informes que terminan rpidamente, el valor por defecto significa que cualquier
programador
o problema de nodo no es detectado por el otro planificador antes de 15 minutos. Si tiene informes de tiempo crtico
programada, puede reducir este parmetro, pero el valor debe todava superar su esperado informe ms largo Ejecutartiempo.
Reinicie todas las instancias del servidor despus de cambiar este parmetro.
Programador A.10 Correr Tareas eliminadas

En algunos casos, las versiones antiguas de JasperReports servidor no eliminar los trabajos programados al eliminar un
informe.
Estos trabajos provocan errores cuando el planificador intenta ejecutarlos, pero no se puede quitar los puestos de trabajo a
travs del usuario
interfaz. El servidor ya no crea estos puestos de trabajo "hurfanos", pero puede aparecer de nuevo cuando se actualiza o
importar un catlogo que los contiene.
Si ha importado accidentalmente trabajos hurfanos, hacer cambio de configuracin se muestra a continuacin y reinicie el
servidor.
Eliminacin automtica de Orphan Jobs
... / WEB-INF / applicationContext-report-scheduling.xml
246
Entrada
Frijol
Descripcin
autoDeleteBroken
UriReportJob
cuarzo
Programador
Si su repositorio tiene trabajos hurfanos que causan errores,

cambiar esta propiedad de falsa (El predeterminado) a
verdadera. Se detectan y eliminan slo empleos hurfanos
antes de que funcionen, por lo que se eliminarn todos los trabajos
hurfanos
gradualmente con el tiempo.
A.11 Grficos que no aparece en Excel de Exportacin

Al exportar un informe a Excel, JasperReports servidor normalmente elimina las imgenes que decoran el informe y que
no encajan en el diseo centrado en los datos de Excel. Sin embargo, JasperReports Server tambin convierte cualquier grficos
a las imgenes y
utiliza la propiedad especial net.sf.jasperreports.export.xls.ignore.graphics ajustado a falsa para hacer que el
aparece imagen. Si el informe no establece esta propiedad explcitamente, las imgenes de grfico qu no aparecen en sus
informes
cuando se exportan a Excel.
Si usted tiene una gran cantidad de informes con este problema, puede establecer la propiedad
en el servidor:
Cuadros de Imgenes en Excel Exportacin
Propiedad
Descripcin
export.xls.ignore.graphics
De forma predeterminada, esta propiedad se establece en verdadera; en

este caso, las imgenes
y las imgenes de grficos del informe no aparecen cuando
exportados a Excel. Establezca esta propiedad falsa para hacer tabla
las imgenes aparecen en las exportaciones de Excel.
Trabajo fuentes de datos con A.12

Al agregar un origen de datos para JasperReports Server, hay varias reas que pueden causar errores. Echen un vistazo
en los siguientes problemas de conectividad en general:
Compruebe que el servidor de base de datos es las conexiones TCP / IP disponibles y aceptar desde el host en el
Est instalado JasperReports Server.
Compruebe en su RDBMS que el nombre de usuario y la contrasea que utiliza son correctos y tener acceso a la
base de datos seleccionada.
Compruebe que los servidores de seguridad o errores de conectividad de red.
Muchas bases de datos, incluyendo MySQL, tambin requieren el usuario concede a incluir el host especfico a partir del cual
se permiten conexiones. De lo contrario, al probar la conexin JDBC, una conexin no puede permitirse siquiera
aunque el nombre de usuario y la contrasea son correctos. Para obtener ms informacin, consulte la Documentacin de
MySQL
la configuracin de usuarios.
Una manera fcil para probar la conectividad desde el servidor a la base de datos con un usuario particular es el uso de una
herramienta como
SQuirreL u otra herramienta de consulta de base de datos para conectarse a la base de datos desde la misma mquina que el
servidor JasperReports
instancia.
A.12.1
Registro de Operaciones de JDBC

Puede habilitar el registro adicional para ayudar a encontrar la causa del error. Establezca cualquiera o todos los
siguientes
los madereros en la interfaz de configuracin del servidor o en el archivo ... / WEB-INF / log4j.properties:
log4j.logger.com.jaspersoft.jasperserver.api.engine.jasperreports.service.impl.JdbcDataSourceService
log4j.logger.com.jaspersoft.jasperserver.api.engine.jasperreports.service.impl.
JndiJdbcDataSourceService
log4j.logger.com.jaspersoft.jasperserver.war.action.ReportDataSourceAction
247
A.12.2
log4j.logger.com.jaspersoft.commons.datarator.JdbcDataSet
log4j.logger.com.jaspersoft.jasperserver.war.common.JasperServerUtil
log4j.logger.com.jaspersoft.commons.semantic.dsimpl.JdbcDataSetFactory
log4j.logger.com.jaspersoft.commons.semantic.metaapi.impl.jdbc.BaseJdbcMetaDataFactoryImpl
log4j.logger.com.jaspersoft.jasperserver.war.validation.ReportDataSourceValidator
Controladores JDBC
A partir de JasperReports Server 5.1, la gestin de controlador JDBC se automatiza y simplifica. JasperReports Servidor
se entrega con controladores para algunas bases de datos, que figuran en el cuadro de dilogo para la creacin de fuentes de
datos. Si el controlador JDBC para
su base de datos no est incluido, el administrador del sistema puede cargar fcilmente el controlador y utilizarlo
inmediatamente en un
fuente de datos.
Para obtener instrucciones sobre la actualizacin de drivers JDBC sin necesidad de reiniciar el servidor, consulte
"Controladores de Gestin de JDBC" en la
pgina 68. Para obtener instrucciones sobre cmo agregar controladores JDBC cuando se utiliza JBoss, consulte la siguiente
seccin.
A.12.3
Controladores JDBC en JBoss

Por razones de modularidad, el servidor de aplicaciones JBoss no permite que las aplicaciones web tales como JasperReports
Servidor para cambiar los archivos ejecutables, tales como controladores JDBC, sobre la marcha. A fin de que los controladores
JDBC que aparezcan en el
lista de los controladores disponibles y se puedan seleccionar, debe configurar JBoss antes de utilizar los controladores para
crear un JDBC
fuente de datos.
Para agregar controladores JDBC en JBoss:
1. Descargar o copiar el archivo JAR del controlador JDBC al directorio / ... WEB-INF / lib /.
2.
Editar el archivo jboss-despliegue-structure.xml como se describe en la siguiente tabla:

Configuracin de JBoss para controladores JDBC
... / META-INF / jboss-despliegue-structure.xml
3.
A.12.4
Propiedad
Descripcin
ruta del recurso-root = "<controlador> .jar"
Busque el elemento raz de los recursos para el controlador JDBC que

aadido y descomentar. El nombre del archivo JAR debe
coincidir exactamente con el nombre del controlador JDBC que
cargar. Puede agregar un nuevo elemento raz de recursos si el
Controlador JDBC de su eleccin no se da en el comentado
lista.
Reinicie JBoss.
Permisos de bases de datos

Al crear los usuarios de bases de datos, debe asegurarse de tener los privilegios adecuados para acceder a los datos, as
como un permiso para conectarse desde el servidor JasperReports Server se ejecuta en.
248
El usuario de base de datos que especifique en su definicin de origen de datos debe tener el select apropiada
Permisos para consultar las tablas dentro de la base de datos para los informes que desea generar.
Si acepta los valores por defecto durante la instalacin de JasperReports Server en Linux desde un RPM usando apt-get,
rpm, o yum, el PostgreSQL integrado slo permite que el usuario que es dueo de PostgreSQL para conectarse.
Introduzca el
siguientes comandos para conectar:
su - postgres
psql -U postgres
Muchas bases de datos, incluyendo MySQL, tambin requieren que los permisos de usuario Nombre de host especfico
desde
que se permiten conexiones. De lo contrario, al probar la conexin JDBC, una conexin puede no ser
permitido a pesar de que el nombre de usuario y la contrasea son correctos. Por ejemplo, vase la Documentacin de
MySQL
para la configuracin de usuarios.
Una manera bastante fcil de probar los permisos y la conectividad es utilizar una herramienta como SquirrelSQL u otra consulta
DB
herramienta para conectarse a la base de datos desde el mismo host que JasperReports Server y al ejecutar consultas tpicas
contra
su base de datos.
A.12.5
JDBC URL de base de datos

Cuando usted elige un driver JDBC, el asistente de creacin de fuente de datos que solicita los elementos de la direccin URL
que
son necesarios para su base de datos. En algunos casos, puede que tenga que aadir algunos argumentos de la URL JDBC.
Asegurar
que la base de datos de URL que ha introducido al definir el origen de datos JDBC es consistente con lo que se requiere para
el controlador especfico de base de datos y base de datos. La siguiente tabla muestra las direcciones URL predeterminadas y
nmeros de puerto, como
as como ejemplos de argumentos opcionales soportados por las bases de datos ms comunes:
Base de datos
Por defecto JDBC URL base de datos
PostgreSQL
jdbc: postgresql: // <host>: 5432 / <db-name>
MySQL y MariaDB
jdbc: mysql: // <host>: 3306 / <db-name> useUnicode = true y characterEncoding = UTF-8?
Ingres
jdbc: ingres: // <host>: II7 / <db-name>; CURSOR = READONLY; auto = multi
Oracle
jdbc: oracle: thin: @ <host>: 1521: ORCL
SQL Server
jdbc: sqlserver: // <host>: 1433; nombredebasededatos = <db-name>; SelectMethod = cursor
JTDS SQL Server

conductor
jdbc: jtds: sqlserver: // <host>: 1433 / <db-name>
DB2
jdbc: db2: // <host>: 50000 / <db-name>: driverType = 4; currentSchema = <schemanombre>; fullyMaterializeLobData = true; fullyMaterializeInputStreams = true;
progressiveStreaming = 2; progresssiveLocators = 2
Vertica
jdbc: vertica: // <host>: 5433 / <db-name>
Informix
jdbc: informix-sqli: // <host>: 1526 / <db-name>: INFORMIXSERVER = <nombre-servidor>
Vertica
jdbc: sybase: Tds: <host>:? 5433 ServiceName = <service-name>
249
A.12.6
Servicios JNDI en Apache Tomcat

Si tiene problemas con una conexin JNDI, es necesario mirar a la definicin JNDI para su base de datos en su
servidor de aplicaciones. Esta seccin da problemas comunes con definiciones JNDI en Apache Tomcat conectarse a
MySQL. Si utiliza un servidor de aplicaciones o servidor de base de datos diferente, consulte su documentacin.
Una conexin JNDI en Tomcat se define en dos archivos diferentes. Asegrese de que ambos tienen la siguiente informacin:
<Tomcat> / webapps / JasperServer [-pro] /META-INF/context.xml

<Recursos name = "jdbc / <db-name>" auth = tipo "Container" = "javax.sql.DataSource"
maxActive = "100" maxIdle = "30" maxWait = "10000"
nombre de usuario = "<db-usuario>" password = "<db-user-password>"
driverClassName = "org.postgresql.Driver"
validationQuery = "SELECT 1" testOnBorrow = "true"
url = "jdbc: mysql: // <host>: 3306 / <base de datos> autoReconnect = true & amp; autoReconnect?
ForPools = true "/>
<Tomcat> /webapps/jasperserver-pro/WEB-INF/web.xml
<Resource-ref>
<Descripcin> JNDI Ejemplo </ description>
<Res-ref-name> jdbc / <db-name> </ res-ref-name>
<Res-type> <res-type /> javax.sql.DataSource
<Res-auth> Container </ res-auth>
</ Resource-ref>
Tambin puedes ver los siguientes puntos:
Asegrese de que el controlador para su conexin a la base de datos se encuentra en el <tomcat> carpeta / lib.
Si ha instalado JasperServer de un archivo WAR, Tomcat puede haber creado una copia separada de context.xml en
<Tomcat> /conf/Catalina/Localhost/jasperserver-pro.xml. Vea la seccin correspondiente en el
Solucin de problemas Apndice del Gua de instalacin del servidor JasperReports.
Consulte la Documentacin de Apache Tomcat para fuentes de datos JNDI.
A.12.7
Servicios JNDI de JBoss

Despus de definir servicios JNDI en el servidor de aplicaciones JBoss, JasperReports Server no detecta automticamente
los nuevos servicios. Para utilizar los nuevos servicios JNDI como fuentes de datos en el servidor, siga estos pasos:
1.
2.
Definir e implementar una fuente de datos JNDI en la consola de administrador de

JBoss.
Modificar el archivo <jboss> /webapps/jasperserver-pro/WEB-INF/web.xml para incluir una referencia a la fuente de datos
este nuevo servicio JNDI.
3.
Modificar jboss-web.xml para incluir una referencia a esta fuente de datos.
4.
Debido a que los archivos de configuracin de implementacin tales como web.xml se modificaron, redistribuir los
JasperReports
Aplicacin de servidor.
Ahora puede definir la fuente de datos JNDI en el repositorio, como se describe en "Fuentes de datos JNDI" en la pgina 71.
A.12.8
Servicios JNDI en WebLogic

Siga estos pasos para configurar JasperReports Server para utilizar fuentes de datos JNDI con WebLogic:
1.
250
Aada la siguiente definicin a la <Referencia descriptor> nodo WEB-INF / weblogic.xml:
<Resource-description>
<Res-ref-name> TestDatabase </ res-ref-name>
<Jndi-name> jdbc / TestDatabase </ jndi-name>
</ Resource-description>
2.
Aada la siguiente definicin de WEB-INF / web.xml:
<Resource-ref>
<Descripcin> Base de datos TestDatabase </ description>
<Res-ref-name> TestDatabase </ res-ref-name>
<Res-type> <res-type /> javax.sql.DataSource
<Res-auth> Container </ res-auth>
</ Resource-ref>
3.
4.
A.12.9
En la consola de administracin de WebLogic, agregar un origen de datos con TestDatabase como el

nombre JNDI.
Reinicie la instancia-JasperServer pro utilizando la consola de administracin de
WebLogic.
Creacin de un origen de datos en SQL Server mediante la autenticacin de Windows

Si su base de datos es Microsoft SQL Server y se utiliza la autenticacin de Windows (tambin denominada seguridad
integrada),
utilizar el siguiente procedimiento para crear una fuente de datos.
1. Ir a la descargar pgina para Microsoft SQL Server JDBC Driver 3.0.
No utilice la versin 4.0 de este controlador, ya que no va a funcionar.
2.
Descargue y ejecute el archivo ejecutable de extraccin: 1033 \ sqljdbc_3.0.1301.101_enu.exe
3.
Abra la carpeta extrada sqljdbc_3.0 \ enu \ auth, y luego o bien la x64 o la subcarpeta x86, dependiendo de
si su versin de Windows de 64 bits o de 32 bits, respectivamente.
4.
Copie el sqljdbc_auth.dll archivo a la carpeta de que su servidor de aplicaciones busca automticamente

archivos DLL.
Para Tomcat, este es el <tomcat> \ bin.
5.
6.
Reinicie el servidor de
aplicaciones.
Acceda a JasperReports Server como administrador y.
7.
8.
9.
JDBC.
Escriba un nombre y una descripcin opcional para el origen de datos.
10 En el campo desplegable, seleccione com.microsoft.sqlserver.jdbc.SQLServerDriver

11 Escriba el nombre de host de base de datos y el nombre de la base de datos de la instancia
de SQL Server.
12 En el campo URL, aada la siguiente cadena al final del URL generada:
; IntegratedSecurity = true
13 En el campo Nombre de usuario, escriba cualquier cadena no est en blanco que desee, por
ejemplo, "ninguno".
14 En el campo Contrasea, escriba cualquier cadena no est en blanco que desee, por ejemplo,
"ninguno".
15 Configure los campos de la zona horaria y Guardar ubicacin si es
necesario.
16 Haga clic en Prueba de conexin y verifique que la conexin funciona.
17 Haga clic en Guardar para salvar la fuente de datos en el
repositorio.
251
A.13 Hadoop Hive-Reports no se ejecuta

Si ha creado una fuente de datos Hadoop Hive-antes en JasperReports servidor 5.6 o anterior, puede no funcionar cuando
importado a una versin ms reciente del servidor, por ejemplo despus de una actualizacin. La razn es debido a la
cambios en los conectores Hadoop-Hive.
Para actualizar las fuentes de datos Hadoop-Hive:
1. Crear un nuevo origen de datos Hive utilizando la misma URL que la antigua fuente de datos Hadoop Hive-utilizado por su
informes. Si usted est usando Cloudera 5, crear una fuente de datos CDH 5 Hive-Impala. Para todos los dems
servidores de la colmena,
crear una fuente de datos JDBC que utiliza el controlador JDBC Hive. Para obtener instrucciones, consulte "Hadoop HiveData
Fuentes "en la pgina 78.
2. Actualice sus informes basados en Hadoop Hive-para utilizar la nueva fuente de
datos.
3. Eliminar la vieja fuente de datos importados,.
A.14 Volviendo a la pgina inicial Antiguo

JasperReports Server 5.5 introduce una nueva pgina de inicio con ms funcionalidad y el acceso a ms caractersticas en la
servidor. Si la instalacin o personalizaciones requieren la pgina principal viejo con los botones grandes, puede especificar
que el servidor utilice la pgina de inicio de edad.
1.
Abra el <js-webapp> file /WEB-INF/flows/homeFlow.xml.
2.
Busque la siguiente lnea:

<Vista de estado id = "Homeview" vista = "mdulos / home / home">
3.
Sustituya el valor vista como se muestra en el siguiente ejemplo:

<Vista de estado id = view "Homeview" = "mdulos / old_home / home">
4.
252
Reinicie el servidor o volver a implementar la aplicacin web JasperReports

Server.
ANEXO B LOCALIZACIN
De forma predeterminada, JasperReports Server se presenta en el idioma Ingls (versin estadounidense), pero es compatible
con otros
idiomas, as, con traducciones que incluyen formatos de datos y paquetes de recursos. Los idiomas soportados
son el portugus de Brasil, chino (simplificado), francs, alemn, italiano, japons y espaol. Las traducciones
estn incluidos en la instancia de JasperReports servidor por defecto; ver la aplicacin en un lugar especfico, seleccione
antes de iniciar la sesin.
Si usted necesita para apoyar un idioma que no sea apoyado a los queridos, usted puede localizar JasperReports Server,
incluyendo la traduccin a un idioma diferente al proporcionar etiquetas y los mensajes en el idioma preferido. Para
otros lugares, es posible que tambin tenga que cambiar la configuracin regional predeterminada y la zona horaria. En este
captulo se describe la
procedimientos y unos pocos ejemplos.
Para obtener informacin sobre la localizacin de Dominios, temas, y los informes, consulte la Gua del usuario de
B.1
Configuracin del servidor JasperReports para Multi-byte Fuentes

UTF-8 Configuracin
Cambio de codificacin de caracteres
Creacin de una configuracin regional
Configuracin de JasperReports servidores que ofrece una
configuracin regional
Configuracin del servidor JasperReports para Multi-byte Fuentes

Aunque los paquetes de traduccin para barco chino y japons con JasperReports Server, los tipos de letra que utiliza por
por defecto no son compatibles con estos idiomas. Por lo tanto, si su organizacin requiere de esas fuentes, es necesario
configurar JasperReports Server para ellos.
Mientras que las fuentes que utiliza JasperReports Server se dictan generalmente por los archivos JRXML que definen su
informes, se requiere un poco de configuracin de fuentes para circunstancias especiales. Por ejemplo, puede configurar
Jaspersoft
OLAP para ofrecer diferentes opciones en el Grfico fuente predeterminada campo en el cuadro de dilogo Opciones de grfico.
Pero tenga en cuenta que, en
Para utilizar un tipo de letra, la fuente debe estar disponible para el sistema operativo del host. En esta seccin se describen los
pasos que
Las
tareas
estaque
seccin
que editar
estos archivos:
puede
que de
tenga
tomar,requieren
dependiendo
de la funcionalidad
que utiliza y las locales que apoya.
253
B.1.1
Nombre del archivo
Ubicacin
Propsito de ediciones
jpivot_internal_messages.properties
WEB-INF / interna
Especificacin de las fuentes de carta para Jaspersoft

OLAP
Comunidad
Ja_pro_internal_messages.properties
WEB-INF / interna
Especificacin de las fuentes de carta para Jaspersoft

OLAP
Profesional y Empresa
userConfig.xml
WEB-INF / JPivot / impresin La incrustacin de fuentes en PDF
Activacin de fuentes asiticas del

este
La configuracin por defecto de Java Runtime Environment (JRE) no admite fuentes de Asia Oriental. Si su
locale requiere una fuente, por lo que necesita para configurar equipos de los usuarios de las fuentes y actualizar su JRE.
Para configurar un equipo con Microsoft Windows (XP y versiones posteriores) para las fuentes de Asia
Oriental:
Los detalles de este procedimiento varan, dependiendo de su versin de Windows.
1.
En el Panel de control, haga clic en Regional y de idioma.
2.
3.
En el dilogo regional y de idioma, seleccione la Teclados e idiomas tab.

En la ficha, instalar el idioma (s) que usted necesita.
4.
Si es necesario, instale las modificaciones de teclado relacionados.
5.
Cierre el panel de control.
6.
Busque el archivo fontconfig.properties.src en el directorio C: \ Archivos de programa \

<JRE_DIRECTORY> \ lib.
En el archivo, busque la siguiente lnea:
7.
sequence.allfonts = alfabtico / default, dingbats, smbolo
8.
Cambie la lnea para incluir las fuentes de Asia Oriental que usted necesita, tales como los
siguientes:
sequence.allfonts = alfabtico / default, dingbats, smbolo, coreano, japons, chinoms936, chino-MS950
9.
Al final del archivo, revise para asegurarse de que las fuentes que ha seleccionado se enumeran, como en el
siguiente:
filename.Gulim = gulim.TTC
Si las fuentes no aparecen, agregarlos.

10. Guarde y cierre el archivo.
11 Cambie el nombre del archivo a fontconfig.properties
B.1.2
Configuracin de Grficos Ad Hoc para fuentes

asiticas
La fuente predeterminada para la leyenda de un grfico Ad Hoc no admite algunos caracteres asiticos, como el japons
glifos kana. Fuentes predeterminadas para informes ad hoc se definen en el archivo siguiente:
254
Cambiar Hoc Ad Grfico Leyenda Fuentes

... / WEB-INF / adhoc / themes / default.new.jrxml
Propiedad
Valor
Descripcin
Nombre style =
"ChartLegend"
fontName =
"Sans DejaVu"
<Default>
El valor por defecto, DejaVu Sans, no

incluir glifos kana, y por lo tanto la leyenda
contiene smbolos en blanco.
"SansSerif"
Si la mquina servidor tiene sistema japons

fuentes disponibles, estableciendo el valor a SansSerif
debera funcionar en la mayora de las configuraciones de
fuente de Java.
Despus de realizar cambios en el archivo default.new.jrxml, debe volver a ejecutar todos los informes ad hoc que
contienen
Caracteres japoneses para que aparezcan.
Si las fuentes japonesas no se instalan en la mquina del servidor, puedes aadir la siguiente manera:
1.
2.
3.
4.
5.
B.1.3
Empaquetar una fuente japonesa como una extensin JAR

fuente.
Aadir el nuevo JAR a la carpeta / lib WEB-INF del archivo WAR del servidor JasperReports.
Editar el archivo default.new.jrxml como se describe ms arriba para especificar el nuevo
nombre de la fuente.
Vuelva a implementar JasperReports Server o reinicie su servidor
de aplicaciones.
Vuelva a ejecutar los informes afectados. Los informes guardados desde Ad Hoc debera mostrar ahora correctamente en
el Visor de informes,
pero la vista correspondiente no puede mostrar las leyendas del grfico correctamente dentro del editor de Ad Hoc.
Configuracin de las opciones de OLAP para grficos por

defecto Fuentes
Si implementa Jaspersoft OLAP y apoya a un escenario con los requisitos del tipo de letra especiales, puede configurar
Jaspersoft OLAP para ofrecer diferentes opciones en el Grfico fuente predeterminada campo en el cuadro de dilogo
Opciones de grfico del
Vista OLAP. Esto puede ser necesario si se implementa locales que Amrica 1 no admite.
De dilogo Opciones de grfico de una vista OLAP incluye la Grfico fuente predeterminada campo, lo que permite a los
usuarios seleccionar el
letra a utilizar en los grficos. Las opciones por defecto son SansSerif, Serif, y Monospaced. JasperReports Server lee estos
valores de un archivo de propiedades y los intentos de asignarlos a las fuentes disponibles en el sistema operativo del host del
servidor.
Puede configurar el servidor para ofrecer diferentes tipos de letra, si estas fuentes no son compatibles con las locales que
implementan.
Para cambiar las opciones del campo de fuente por defecto grfico:
1. Guarde el archivo jpivot_internal_messages.properties con un nuevo nombre que refleja la nueva configuracin regional. Por
ejemplo,
para el japons, el nuevo archivo se llamara jpivot_internal_messages_ja.properties.
2. Abra el nuevo archivo y busque las siguientes claves:
JAJ_000_jsp.jpivot.chartpropertiesform.sansSerif = SansSerif
JAJ_000_jsp.jpivot.chartpropertiesform.serif = Serif
JAJ_000_jsp.jpivot.chartpropertiesform.monospaced = Monospaced
255
Si est utilizando Jaspersoft OLAP Community Edition, el nombre del archivo y las claves que se editan son
diferente. Para la Edicin Comunidad, abrir el archivo jpivot_internal_message.properties y editar estos
teclas:
jsp.wcf.chart.sansserif = SansSerif
jsp.wcf.chart.serif = Serif
jsp.wcf.chart.monospaced = Monospaced
3.
Cambie una o ms de las cadenas al nombre de una fuente disponible en el sistema operativo del host. Para
ejemplo, si usted quiere cambiar la fuente SansSerif a la fuente SimHei, edite el valor especificado por
jsp.wcf.chart.sansserif. Por ejemplo:
jsp.wcf.chart.sansserif = SimHei
B.1.4
4.
Guarde el archivo.
5.
Reinicie JasperReports Server.
La incrustacin de fuentes en PDF de

salida
De forma predeterminada, JasperReports Server puede crear PDF (Portable Document Format) archivos con muchos
diferentes
fuentes. Sin embargo, si usted experimenta problemas de fuentes en el PDF de salida de sus informes, es posible que tenga
que tomar
los pasos que se describen en esta seccin para que las fuentes disponibles para formateo XSL de JasperReports Servidor
Objeto (XSL-FO) del procesador.
Debe tener derechos de distribucin de una fuente para poder insertar en un archivo PDF.
Cuando los usuarios guardar informes en formato PDF, JasperReports Server genera la salida PDF usando Apache FOP
(Formato Objetos procesador). Para FOP presenten las letras correctamente, debe instalar la propia fuente (por
ejemplo, un archivo TTF) en el host del servidor, crear un archivo de medidas de fuente (usando Apache de
org.apache.fop.fonts.apps.TTFReader utilidad), y actualizar el archivo userConfig.xml asociar la fuente
con sus mtricas. Para obtener ms informacin, consulte la Documentacin de Apache FOP.
Puede incrustar cualquier fuente Unicode utilizando este procedimiento, aunque ficheros ms grandes pueden tener
significativamente ms grande
capacidad de memoria. Con el fin de mantener los requisitos de memoria pequea, Jaspersoft recomienda que utilice la ms
pequea
archivo de fuente que puede, como SimHei para apoyar el chino, japons y coreano.
B.2
UTF-8 Configuracin
JasperReports Serveruses UTF-8 (8-bit Unicode Transformation Format) codificacin de caracteres. Si su base de datos
servidor o servidor de aplicaciones utiliza una forma de codificacin de caracteres diferente, puede que tenga que configurarlos
para apoyar
UTF-8. En esta seccin se proporciona informacin para configurar la codificacin de caracteres para varios servidores de
aplicaciones
y servidores de bases de datos. Si utiliza un servidor de aplicaciones distinto o base de datos, y su codificacin de caracteres por
defecto no es
UTF-8, puede que tenga que hacer cambios similares para apoyar a ciertos lugares. Para obtener ms informacin, consulte la
documentacin de su servidor de aplicaciones o de bases de datos.
B.2.1
Tomcat
Por defecto, Tomcat utiliza ISO-8859-1 (ISO Latin 1) codificacin de caracteres para los URI, que es suficiente para Western
Entornos nacionales europeos, pero no es compatible con muchos locales en otras partes del mundo.
256
Si va a admitir configuraciones regionales que Amrica 1 no admite, debe cambiar el formato de codificacin URI de Tomcat.
Si elige la instancia de Tomcat que se incluye con el instalador, usted no necesita hacer este
cambiar. El Tomcat incluido est pre-configurado para admitir UTF-8. Si ha instalado la distribucin de archivos WAR
con su propia instancia de Tomcat y quieren apoyar a UTF-8, realice el siguiente procedimiento.
Para configurar Tomcat para apoyar UTF-8:

1. Abra el archivo conf / server.xml y busque el siguiente cdigo:
<! - Definir un no SSL HTTP / 1.1 conector en el puerto 8080 ->
<Connector>
port = "8080" maxHttpHeaderSize = "8192"
MaxThreads = "150" MinSpareThreads = MaxSpareThreads "25" = "75"
enableLookups = redirectPort "false" = "8443" acceptCount = "100"
connectionTimeout = "20000" disableUploadTimeout = "true"
</ Connector>
2.
Al final de esta seccin, inserte la lnea siguiente antes de la etiqueta de cierre:
3.
Por ejemplo, despus de los cambios, la seccin podra ser:
<! - Definir un no SSL HTTP / 1.1 conector en el puerto 8080 ->

<Connector>
port = "8080" maxHttpHeaderSize = "8192"
MaxThreads = "150" MinSpareThreads = MaxSpareThreads "25" = "75"
enableLookups = redirectPort "false" = "8443" acceptCount = "100"
connectionTimeout = "20000" disableUploadTimeout = "true"
</ Connector>
B.2.2
4.
Guarde el archivo.
5.
Reinicie Tomcat.
JBoss
Desde JBoss utiliza Tomcat como su conector Web, los cambios de configuracin en "Tomcat" en la pgina 256) tambin tienen
hacerse para JBoss. La nica diferencia es que el archivo server.xml se encuentra en el despliegue de Tomcat
directorio, normalmente server / default / deploy / jbossweb-tomcat55.sar. Realice los mismos cambios de configuracin, a
continuacin,
reiniciar JBoss.
B.2.3
PostgreSQL
JasperReports Server requiere PostgresSQL utilizar UTF-8 codificacin de caracteres para la base de datos que almacena
su
repositorio, as como para las fuentes de datos. Una forma sencilla de cumplir con el requisito es para crear la base de datos
con una
UTF-8 juego de caracteres. Por ejemplo, escriba el siguiente comando:
crear base de datos de codificacin JasperServer = 'utf8';
257
B.2.4
MySQL
Por defecto, MySQL utiliza la norma ISO-8859-1 (ISO Latin 1) codificacin de caracteres. Sin embargo, JasperReports Server
requiere
MySQL a usar UTF-8 codificacin de caracteres para la base de datos que almacena su repositorio, as como para las fuentes
de datos.
La forma ms sencilla de cumplir con el requisito es crear la base de datos con un conjunto de caracteres UTF-8. Por ejemplo,
introduzca el siguiente comando:
crear base de datos de conjunto de caracteres utf8 JasperServer;
Para apoyar a UTF-8, el controlador JDBC de MySQL tambin requiere que el useUnicode y characterEncoding
parmetros pueden establecer como en esta URL de inicio:
url = "jdbc: mysql: // localhost: 3306 / JasperServer useUnicode = true y characterEncoding = UTF-8"
Si la base de datos MySQL es una fuente de datos JNDI gestionado por Tomcat, como el repositorio del servidor
JasperReports
base de datos, los parmetros se puede agregar a la JDBC URL en WEB-INF / context.xml. La siguiente es una muestra
definicin de recursos de ese archivo:
<Recursos name = "jdbc / JasperServer" auth = tipo "Container" = "javax.sql.DataSource"
nombre de usuario = "root" password = driverClassName "password" = "com.mysql.jdbc.Driver"
url = "jdbc: mysql:? // localhost / JasperServer useUnicode = true & amp; characterEncoding = UTF-8" />
JBoss ignora el archivo context.xml, sino que pide un archivo XML para definir las fuentes de datos JNDI en el despliegue
directorio, que es tpicamente server / default / deploy. El siguiente es un ejemplo de una definicin de recursos en una
de esos archivos XML:
<-Tx-datasource locales>
<Nombre JNDI jdbc / JasperServer />
<Conexin-url>
? jdbc: mysql: // localhost / JasperServer useUnicode = true & amp; characterEncoding = UTF-8
</ Conexin-url>
<Com.mysql.jdbc.Driver clase controlador />
<Nombre de usuario jasperadmin />
<Contrasea jasperadmin />
<Min-pool-size 5 />
<Max-pool-size 20 />
<Idle-timeout minutos 0 />
<Metadatos>
<MySQL tipo de mapeo />
</ Metadata>
</ Local-tx-datasource>
Si la base de datos es una fuente de datos JDBC configurada en el repositorio, cambiar la URL de JDBC mediante la edicin
de los datos
fuente en el repositorio del servidor JasperReports. El siguiente es un ejemplo de la JDBC URL (tenga en cuenta que la
ampersand no se escap):
jdbc: mysql: // localhost: 3306 / foodmart_ja useUnicode = true y characterEncoding = UTF-8
B.2.5
Oracle
Bases de datos Oracle tienen tanto un conjunto de caracteres por defecto y un juego de caracteres nacional que admite
caracteres Unicode.
Tipos de texto que comienzan con N (NCHAR, NVARCHAR2 y NCLOB) utilizan el juego de caracteres nacional. A partir de
JasperServer 1.2, todos los datos de texto utilizados por el repositorio JasperReports Server (cuando se almacena en Oracle) se
almacenan
258
en columnas NVARCHAR2, por lo que los metadatos JasperReports Server puede utilizar el conjunto completo de caracteres
Unicode. Para
ms informacin sobre el soporte de texto Unicode, consulte la Papel blanco Oracle (PDF).
Para trabajar correctamente con los datos Unicode, el controlador Oracle JDBC requiere que establezca una propiedad del
sistema Java
pasando el siguiente argumento a la JVM:
-Doracle.jdbc.defaultNChar = True
En Tomcat, agregar la variable al JAVA_OPTS en bin / setclasspath.sh (Linux) o bin / setclasspath.bat (Windows):
1.
Busque la siguiente lnea del script:
Linux
Ventanas
2.
# Establezca el argumento predeterminado -Djava.endorsed.dirs

rem Establecer el argumento predeterminado -Djava.endorsed.dirs
Agregue la siguiente lnea antes de ella:
Linux
Ventanas
JAVA_OPTS = "$ JAVA_OPTS" -Doracle.jdbc.defaultNChar = true

establecer JAVA_OPTS =% JAVA_OPTS% -Doracle.jdbc.defaultNChar = true
Desde JBoss tambin utiliza JAVA_OPTS pasar opciones a la JVM, puede agregar la misma JAVA_OPTS lnea
bin / run.sh (Linux) y bin / run.bat (Windows). Adelo antes de esta lnea:
Linux
Ventanas
B.3
# Configuracin de los directorios java aprobado

Configuracin rem los dirs java aprobado
Cambio de codificacin de caracteres

Dependiendo del software de terceros que utiliza y los lugares que usted apoya, es posible que tambin tenga que
configurar
JasperReports Server y su husped. Los pasos descritos en esta seccin slo son necesarios en determinadas
circunstancias, como si va a utilizar una forma de codificacin de caracteres UTF-8 que no puede manejar.
Para utilizar una forma de codificacin de caracteres que no sea UTF-8, debe configurar JasperReports Server, su aplicacin
servidor, y el servidor de base de datos.
Las tareas de esta seccin requieren que se modifique el siguiente archivo:
B.3.1
Nombre del archivo
Ubicacin
applicationContext.xml
WEB-INF
Cambiar la codificacin de caracteres
Configuracin del servidor JasperReports

Para configurar JasperReports Server para un formulario de codificacin diferente, debe editar el archivo
applicationContext.xml.
Para especificar una forma de codificacin diferente:
1. Abra el archivo applicationContext.xml y busque la siguiente frijol. Est configurado para UTF-8:
<Bean id = "encodingProvider"
class = "com.jaspersoft.jasperserver.api.common.util.
StaticCharacterEncodingProvider ">
<Valor constructor-arg = "UTF-8" />
</ Bean>
259
2.
Cambiar "UTF-8" para la codificacin escriba su uso del servidor del servidor de base de datos y la aplicacin. Por
ejemplo:
<Bean id = "encodingProvider"
class = "com.jaspersoft.jasperserver.api.common.util.
StaticCharacterEncodingProvider ">
<Valor constructor-arg = "UTF-16" />
</ Bean>
3.
Guarde el archivo.
4.
B.3.2
Configuracin del servidor de base de servidor de aplicaciones y

Si desea utilizar una codificacin de caracteres que no sea UTF-8, puede que tenga que configurar el software de terceros
que JasperReports Server se basa en. Para obtener ms informacin, consulte la documentacin asociada a su
servidor de aplicaciones y el servidor de base de datos. Para Tomcat, puede especificar una codificacin de caracteres diferente
al seguir
pasos similares a los descritos en "Tomcat" en la pgina 256 y "Configuracin de UTF-8" en la pgina 256.
Este paso slo es necesario si va a admitir configuraciones regionales que requiere una codificacin de caracteres diferente,
como UTF-16. Adems de este cambio, el servidor de aplicaciones y base de datos deben estar configurados para utilizar el
codificacin de caracteres que usted requiere. Para obtener ms informacin, consulte la documentacin asociada a su
software de terceros.
B.3.3
Configuracin de Anlisis localizado esquemas

Si va a utilizar las vistas OLAP localizadas, debe tomar pasos adicionales para configurar JasperReports Server.
Para configurar JasperReports Server para vistas OLAP localizadas:
1. base de datos Cada Unicode que JasperReports servidor interacta con (si se trata de la base de datos del repositorio o un
base de datos accesible a travs de una fuente de datos definida en JasperReports Server) debe ser creado para apoyar a
UTF-8.
Por ejemplo, para crear la base de datos Foodmart en PostgreSQL, podra dar una orden similar a la
siguiente:
crear base de datos de codificacin foodmart_ja = 'utf8';
2.
La direccin URL de cualquier fuente de datos OLAP que accesos JasperReports Server deben configurarse
correctamente en el
/ji-pro/META-INF/context.xml archivo. Por ejemplo, la definicin URL de la base de datos de ejemplo Foodmart
podra ser similar a la siguiente:
<Name = "jdbc / MondrianFoodMart_ja"

auth = tipo "Container" = "javax.sql.DataSource"
username = "postgres" password = "postgres" driverClassName = "org.postgresql.Driver"
url = "jdbc: postgresql: // localhost: 5432 / foodmart_ja" />
3.
Opciones de codificacin deben agregarse a la cadena de conexin JDBC para cualquier origen de datos que apunta a un
OLAP
base de datos. Por ejemplo, al crear una fuente de datos en JasperReports Server que apunta a un OLAP
base de datos, utilice la siguiente cadena de conexin:
jdbc: postgresql: // localhost: 5432 / foodmart_ja
260
B.4
Creacin de una
configuracin
Cuando desea crearregional
otras localidades para JasperReports Server, la traduccin es solamente un aspecto de la localizacin.
Creacin de una configuracin regional incluye las siguientes tareas:
La traduccin de las etiquetas y los

mensajes.
Cambio de formatos de fecha.
Cambio de mscaras de formato.
Las tareas de esta seccin requieren que editar estos archivos:
B.4.1
Archivo
Ubicacin
* archivos .properties
WEB-INF \ paquetes
La traduccin de las etiquetas y mensajes
jasperserver_config.properties
WEB-INF \ paquetes
Cambio de formatos de fecha
adhoc_masks
WEB-INF \ paquetes
Cambio de mscaras de formato
Acerca de las propiedades de

archivos
Paquetes de recursos para JasperReports Server y Jaspersoft OLAP son Java archivos de propiedades que se encuentran en
el ... / WEBINF / la directorio. Los archivos de propiedades contienen todas las etiquetas y los mensajes utilizados en JasperReports
Server y
Jaspersoft
Un paqueteOLAP.
incluye un entorno local por omisin (por ejemplo, jasperserver_messages.properties), que est escrita en los
Estados Unidos
Ingls. Entonces se compone de todos los archivos de propiedades con el mismo nombre base, pero diferente configuracin
regional (como
jasperserver_messages_fr.properties). Cada archivo se traduce todas las cadenas del archivo predeterminado en el idioma
determinado por la configuracin regional. El lenguaje de programacin Java tiene normas para locales especificando y locales
alternativos y
que la determinacin de locale en el haz de usar.
Por defecto los paquetes de recursos en JasperReports Servidor
Presente en ... / WEB-INF / paquetes
Descripcin
AdHocFiltersBundle.properties
Las etiquetas y mensajes para el panel Filtros Ad Hoc.
adhoc_masks.properties
Mscaras (formatos de datos) para los valores que aparecen en el Editor de Ad

Hoc.
adhoc_messages.properties
Las etiquetas y los mensajes para el Editor Ad Hoc.
calendar.properties
Las etiquetas y los mensajes utilizados por el dilogo del calendario

emergente.
CommonBundle.properties
Bundle para las pruebas.
createsldatasource_messages
.properties
Las etiquetas y los mensajes para el dilogo Crear dominio.
domain_designer_messages
.properties
Las etiquetas y los mensajes de la interfaz de usuario Diseador

de dominio.
261
Por defecto los paquetes de recursos en JasperReports Servidor

Descripcin
HomeBundle.properties
Etiquetas para la nueva pgina de inicio introdujeron en la versin 5.5.
image_descriptions_messages
.properties
Las etiquetas y los mensajes para el (Amazon Web Services) mquina de AWS
imgenes.
jasperreports_highcharts_
messages.properties
Mensajes para los grficos en el visor de informes.
jasperreports_messages
.properties
Las etiquetas y los mensajes para el visor de informes.
jasperserver_config.properties
Propiedades de configuracin para fechas y fecha-veces.
jasperserver_messages.properties
Las etiquetas y los mensajes utilizados en el principal usuario del servidor

JasperReports
interfaz.
jsexceptions_messages.properties
Mensajes utilizados en los errores y excepciones, tanto en la interfaz de usuario y en

el registro de
mensajes.
LicenseMessages.properties
Las etiquetas y los mensajes utilizados al validar licencias.
logger_descriptions.properties
logger_descriptions_pro.properties
Mensajes de registro internas.
pro_nav_messages.properties
Las etiquetas y los mensajes de la barra de mens y la pgina de Inicio de

edad.
querybuilder_messages.properties
Las etiquetas y los mensajes para el dilogo Elegir datos (para la creacin de un
Tema de dominio antes de usar editor de Ad Hoc).
report_option_messages
.properties
Las etiquetas y los mensajes para el dilogo de opciones de

informe.
ScalableInputControlsBundle
.properties
Etiquetas para listas de valores en los controles de

entrada.
scheduling_ws.properties
Los mensajes de validacin para el programador de

reportes.
semanticLayer.properties
Las etiquetas y los mensajes para el diseador de dominio y datos de Ad Hoc

polticas.
Por defecto los paquetes de recursos en Jaspersoft OLAP
262
Descripcin
ja_mondrian.properties
Las etiquetas y los mensajes de la interfaz de usuario de

configuracin de OLAP.
Por defecto los paquetes de recursos en Jaspersoft OLAP

Descripcin
JA-pro_messages.properties
Las etiquetas y los mensajes en la edicin comercial OLAP espectador.
jpivot_messages.properties
Las etiquetas y los mensajes en la edicin de la comunidad OLAP

espectador.
mondrian_exception_messages
.properties
Mensajes de error de validacin MDX especficas al motor de anlisis interno.
Si utiliza el portlet JasperReports Server para mostrar el contenido del servidor JasperReports en un portal (como Liferay),
el portlet desplegado incluye archivos de propiedades, as:
Archivo
Ubicacin
Descripcin
jaspersoft_portlet_
message.properties
WEB-INF \ agrupa bajo el lugar donde

el portlet se despliega. Por ejemplo:
Las etiquetas y los mensajes que

aparecer en el portlet, incluyendo
el texto de ayuda.
C: \ liferay \ webapps \ <portlet_context_

Nombre> \ WEB-INF \ manojos (donde <portlet_
nombre_contexto> es el nombre especificado al
el portlet JasperReports Server no
desplegado).
Tenga en cuenta que esto no incluye

texto en informes especficos; a
localizar el contenido del informe,
debe cargar su recurso
paquete al repositorio.
Jaspersoft iReport Designer (iReport) y el iReport Plug-in para JasperReports Server (iReport plug-in) tienen
sus propios paquetes de recursos, incluyendo:
B.4.2
Componente
Archivo
Descripcin
iReport
ireport.properties
Las etiquetas y los mensajes utilizados en Jaspersoft iReport Designer.
iReport plug-in
irplugin.properties
Las etiquetas y los mensajes utilizados en iReport Plug-in para

Creacin de un paquete de recursos

Crear un paquete de recursos haciendo una copia de cada archivo * .properties, utilizando la siguiente sintaxis para la copia de
Nombre del archivo:
<Default_file_name> _ <> locale .properties
donde
<Default_file_name> es el nombre de la versin predeterminada del archivo de propiedades, y
<Locale> es un identificador de configuracin regional en
Java compatible.
Por ejemplo, considere el paquete de recursos del servidor JasperReports centrales. Para varios locales, podra ser nombrado
como
de la siguiente manera:
263
Tipo de Archivo
Nombre del archivo
Paquete de recursos
predeterminado
jasperserver_messages.properties
Ingls
jasperserver_messages_en.properties
Francs
jasperserver_messages_fr.properties
Francs en Suiza
jasperserver_messages_fr_CH.properties
Para obtener una lista de los lugares con RoHS-Java, por favor consulte el sitio
web de Java.
Los paquetes de recursos descritos en el presente documento consisten en Java archivos de propiedades especficas de
configuracin regional. Java
archivos de propiedades utilizan el ISO-8859-1 (Latin-1) de codificacin que es el mismo para todos ASCII Ingls no
caracteres acentuados. Para los personajes internacionales que no estn en la norma ISO-8859-1, utilice Unicode de
escape
secuencias (por ejemplo, \ U00e9 es E).
Para crear un nuevo paquete de recursos JasperReports del servidor:

1. Copie cada uno de los archivos de propiedades (mantenindolos en el mismo directorio que los originales) y cambiarles el
nombre
de acuerdo con su configuracin regional.
2. Traducir etiquetas cada uno * de archivos .properties y mensajes en el nuevo idioma.
3.
4.
Algunas de las cadenas en los archivos de propiedades son los formatos de fecha y mscaras de formato que pueden
necesitar ser modificado para
la nueva configuracin regional. Para obtener ms informacin, consulte "Ajuste de la fecha y de fecha y hora formatos" en
Guarde
archivos.
la pginalos
264.
Si el nuevo escenario requiere codificacin o fuentes de carcter especfico, asegrese de que JasperReports Server y el
tercero
software de terceros se basa en estn configurados para apoyarlos. Para obtener ms informacin, consulte "Configuracin
de
JasperReports Server para Multi-byte Fuentes "en la pgina 253.
El nuevo local no est disponible en JasperReports Server hasta que siga los pasos descritos en
"Especificacin de los entornos nacionales adicionales" en la pgina 266.
B.4.3
Ajuste de la fecha y de fecha y hora Formatos

Cada entorno puede tener sus propias reglas para la visualizacin de fechas y valores de fecha y hora. La fecha del sistema
y la fecha y hora
formato es controlado por cuatro patrones que se especifican en el jasperserver_config_ archivo <> locale .properties
asociado a un lugar en particular.
Por ejemplo, en el paquete de recursos Ingls, las cuatro entradas son:
date.format = dd-mm-aaaa
datetime.format = dd-mm-aaaa HH: mm
calendar.date.format =% d-% m-% Y
calendar.datetime.format =% d-% m-% Y% H:% M
Las dos primeras teclas se utilizan para analizar y las fechas de formato y los valores de fecha y hora utilizando un interno
java.util.DateFormat objeto a travs de toda la aplicacin. Estos patrones deben ser fecha no localizado
patrones, de acuerdo con la sintaxis de Java Development Kit (JDK).
264
Las otras dos teclas son usadas por el control de calendario, que da formato a los valores de fecha y hora y fecha seleccionadas
por el usuario en
conformidad con su propia sintaxis patrn.
Para cambiar la fecha del sistema y el formato de fecha y hora para un nuevo local, editar las cadenas especificadas por
estas claves.
B.4.4
Configuracin de formato de datos

Mscaras
Cada entorno puede tener sus propias mscaras de formato que determinan cmo los nmeros aparecen en el Editor de Ad
Hoc. Para hacer
los datos de las mscaras de formato varan de acuerdo al lugar, debe crear un archivo adhoc_masks para la nueva
configuracin regional. Para ello, copiar
los adhoc_masks.properties de archivo a un nuevo nombre que especifica el nuevo local y cambiar las mscaras se define en
el nuevo archivo. Por ejemplo, el archivo francs sera nombrado adhoc_masks_fr.properties.
Las mscaras de formato de datos que se describen en esta seccin se utilizan en los dominios y en el Editor Ad Hoc; que
aparecer en las vistas de Ad Hoc, as como JRXML informes basados en dominios; que no son aplicables a
Jaspersoft OLAP.
Personaliza las mscaras de formato de datos disponibles para las fechas, los nmeros enteros y decimales editando el
enmascaramiento existente
entradas o aadiendo otros nuevos. Las entradas por defecto se indican en la siguiente tabla:
Formato de datos de propiedades de la
mscara
Aparicin en en_US Locale
ADH_100_MASK_date_0
ADH_100_MASK_date_1
ADH_100_MASK_date_2
ADH_100_MASK_date_3
3/31/09
31 de marzo 2009
31 de marzo 2009
31 de marzo 2009 23:59:59
=
=
=
=
corto, ocultar
de largo, ocultar
corto, mediano
medio, medio
ADH_100_MASK_int_0
ADH_100_MASK_int_1
ADH_100_MASK_int_2
ADH_100_MASK_int_3
=
=
=
=
# ## 0
0
$ #, ## 0; ($ #, ## 0)
# ## 0; (# ## 0)
-1234
-1234
(1.234 dlares)
(1234)
ADH_100_MASK_dec_0
ADH_100_MASK_dec_1
ADH_100_MASK_dec_2
ADH_100_MASK_dec_3
=
=
=
=
# ## 0,00
0
$ #, ## 0.00; ($ #, ## 0.00)
$ #, ## 0; ($ #, ## 0)
-1,234.56
-1234
($ 1,234.56)
(1.234 dlares)
Las mscaras de formato de datos para cada tipo se cuentan a partir de cero; crear nuevas mscaras aadiendo nueva
entradas. Las claves de las nuevas entradas deben seguir la convencin establecida en las entradas predeterminadas. Por
ejemplo, una
nueva mscara de formato de datos decimal podra tener este ID:
ADH_100_MASK_dec_4
Mscaras de formato de fecha se implementan utilizando java.text.SimpleDateFormat y extensiones de JasperReports que

proporcionar acceso a mscaras predefinidas de formato de datos localizadas. Nuevas mscaras de fecha y hora deben
especificarse en una de las
siguientes formatos:
Un estilo para la parte de fecha del valor y un estilo para la pieza del tiempo (separados por comas) o un solo estilo para
ambas partes. Un estilo es una de corto, mediano, largo, completo, Default (que corresponden a
java.text.DateFormat estilos) y Hide.
Un modelo que puede ser suministrado a java.text.SimpleDateFormat. En este caso, apoyo a la internacionalizacin
es limitado.
265
Ambas mscaras enteros y formato de datos decimal se implementan con java.text.DecimalFormat, Que
localiza caracteres en la especificacin de formato. Por ejemplo, considere el caso del smbolo de agrupacin de dgitos
(Separador de miles): en francs, es un espacio; en EE.UU. Ingls, es una coma. DecimalFormat maneja tanto
casos: si el patrn de nmero #, se usa ## 0, el nmero 6000 aparece como 6 000 en el entorno local francs y 6.000
en la localidad EE.UU. Ingls.
Para obtener ms informacin acerca de la manipulacin de Java de decimales y de formato de
fecha mscaras, consulte:
http://download.oracle.com/javase/6/docs/api/java/text/DecimalFormat.html
http://download.oracle.com/javase/6/docs/api/java/text/DateFormat.html
De forma predeterminada, los valores monetarios en vistas Ad Hoc estn enmascarados como USD (dlares
estadounidenses). Dependiendo de
sus datos, puede que tenga que soportar una moneda diferente, apoyar ms de una moneda, o el apoyo
conversin de moneda. Estos son tres casos muy diferentes:
El apoyo a una moneda diferente a USD implica cambiar las mscaras monetarios de utilizar la correcta
smbolo de su moneda (por ejemplo, sustituir el $smbolo en la ADH_100_MASK_dec_2 y ADH_
100_MASK_dec_3 mscaras). Sin embargo, el cambio de este smbolo en realidad no convertir las monedas en
sus informes.
B.5
Apoyo a otras monedas adems de USD implica aadir nuevas mscaras. Sin embargo, la adicin de los datos
formatos en realidad no convertir las monedas en sus informes.
Apoyo a la conversin de moneda es ms complicado; debe tener en cuenta cuestiones tales como las fluctuaciones en
las tasas de conversin. A menudo, un servicio de terceros puede ser utilizado para realizar la conversin de moneda
Configuracin de JasperReports servidores que ofrece una

configuracin
Despus de crear unregional
local, debe configurar JasperReports Server para ofrecer a sus usuarios, junto con cualquier nuevo
zonas horarias.
Las tareas de esta seccin requieren que editar estos archivos:
B.5.1
Nombre del archivo
Ubicacin
applicationContext-security.xml
WEB-INF
Especificar localizaciones adicionales
JasperServer-servlet.xml
WEB-INF
Especificacin de zonas horarias adicionales
Especificacin de los entornos

nacionales adicionales
De forma predeterminada, JasperReports Server aparece en la configuracin regional seleccionada en el navegador del usuario
final. La Pgina de registro permite
los usuarios especificar la configuracin regional que desea utilizar. La lista de los lugares de donde elegir es definido en
applicationContext-security.xml. Editar este archivo para agregar una nueva configuracin regional.
Para agregar un nuevo local:
1. Editar el archivo applicationContext-security.xml y localizar el bean llamado userLocalesList. Por ejemplo:
<Bean id = "userLocalesList"
class = "com.jaspersoft.jasperserver.war.common.LocalesListImpl">
<Nombre de propiedad = "locales">
266
<Lista>
<Valor
<Valor
<Valor
<Valor
<Valor
<Valor
<Valor
</ List>
</ Propiedad>
</ Bean>
2.
type = "java.util.Locale"> en </ value>

type = "java.util.Locale"> fr </ value>
type = "java.util.Locale"> que </ value>
type = "java.util.Locale"> de </ value>
type = "java.util.Locale"> ro </ value>
type = "java.util.Locale"> ja </ value>
type = "java.util.Locale"> zh_TW </ value>
Aadir el nuevo escenario al final de la lista. Por ejemplo, aada la siguiente lnea de Holands (nl_NL de Java
locale):
<Tipo value = "java.util.Locale"> nl_NL / value>
3.
Guarde el archivo.
4.
Reinicie JasperReports Server, y acceder a la aplicacin web para probar su traduccin. Revisin de la
cadenas traducidas en contexto pueden ayudar a mejorar sus opciones de palabras.
Para obtener una lista de los lugares con RoHS-Java, por favor consulte el sitio
web de Java.
B.5.2
Especificacin de zonas horarias adicionales

De forma predeterminada, JasperReports Server supone la zona horaria del usuario es el mismo que la zona horaria de los
JasperReports
Host del servidor. Sin embargo, la pgina de Inicio de sesin permite a los usuarios elegir una zona horaria diferente. La lista de
los que
elegir se define en el archivo applicationContext.xml.
Para agregar una zona horaria:
1. Abra el archivo applicationContext.xml y localice el userTimeZonesList frijol. Por ejemplo:
<Bean id = "userTimeZonesList"
class = "com.jaspersoft.jasperserver.war.common.JdkTimeZonesList">
<Nombre de propiedad = "timeZonesIds">
<Lista>
<Valor> America / Los_Angeles </ value>
<Valor> Amrica / Denver </ value>
<Valor> Amrica / Chicago </ value>
<Valor> Amrica / Chicago </ value>
<Valor> Europe / London </ value>
<Valor> Europe / Berlin </ value>
<Valor> Europa / Bucarest </ value>
</ List>
</ Propiedad>
</ Bean>
2.
Aadir la nueva zona horaria a la parte inferior de la lista. Especifique cada zona horaria que la zona horaria estndar de
Java
valores para que JasperReports servidor ajusta al horario de verano, cuando proceda. Por ejemplo, aadir el
siguiendo la lnea de Tokio:
<Valor> Asia / Tokio </ value>
3.
Guarde el archivo.
267
4.
Para obtener ms informacin sobre zonas horarias Java-queja, por favor consulte el sitio web de Java.
B.5.3
Establecer una zona horaria

predeterminada
Si desea JasperReports Server para utilizar una zona horaria que es diferente de la computadora host, se puede establecer
un
zona horaria especfica en Java. Se convierte en la zona horaria predeterminada para todos los usuarios, pero an as
puede seleccionar una diferente
zona
horaria cuando
inician
sesin.
Para establecer
una zona
horaria
predeterminada, establezca la user.timezone propiedad en la JVM, como se muestra en las
tablas siguientes. Busque
la configuracin de la JVM de archivos que contiene para su plataforma y servidor de aplicaciones. El valor de la propiedad
debe ser una
Zona
compatible,
por ejemplo,
Europe
Bucharest.surtan efecto. La zona horaria se establece para todas las
Debe horaria
reiniciaren
el Java
servidor
de aplicaciones
para que
los/ cambios
aplicaciones en
el servidor de aplicaciones, incluyendo JasperReports Server.
Valores de JVM para zona horaria predeterminada
FuncionamientoApp
Sistema
Servidor
Archivo
Ajuste
Ventanas
Tomcat
<Apache-tomcat> \ bin \ setenv.bat
Aadir esta lnea de cdigo:
JBoss
<Jboss> \ bin \ run.bat
Tomcat
<Apache-tomcat> /bin/setenv.sh
JBoss
<Jboss> /bin/run.sh
GlassFish
<De vidrio
pescado> / dominios / dominio1 / config / domain.xml
Linux
Ambos
establecer JAVA_OPTS =% JAVA_OPTS%

-Duser.timezone = <Zona horaria>
Aadir esta lnea de cdigo:
JAVA_OPTS exportacin = "$ JAVA_OPTS
-Duser.timezone = <Zona horaria> "
Aadir esta lnea de cdigo para <jvm-options>
seccin:
-Duser.timezone = <Zona horaria>
268
GLOSARIO
Ad Hoc Editor
El explorador de datos interactiva en ediciones JasperReports Server Professional y Enterprise. A partir de un
coleccin predefinida de campos, la Hoc Editor de anuncios le permite arrastrar y soltar campos, dimensiones y medidas a
explorar los datos y crear tablas, grficos y tablas de referencias cruzadas. Estos Hoc Visitas del anuncio se pueden guardar
como informes.
Informe Especial
En versiones anteriores de JasperReports Server, un informe creado por el Editor Ad Hoc. Estos informes podran ser
aadido a cuadros de mando y ser programado, pero cuando editado en iReport, perdido su agrupacin y clasificacin. En el
versin actual, el Editor Ad Hoc se utiliza para explorar puntos de vista que a su vez se pueden guardar como informes. Tales
informes
se pueden editar en iReport y Jaspersoft Studio sin prdida, y puede ser programado y se aade a cuadros de mando.
Especial Vista
Una vista de los datos que se basa en una conexin de cliente de dominio, Tema, o OLAP. Un punto de vista ad hoc puede ser
una tabla,
grfico o tabla de referencias cruzadas y es el punto de entrada para operaciones de anlisis, tales como slice and dice, drill
down y drill
a travs. Comparar OLAP Vista. Puede guardar una vista ad hoc como un informe con el fin de editarlo en el interactivo
espectador, programar, o agregarlo a un tablero de instrumentos.
Funcin de agregacin
Una funcin agregada es uno que se calcula utilizando un grupo de valores; por ejemplo, Suma o Promedio. Aggregate
funciones se pueden utilizar para crear campos calculados en vistas Ad Hoc. Los campos calculados que contienen agregados
funciones no se pueden utilizar como campos o aadirse a los grupos en una vista ad hoc y no deben ser utilizados como filtros.
Las funciones de agregado le permiten establecer un nivel, que especifica el alcance del clculo; valores de nivel incluyen
Actual (no disponible para percentof), ColumnGroup, ColumnTotal, rowgroup, RowTotal, Total
Vista de Anlisis
Ver OLAP Vista.
Auditora Archiving
Para evitar registros de auditora se haga demasiado grande para ser de fcil acceso, el instalador configura JasperReports
Servidor
para mover los registros de auditora actuales a un archivo despus de un cierto nmero de das, y para eliminar los registros en
el archivo despus de un
cierta
edad.
El archivo es otra tabla en la base de datos de repositorio del JasperReports Server.
Dominios
de auditora
Un dominio que tiene acceso a los datos de auditora en el repositorio y permite a los administradores crear informes ad
hoc de servidor
actividad. Hay un dominio de los registros de auditora actuales y uno para los registros archivados.
269
Registro de auditora
Cuando est habilitada la auditora, el registro de auditora es el registro activo del que se usa JasperReports Server para
hacer lo
cuando. El instalador del sistema puede configurar qu actividades para iniciar la sesin, el nivel de detalle se reunieron, y
cundo
archivar los datos. Los registros de auditora se almacenan en la misma base de datos privada que JasperReports Server
utiliza para almacenar el
Auditora
repositorio, pero los datos slo se puede acceder a travs de los dominios de auditora.
Una caracterstica de la edicin JasperReports Server Enterprise que registra toda la actividad del servidor y permite a los
administradores
ver los datos.
Campo calculado
En una vista ad hoc o un dominio, un campo cuyo valor se calcula a partir de una frmula definida por el usuario, que puede
incluir
cualquier nmero de campos, operadores y constantes. Para Dominios, un campo calculado se convierte en uno de los artculos
a
que pueden solicitar archivos de seguridad y la configuracin regional paquetes del dominio. Hay ms funciones disponibles para
Ad Hoc
CRM
Vea los clculos que para los dominios.
Customer Relationship Management. La prctica de la gestin de todas las facetas de la interaccin de la empresa con su
clientela. Aplicaciones de CRM ayudan a las empresas a seguir y apoyar a sus clientes.
CrossJoin
Una funcin MDX que combina dos o ms dimensiones en un solo eje (columna o fila).
Cube
La base de la mayora de las aplicaciones OLAP, un cubo es una estructura de datos que contiene tres o ms dimensiones
que
clasificar los datos cuantitativos del cubo. Al navegar los datos que se muestran en una vista OLAP, usted es
explorar un cubo.
Campo personalizado
En el Editor Ad Hoc, un campo que se crea a travs de los elementos del men como una simple funcin de uno o dos
disponibles
campos, incluyendo otros campos personalizados. Cuando un campo personalizado se vuelve demasiado complejo o
necesita ser utilizado en muchos
informes, lo mejor es definirlo como un campo calculado en un dominio.
Dashboard
Una coleccin de informes, controles de entrada, grficos, etiquetas y contenido de la web est representada en una nica vista
integrada.
Dashboards menudo presentan una vista de alto nivel de sus datos, pero los controles de entrada pueden parametrizar los datos
para mostrar.
Por ejemplo, se puede reducir el nmero de datos a un rango de fechas. Contenido web incorporado, como otra webaplicaciones o mapas base, hacen cuadros de mando ms interactivo y funcional.
Tabla derivada
En un dominio, una tabla derivada es definida por una consulta adicional, cuyo resultado se convierte en otra serie de artculos
disponible en el dominio. Por ejemplo, con una fuente de datos JDBC, puede escribir una consulta SQL que incluye
funciones complejas para la seleccin de datos. Puede utilizar los elementos de una tabla derivada para otras operaciones
sobre el
Dominio, como unin de tablas, la definicin de un campo calculado, o filtrado. Los elementos de una tabla derivada tambin
puede ser
referencia en archivos de seguridad y la configuracin regional paquetes del dominio.
Poltica de datos
En JasperReports Server, un entorno que determina cmo los procesos de servidor y guarda en cach los datos usados por
Ad Hoc
informes. Seleccione sus polticas de datos haciendo clic Administrar> Configuracin Ad Hoc.
270
Glosario
Fuente de datos
Define las propiedades de conexin que JasperReports Server necesita acceder a los datos. El servidor transmite consultas a
fuentes de datos y conjuntos de datos obtiene a cambio de uso en el llenado de los informes y la vista previa de informes ad
hoc.
JasperReports Server es compatible con JDBC, JNDI, y las fuentes de datos de frijol; fuentes de datos personalizados pueden
definirse
tambin.
Conjunto de
datos
Una coleccin de datos dispuestos en columnas y filas. Los conjuntos de datos son equivalentes a los resultados
relacionales conjuntos y la
JRDataSource escribir en la biblioteca JasperReports.
Tipo de datos
En JasperReports Server, un tipo de datos se utiliza para caracterizar un valor introducido a travs de un control de entrada. Un
tipo de datos
debe ser de tipo texto, numrico, de fecha o de fecha y hora. Puede incluir restricciones en el valor de la entrada, por ejemplo
valores mximos y mnimos. Como tal, un tipo de datos en JasperReports Server es ms estructurada que un tipo de datos
en la mayora de lenguajes de programacin.
Desnormalizar
Un proceso para la creacin de uniones entre tablas que acelera la recuperacin de datos en el coste de tener valores
de fila duplicados
entre algunas columnas.
Dados
Una operacin OLAP para seleccionar columnas.
Dimensin
Una categorizacin de los datos en un cubo. Por ejemplo, un cubo que almacena datos acerca de las cifras de ventas puede
incluir
dimensiones como el tiempo, producto, regin y sector del cliente.
Dominio
Una vista virtual de un origen de datos que presenta los datos en trminos de negocio, permite la localizacin, y ofrece
La seguridad a nivel de datos. Un dominio no es una vista de la base de datos en trminos relacionales, pero se implementa la
misma
funcionalidad dentro de JasperReports Server. El diseo de un dominio especifica las tablas de la base de datos, se unen
clusulas,
campos calculados, nombres de pantalla, y propiedades por defecto, todos los cuales definen los elementos y conjuntos de
elementos para la creacin de
Tema
de dominio
Informes
ad hoc.
Un tema que se crea a partir de un dominio mediante el Selector de datos. Un tema de dominio se basa en el origen de datos y
artculos en un dominio, sino que adems permite el filtrado, la entrada del usuario, y la seleccin de artculos. A diferencia
basada JRXML-A
Tema, un tema de dominio se puede editar en JasperReports Server los usuarios con los permisos adecuados.
Drill
Para hacer clic en un elemento de una vista OLAP para cambiar los datos que se muestra:
Profundizar. Una operacin OLAP que expone la informacin ms detallada hasta los niveles de la jerarqua de
profundizar en la jerarqua y la actualizacin de los contenidos de la tabla de navegacin.
Perforar a travs. Una operacin OLAP que muestra los datos transaccionales detallados para una medida agregada
dado.
Haga clic en un hecho de abrir una nueva mesa de debajo de la mesa principal de navegacin; la nueva tabla indica el
bajo nivel
datos que constituye los datos que se ha hecho clic.
Sintetizar. Una operacin OLAP para devolver el nivel de jerarqua de elementos primarios para ver la informacin de
resumen.
Eclipse
Un cdigo abierto entorno de desarrollo integrado (IDE) para Java y otros lenguajes de programacin, como
C / C ++.
271
ETL
Extraer, Transformar, Cargar. Un proceso que recupera datos de los sistemas transaccionales y filtros y agregados del
datos para crear una base de datos multidimensional. Generalmente, ETL prepara la base de datos que sus informes tendrn
acceso.
El producto ETL Jaspersoft permite definir y procesos ETL horario.
Realidad
El valor especfico o el valor agregado de una medida para un miembro particular de una dimensin. Los hechos son
tpicamente
numrico.
Campo
Un campo es equivalente a una columna en el modelo de base de datos relacional. Los campos se originan en la estructura de
los datos
fuente, pero puede definir campos calculados en un campos personalizados en el Editor Ad Hoc o de dominio. Cualquier tipo de
campo, junto con su nombre de visualizacin y formato predeterminado propiedades, se llama un elemento y se puede utilizar en
el Ad
Editor Hoc.
Frame
Un elemento de panel que muestra informes o URL personalizadas. Marcos se pueden asignar a los controles de entrada si
su
contenido puede aceptar parmetros.
Grupo
En un informe, un grupo es un conjunto de filas de datos que tienen un valor idntico en un campo
designado.
En una tabla, el valor aparece en un encabezado y pie alrededor de las filas del grupo, mientras que los otros campos
aparecer como columnas.
En un grfico, el campo elegido para definir el grupo se convierte en la variable independiente en el eje X, mientras que el
otros campos de cada grupo se utilizan para calcular el valor dependiente en el eje Y.
Nivel de Jerarqua
En un cubo OLAP, un miembro de una dimensin que contiene un grupo de miembros.
Control de entrada
Cuadro A, el botn de verificacin, la lista desplegable, campo de texto o icono de calendario que permite al usuario introducir un
valor cuando se ejecuta
un informe o la visualizacin de un panel de control que acepta parmetros de entrada. Para informes JRXML, controles de
entrada y su
tipos de datos asociados deben ser definidos como objetos del repositorio y se asocian explcitamente con el informe. Para
Informes basados en el dominio que incitan a los valores de filtro, los controles de entrada se definen internamente. Cuando
cualquiera de los tipos de
iReport
informeDiseador
se utiliza en un tablero de instrumentos, sus controles de entrada estn disponibles para ser aadido como contenido
especial.
Una herramienta de cdigo abierto para disear grficamente informes que aprovechan todas las caractersticas de la biblioteca
JasperReports. El
Jaspersoft iReport Diseador le permite arrastrar y colocar campos, grficos y subinformes en un lienzo, y tambin definir
parmetros o expresiones para cada objeto para crear informes de pxel perfecto. Puede generar el JRXML del
reportar directamente en iReport, o subirlo a JasperReports Server. iReport se implementa en NetBeans.
Artculo
En el diseo de un dominio o crear un tema basado en un dominio, un elemento es la representacin de una base de datos
campo o un campo calculado junto con sus nombres de pantalla y formato propiedades definidas en el dominio. Artculos
pueden agruparse en conjuntos y estn disponibles para su uso en la creacin de informes ad hoc.
JasperReport
Una combinacin de una plantilla de informe y los datos que produce un documento complejo para ver, imprimir o
informacin de archivo. En el servidor, un JasperReport referencias a otros recursos en el repositorio:
272
La plantilla de informe (en forma de un archivo JRXML)
Glosario
Informacin sobre la fuente de datos que suministra los datos para el informe
Cualquier recurso adicional, como imgenes, fuentes y paquetes de recursos referenciados por la plantilla del informe.
La coleccin de todos los recursos que se hace referencia en un JasperReport a veces se llama una unidad de informe. Fin
los usuarios suelen ver e interactuar con un JasperReport como un recurso nico en el repositorio, pero los creadores informe
debe
definir todos los componentes en la unidad de informe.
Nivel
Especifica el mbito de una funcin de agregado en una vista especial. Valores de nivel son Actual (no disponible para
Percentof), ColumnGroup, ColumnTotal, rowgroup, RowTotal, Total.
JasperReports Biblioteca
Una, de cdigo abierto integrable, API Java para la generacin de un informe, llenndolo de datos actual, dibujo y grficos
tablas y exportar a cualquier formato estndar (HTML, PDF, Excel, CSV, y otros). Procesos JasperReports
informes definidos en JRXML, un formato XML abierto que permite que el informe contiene expresiones y lgica para
informe de control de salida en base a los datos de tiempo de ejecucin.
Una aplicacin de cdigo abierto comercial, basada en el servidor que llama a la biblioteca JasperReports para generar y
compartir
informes de forma segura. JasperReports servidor autentica a los usuarios y les permite cargar, ejecutar, ver, programar y
enviar
informes desde un navegador web. Las versiones comerciales proporcionan capas de metadatos, informe interactivo y el
salpicadero
Jaspersoft ETL
funciones de creacin, y de la empresa, tales como las organizaciones y auditora.
Una herramienta grfica para el diseo y la implementacin de su extraccin de datos, transformacin y carga (ETL) de tareas.
Es
ofrece cientos de conectores de fuente de datos para extraer datos de muchos sistemas relacionales y no relacionales.
Entonces, horarios y lleva a cabo la agregacin de datos y la integracin en mercados de datos o almacenes de datos que
utilizar para la presentacin de informes.
Jaspersoft OLAP
Un servidor OLAP relacional integrado en JasperReports Server que realiza anlisis de datos con consultas MDX.
El producto incluye generadores de consultas y clientes de visualizacin que ayudan a los usuarios explorar y dar sentido a
datos multidimensionales. Jaspersoft OLAP tambin soporta conexiones XML / A a servidores remotos.
Jaspersoft Studio
Una herramienta de cdigo abierto para disear grficamente informes que aprovechan todas las caractersticas de la biblioteca
JasperReports.
Jaspersoft Studio le permite arrastrar y colocar campos, grficos y subinformes en un lienzo, y tambin definir parmetros
o expresiones para cada objeto para crear informes de pxel perfecto. Puede generar el JRXML del informe directamente
en Jaspersoft Studio, o subirlo a JasperReports Server. Jaspersoft Studio se implementa en Eclipse.
JavaBean
Un componente Java reutilizable que se puede caer en un contenedor de aplicaciones que proporcionan una funcionalidad
estndar.
JDBC
Java Database Connectivity. Una interfaz estndar que las aplicaciones Java utilizan para acceder a bases de
datos.
JNDI
Java Naming and Directory Interface. Una interfaz estndar que las aplicaciones Java utilizan para acceder a nombrar y
servicios de directorio.
273
nete rbol
En Dominios, una coleccin de tablas combinadas de la fuente de datos real. Una unin es la operacin relacional que
asocia las filas de una tabla con las filas de otra tabla basada en un valor comn en determinado campo de cada
tabla. Slo los campos de un mismo rbol o unirse calculan a partir de los campos en un mismo rbol unirse pueden aparecer
juntos en
un informe.
JPivot
Una interfaz grfica de usuario de cdigo abierto para operaciones OLAP. Para obtener ms
informacin, visite
http://jpivot.sourceforge.net/.
JRXML
Un formato de archivo XML para los informes de ahorro y de intercambio creadas para la biblioteca JasperReports y las
aplicaciones
que lo utilizan, como iReport Designer y JasperReports Server. JRXML es un formato abierto que utiliza el XML
estndar de definir con precisin toda la estructura y configuracin de un informe.
MDX
Multidimensional Expression Language. Un lenguaje para realizar consultas de objetos multidimensionales, como OLAP (On
Line Analytical Processing) cubos y regresan los datos del cubo de procesamiento analtico. Una consulta MDX es el
consulta que determina los datos que se muestran en una vista OLAP.
Medida
Dependiendo del contexto:
En un informe, una frmula que calcula los valores mostrados en las columnas de una tabla, los valores de datos de una
tabla de referencias cruzadas, o una
variable dependiente del grfico (como las rodajas en una empanada).
En una vista OLAP, una frmula que calcula los hechos que constituyen los datos cuantitativos en un cubo.
Mondrian
Una, la aplicacin de base de datos multidimensional de cdigo abierto basado
en Java.
Conexin Mondrian
Una conexin de cliente OLAP que consiste en un esquema OLAP y una fuente de datos. Conexiones de cliente OLAP
poblar vistas OLAP.
Mondrian Esquema Editor
Una fuente abierta Eclipse plug-in para la creacin de esquemas OLAP Mondrian.
XML Mondrian / A Fuente
Un XML de servidor / Una definicin de origen de un XML en el cliente remoto / Una conexin utiliza para rellenar un OLAP
ver usando el XML / A estndar.
MySQL
Un sistema de gestin de base de datos relacional de cdigo abierto. Para obtener ms informacin, visita
http://www.mysql.com/.
Tabla de navegacin
La tabla principal en una vista que muestra OLAP medidas y dimensiones como columnas y filas.
ODBO Conectar
Jaspersoft ODBO Connect permite a Microsoft Excel Pivot Tables 2003 y 2007 para trabajar con Jaspersoft OLAP
y otros servidores OLAP que apoyan el XML / Un protocolo. Despus de configurar la fuente de datos de Jaspersoft ODBO,
los analistas de negocios pueden usar las tablas dinmicas de Excel como un front-end para el anlisis OLAP.
274
Glosario
OLAP
El procesamiento analtico en lnea. Ofrece vistas multidimensionales de datos que ayudan a los usuarios a analizar y pasados
rendimiento y modelo escenarios futuros.
OLAP Client Connection
Una definicin de recuperacin de datos para rellenar una vista OLAP. Una conexin de cliente OLAP es o un Java directa
conexin (conexin Mondrian) o una conexin API basada en XML (XML / A la conexin).
OLAP esquema
Una definicin de metadatos de una base de datos multidimensional. En Jaspersoft OLAP, los esquemas se almacenan en el
repositorio
como los recursos de archivos XML.
OLAP Vista
Tambin se llama una vista de anlisis. Una vista de datos multidimensional que se basa en una conexin de cliente OLAP y
una consulta MDX. A diferencia de Ad Hoc vistas, puede editar directamente consulta MDX de una vista OLAP para cambiar los
datos
y la forma en que se visualizan. Una vista OLAP es el punto de entrada para los usuarios de anlisis avanzados que quieren
escribir sus propias consultas. Compare Ad Hoc View.
Organizacin
Un conjunto de usuarios que comparten carpetas y recursos en el repositorio. Una organizacin tiene sus propias cuentas de
usuario, roles,
y la carpeta raz del repositorio para aislar de forma segura de otras organizaciones que pueden ser alojados en la misma
instancia de JasperReports Server.
Organizacin administracin
Tambin llamado el administrador de la organizacin. Un usuario en una organizacin con los privilegios para administrar el
las cuentas de la organizacin de usuarios y roles, permisos del repositorio, y el contenido del repositorio. Un administrador
organizacin
Tambin puede crear suborganizaciones y sarna todas sus cuentas, las funciones y los objetos del repositorio. El valor por
defecto
organizacin admin en cada organizacin es la jasperadmin cuenta.
Outlier
Un hecho que parece incongruente con respecto a los hechos de otros miembros. Por ejemplo, una cifra de ventas muy bajo o
una
nmero muy elevado de entradas helpdesk. Estos valores atpicos pueden indicar un problema (o un logro importante) en
su negocio. Las funciones de anlisis de Jaspersoft OLAP sobresalen en los valores extremos que revelan.
Parmetro
Valores con nombre que se pasan al motor en tiempo de informe rellenando para controlar los datos devueltos o la aparicin
y el formato del informe. Un parmetro de informe se define por su nombre y el tipo. En JasperReports Server,
parmetros se pueden asignar a los controles de entrada que los usuarios puedan interactuar.
Pivot
Para girar una tabla de referencias cruzadas de tal manera que sus grupos de filas se convierten en grupos de columnas y sus
grupos de columnas se convierten en filas. En el
Ad Hoc Editor, gire una tabla de referencias cruzadas,
.
haga clic en
Tabla Pivot
Una mesa con dos dimensiones fsicas (por ejemplo, X y eje Y) para organizar la informacin que contiene ms
de dos dimensiones lgicas (por ejemplo, producto, cliente, hora y lugar), de manera que cada
dimensin fsica es capaz de representar una o ms dimensiones lgicas, donde los valores descritos por
las dimensiones se agregan utilizando una funcin como SUM. Las tablas pivote se utilizan en Jaspersoft OLAP.
275
Propiedades
Ajustes asociados a un objeto. Los ajustes determinan ciertas caractersticas del objeto, como su color y
etiqueta. Las propiedades son normalmente editable. En Java, las propiedades se pueden establecer en archivos de lista de
objetos y sus configuraciones.
Informe
En el uso casual, informe puede referirse a:
A JasperReport. Ver JasperReport.

El JRXML principal en un JasperReport.
El archivo se genera cuando se programa una JasperReport. Estos archivos tambin se llaman recursos de contenido o
de salida
archivos.
El archivo genera cuando un JasperReport se ejecuta y luego exportado.
En versiones anteriores de JasperReports Server, un informe creado en el Editor Ad Hoc. Ver anuncio Reportar Hoc.
Ejecutar informe
Una ejecucin de un informe, Ad Hoc vista, o en el salpicadero, o una sesin de visualizacin o en el salpicadero de diseo,
mide y
lmites de uso de instancias Freemium de JasperReports Server. Las ejecuciones se aplican a los recursos sin importar cun
ser lanzados (ya sea en la interfaz web oa travs de las distintas APIs, como los servicios Web REST). Los usuarios de nuestra
Proyecto Comunitario y nuestros usos llena licencias comerciales no se ven afectados por el lmite. Para obtener ms
informacin,
por favor pngase en contacto con sales@jaspersoft.com.
Repositorio
La estructura de rbol de carpetas que contienen los informes de todos los salvados, cuadros de mando, puntos de vista OLAP
y recursos. Acceso Usuarios
el repositorio a travs de la interfaz web JasperReports Server o a travs de iReport. Las aplicaciones pueden acceder a la
repositorio a travs de la API de servicios web. Los administradores usan las utilidades de importacin y exportacin de copias
de seguridad de la
contenido del repositorio.
Recursos
En JasperReports Server, cualquier cosa que residen en el repositorio, como una imagen, archivo de fuente, tipo de letra,
datos, Tema,
Dominio, informe elemento, informe guardado, salida del informe, cuadro de mandos, o consulta OLAP. Los recursos
tambin incluyen la
carpetas en el repositorio. Los administradores configuran los usuarios y basados en roles permisos de acceso a los
recursos del repositorio de
Papel
establecer una poltica de seguridad.
Una caracterstica de seguridad de JasperReports Server. Los administradores crean papeles con nombre, asignarlos a las
cuentas de usuario, y
a continuacin, establecer permisos de acceso a los objetos del repositorio basado en esos roles. Ciertas funciones tambin
determinan lo
funciones
Esquema y opciones de men se muestran a los usuarios en la interfaz de JasperReports Server.
Un modelo lgico que determina cmo se almacenan los datos. Por ejemplo, el esquema en una base de datos relacional es una
descripcin de las relaciones entre las tablas, vistas e ndices. En Jaspersoft OLAP, un esquema OLAP es el
modelo lgico de los datos que aparecen en una vista OLAP; que se cargan en el repositorio como recursos. Para
Dominios, esquemas estn representados en los archivos de diseo XML.
Workbench de esquema
Una herramienta grfica para disear fcilmente esquemas OLAP, los esquemas de seguridad de datos y las consultas MDX.
La resultante
definiciones de cubo y de consulta se pueden utilizar en Jaspersoft OLAP para realizar anlisis simple pero potente de
grandes cantidades de datos multidimensionales almacenados en sistemas RDBMS estndar.
276
Glosario
Set
En dominios y dominio Temas, una coleccin con nombre de objetos agrupados para facilitar su uso en el Ad Hoc
Editor. Un conjunto se puede basar en los campos de una tabla o totalmente definidos por el creador de dominio, pero todos
los elementos de una
conjunto debe originarse en el mismo rbol unirse. El orden de los elementos en un conjunto se conserva.
Rodaja
Una operacin OLAP para el filtrado de filas de datos.
SQL
Lenguaje de consulta estructurado. Un lenguaje estndar que se utiliza para acceder y manipular datos y esquemas en
un
base de datos relacional.
System Admin
Tambin llamado el administrador del sistema. Un usuario que tiene acceso ilimitado para gestionar todas las organizaciones,
usuarios, roles,
permisos del repositorio, y los objetos del repositorio en toda la instancia del servidor JasperReports. El sistema de
administracin
puede crear organizaciones de nivel raz y gestionar todos los ajustes del servidor. El sistema por defecto admin es la
superusuario
Tema
cuenta.
Un archivo JRXML creado externamente y subido a JasperReports Server como base para informes ad hoc. Los temas son
creado por los analistas de negocio para especificar una fuente de datos y una lista de los campos con los que los usuarios de
negocio pueden crear
informes en el Editor Ad Hoc. Los temas se guardan en la carpeta Ad Hoc Componentes del repositorio y
se muestra cuando un usuario inicia el Editor Ad Hoc.
Transactional Data
Los datos que describen aspectos mensurables de un evento, como una transaccin de venta, relevantes para su negocio.
Los datos transaccionales a menudo se almacenan en bases de datos relacionales, con una fila para cada evento y una
columna de tabla o
campo para cada medida.
Usuario
Dependiendo del contexto:
Una persona que interacta con JasperReports Server a travs de la interfaz web. En general, existen tres
categoras de usuarios: administradores que instalan y configuran JasperReports Server, base de datos o expertos
analistas de negocio que crean fuentes de datos y dominios, y los usuarios de negocios que crean y ver informes y
cuadros de mando.
Una cuenta de usuario con un ID y una contrasea para hacer cumplir la autenticacin. Tanto las personas como llamadas a
la API con el acceso
el servidor debe proporcionar el ID y la contrasea de una cuenta de usuario vlida. Las funciones se asignan a cuentas de
usuario a
determinar el acceso a los objetos en el repositorio.
Ver
Varios significados pertenecen a JasperReports del servidor:
Una vista Ad Hoc. Ver Especial View.

Una vista OLAP. Ver OLAP Vista.
Una vista de base de datos. Ver http://en.wikipedia.org/wiki/View_%28database%29.
Virtual Data Fuente

Una fuente de datos virtual le permite combinar los datos que residen en mltiples JDBC y / o fuentes de datos JNDI en un
nica fuente de datos que se pueden consultar los datos combinados. Una vez que haya creado una fuente de datos virtual,
se crea
Los dominios que se unen a las tablas a travs de las fuentes de datos para definir las relaciones entre las fuentes de datos.
277
WCF
Marco de componentes Web. Un componente GUI de bajo nivel de JPivot. Para obtener ms informacin,
consulte
http://jpivot.sourceforge.net/wcf/index.html.
Servicios Web
Un jabn (Simple Object Access Protocol) API que permite a las aplicaciones acceder a ciertas funciones de
JasperReports Server. Las caractersticas incluyen tareas de depsito, programacin y administracin de usuarios.
XML
Extensible Markup Language. Un estndar para la definicin, la transferencia y la interpretacin de los datos para su uso a
travs de cualquier
nmero de aplicaciones habilitadas para XML.
XML / A
XML for Analysis. Un estndar XML que utiliza el protocolo de acceso a objetos simple (SOAP) para tener acceso a datos
remotos
fuentes. Para obtener ms informacin, consulte http://www.xmla.org/
XML / A Conexin
Un tipo de conexin de cliente OLAP que consta de protocolo simple de acceso a objetos (SOAP) definiciones utiliza para
datos de acceso en un servidor remoto. Conexiones de cliente OLAP pueblan vistas OLAP.
278
NDICE
Y
Y parmetro tema 129
A
Sobre ventana JasperReports servidor 23
control de acceso
administrar 57
autenticacin 19
autorizacin 20
permisos a nivel de objeto 60
Permisos 57
repositorio 15
Ad hoc
caching 184
comparacin con Jaspersoft OLAP caching 188
formatos de datos 265
polticas de datos 179
formatos de fecha 265
se ha podido recuperar el tiempo 186
consultas de 178, 184
tiempo de consulta 186
conjuntos de resultados 184
vistas 178, 187, 231
aadiendo
fuentes de datos de frijol 88
tipos de datos 94
carpetas 49
Fuentes de datos JDBC 66
Fuentes de datos JNDI 71
consultas de 92
recursos 50
fuentes de datos virtuales 82
administracin de servidor JasperReports
Especial 178, 184
Amazon Web Services 197
auditora 221
fuentes de datos de frijol 88
temas grfico 207
archivos de configuracin 171
tabla de referencias cruzadas limitar 207
polticas de datos 178-179
fuentes de datos 65
tipos de datos 94
Validacin de dominio 200
carpetas 49
111 fuentes
tareas generales 13
latido del corazn 218
Exportador HTML 208
HTML5 para Pro Listas 209
Los controles de entrada 96
Archivos JAR 111
JasperReports Library 206
Configuracin del servidor JasperReports 183
niveles de la administracin 13
enumera 95
localizacin 256, 261, 266
iniciar sesin como un usuario 62
enumera 96
279
varios administradores 15, 25

ayuda en lnea 219
organizaciones de 12, 25, 55
contraseas 151
consultas de 91, 178
informe Intervalos 216
repositorio de 14, 43, 55
recurso agrupa 111
recursos 50
funciones 17, 36
configuracin de seguridad 145
Ver tambin el control de acceso. [Administrar JasperReports
Servidor
aaa] 15
Resumen de las tareas 25
Suite de Integracin Talend 37
los usuarios 17, 19, 25, 29
XHTML exportador 208
administradores
tareas generales 13
niveles de la administracin 13
administrador de la organizacin 25
administrador del sistema 13
Adobe Flash 209
Amazon Web Services 73, 197
Apache Hadoop. Ver fuentes de datos Hadoop Hive-. 65
Apple iOS 209
Fuentes asiticas 253-254
atributos, perfil. Ver atributos de perfil. 104
auditora
administrar 221
eventos de auditora archivado 221, 224
informes de auditora 229
eventos auditados 222
configuracin 223
importacin y exportacin de datos de auditora 232
de autenticacin. Ver control de acceso. 19
autorizacin. Ver control de acceso. 20
C
el almacenamiento en cach. Ver Ad Hoc. 184
Los controles de entrada en cascada 105
codificacin de caracteres
codificacin de forma 259
JBoss 257-259
Conexiones JDBC 260
Controladores JDBC 258
MySQL 258
no UTF-8 codificacin de caracteres 259
Fuentes de datos OLAP 260
OLAP ve 260
Bases de datos Oracle 258
PostgreSQL 257
Ver tambin fuentes, locales, y la localizacin. [Personaje
codificacin
aaa] 253
Tomcat 256, 259-260
Bases de datos Unicode 260
UTF-8 256
grficos
generacin 210
informes y temas para 207
CLOB 203
Cloudera Impala 65
configurar JasperReports Server. Ver administrar JasperReports Server. 15
copia
carpetas 52
recursos 16, 52
la creacin de
tipos de datos 94
carpetas 49
Los controles de entrada 97
enumera 96
consultas de 92
recursos 16
informe de tabla cruzada, Errores de falta de memoria 207
CSS archivos 118, 127
fuentes de datos personalizados 66
B
frijoles. Ver fuentes de datos. 88
grandes volmenes de datos 78,
181
la navegacin de repositorios 16
D
polticas de datos 178-179
280
ndice
fuentes de datos
administrar 65
Amazon Web Services 73
frijol 88
la combinacin. Ver fuentes de datos virtuales. 82
personalizada 66
JDBC 66
JNDI 71
consultas de 93
virtuales 82
el almacenamiento en cach de datos 184
dataSnapshotService frijol 191
tipos de datos
administrar 94
y controla la entrada 97, 99
la creacin de 94
Para los controles de entrada 94
tipos 94
formatos de fecha 264-265
incumplimientos
cambiar 171
temas grfico 207
Validacin de dominio 200
instalacin 12
locale 261
Carcter Oracle establece 258
Sinnimos de Oracle 202
Fuentes PDF 256
reportar opcin de programacin intervalo de 216
papeles 36
zona horaria 268
29 usuarios
borrado
carpetas 54
recursos 16, 54
demostracin. Ver Supermart. 37
diagnstico 233
Dominios
adaptar los informes a los pblicos 92
Tipos de columna JDBC 204
validacin 200
exportar
datos de auditora 232
desde la interfaz de usuario 133134
visin general 131
recursos 137
F
favicon.ico presentar 119
Plug-in de 128 Firebug
Flash 209
Plantilla Carpeta 28, 127
carpetas
la creacin de 49
borrar 54
edicin 51
Plantilla Carpeta 28
mvil 52
Pblica 16
fuentes
administrar 111
Asia Oriental 253-254
en el depsito de 111
Jaspersoft OLAP 255
localizacin 253
multi-byte 253
fuentes no UTF-8 259
OLAP ve 255
Archivos PDF 256
Ver tambin la codificacin de caracteres, locales, y la
localizacin.
[fuentes
aaa] 253
solucin de problemas en los archivos exportados 111
mscaras de formato 265
Grficos de fusin 209-210
T
cartas que generan 210
GlobalPropertiesList 174
E
carpetas de edicin y recursos 51
eventos. Ver registro. 221
Fuentes de datos Hadoop Hive-78

latido del corazn 21, 218
configuracin ayuda 219
Generacin Highcharts 210
Idioma Hive Consulta 65
HiveQL 94
281
Exportador HTML 208

HTML5 209
I
Impala 65
importacin
datos de auditora 232
desde la interfaz de usuario 135
visin general 131
recursos 139
controles de entrada
aadiendo 97
administrar 96
y tipos de datos 94, 97, 99
cascada 105
la creacin de 97
lista de valores para 95
lista Tipo 95
parmetros para la entrada en cascada controla 106-107
parmetros de entrada basado en consultas controla 106
99 basado en consultas
ahorro de 95-96, 99
tipos 97
internacionalizacin. Ver localizacin. 253
iReport. Ver Jaspersoft iReport Designer. 11
JBoss
y la configuracin UTF-8 257
JBoss Portal 171
JMX 233
Archivos JRXML
sintaxis de referencia. Ver repositorio. 46
recurso agrupa 111
comando js-exportacin 137
comando js-importacin 139
idiomas. Ver localizacin. 253

caducidad de la licencia 23
Liferay Portal 171
listas
administrar 95
la creacin de 96
controla tipo de lista de entrada 95
locales
administrar 266
codificacin de caracteres 259
la creacin de 261
formatos de fecha 264-265
mscaras de formato 265
no UTF-8 codificacin de caracteres 260
261 propiedades
Ver tambin la codificacin de caracteres, las fuentes, y la
localizacin.
J
[locales
aaa] 261
Archivos JAR, la administracin de 111
zonas de tiempo 267
JasperAnalysis. Ver Jaspersoft OLAP. 11
localizacin
JasperETL 37
253 fuentes
JasperReports Biblioteca
JasperReports servidor 261
configuracin 206
Jaspersoft iReport Diseador 263
la creacin de informes 11
OLAP ve 255, 260
se extiende 206
Ver tambin codificacin de caracteres, fuentes y lugares.
estructura de un JasperReport 45
[LocalJasperReports Servidor
izacin
configuracin 183
aaa] 253
plug-in para iReport 108
UTF-8 256
JasperServer. Ver la administracin de JasperReports Server. 11 tala
Jaspersoft iReport Diseador
eventos de auditora. Ver la auditora. 221
temas grfico 207
los eventos del sistema 192
la creacin de informes con 11
recurso agrupa 263
Jaspersoft OLAP 37, 188, 255
Java Management Extensions (JMX) 233
Motor de JavaScript 210
iniciar sesin como un usuario

62
282
ndice
M
maxFilterValues 190
maxHttpHeaderSize 245
MaxPostSize 244
Consulta MDX en vista Especial 178
mdxDataStrategy 190
Fuentes de datos MongoDB 66
monitoreo
configuracin 223
muestra de 231 informes
movimiento
carpetas 52
recursos 16, 52
fuentes multi-byte 253
mltiples organizaciones. Vea las organizaciones. 55
MySQL 180, 258
N
NVARCHAR2 204
contraseas
auditora 227
expiracin 151
usuarios cambiar 152
PDF
la incrustacin de fuentes 256
Resolucin de problemas de fuentes en 111
permisos. Ver control de acceso. 57, 60
PhantomJS 210
plug-in para iReport 108
portlets
y JBoss 171
y Liferay 171
papel 37
PostgreSQL 257
Pro Listas 209
Pro generacin Charts 210
Atributos de perfil 34
y la auditora 223
y controles de entrada basado en consultas
104
definido 21
'31 usuarios que ven
archivos de propiedades
la creacin de 261
recurso agrupa 263
Carpeta pblica 16
O
OLAP ve 21, 255, 260
ayuda en lnea 219
Oracle
juegos de caracteres 258
CLOB 203
NVARCHAR2 204
sinnimos 202
TIMESTAMP WITH LOCAL TIME ZONE 205
TIMESTAMP WITH TIME ZONE 205
organizaciones
roles de administracin 36
administrar 25
predeterminado 12
estructura de carpetas 28
mltiples 12, 25, 55
Organizaciones carpeta 28
la bsqueda de 27
solo 12, 25
suborganizaciones 13
Errores de falta de memoria 207
archivo overrides_custom.css 120
Q
consultas
administrar 91
y considera Especial 178, 184
la creacin de 92
mltiples lenguajes de consulta 94
parmetros para la entrada en cascada 106 controla
parmetros de entrada basado en consultas controla 106
ejecutores de consulta 94
utilizando 91
Los controles de entrada basado en consultas 99
sintaxis repo 46
informes
y controla la entrada en cascada 110
la creacin de 11
JasperReport 46
Biblioteca JasperReports 11
consultas con parmetros. Ver consultas. 96
283

informe Intervalos 216
programacin 216
solucin de problemas de fuentes en los informes
exportados 111
repositorio
control de acceso 15
la administracin de 14, 43
navegacin 16
configuracin 55
diseo emite 55
eventos 227
carpetas 14
importacin y exportacin de 131
Carpeta pblica 16
sintaxis de referencia 46
recursos que hacen referencia a 56
recursos 14, 46
datos de la muestra 15
buscar 16, 38
Ver tambin los recursos. [Repositorio
aaa] 16
estructura 14
Codificacin UTF-8 257-258
paquetes de recursos
en el depsito de 111
Ver tambin la localizacin. 263
recursos
agregando 16, 50
navegacin 16
copia 16
corte de 16
eliminacin de 16, 54
edicin 51
111 fuentes
importacin y exportacin de 131
en el repositorio 46
Archivos JAR 111
mvil 52
pegar 16
consultas de 91
recurso agrupa 111
referencias de recursos en archivos JRXML. Ver
repositorio. 46
buscar 16
conjuntos de resultados 184
284
Rhino 210
papeles
administracin de 17, 36
administrativa 25
y usuarios 36
roles predeterminados 36
la bsqueda de 38
S
ahorro
Los controles de entrada 95-96, 99
buscar en el repositorio de 16, 38
seguridad 145
tiempo de espera de la sesin 153
snapshotPersistenceEnabled 191
snapshotRecordingEnabled 191
Consulta SQL en la vista Especial 178
suborganizaciones. Vea las organizaciones. 13
Demostracin Supermart y funciones 37
apoyo, la bsqueda de la versin de producto 23
roles de administrador del sistema 36
registro del sistema 192
Carpeta Propiedades del sistema 174
T
Talend Integration Suite (TIS EE) 37
temas
Y parmetro tema 129
tema activo 118
CSS archivos 118, 127
costumbre prevalece sobre 120
tema por defecto 117
descargar 125
Plug-in de 128 Firebug
en la plantilla de carpeta 127
mecanismo de herencia 119
tema heredado 118
permisos 123
recuperando de 129 inadvertida cambia
galeras de muestra 129
Ver tambin trazar temas. [temas
&&] 115
tema del sistema 117
Carpeta Themes 117
ndice
subir 126
Parmetro URL 129
Archivo ZIP 124
APIs de terceros 111
zonas de tiempo 267
TIMESTAMP WITH LOCAL TIME ZONE 205
TIMESTAMP WITH TIME ZONE 205
Tomcat 256
traducciones 253
U
Formato de transformacin Unicode (UTF-8). Ver personaje
codificacin. 256
Recursos Identificadores universal (URI) 56
muestras de interfaz de usuario 129
usuarios
la administracin de 17, 19, 29
autenticar 19-20, 57
el cambio de contraseas 152
usuarios por defecto 29
ingresar como 62
papeles 36
la bsqueda de 31
tiempo de espera de la sesin 153
V
versin del software 23
21 visitas
W
servicios web 225
X
XHTML exportador 208
285
286

JasperReports Server Admin Guide Release 5.6.es PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

JasperReports Server Admin Guide Release 5.6.es PDF

Hochgeladen von

Copyright:

Verfügbare Formate

JasperReports SERVIDOR

Captulo 2 Organizacin, usuario y administracin de funciones

Gua del administrador del servidor JasperReports

2.2.5 Activacin o desactivacin de usuarios en bloque

Captulo 3 Administracin Repositorio

Captulo 4 Fuentes de datos

4.7 Fuentes de datos MongoDB

Captulo 5 Otros recursos en el Repositorio

Gua del administrador del servidor JasperReports

6.5.5 Interfaz de usuario de ejemplo

Captulo 8 Seguridad de aplicaciones

8.10 de cifrado de sesin de usuario Inicio de

Gua del administrador del servidor JasperReports

9.11.3 Restriccin del sistema de archivos de salida

Captulo 10 Diagnsticos del servidor

Apndice A Solucin de problemas

A.12.5 JDBC URL de base de datos

Gua del administrador del servidor JasperReports

CAPTULO 1 PANORAMA DE JasperReports SERVIDOR DE

Este captulo contiene las siguientes secciones:

Informacin general de las

Gua del administrador del servidor JasperReports

Visin general de usuarios y roles

Informacin general de las

Individual Organizacin por omisin

Captulo 1 Introduccin a la administracin del servidor JasperReports

Los niveles de Administradores

y eliminar usuarios, roles y objetos de repositorio de cualquier organizacin.

Gua del administrador del servidor JasperReports

Descripcin del repositorio

Figura 1-1 raz de las carpetas predeterminadas Mostrando Repositorio

Captulo 1 Introduccin a la administracin del servidor JasperReports

Organizacin admin (jasperadmin) Vista:

Figura 1-2 Sistema de admin y la admin Vistas de datos de ejemplo

Gua del administrador del servidor JasperReports

Explorar - En la pgina Inicio, haga clic en Ver> Repositorio.

Figura 1-3 Navegando por el repositorio

Captulo 1 Introduccin a la administracin del servidor JasperReports

Figura 1-4 Bsqueda del Repositorio

Visin general de usuarios y roles

Administracin de usuarios y roles

Gua del administrador del servidor JasperReports

Crear, modificar y eliminar usuarios.

Captulo 1 Introduccin a la administracin del servidor JasperReports

La autorizacin se explica con ms detalle en una seccin siguiente.

Inicio de sesin nico utilizando central Servicio de autenticacin de JA-SIG (CAS)

Autenticacin Java y Servicio de autorizacin (JAAS)

Seguridad de los contenedores (Tomcat, Espoln)

El acceso de usuarios annimos (deshabilitado por defecto)

JasperReports Server tambin es compatible con estos estndares de cifrado y autenticacin:

HTTPS, incluyendo el requerir HTTPS

Gua del administrador del servidor JasperReports

Los permisos se aplican al acceder a cualquier recurso, ya sea directamente a travs de la

JasperReports servidor distingue entre la lectura o escritura de un recurso en el

Captulo 1 Introduccin a la administracin del servidor JasperReports

Proyecto de la Comunidad: administrador de sistema: nombre de usuario jasperadmin y la contrasea jasperadmin

JasperReports Server Heartbeat

Gua del administrador del servidor JasperReports

Figura 1-5 Diferentes Administrar mens para diferentes administradores

Captulo 1 Introduccin a la administracin del servidor JasperReports

Figura 1-7 Acerca JasperReports dilogo del servidor

Gua del administrador del servidor JasperReports

CAPTULO 2 ORGANIZACION, DE USUARIO, Y LA GESTIN