JasperReports Server Admin Guide Release 5.6.es.pdf

JasperReports SERVIDOR

GUÍA 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 demás nombres de compañías y de productos son o pueden ser el comercio nombres o marcas comerciales de sus respectivos propietarios.

Esta es la versión 0814-JSP56-20 del Guía del administrador del servidor JasperReports.

Tabla de contenido

Capítulo 1 Introducción a la administración del servidor JasperReports

1.1 Descripción general de las Organizaciones 1.1.1 Individual Organización por omisión 1.1.2 Organizaciones Múltiples 1.1.3 Niveles de Administradores 1.2 Descripción 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 Administración de usuarios y roles 1.3.2 Administración delegada 1.4 Introducción a la seguridad 1.4.1 Autenticación 1.4.2 Autorización general 1.5 Administrator Login 1.5.1 JasperReports Server Heartbeat 1.5.2 Administrador de Correo Pages 1.6 Administrador

Capítulo 2 Organización, usuario y administración de funciones

2.1 Las organizaciones encargadas 2.1.1 Visualización de las propiedades de la Organización 2.1.2 Creación de una Organización 2.1.3 Las carpetas predeterminadas para Organizaciones 2.1.4 Edición de una Organización 2.1.5 Eliminación de una Organización 2.2 Administración de usuarios 2.2.1 Visualización de las propiedades del usuario 2.2.2 Creación de un usuario 2.2.3 Edición de un usuario 2.2.4 Edición 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

3

Guía del administrador del servidor JasperReports

2.2.5 Activación o desactivación de usuarios en bloque 2.2.6 Borrado de uno o más usuarios 2.3 Roles Gestión 2.3.1 Visualización de Propiedades de la función 2.3.2 Creación de un rol 2.3.3 Asignación de usuarios a un rol 2.3.4 Borrado de una o varias funciones

Capítulo 3 Administración 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 Gestión de carpetas y Recursos 3.3.1 Recursos IDs 3.3.2 Creación 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 Edición de Recursos 3.3.7 Supresión de carpetas y Recursos 3.4 Múltiples Organizaciones en el Repositorio 3.4.1 Organización de carpetas 3.4.2 Consideraciones de diseño 3.4.3 menciona recursos en el Repositorio 3.4.4 Mejores Prácticas 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 sólo 3.5.5 Permisos de usuario por defecto 3.5.6 Establecer permisos 3.5.7 Pruebas de permisos de usuario

Capítulo 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 Creación de un origen de datos Cassandra 4.5.2 El aumento de los límites 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

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 orígenes de datos virtuales 4.9.1 Creación de Big Data Conectores 4.9.2 Esquema Relacional para MongoDB Conector 4.10 Fuentes de datos de frijol

Capítulo 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 Creación de un control de entrada basado en consultas 5.5.2 Parámetros 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 Parámetros en consultas de control de entrada 5.6.2 Creación 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 Creación de un recurso de archivo 5.7.5 Edición de un archivo de recursos

Capítulo 6 Temas

6.1 Introducción a los Temas 6.2 ¿Cómo 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 Administración de 6.3.1 Ajuste del tema del sistema 6.3.2 Establecimiento de una Organización Temática 6.3.3 Restringir el acceso a los temas 6.4 Creación de Temas 6.4.1 Creación de carpetas temáticas 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 Modificación de la presentación 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

5


6.5.5 Interfaz de usuario de ejemplo

Capítulo 7 Importación y Exportación

7.1 Importación y exportación Catálogos 7.1.1 Ajuste de la clave de cifrado Import-Export 7.1.2 Importación sin cifrar Catálogos 7.2 Importación y exportación a través de la interfaz de usuario web 7.2.1 Exportación desde la interfaz de usuario del repositorio 7.2.2 Exportación desde la interfaz de usuario de configuración 7.2.3 Importación desde la interfaz de usuario de configuración 7.3 Importación y exportación a través de la línea de comandos 7.3.1 Exportación desde la línea de comandos 7.3.2 Importación desde la línea de comandos 7.3.3 Configuración de Importación-Exportación Utilidades 7.4 Alternos Scripts Import-Export 7.4.1 Ejecución de Importación de Buildomatic 7.4.2 Ejecución de Exportación de Buildomatic

Capítulo 8 Seguridad de aplicaciones

8.1 Cifrado de contraseñas en los archivos de configuración 8.1.1 Configuración de cifrado de contraseñas en Tomcat (o primavera tcServer) 8.1.2 Cifrado de contraseñas de configuración en la Enterprise Servers 8.1.3 Cifrado de Propiedades adicionales en default_master.properties 8.1.4 Cifrado de contraseña para la autenticación externa 8.1.5 Opciones de cifrado 8.2 Configuración de opciones de contraseña de usuario 8.2.1 Configuración de la memoria Contraseña 8.2.2 Habilitación de caducidad de la contraseña 8.2.3 Permitir que los usuarios cambien sus contraseñas 8.2.4 Cumplimiento de patrones de contraseña 8.3 Configuración del usuario Sesión inactiva Prevención 8.4 Configuración CSRF 8.5 Configuración de validación de entrada 8.5.1 Mensajes de Error del Seguro 8.5.2 Edición de reglas de validación de entrada 8.5.3 Creación de expresiones Validator 8.5.4 Validación de Nuevos Parámetros de entrada 8.5.5 validación de consulta 8.5.6 Configuración adicional 8.6 Restricción de la subida de archivos 8.7 Ocultación de Seguimiento de la pila de mensajes 8.8 Definición de una directiva entre dominios para Flash 8.9 Cifrado de contraseñas de usuario 8.9.1 Caídas e Recreando la base de datos en PostgreSQL 8.9.2 Caídas e Recreando la base de datos en MySQL 8.9.3 Caídas e Recreando la base de datos en Oracle 8.9.4 Caídas 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

6

8.10 de cifrado de sesión de usuario Inicio de sesión 8.10.1 Clave Dinámica Encryption 8.10.2 estático clave de cifrado

Capítulo 9 Configuración del Sistema

9.1 Ajustes de configuración en la interfaz de usuario 9.2 Configuración para el uso de proxies 9.3 Configuración de la persistencia de sesión 9.4 Configuración Ad Hoc 9.4.1 Ad Hoc Configuración de la consulta 9.4.2 Ad Hoc Políticas de datos 9.4.3 Ad Hoc Políticas de datos para Big Data 9.4.4 Ad Hoc plantillas de informe y Generadores 9.4.5 Ad Hoc del archivo de configuración 9.4.6 Ad Hoc administración del caché 9.4.7 Ad Hoc Configuración de filtros OLAP 9.5 Habilitación de datos instantáneas 9.5.1 Configuración Global Snapshot de datos 9.5.2 Informe de nivel de configuración de instantánea de datos 9.5.3 Datos instantáneas en el Programador 9.6 Configuración de registros del sistema 9.6.1 Administración de los valores de registro 9.6.2 Archivos de registro de configuración 9.6.3 Adición de un registrador a la página Configuración de registro 9.7 Configuración de servicios Web de Amazon 9.8 Configuración de Dominios 9.8.1 Desactivación de la validación de dominios Comprobar 9.8.2 Optimización del copo de nieve de esquema se une 9.8.3 Configuración de dominio Dependencia Comportamiento 9.8.4 Habilitación de Oracle sinónimos 9.8.5 Habilitación de campos CLOB 9.8.6 Habilitación de tipos de propiedad 9.8.7 Extendiendo Mapping JDBC Tipo 9.8.8 Acceso a vistas materializadas 9.9 Configuración de JasperReports Biblioteca 9.9.1 Ampliación de JasperReports Biblioteca 9.9.2 Cambiar el límite de referencias cruzadas 9.9.3 Configuración de un Chart Tema Global 9.9.4 Desactivación de interactividad en el Visor de informes 9.9.5 Habilitación de las XHTML o HTML Exportadores 9.9.6 Habilitación de Flash o HTML5 para Pro Charts 9.9.7 Configuración de un motor de JavaScript para la gráfica de representación de informes 9.10 Configuración del funcionamiento del control de entrada 9.11 Configuración del Programador 9.11.1 Configuración de la Directiva fallo de encendido del Programador 9.11.2 Configuración 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

7


9.11.3 Restricción del sistema de archivos de salida 9.11.4 Extracción de opciones Informe Programación de intervalo 9.11.5 Adición de un Holiday Exclusión Calendario 9.12 Configuración del latido del corazón 9.13 Configuración de la Ayuda en línea

Capítulo 10 Diagnósticos del servidor

10.1 Eventos que se audita y monitoreados 10.2 Configuración de Auditoría y Supervisión 10.2.1 Habilitación Auditoría y Monitoreo 10.2.2 Auditoría Opciones de copia de 10.2.3 Desactivación de Eventos y Propiedades 10.3 Uso de los Datos de Auditoría 10.3.1 Elementos de dominio de Auditoría 10.3.2 Informes de Auditoría y Ad Hoc Vistas 10.4 Uso de la Monitorización de Datos 10.4.1 Los productos Domain Monitoring 10.4.2 Informes de Seguimiento y Ad Hoc Vistas 10.5 Importación y exportación de datos de eventos 10.6 Real-Time Diagnóstico 10.7 La exposición de Diagnóstico a través del agente JMX de Jaspersoft 10.7.1 Conexión al agente JMX 10.7.2 Configuración del nombre del puerto y la conexión 10.7.3 Configuración de las funciones para las conexiones JMX 10.7.4 Desactivación de conexiones remotas a la agente JMX 10.7.5 Conexión Alternativa a través del servicio del servidor de aplicaciones JMX 10.8 Uso de los datos de diagnóstico en los Informes Atributos 10.9 Excluyendo diagnóstico 10.10 Desactivación Real-Time Diagnóstico

Apéndice A Solución de problemas

A.1 Número 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 electrónico Programador A.10 Correr Tareas eliminadas A.11 Gráficos que no aparece en Excel de Exportación 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

8

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 Creación de un origen de datos de SQL Server mediante la autenticación de Windows A.13 Hadoop Hive-Reports no se ejecuta A.14 Volviendo a la página inicial Antiguo

Apéndice B Localización

B.1 Configuración de JasperReports Server para Multi-byte Fuentes B.1.1 Habilitación de fuentes asiáticas del este Cuadros B.1.2 Configuración Ad Hoc para fuentes asiáticas B.1.3 Configuración de las opciones de OLAP para gráficos por defecto Fuentes B.1.4 incrustación de fuentes en PDF de salida B.2 UTF-8 Configuración B.2.1 Tomcat B.2.2 JBoss B.2.3 PostgreSQL B.2.4 MySQL B.2.5 Oracle B.3 Cambio de codificación de caracteres B.3.1 Configuración de servidor JasperReports B.3.2 Configuración de la base de datos del servidor Application Server y Configuración B.3.3 para localizados esquemas de análisis B.4 La creación de un Locale B.4.1 Acerca de las propiedades de archivos B.4.2 Creación de un paquete de recursos B.4.3 Ajuste de la fecha y de fecha y hora Formatos B.4.4 Configuración de formato de datos Máscaras B.5 Configuración JasperReports servidores que ofrece una configuración regional B.5.1 Especificación de los entornos nacionales adicionales B.5.2 Especificación de zonas horarias adicionales B.5.3 Configuración de una zona horaria predeterminada

Glosario

Índice

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

269

279

9


10

CAPÍTULO 1 PANORAMA DE JasperReports SERVIDOR DE ADMINISTRACIÓN

JasperReports Server genera en JasperReports Biblioteca como una familia completa de Business Intelligence (BI) productos, proporcionando sólidos informes estático e interactivo, servidor de informes y capacidades de análisis de datos. Estos las capacidades están disponibles como productos independientes o como parte de una suite de BI integrado de extremo a extremo utilizando metadatos comunes y la prestación de servicios compartidos, tales como la seguridad, un depósito, y la programación. El corazón de la Jaspersoft BI Suite es el servidor, que proporciona la capacidad de:

• • • •

Fácil de ver y explorar los datos en el basado en la web de arrastrar y soltar Ad Hoc interfaz del Editor. Eficiente y segura gestión de muchos informes. Interactuar con los informes, incluida la clasificación, filtrado, el formato, la introducción de parámetros y la perforación en los datos. Organizar informes y contenido de la web para crear atractivas, Jaspersoft Dashboards ricos en datos que transmiten rápidamente tendencias de negocios.

Jaspersoft OLAP es un componente opcional de JasperReports Server, controlada por licencia y se describe en su guía de usuario propia.

Mientras que el Editor Ad Hoc permite a los usuarios crear informes sencillos, informes más complejos se pueden crear fuera de la servidor. Puede usar Jaspersoft iReport Designer (en adelante denominado "iReport") o escribir su propio código 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 Guía del usuario del servidor JasperReports para más información. Jaspersoft ofrece varias otras fuentes de información para ayudar a ampliar su conocimiento de JasperReports del servidor:

•

•

Nuestros guías Ultimate documentan funciones avanzadas, las mejores prácticas, 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 están disponibles en línea en el profesional Sección de Servicios de nuestra sitio web. Nuestras muestras gratuitas, que se instalan con JasperReports Biblioteca, Jaspersoft iReport Designer y JasperReports

Server, se documentan en línea. El muestras documentación se puede encontrar en nuestra comunidad web.

Esta guía del administrador describe características que sólo están disponibles para los usuarios que tienen funciones de administrador. Muchos de los procedimientos de configuración también se supone que tiene acceso ilimitado a los JasperReports Equipo host del servidor.

Este capítulo contiene las siguientes secciones:

• •

Información general de las Organizaciones Descripción del repositorio

11


• • • •

Visión general de usuarios y roles Introducción a la seguridad Administrator Login Administrador de Páginas

En esta sección 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 sección, su licencia puede prohibirle usarlos. Para saber lo que usted está autorizado a utilizar, o para actualizar su licencia, póngase en contacto con Jaspersoft.

JasperReports Server es un componente tanto de un proyecto comunitario y ofertas comerciales. Cada integra la características estándar tales como la seguridad, la programación, una interfaz de servicios web, y mucho más para correr y compartir informes. Ediciones comerciales ofrecen características adicionales, gráficos Ad Hoc, gráficos flash, cuadros de mando, incluyendo, Dominios, auditoría, y una arquitectura multi-organización para la celebración de grandes despliegues de BI.

1.1 Información general de las Organizaciones La arquitectura de la versión comercial de JasperReports Server se basa en las organizaciones, que son lógicas entidades dentro de JasperReports Server que tienen sus propios usuarios, roles y ramas del repositorio. Como con cualquier estructura empresarial o jerarquía, las organizaciones pueden tener suborganizaciones, que a su vez puede tener suborganizaciones, y así sucesivamente.

En la instalación JasperReports Server por omisión, hay una sola organización que imita la estructura simple de versiones anteriores de JasperReports servidor. Si desea implementar múltiples organizaciones, hay cierto diseño consideraciones que deben tener en cuenta.

1.1.1 Individual Organización por omisión

Después de una instalación por defecto, JasperReports Server contiene una sola organización en la que usted puede implementar su informes. Por ejemplo, si instala los datos de ejemplo, se ve una sola organización que mantiene toda la muestra recursos, usuarios y roles. Organizaciones individuales están diseñados para manejar la mayoría de los casos de negocios y son fáciles de administrar. Incluso en un organización única, hay un administrador de sistema y un administrador organización que comparten tareas administrativas. Si el necesidades de su negocio llamar para más organizaciones, que deben gestionar varios niveles de administración y posiblemente crear recursos compartidos en el repositorio. Las siguientes secciones ofrecen los casos de uso y explicar la funcionamiento de múltiples niveles de los administradores.

1.1.2

•

Múltiples organizaciones

Hay muchos escenarios para la definición de múltiples organizaciones en JasperReports Server. Por ejemplo:

Un proveedor de la aplicación, tales como (SaaS) empresa de software-as-a-service o un departamento informático, tiene una aplicación alojada siendo ofrecido a muchos clientes. Integra JasperReports servidor en su aplicación en para ofrecer cuadros de mando, informes y análisis. Hay una serie de informes comunes y fuentes de datos que son útiles en todos los clientes, pero hay informes específicos de los clientes, así. Máquinas y bases de datos son compartida por los clientes, de acuerdo con la propia arquitectura del proveedor, pero dentro de la funcionalidad proporcionada por

12


•

JasperReports Server, cada cliente es una organización independiente. Los clientes pueden gestionar sus propios usuarios en el aplicación alojada, y mapas de JasperReports esquema de autenticación del servidor de la aplicación para la correcta organización. El mecanismo de organización 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 común. Corporativo de TI sólo tiene que implementar y mantener una única instancia de JasperReports Server, y cada departamento está representado por una organización 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 organización se han definido las fuentes de datos Dominios y específica a las necesidades de los usuarios de sus departamentos. La función de organización es suficiente para acomodar cualquier combinación de estos escenarios flexibles y muchos como

ella. En todos los casos, los administradores pueden configurar entornos seguros para cualquier número de organizaciones y usuarios finales experimentar una potente plataforma de BI que se adapte a sus necesidades. Cada organización o jerarquía de las organizaciones co-existe con independencia de la misma instancia de JasperReports Server, que aísla las organizaciones vecinas entre sí, sino que permite a las organizaciones de padres tienen plena control sobre sus suborganizaciones. Los usuarios pueden acceder sólo a los datos y recursos en su organización o un suborganización y administradores pueden definir las funciones y establecer permisos para restringir aún más el acceso.

1.1.3 Los niveles de Administradores

Cada organización tiene un administrador que puede administrar usuarios, roles y permisos del repositorio en que organización. La administración de las organizaciones es jerárquica, lo que significa que el administrador también puede gestionar todos los usuarios y roles en suborganizaciones de cualquier nivel.

Fundamentalmente, hay tres niveles de administración:

• El administrador del sistema - También llamado administrador de sistema. La ID del administrador de sistema es superusuario. Él existe en el nivel raíz, fuera de todas las organizaciones. El sistema de administración gestiona la instalación 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 organización. El administrador de una organización de nivel superior - También llamado organización de administración. El administrador organización gestiona todos los usuarios, roles y objetos de repositorio en toda una organización, incluyendo cualquier suborganizaciones. El nombre predeterminado de inicio de sesión del administrador organización es jasperadmin. El administrador de un suborganización - Funcionalmente equivalente a un administrador organización, pero debido a la jerarquía de las organizaciones, gestiona un conjunto limitado de usuarios, roles y objetos del repositorio y puede ser anulado por una organización de administración de nivel superior.

•

•

La distinción más importante es entre el administrador de sistema y organización de administración. Incluso en el caso de un organización predeterminada sola, hay un administrador de sistema para la configuración del servidor, y un administrador para la organización única organización. El sistema administrador puede gestionar todos los usuarios y todo el repositorio, pero a veces es más conveniente utilizar el administrador de la organización para hacer esto debido a que el administrador organización ve el repositorio en la misma manera que los usuarios de la organización. Cuando hay suborganizaciones, el administrador de la organización matriz puede o bien gestionar sus usuarios y papeles, o delegar esas tareas a un administrador en cada suborganización. El administrador de un suborganización se limita a acceder a los recursos y la gestión de usuarios y roles en el suborganización, por lo tanto el mantenimiento de la seguridad de la organización matriz y la o de los padres de otros suborganizaciones.

13


1.2 Descripción del repositorio

El repositorio es una estructura jerárquica de carpetas donde JasperReports Server, los administradores y los usuarios almacenar recursos para la creación, funcionamiento y visualización de informes. En su aspecto y función, 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 raíz de la estructura de árbol del repositorio es accesible sólo para el administrador de sistema conectado como superusuario (Como se se muestra en la siguiente figura) en la edición comercial, o jasperadmin en la edición de la comunidad. El árbol contiene las carpetas de cada organización (en la edición comercial), y carpetas para determinada configuración configuración.

Figura 1-1 raíz de las carpetas predeterminadas Mostrando Repositorio

En el repositorio, cada organización tiene su propia rama, contenida en una carpeta con el nombre de la organización. Cada carpeta de nivel superior de organización también contiene una carpeta llamada Organizaciones de modo que pueden ser suborganizaciones creado. La figura anterior muestra la opinión del superusuario, a partir de la raíz. En la carpeta Organizaciones hay una carpeta para la organización por omisión, que se denomina Organización. Esta figura también muestra una segunda organización de nivel superior. Usuarios de edición comercial conectado como jasperadmin verá una estructura similar. JasperReports servidor automáticamente restringe el acceso de cada usuario a la sucursal de su propia organización de la repositorio. Los administradores del sistema (superusuario) Pueden ver y crear carpetas en todas las organizaciones, mientras que la organización (administradoresjasperadmin) Sólo puede ver y crear carpetas en las organizaciones que administran. En general, Jaspersoft recomienda evitar la colocación de recursos directamente en la carpeta raíz o de la organización. En su lugar, uti lice 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 creación de informes y la realización de análisis. Algunos recursos, como imágenes, 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 también 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 también.

14


Todos los recursos, incluyendo carpetas, tienen un identificador único, un nombre y una descripción 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 descripción aparece en la interfaz de usuario cuando el navegador o buscar en el repositorio. Los recursos se almacenan en un formato interno que no 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-exportación de servicios públicos, 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 función de las organizaciones, nombres de usuarios y roles. El administrador de sistema y organización de administración pueden definir permisos como se explica en "Visión general de usuarios y funciones" en la página 17.

1.2.3 Sample Data

Al instalar los datos de ejemplo en JasperReports Server, la organización por omisión (Organización) 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 organización predeterminada de administrador.

Administrador del sistema (superusuario) Vista:

Organización 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 fácil 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 pública es una carpeta especial del sistema que aparece en la raíz y en cada carpeta de organización. Su contenido se comparten con todas las organizaciones. El sistema de administración debe gestionar la carpeta pública 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 función de la acción que se desea realizar y cómo se organizan los recursos. Al navegar por las carpetas y su contenido, los administradores tienen más acciones disponibles, tales como la creación de recursos. Buscando el repositorio encuentra recursos específicos más rápido.

• Explorar - En la página Inicio, haga clic en Ver> Repositorio.

Figura 1-3 Navegando por el repositorio

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 búsqueda no tiene la barra de herramientas. • Buscar - Ingrese un término de búsqueda en el campo de búsqueda en la parte superior de cualquier página, o seleccione Ver> Resultados de la búsqueda.

16


Figura 1-4 Búsqueda del Repositorio

Los filtros en el panel de la izquierda permiten a los usuarios a refinar su búsqueda. El Ver> Informes y Ver> OLAP Vistas también utilizar la función de búsqueda con filtros predefinidos para encontrar todos los informes y todas las vistas OLAP a la que el usuario tiene acceso.

Para obtener más información sobre la navegación y la búsqueda en el repositorio, consulte la Guía del usuario de JasperReports Server.

1.3 Visión general de usuarios y roles

Las cuentas de usuario y la pertenencia a funciones proporcionan mecanismos de autenticación y autorización para implementar el acceso Control en JasperReports Server. Los usuarios introducen un nombre de organización si se requiere, un nombre de usuario y una contraseña en Para acceder a JasperReports Server. Basada en funciones de administradores asignan nombrados roles a usuarios y luego crean permisos para restringir aún más el acceso a los objetos del repositorio y en los datos de Dominios. En la versión comercial de JasperReports Server, los usuarios y los roles están asociados con las organizaciones en que se han definido, y que siguen el mismo modelo jerárquico. Usuarios y roles definidos en una organización puede ser concedido o denegado el acceso a cualquier carpeta del depósito o el objeto en la organización o sus suborganizaciones. Sin embargo, el administrador de la suborganización no tiene visibilidad de los roles y los usuarios de los padres organización, incluso si se utilizan en el permiso de acceso dentro de la suborganización.

Los nombres de usuario y nombres de rol son únicos dentro de una organización, pero no necesariamente entre suborganizaciones o en todas las organizaciones en el servidor. Por ejemplo, el administrador de la organización por defecto se llama jasperadmin en toda organización. Debido a que la organización se debe dar al iniciar la sesión, 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 edición de la comunidad de JasperReports Server, no es sólo una organización predeterminada. Todo usuario y el papel nombres pertenecen a esta organización.

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 sólo 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 Administración de usuarios y roles

Los administradores realizan las siguientes acciones para gestionar los usuarios en su organización:

17


• •

• • • •

Crear, modificar y eliminar usuarios. Establecer propiedades de la cuenta de usuario, como nombre, correo electrónico, y la configuración de la contraseña. Sin embargo, ningún administrador puede nunca ver la contraseña existente de un usuario en texto sin cifrar. Entrar como cualquier usuario de la organización 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.

1.3.2

•

Administración delegada

JasperReports Server permite tres niveles de la administración delegada:

La estructura jerárquica de las organizaciones significa administradores en cada organización se limitan a acciones dentro de su organización. Pero esto sólo se aplica a múltiples 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 sección del repositorio, pero no para crear o administrar usuarios. Concesión ROLE_ADMINISTRATOR,ROLE_SUPERUSER, O ambos permite a un usuario para ver la interfaz de gestión y crear usuarios y roles. Esto es cierto la administración delegada, mediante el cual un usuario que no sea superusuario o jasperadmin tiene las mismas habilidades.

•

•

En el caso de la verdadera administración delegada, hay tres factores que determinan el alcance de un usuario de privilegios administrativos:

• ROLE_ADMINISTRATOR - JasperReports Servidor confiere los privilegios de nivel de organización para cualquier usuario con este

•

papel. Esto incluye Gestión de usuarios, roles y permisos en el repositorio, así como los recursos que crean en el repositorio. Cuando un usuario con este rol inicia una sesión, el servidor muestra los menús adicionales para acceder a la páginas de administración y gestión de los recursos del repositorio. Cualquier administrador, que por definición tiene esta función, puede asignarlo a cualquier otro usuario. ROLE_SUPERUSER - Cuando un usuario ya tiene ROLE_ADMINISTRATOR, Esta función adicional permite el acceso a las funciones de configuración del sistema. Sólo un administrador del sistema puede asignar esta función a otro usuario; organización los administradores no pueden ver o asignar este rol. En un entorno multi-organización, ROLE_SUPERUSER No se debe dar a los administradores de organización o usuarios de la organización, ya que esto permite el acceso a la caché Especial compartida por todas las organizaciones. En el caso de una sola organización, como en la instalación por defecto, puede asignar esta función a la organización administradores que permitan el acceso a la configuración del sistema sin otorgar privilegios para crear organizaciones de grado superior o otros administradores de sistemas.

• La organización del usuario - Independientemente de los roles, el administrador siempre está limitada en su alcance al organización en la que se crea la cuenta de usuario, incluidas las suborganizaciones de los mismos. En ningún caso puede un usuario, incluso con la ROLE_SUPERUSER, Nunca ver o modificar cualquier organización, usuario, rol o carpeta fuera de la organización a la que pertenece el usuario.

Cualquier administrador puede conceder ROLE_ADMINISTRATOR a cualquier usuario. Ese usuario se convierte entonces equivalente a una organización de administración de la organización en la que él pertenece. Con el fin de delegar la administración del sistema, la administrador de sistema existente debe primero crear otros usuarios en el nivel raíz, fuera de cualquier organización. El sistema administrador puede asignar tanto ROLE_ADMINISTRATOR y ROLE_SUPERUSER concederles administrador de sistema privilegios. Para más información sobre estas funciones, consulte "Permisos" en la página 57.

18


1.4 Introducción a la seguridad

JasperReports Server garantiza que las personas sólo 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: •

•

•

Autenticación - Restringe el acceso a los usuarios identificados y protege el acceso con contraseñas. Define los roles para agrupar a los usuarios y la asignación de permisos. La autenticación se explica con más detalle en la siguiente sección. Autorización - Controla el acceso a los objetos del repositorio, páginas y menús basados en usuarios y roles. La autorización se explica con más detalle en una sección siguiente. Seguridad a nivel de datos (sólo versión 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 más información, consulte la Guía del usuario de JasperReports Server. Si implementa Jaspersoft OLAP, puede utilizar funciones a asegurar sus datos en cualquier nivel de la jerarquía de un esquema de análisis. Para obtener más información, consulte la Jaspersoft Guía del usuario de OLAP.

Los administradores deben mantener la seguridad en mente en todo momento en la gestión de las organizaciones, usuarios, roles y recursos, debido a que el mecanismo de seguridad detrás de cada uno de ellos dependen de los demás.

1.4.1 Autenticación

La primera parte de la seguridad es definir las cuentas de usuario y seguro con contraseñas. Los usuarios deben iniciar sesión con su ID de usuario y contraseña para que tengan una identidad en JasperReports Server. Las definiciones servidor almacena los usuarios, incluidas las contraseñas cifradas, en una base de datos privada. Los administradores crear, modificar y eliminar cuentas de usuario a través de las páginas de administrador, como se describe en "Gestión de usuarios" en la página 29. JasperReports Server también implementa las funciones que se pueden asignar a cualquier número de usuarios. Roles permiten a los administradores crear grupos o categorías de usuarios que se otorgan permisos similares. Un usuario puede pertenecer a cualquier número de funciones y recibir los privilegios de cada uno de ellos. La definición de funciones servidor almacena en su base de datos privada, y administradores crear, modificar y eliminar los roles a través de las páginas de administrador, como se describe en "Gestión Roles "en la página 36. JasperReports Server se basa en el marco de seguridad de la primavera de código abierto; tiene muchas opciones configurables para: • • • • • •

• • • •

Servicios de autenticación externos como LDAP (utilizado por Microsoft Active Directory y Novell eDirectory) Inicio de sesión único utilizando central Servicio de autenticación de JA-SIG (CAS) Autenticación Java y Servicio de autorización (JAAS) Seguridad de los contenedores (Tomcat, Espolón) SiteMinder El acceso de usuarios anónimos (deshabilitado por defecto)

HTTPS, incluyendo el requerir HTTPS HTTP Básica HTTP Digest X509

JasperReports Server también es compatible con estos estándares de cifrado y autenticación:

El framework Spring es fácilmente extensible para integrar a los usos y servicios de autenticación y comerciales transporta.

Autenticación se realiza de forma predeterminada a través de la interfaz de usuario de la web, lo que obligó inicio de sesión, y / oa través de HTTP Básica autenticación para servicios web, como Jaspersoft iReport Designer y para XML / A de tráfico. El servidor puede sincronizar automáticamente con un servicio de autenticación externo. Los usuarios externos no necesitan ser creados

19


manualmente en el servidor primero. Tanto los usuarios como los roles se crean automáticamente en el servidor desde sus definiciones en un servicio de autenticación externo. Para una visión general del sistema de autenticación y detalles sobre externo autenticación, consulte la JasperReports servidor de autenticación Cookbook.

1.4.2 Autorización 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 páginas

Los menús que aparecen en JasperReports Servidor dependen de los roles del usuario. Para ejemplo, sólo los usuarios con el rol de administrador pueden ver el Gestionar menú y acceder a las páginas de administrador. Mediante la modificación de la configuración del servidor, puede modificar el acceso a los menús, elementos de menú y las páginas individuales. Consulte el Guía de compilación del servidor Fuente JasperReports y JasperReports Servidor último Guía para obtener más información.

Los usuarios pertenecen a las organizaciones y se limitan a ver a los recursos dentro de su organización. Las organizaciones tienen sus propios administradores, pero sólo ven la usuarios, roles y recursos de su organización. Cuando JasperReports Server es configurado con múltiples organizaciones, que están efectivamente aislados el uno del otro, aunque el administrador de sistema puede compartir recursos a través de la carpeta pública. Para obtener más información, consulte "Múltiples Organizaciones en el repositorio" en la página 55.

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 También puede crear informes compartidos en la misma carpeta que se establece en sólo lectura. El permisos posibles son: acceso, ejecutar solamente, de sólo lectura, lectura eliminar, lectura escribir-eliminar y administrar (ver "Permisos" en la página 57).

Los permisos se aplican al acceder a cualquier recurso, ya sea directamente a través de la interfaz de repositorio, de forma indirecta cuando se llama desde un informe, o mediante programación a través de los servicios web. Los permisos son acumulativos, lo que significa que un usuario tiene la más permisiva acceso que se concede a cualquiera de los roles a los que pertenece el usuario.

Privilegios de administrador JasperReports servidor distingue entre la lectura o escritura de un recurso en el repositorio y ver o editar la definición interna de un recurso. Para mayor seguridad efectos, la concesión de un permiso de lectura o de escritura del usuario en un recurso no permite ver o editar la definición 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 definición de la fuente que incluye una contraseña de base de datos. Además, sólo los administradores puede interactuar con carpetas temáticas para cargar, descargar y activar archivos CSS que controlar la interfaz de usuario.

Alcance Organización

Permisos de recursos

20


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 gestión podría permitir a cualquier usuario ver la jerarquía de gestión, gerentes verían la información sobre los salarios de sus empleados directos, y sólo los gerentes de recursos humanos verían todos los valores salariales.

La seguridad a nivel de datos en dominios se explica en el JasperReports usuario del servidor Guía. La seguridad a nivel de datos a través de vistas OLAP está cubierto de la Jaspersoft OLAP Guía del usuario.

Nota: Este tipo de seguridad sólo está disponible en la edición comercial de JasperReports Server.

Atributos del perfil Atributos del perfil son pares nombre-valor asociados a una cuenta de usuario. Pueden proporcionar información adicional sobre el usuario, y también pueden ser utilizados para restringir el acceso a datos a través de archivos de seguridad de dominio y esquemas OLAP. Para obtener información sobre definir atributos de perfil, ver "Editar Perfil Atributos" en la página 34.

1.5 Administrator Login

Administradores de sesión en la página de inicio de sesión estándar, utilizando las siguientes contraseñas por defecto: Ediciones comerciales:

Proyecto de la Comunidad:

administrador de sistema: nombre de usuario superusuario y la contraseña superusuario organización de administración: nombre de usuario jasperadmin y la contraseña jasperadmin administrador de sistema: nombre de usuario jasperadmin y la contraseña jasperadmin

Por razones de seguridad, siempre cambiar el administrador por defecto las contraseñas inmediatamente después de la instalación JasperReports Server. Para obtener instrucciones, consulte "Edición de un usuario" en la página 33.

Para obtener más información acerca de las opciones en la página de inicio de sesión y de registro con múltiples organizaciones, consulte la Guía del usuario de JasperReports Server. La primera vez que inicie sesión como administrador, se le pedirá a optar-en el programa Heartbeat. Usted También debe establecer las contraseñas y correo electrónico de administrador.

1.5.1 JasperReports Server Heartbeat

Cuando inicia sesión en JasperReports Server por primera vez después de la instalación, los usuarios de la edición comercial puede se le pregunte a optar en el servidor de Heartbeatprogram. Se reporta la información específica de Jaspersoft sobre su aplicación: el sistema operativo, JVM, servidor de aplicaciones, base de datos (tipo y versión), y JasperReports Edición de servidor y número de versión. Mediante el seguimiento de esta información, Jaspersoft puede crear mejores productos que funcionar de manera óptima en su entorno. No se recopila información personal. Para optar al programa, haga clic en Okay. Para optar por no, desactive la casilla de verificación a continuación, haga clic en Okay.

1.5.2 Administrador de Correo

Después de iniciar sesión por primera vez, se debe configurar el correo electrónico en el superusuario y jasperadmin cuentas a Su dirección de correo electrónico. En casos muy raros, puede que el servidor le notificará por correo electrónico acerca de problemas con su licencia.

21


Este es también un buen momento para cambiar las contraseñas por defecto en la superusuario y jasperadmin cuentas también.

Para configurar el correo electrónico y las contraseñas en las cuentas de administrador, editar la información de la cuenta de usuario como se describe en "Edición de un usuario" en la página 33.

1.6 Administrador de Páginas

Los administradores tienen acceso a páginas especiales para administrar el servidor. Después de iniciar sesión, haga clic en Ver opciones en el Caja de administración en la página de introducción o seleccionar un elemento de la Gestionar menú en cualquier página.

Administrador del sistema: Organización de administrador:

Figura 1-5 Diferentes Administrar menús para diferentes administradores

En la edición comercial de JasperReports Server, los controles de administrador son diferentes para el sistema y administradores de la organización, como se muestra en la figura anterior. Administradores de la organización pueden administrar usuarios, roles, y suborganizaciones, pero sólo dentro de su organización. Los administradores del sistema pueden gestionar organizaciones de nivel superior, así como usuarios y roles en cualquier organización. Además, sólo los administradores del sistema tienen acceso a la configuración a nivel de servidor que se aplican a los registros, Jaspersoft OLAP, y Ad Hoc de caché de datos y políticas. La siguiente figura muestra el Admin Home página para los administradores de sistemas que incluye el Ver configuración botón no a disposición de los administradores de la organización.

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 página de todas las páginas muestra el diálogo que se muestra en la siguiente figura. El cuadro de diálogo muestra el número de versión del producto, así como otra información, como la compilación de software, su el tipo de licencia, y su vencimiento. Por favor, tenga esta información si necesita ponerse en contacto con Jaspersoft para el apoyo.

Figura 1-7 Acerca JasperReports diálogo del servidor

23


24

CAPÍTULO 2 ORGANIZACION, DE USUARIO, Y LA GESTIÓN PAPEL


En una implementación de una sola organización, el administrador sólo tiene que crear los usuarios y roles. En las implementaciones con múltiples organizaciones, los administradores necesitan para crear organizaciones, rellenarlos con los usuarios, y crear los papeles que utilizan después para establecer los permisos de acceso. En un despliegue con múltiples organizaciones, no puede haber administradores en todos los niveles de la jerarquía, como descrito en "Administración delegada" en la página 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 administración de cada organización a continuación, crear y gestionar los usuarios de su en particular la organización. La interfaz en JasperReports Server para organizaciones que gestionan (los usuarios de la edición comercial), usuarios y roles (Tanto comerciales como ediciones comunidad) tiene capacidad para todos los niveles de administración y hace que sea fácil para ellos buscar entre cientos de usuarios y roles, ya sea en una sola organización o difundir a través de muchos. El interfaz también hace cumplir el alcance de los privilegios administrativos. Por ejemplo, se asegura que una organización administrador no puede ver las funciones y los usuarios de las organizaciones de padres.


• • •

Gestión de Organizaciones Gestión de usuarios Administración de funciones

2.1 Gestión de Organizaciones

Los administradores del sistema y los administradores de la organización utilizan las mismas páginas 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 organización se limitan a suborganizaciones.

Los usuarios de la edición Comunidad y administradores de implementaciones con una sola organización por defecto puede en general, omita esta sección. Sin embargo, este procedimiento se puede utilizar para cambiar el nombre del defecto organización.

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 raíz de la jerarquía de la organización, e incluye todas las organizaciones y suborganizaciones definidos, por lo que él puede manejar cualquier organización o suborganización 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 Página

La siguiente figura muestra el mismo repositorio, como se ve por el administrador de la Organización (jasperadmin). Muestra que la visión de esta administración se limita a su propia organización y sus suborganizaciones, y él puede tener acceso y administrar solo aquellos.

Figura 2-2 Organización Admin Ver Gestionar Organizaciones de Página

26


2.1.1

1.

2.

3.

Visualización de las propiedades de la Organización Inicie sesión como un usuario con privilegios de administrador para la organización. Seleccione Gestionar> Organizaciones.

Aparece la página de gestión de la organización, como se muestra en Figura 2-1 o Figura 2-2.

Para seleccionar una organización, haga clic en su padre, en el panel de Organizaciones de la mano izquierda, a continuación, seleccione en el centro Panel de Organización. Si hay muchas organizaciones, puede introducir un término de búsqueda para encontrar una específica organización. Sin embargo, el término de búsqueda sólo busca en la lista de la organización en los centros de Organizaciones panel. Una vez que se selecciona una organización, el panel Propiedades muestra información sobre la organización:

• • • • •

•

Nombre - Muestra el nombre de la organización que aparece en la carpeta de la parte superior de la organización. ID - único y permanente identificación de la organización que se utiliza para iniciar sesión en la organización. Alias - nombre corto Único pero editable para la organización que también puede utilizarse al iniciar sesión. Descripción - descripción opcional que sólo aparece en este panel Propiedades. Número de usuarios - Conde de todos los usuarios, incluidos los de las suborganizaciones. Haga clic en Gestionar para ver la lista de usuarios en la página de gestión de usuarios. Número de Roles - Cuenta todos los papeles, incluidos los de todo suborganizaciones. El número de funciones hace No incluye las funciones de sistema (como ROLE_USER) que aparecen en cada nivel de la organización, pero que son definidos en el nivel raíz. Haga clic en Gestionar para ver la lista de funciones en la página de administración de funciones.

4.

2.1.2

1.

2. 3.

4.

Creación de una Organización

Inicie sesión como un usuario con privilegios de administrador para el padre de la nueva organización. Haga clic en Gestionar> Organizaciones. En el panel de Organizaciones de la mano izquierda, expanda la jerarquía de las organizaciones para seleccionar al padre organización, por ejemplo, Finanzas, a continuación, haga clic en Añadir organización en el panel central. Aparecerá el cuadro de diálogo Agregar Organización.

Figura 2-3 Adición de una Organización

27


5. Introduzca el nombre de la organización; el servidor rellena automáticamente el ID y alias basado en el nombre. Usted puede cambiar el ID y alias, si es necesario antes de guardar la organización. Una vez guardado, el identificador de la organización no puede ya que modificarse. La descripción es opcional. La figura anterior muestra este cuadro de diálogo con valores de muestra. Para guardar la nueva organización, haga clic en Añadir a la Organización <organización>.

La nueva organización 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.

6.

El panel de propiedades muestra el número de usuarios y roles en la organización y enlaces para gestionarlos. Por De forma predeterminada, las nuevas organizaciones tienen el siguiente:

• Dos usuarios con contraseñas predeterminadas: el administrador (organizaciónjasperadmin/jasperadmin) Y un usuario de ejemplo (joeuser / joeuser).

Por razones de seguridad, siempre cambiar las contraseñas por defecto inmediatamente después de crear una nueva organización. Para obtener instrucciones, consulte "Gestión de usuarios" en la página 29.

•

•

La organización 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 Organización de los padres. La nueva organización carpeta contiene una copia de la carpeta Plantilla Organización / carpeta de los padres. Para administrar la Organización carpetas, seleccione Ver> Repositorio.

2.1.3 Las carpetas predeterminadas para Organizaciones

Cada organización 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 organización, la todo el contenido de la plantilla de carpeta se copia para crear carpetas de la nueva organización. Los administradores pueden añadir carpetas y recursos en la plantilla de la carpeta, y estos también se copian cuando se crean organizaciones adicionales.

Las carpetas predeterminadas en la plantilla de carpeta son: •

• • •

Ad Hoc Componentes \ Temas - La ubicación donde el Editor Ad Hoc busca temas para crear nuevas informes. Temp - Una carpeta sólo los administradores visibles, que utiliza el servidor para almacenar archivos temporales. Plantillas - Una carpeta para guardar las plantillas utilizadas en la generación 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 pública visible en cada organización es una carpeta compartida especial en el nivel raíz. El repositorio hace que sea accesible a todas las organizaciones, pero no está dentro de la carpeta de organización.

Hay una plantilla de carpeta en cada nivel de la jerarquía de la organización, incluyendo la raíz. El sistema de administración puede agregar contenido a la plantilla de carpeta de nivel superior para su uso en la creación de organizaciones de primer nivel. Organización los administradores pueden agregar contenido a su respectiva plantilla de carpeta para su uso en la creación de suborganizaciones. Por último, la propia plantilla de carpeta se copia en una nueva organización, por lo que los nuevos suborganizaciones tienen el mismo carpetas predeterminadas y recursos como su padre.

2.1.4

1.

2.

Edición de una Organización

Inicie sesión como un usuario con privilegios de administrador para la organización. Haga clic en Gestionar> Organizaciones.

28


3.

4.

En las Organizaciones paneles de la izquierda, seleccione los padres de la organización. En el centro del panel Organizaciones, seleccione la organización. En el panel Propiedades de la derecha, haga clic en Edit. Los campos en el panel Propiedades de la organización se convierten en editable.

Figura 2-4 Editando Propiedades de una Organización

5. Cambiar las propiedades de la organización, según sea necesario. Cambiar el nombre de la organización cambia el nombre de la carpeta de organización, también, pero no hay otros datos. El ID de la organización no se puede cambiar; siempre tiene la valor definido cuando se creó la organización. El alias y la descripción se pueden cambiar. Haga clic en Guardar para mantener los cambios o Cancelar para salir sin guardar. 6.

2.1.5

1.

2. 3.

4.

Eliminación de una Organización

Inicie sesión como un usuario con privilegios de administrador para la organización. Haga clic en Gestionar> Organizaciones. En las Organizaciones paneles de la izquierda, seleccione los padres de la organización. En el centro del panel Organizaciones, seleccione la organización. En el centro del panel Organizaciones, haga clic en Eliminar. Los administradores no pueden eliminar la organización a la que pertenecen. Confirmando el eliminar por completo elimina todos los usuarios, roles y carpetas de la organización y todos sus suborganizaciones de JasperReports Server.

2.2 Gestión 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 "Administración delegada" en la página 18. Los administradores de la organización pueden gestionar sólo los usuarios en las organizaciones que administran. La instalación por defecto de JasperReports Server contiene los siguientes usuarios:

29


Tabla 2-1 Defecto Usuarios en Instalaciones JasperReports Server

Nombre de Usuario Contraseña por defecto (Distingue mayúsculas y minúsculas)

superusuario

Organización Descripción

superusuario ninguno Administrador de sistema por defecto (edición comercial solamente).

Permite el acceso anónimo; deshabilitado por predeterminado. Si usted no permite el anonimato acceso, este usuario se puede eliminar.

Por defecto organización admin en cada organización.

Usuario final por defecto en todas las organizaciones. Incluido para su uso con datos de ejemplo.

Incluido para su uso con datos de ejemplo.

AnonymousUser AnonymousUser ninguno

jasperadmin jasperadmin Organización

joeuser

demostración

CaliforniaUser

joeuser

demostración

CaliforniaUser

Organización

Organización

Organización

Usted debe aconsejar a los usuarios que cambien sus contraseñas con regularidad. Para configurar el vencimiento periódico de sus contraseñas, se refieren a "Configuración de opciones de contraseña de usuario" en la página 150.

Algunas ediciones de servidor no incluyen todos estos usuarios; por ejemplo, superusuario no se crea en el Edición Comunidad del servidor, y demostración y CaliforniaUser se crean sólo cuando los datos de la muestra está instalado.

2.2.1

1.

2.

Visualización de las propiedades de usuario Inicie sesión como un usuario con privilegios administrativos para la organización del usuario. Seleccione Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. Como se muestra en la figura siguiente, la página Administrar usuarios muestra los usuarios en cada organización y propiedades para el usuario seleccionado.

30


Figura 2-5 administrar usuarios Página

La lista de usuarios incluye a todos en la organización elegida y sus suborganizaciones. El mismo ID de usuario puede aparecer más 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 organización de un usuario en particular.

En este ejemplo, el administrador de sistema puede ver todos los usuarios en todas las organizaciones mediante la selección de la raíz de la Jerarquía de la organización. Siempre hay múltiples usuarios jasperadmin en una jerarquía de las organizaciones, porque es el ID de administrador predeterminada en cada organización que se crea.

3. Para localizar a un usuario: •

•

Para buscar usuarios, expanda la jerarquía de la organización en el panel de la izquierda, y seleccione una organización. Desplácese por la lista de usuarios, o elegir un suborganización para reducir la lista. Para buscar un usuario específico, seleccione la organización (o cualquier organización matriz) y entrar en una búsqueda cadena en el Búsqueda campo del panel Usuarios. Los resultados de la búsqueda a todos los usuarios en el seleccionado muestran organización y suborganizaciones cuyo nombre de usuario contiene la cadena de búsqueda. Si es necesario, desplácese a través de los resultados o refinar su búsqueda.

4.

Para detener la búsqueda, 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, dirección de correo electrónico, las funciones asignadas, la condición 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 página de administración de roles para cada rol.

A medida que el administrador de una organización determinada, se puede ver los roles definidos en su organización y su suborganizaciones, pero no la organización de padres (excepto para ciertos papeles de todo el sistema). Un usuario puede tener roles definidos y asignados de una organización de padres que no son visibles para el administrador de la la organización del usuario. Para obtener más información, consulte "Gestión de Roles" en la página 36.

2.2.2

1.

Creación de un usuario

Inicie sesión como un usuario con privilegios administrativos para la organización a la que el usuario pertenece.

31


2.

3.

Seleccione Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. En los paneles de Organizaciones, seleccione la organización a la que pertenecerá el usuario, a continuación, haga clic en Añadir usuario. Para los administradores de la edición de la comunidad, simplemente haga clic en Añadir usuario. Aparecerá el cuadro de diálogo Agregar usuario.

Figura 2-6 Adición de un usuario

4. Introduzca la siguiente información:

• 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 convención. JasperReports Server siempre muestra la corriente el nombre de usuario en la esquina superior derecha de la pantalla. ID de usuario - genera automáticamente a partir del nombre de usuario; puede aceptar el valor sugerido o escriba el suyo propio. El ID de usuario se utiliza para iniciar sesión en JasperReports Server, y para los administradores para gestionar usuarios y recursos. ID de usuario deben ser únicos dentro de una organización, pero pueden existir en otras organizaciones. E-mail - La dirección de correo electrónico de la persona. El correo electrónico es opcional, pero la dirección debe estar en una válida formato. Contraseña y confirmación - Introduzca la misma contraseña en ambos campos. Usuario está habilitada - Seleccione la casilla para habilitar al usuario de inmediato.

Los usuarios que no están habilitados no pueden iniciar sesión en. Si implementa permisos basados en roles, es posible que desee retrasar permitiendo al usuario hasta que asigne más roles. Para obtener más información sobre las funciones, consulte "Gestión Roles "en la página 36. 5. Haga clic en Añadir usuario a <organización> (Añadir Usuario para los usuarios de edición de la comunidad)

para crear el usuario. El nuevo usuario aparecerá en el panel Usuarios, a menos que ha introducido un término de búsqueda 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 sección.

•

•

• •

32


2.2.3 Edición 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 número de usuarios a una función determinada. 1.

2. 3.

Inicie sesión como un usuario con privilegios administrativos para la organización del usuario. Haga clic en Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. En el panel organizaciones, seleccionar la organización del usuario. (Los usuarios comerciales solamente. Usuarios de la Comunidad pase a la paso 4)

El panel de usuarios se actualiza para mostrar los usuarios en la organización seleccionada, que incluye a todos los niños organizaciones.

4.

5.

En el panel Usuarios, seleccione el usuario.

La información de cuenta de usuario seleccionado se muestra en el panel Propiedades.

En el panel Propiedades, haga clic en Edit.

Figura 7.2 Edición de las propiedades de un usuario

6.

7.

Modificar el nombre de usuario, dirección de correo electrónico, la contraseña y el estado de habilitación, según sea necesario. No puede editar el ID de usuario; siempre tiene el valor definido cuando se crea el usuario originalmente.

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


La lista de funciones disponibles incluyen ningún papel en las organizaciones del administrador actual, así como el papeles especiales de todo el sistema. Para obtener más información sobre cómo crear y agregar funciones, consulte "Gestión de Roles" en la página 36.

8.

9.

Haga clic en Guardar para mantener los cambios o Cancelar para salir de la edición 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 página 62. Inicio de sesión como otro usuario también es necesario cuando usted está manteniendo los recursos que utilizan absoluta referencias en el repositorio. Para obtener más información, consulte "Recursos de su anuncio en el repositorio" en la página 56.

2.2.4 Edición de atributos del perfil

Atributos del perfil son pares nombre-valor asociados a una cuenta de usuario. Pueden proporcionar información adicional sobre el usuario, y pueden también ser usados para restringir el acceso a datos a través de los archivos de seguridad de dominio y OLAP esquemas. Desde la versión 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 requería anteriormente.

Para agregar, editar o eliminar atributos del perfil: 1. Inicie sesión como un usuario con privilegios administrativos para la organización del usuario. 2. 3.

Haga clic en Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. En el panel organizaciones, seleccionar la organización del usuario. (Los usuarios comerciales solamente. Usuarios de la Comunidad pase a la paso 4)

El panel de usuarios se actualiza para mostrar los usuarios en la organización seleccionada, que incluye a todos los niños organizaciones.

4.

5.

En el panel Usuarios, seleccione el usuario. La información de cuenta de usuario elegido se muestra en las Propiedades panel.

En el panel Propiedades, haga clic en Editar y seleccione el Atributos pestaña en la parte superior del panel.

34


Figura 8.2 Edición 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 Añadir.

Los atributos pueden tener múltiples valores especificados como una lista separada por comas en el campo de valor. No se puede agregar dos atributos con el mismo nombre.

7. 8.

9.

Para quitar un atributo existente, haga clic en Retire en la fila correspondiente. Para editar un atributo, retírela y vuelva a crearla con el valor deseado.

Haga clic en Guardar. Los nuevos atributos aparecen en una tabla en el panel Propiedades del usuario.

Figura 2-9 Visualización de los atributos de un usuario

35


2.2.5 Activación y desactivación de usuarios en bloque

Los administradores necesitan a veces para evitar que los usuarios inicien sesión en desactivando las cuentas de usuario. Por ejemplo, cuando se realizan cambios en la configuración, es posible que desee bloquear todos los usuarios hasta que se acaban los cambios. Granel operaciones permiten a los administradores seleccionar cualquier número de usuarios, y superusuario puede seleccionar todos los usuarios en el servidor, excepto sí mismo. 1.

2. 3.

4.

Inicie sesión como un usuario con privilegios administrativos para la organización de usuarios. Haga clic en Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. En el panel de Organizaciones, seleccione la organización de usuarios; para habilitar o deshabilitar los usuarios en diferentes organizaciones, seleccionar la organización común de los padres. En la lista de usuarios, seleccione todos los usuarios activar o desactivar. Utilice Control-clic y Mayús y hacer clic para hacer selecciones múltiples. Si la lista de usuarios es demasiado largo, introduzca un término de búsqueda para encontrar usuarios y activar o desactivar ellos individualmente. Haga clic en Habilitar o Desactivar en la barra de menú.

5.

2.2.6

1.

2. 3.

4.

5.

Borrado de uno o más usuarios

Inicie sesión como un usuario con privilegios administrativos para la organización del usuario. Haga clic en Gestionar> Usuarios o, en la página Administrador de inicio, haga clic en Usuarios. En el panel organizaciones, seleccionar la organización del usuario; para eliminar varios usuarios en diferentes organizaciones, seleccione la organización común de los padres. En la lista de usuarios, seleccione el usuario que desea eliminar. Utilice Control-clic y Mayús y hacer clic para seleccionar varias opciones. Si la lista de usuarios es demasiado largo, introduzca un término de búsqueda para buscar y seleccionar el usuario. En la barra de herramientas del panel Usuarios, haga clic en Eliminar y confirmar la acción.

2.3 Administración 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 (véase "Permisos" en la página 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 datos: Tabla 2-2 Funciones predeterminadas en Instalaciones JasperReports Server

Papel

ROLE_SUPERUSER

Descripción

Ediciones comerciales solamente. Esta función determina los privilegios de administrador del sistema, como se explica en "Administración delegada" en la página 18. Es un nivel de sistema papel, sin embargo, el administrador del sistema puede asignar a los administradores de la organización en implementaciones de una sola organización. Nunca elimine esta función, es necesario para la correcta administración del servidor.

36


Papel

ROLE_ADMINISTRATOR

Descripción

Esta función determina los privilegios de administrador de organización, como se explica en "Administración delegada" en la página 18. JasperReports Servidor asigna automáticamente esta función al usuario jasperadmin predeterminada en cada nueva organización. Se trata de un papel a nivel de sistema especial que es visible en todos los organización y que la organización los administradores pueden asignar a otros usuarios. Nunca elimine esta función, es necesario para la correcta administración del servidor.

Cada usuario que se registra en JasperReports Server debe tener esta función. El servidor asigna automáticamente esta función a cada usuario que se crea, y es necesario iniciar sesión. Es un papel a nivel de sistema especial que es visible en todos los organización. Nunca elimine esta función, es necesario para crear usuarios y les permite iniciar sesión.

Cuando el acceso anónimo está habilitado, JasperReports servidor automáticamente asigna esta función a cualquier agente que accede al servidor sin iniciar sesión. Es un papel a nivel de sistema especial que es visible en todas las organizaciones. Esta función es también asignado al usuario anónimo predeterminada. Por defecto, el anonimato el acceso está desactivado y no se utiliza esta función. Es una función del sistema que incluso el administrador de sistema no se puede eliminar.

JasperReports Server asigna esta función a los usuarios que se crean automáticamente cuando un portal como Liferay solicita autenticación para un conexión. Si el nombre de usuario especificado no existe en el servidor, es creado, asignado la contraseña del usuario en el portal, y se asigna la ROLE_PORTLET y ROLE_USER roles. Si usted no utiliza un servidor de portal, esta función se puede eliminar.

Esta función permite el acceso a la demo Principal Supermart, informes, y si implementar Jaspersoft OLAP, vistas OLAP. Este rol se asigna a la usuario de demostración en la organización por omisión. Estos objetos están disponibles sólo si instalar los datos de ejemplo al instalar JasperReports Server. Es un papel a nivel de sistema especial que es visible en cada organización Cuando ya no necesita los datos de la muestra, esta función se puede eliminar.

Esta función 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 características de seguridad de datos disponibles en Jaspersoft OLAP. Consulte la Jaspersoft Guía OLAP último para obtener más información. Cuando ya no necesita los datos de la muestra, esta función se puede eliminar.

Esta función ya no gobierna ningún 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.

ROLE_USER

ROLE_ANONYMOUS

ROLE_PORTLET

ROLE_DEMO

ROLE_SUPERMART_ MANAGER

ROLE_ETL_ADMIN

A excepción 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 organización. Los administradores pueden gestionar todos los papeles en sus organizaciones y cualquier suborganización, pero nunca pueden ver roles en una organización de padres o hermanos. JasperReports Server aplica este esquema para asegurar que organizaciones son seguras y sólo papeles válidos se asignan a los usuarios.

37


Es posible que un administrador asignar un rol a un usuario en un suborganización, donde el papel se define en un organización matriz del usuario. El administrador de la organización del usuario no puede ver el papel en la gestión de la usuario, pero el administrador de la organización de la función puede, y los permisos asociados a la función son adecuadamente forzada.

2.3.1

1.

2.

Visualización de las propiedades de rol Inicie sesión como un usuario con privilegios administrativos para la organización de la función. Usuarios de la Comunidad inicie la sesión como cualquier usuario con privilegios administrativos. Seleccione Gestionar> Funciones o, en la página Administrador de inicio, haga clic en Roles. Como se muestra en la figura siguiente, la página Administrar funciones muestra las funciones de cada organización y propiedades para cada papel.

Figura 2-10 Administrar funciones Página

La lista de funciones incluye todas las funciones en la organización elegida y sus suborganizaciones. La lista de funciones también incluye las funciones de nivel de sistema de cinco por defecto. El mismo nombre de función puede aparecer más 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 organización de un papel particular. En este ejemplo, el administrador de sistema puede ver todos los papeles en todas las organizaciones mediante la selección de la raíz de la Jerarquía de la organización.

3. Para seleccionar una función, haga clic en su organización en el panel de Organizaciones. (usuarios comerciales solamente. usuarios de la Comunidad saltar al paso 4) Se muestra el panel Funciones.

4. Haga clic en la función en el panel Funciones. Para filtrar la lista de roles, introduzca una cadena de búsqueda en el Búsqueda campo del panel Funciones. Los resultados de la búsqueda mostrar todos los papeles en la organización y suborganizaciones seleccionado cuyo nombre contiene la búsqueda cadena. Si es necesario, desplácese por la lista nueva o refinar su búsqueda.

38


5. Para detener la búsqueda, haga clic en Seleccione la función en el panel Funciones. Propiedades de la función aparecen en el panel Propiedades. El panel Propiedades muestra el nombre de la función, la organización donde se define, y la lista de usuarios a quien se le ha asignado el papel. La lista de usuarios muestra sólo sus ID de usuario, pero se cierne sobre un ID muestra un tooltip con el nombre completo y la organización, como se muestra en Figura 2-10.

Al ver las propiedades de los papeles especiales a nivel de sistema, sólo verá los usuarios con este rol en su organización o cualquier suborganización. Un administrador organización nunca puede ver a los usuarios fuera de su organización o sus suborganizaciones.

2.3.2

1.

2. 3.

4.

Creación de un rol

Inicie sesión como un usuario con privilegios administrativos para la organización en la que se utilizará el papel.

Seleccione Gestionar> Funciones o, en la página Administrador de inicio, haga clic en Roles. En los paneles de Organizaciones, seleccione la organización 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.

Aparecerá el cuadro de diálogo Agregar función.

Figura 2-11 Adición de un Papel

5.

6.

Introduzca el nombre de la función. Roles no tienen otras propiedades o la configuración. Haga clic en Agregar rol a <organización> (Añadir Papel para los usuarios de edición de la comunidad) para crear el papel. La nueva función aparece en el panel Funciones, a menos que ha introducido un término de búsqueda que excluye. Si quieres asignar usuarios a la función, haga clic en Editar en el panel Propiedades del nuevo papel, como se muestra en el siguiente sección.

2.3.3 Asignación de usuarios a un rol

La interfaz de gestión 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 "Edición de un usuario" en la página 33.

1.

2. 3.

Inicie sesión como un usuario con privilegios administrativos para la organización en la que se define el papel.

Seleccione Gestionar> Funciones o, en la página Administrador de inicio, haga clic en Roles. En los paneles de Organizaciones, seleccione la organización de la función. (Los usuarios comerciales solamente. Usuarios de la Comunidad pase a la paso 4)

Se muestra el panel Funciones.

39


4. Seleccione la función 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 función y los usuarios asignados a la misma.

Figura 2-12 Edición de los miembros de una función

6. Introduzca un nombre diferente para cambiar el nombre de la función en todo el servidor.

Permisos en el repositorio que utilizan el nombre de la función se actualizan automáticamente. Sin embargo, los nombres de rol en archivos de seguridad para dominios y OLAP son no actualizado con el nuevo nombre de la función 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 más información, consulte la Guía del usuario de JasperReports Server.

7.

8.

Para asignar o quitar usuarios de la función, 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.

2.3.4

1.

2. 3.

Eliminación de una o varias funciones

Inicie sesión como un usuario con privilegios administrativos para la organización en la que se define el papel.

Seleccione Gestionar> Funciones o, en la página Administrador de inicio, haga clic en Roles. En los paneles de Organizaciones, seleccione la organización de la función. (Los usuarios comerciales solamente. Usuarios de la Comunidad pase a la paso 4)

Se muestra el panel Funciones.

4. Seleccione la función en el panel Funciones. Utilice Control-clic y Mayús y hacer clic para seleccionar varias opciones.

40


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 acción.

41


42

CAPÍTULO 3 ADMINISTRACIÓN 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 imágenes. 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 también contiene los archivos CSS y de imagen que definen un tema. El repositorio está estructurada como una jerarquía de carpetas que se basa en la jerarquía 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 capítulo trata de las tareas básicas de administración del repositorio, incluyendo:

• • •

• • •

Creación de carpetas y organizar los objetos del repositorio. La gestión de las referencias a las fuentes de datos, imágenes, fuentes y otros recursos de los que dependen los informes. El control del acceso a los recursos en el repositorio a través de roles y permisos a nivel de objeto.

"Descripción del repositorio" en la página 14 "Otros recursos en el repositorio" en la página 91 "Temas" en la página 115

Más información sobre el repositorio se cubre en las siguientes secciones:

También puede acceder al repositorio mediante programación utilizando los servicios web y APIs. Para obtener más información sobre estas funciones, consulte la Guía de Servicios Web JasperReports Servidor y para la JasperReports Servidor Última guía, respectivamente. Este capítulo contiene las siguientes secciones:

• • • • •

Tipos de recursos Estructura JasperReport Gestión 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 cómo 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 Guía del usuario del servidor: Tabla 3-1 Recursos Creado por Usuarios Finales

Tipo de recurso

Ad Hoc vista

Descripción

Edición Professional. Creado de forma interactiva en el Editor Ad Hoc arrastrando y colocar columnas de datos en una tabla, un gráfico o tabla de referencias cruzadas. Los usuarios pueden entonces explorar sus datos mediante la aplicación de filtros y la realización de operaciones de pivote. Un Ad Hoc punto de vista también se puede guardar como un informe interactivo y compartir con otros usuarios. Edición Professional. Una colección de informes, controles de entrada, gráficos, etiquetas, y contenido de la web muestra junto. Los usuarios crean cuadros de mando de forma interactiva en el Diseñador de paneles y guardarlos en el repositorio.

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.

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 más información, consulte "Estructura JasperReport" en la página 45. Opcionalmente, los informes también pueden almacenar una instantánea de los datos del informe a mejorar el rendimiento cuando muchos usuarios acceden a los mismos informes.

Edición Professional. Informes con controles de entrada le permiten guardar combinaciones de datos de entrada de modo que usted puede ejecutar una versión personalizada del informe directamente. En el repositorio, versiones de informe siempre se enumeran en el informe original.

Dashboard

Recurso de contenido

JasperReport o simplemente informe

Versión del

Los otros tipos de recursos son creados y gestionados en el repositorio por los administradores. La siguiente recursos en general, apoyan la creación de informes:

Tabla 3-2 Recursos Creado por administradores

Tipo de recurso

Fuente de datos

Descripción

Una conexión 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 conexión o ubicación de los datos: JDBC, JNDI, y los datos de frijol fuentes. Para obtener más información, consulte "Fuentes de datos" en la página 65.

Un tipo básico que define el formato para los valores de entrada, por ejemplo, texto, número o fecha. Un tipo de datos también puede especificar un rango válido para el valor de entrada.

Tipo de datos

44


Tipo de recurso

Dominio

Descripción

Una capa de metadatos que selecciona, se une, y filtra las tablas y los campos de sus datos y le permite darles etiquetas fáciles de usar. Un dominio puede ser la base de un Grupo Especial informe. Dominios también apoyan la seguridad a nivel de fila y la localización de las etiquetas. Dominios se documentan más en el Guía del usuario de JasperReports Server.

Un recurso que almacena un archivo en el repositorio. "Archivo Tipos de recursos" en la página 110 da la lista de formatos de archivo y su propósito.

Un tipo complejo que especifica qué valores usuarios pueden ingresar a un informe y cómo 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.

Un tipo básico 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.

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.

Archivo

Control de entrada

Lista de valores

Consulta

Los administradores también pueden gestionar los recursos OLAP en el repositorio, si su licencia es compatible con Jaspersoft OLAP. Para obtener más información acerca de OLAP y los recursos de Mondrian, consulte la Guía del usuario de Jaspersoft OLAP. Tabla 3-3 Recursos OLAP creados por los administradores

Tipo de recurso

XML Mondrian / A Fuente

OLAP Client Connection

Descripción

Una definición de origen XMLA en el servidor de un XML en el cliente remoto / Una conexión.

Define cómo recuperar datos para una vista OLAP. Una conexión de cliente OLAP es o bien una conexión directa de Java (conexión Mondrian) o una conexión API basada en XML (XML / A la conexión).

Si implementa Jaspersoft OLAP, una vista de datos multidimensional que se basa en una conexión 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.

OLAP Vista

3.2 Estructura JasperReport

El recurso en el repositorio que agrega toda la información necesaria para que un informe se denomina JasperReport. A JasperReport se basa en un archivo de JRXML que se ajusta a la biblioteca de código 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 parámetros que los usuarios pueden entrar antes de ejecutar el informe. Los controles de entrada son compuesto de cualquiera de: •Una definición de tipo de datos. •Una lista de valores. Todos los recursos de archivos adicionales, como imágenes, fuentes y paquetes de recursos referenciados por la plantilla del informe. Si el informe contiene subinformes, los archivos JRXML para los subinformes.

La colección 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 solución es a veces poco práctico, ya que no siempre se puede añadir estos recursos a la ruta de clases, y el uso de rutas absolutas tiene sus propias limitaciones. Además, el almacenamiento de los recursos en el sistema de archivos desalienta su reutilización: los desarrolladores pueden invertir tiempo en la creación 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 imágenes, 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 manejar como referencias a recursos externos en el repositorio. En las versiones de JasperReports Server anterior a la 5.5, el JasperReports utiliza la repo: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 válido, 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. Además, puede administrar estos recursos, ya sea a través de iReport, a través de la interfaz de usuario JasperReports Server, oa través de las API del servidor. Por ejemplo, al actualizar un recurso de imagen logo, todos los informes que hacen referencia al recurso también 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 raíz del repositorio en la edición de la comunidad, o la organización 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 diseño.

46


Si implementa organizaciones, la ruta absoluta es relativa la organización del usuario, como se describe en "Múltiples Organizaciones en el repositorio" en la página 55.

Al subir la JRXML con referencias absolutas de recursos como parte de un JasperReport en el servidor, sólo 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 imágenes, 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é todavía 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 más flexibilidad y potencia al utilizar referencias indirectas en lugar de absoluta referencias. Referencias indirectas son nombres de marcador de posición que deben estar vinculados manualmente al recurso cuando subir la JasperReport. La sintaxis de una referencia indirecta sólo contiene un nombre de marcador de posición 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 creación 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, sólo existe dentro de la JasperReport. Selección de un recurso desde el repositorio, llamado una referencia externa, ya que es externo a la JasperReport. Esto permite que cualquier número de informes que enlazan con el mismo recurso, sin embargo, permitir que dicho recurso sea gestión independiente de ellos.

•

Si bien las referencias indirectas requieren un poco más 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 autónomo. 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 opción es para crear los recursos locales para todas las dependencias dentro de la JasperReport.

Las referencias indirectas se utilizan implícitamente 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 opción de crear un nuevo local de de recursos o de utilizar una referencia externa a un origen de datos existente.

47


•

•

Cada informe también 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 parámetros en un informe se manejan de manera implícita como una referencia indirecta a un control de entrada. Por cada parámetro 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 relación 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 también pueden almacenar una instantánea de los datos del informe. Una instantánea es una copia de los datos que la consulta devuelve cuando se actualicen los datos. Esta instantánea de datos es una estructura interna que no es visible ni accesible desde el repositorio. Sin embargo, cuando instantáneas de datos están habilitadas, una instantánea 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 instantánea. Después, los usuarios tienen la opción de actualizar los datos en el visor de informes, y si tienen permisos, el ahorro de la instantánea de datos de nuevo en el recurso informe. Para obtener más información acerca de la interacción con las instantáneas de datos, consulte la Guía del usuario de JasperReports Server. Para habilitar instantáneas, ver "Habilitación de instantáneas de datos" en la página 190.

3.3 Gestión 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 específicas determinan las acciones que están disponibles. Para el definición de los permisos de las carpetas y recursos, consulte "Permisos" en la página 57.

Una de las responsabilidades de un administrador de JasperReports Server es la creación de un ambiente para que los usuarios creen y guardar cuadros de mando, Ad Hoc vistas e informes. Eso generalmente significa la creación de una estructura de carpetas donde los usuarios tienen permiso de escritura. Los usuarios con permisos de escritura también pueden crear sus propias subcarpetas para almacenar sus informes y cuadros de mando. Otro escenario que los administradores pueden configurar los recursos implica que los usuarios creen JasperReports. Cuando 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, sólo el administrador puede crear fuentes de datos compartidas y otros recursos en el repositorio. Si muchos usuarios están cargando archivos JRXML como JasperReports, el administrador debe crear

48


fuentes y recursos de datos compartidos antes de tiempo en el repositorio. Esto también tiene la ventaja de simplificar mantenimiento, por ejemplo, la actualización 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 identificación, un nombre y una descripción 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 descripción opcional aparece en el repositorio y en la información sobre herramientas. Usted puede dar descripciones más 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 podría ser: / informes / samples / Freight. El camino de cada recurso se muestra bajo su nombre en El anuncio o la búsqueda 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 búsqueda resultados y seleccione Propiedades ... en el menú contextual.

Propiedades Figura Recurso 3-1 de diálogo para un recurso grabable

Si usted tiene escribir o administrar el permiso como se muestra en la figura, también se puede editar el nombre y la descripción de el recurso. Para algunas operaciones como la exportación, lo que necesita la ruta del recurso, también llamado repositorio URI, que usted puede copiar de este cuadro de diálogo.

3.3.2 Creación de carpetas

Cualquier usuario con permiso de escritura en una carpeta puede crear nuevos sub-carpetas. Para crear una carpeta: 1. Inicie sesión como un usuario que tenga permiso de escritura en la carpeta principal.

49


2.

3. 4.

Seleccione Ver> Repositorio y busque la carpeta principal en el panel de carpetas del lado izquierdo.

Haga clic derecho en la carpeta principal y seleccione Agregar carpeta en el menú contextual. Aparecerá el cuadro de diálogo Agregar carpeta.

Figura 3-2 Cuadro de diálogo Agregar carpeta

5. Introduzca un nombre de carpeta y una descripción opcional, a continuación, haga clic en Añadir. Se crea la carpeta en el repositorio. El nombre aparece en la jerarquía de carpetas. La descripción es sólo 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 configuración" en la página 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 Adición de recursos

Cada recurso tiene diferentes requisitos, por ejemplo, algunos se crean a partir de los archivos cargados, otros son creados por la definición de los valores de un asistente. Los procedimientos específicos para la adición 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 Guía. JasperReports se tratan en el Guía del usuario de JasperReports Server. Dominios están cubiertos en el Guía del usuario de JasperReports Server. Dominios sólo están disponibles en la Edición Comercial de JasperReports Server. Recursos y Mondrian OLAP están cubiertos en el Guía del usuario de Jaspersoft OLAP. Las fuentes de datos, consultas, controles de entrada, y los recursos de archivos se explican en el capítulo "Otros recursos en el repositorio "en la página 91

La mayoría de los recursos se crean a través de la opción 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. Además, cada diálogo tiene una o más páginas para especificar los valores y controles específicos 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 sección "Permisos" en la página 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 descripción.

No se puede cambiar el nombre de carpeta de nivel superior de la organización de la manera descrita aquí. El nombre de la carpeta de nivel superior se copia del nombre de la organización. Por lo tanto, para cambiar el nombre de la carpeta, usted tiene que cambiar el nombre de la organización, tal como se describe en la sección "Edición de un Organización "en la página 28.

Para cambiar el nombre de una carpeta o recurso: 1. Inicie sesión como un usuario que tiene permiso de escritura para la carpeta o recurso. 2.

3.

En el repositorio, navegar o buscar el recurso. Para cambiar el nombre de carpetas, seleccione Ver> Repositorio y busque la carpeta.

Haga clic derecho en el objeto y seleccione Propiedades ... en el menú contextual.

Aparecerá el cuadro de diálogo Propiedades.

51


Figura 3-4 Cuadro de diálogo Propiedades para un Informe de Recursos

Puede cambiar la carpeta o el nombre y la descripción 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í sólo para información.

4. Haga clic en Enviar para guardar los cambios.

3.3.5 Copiar y mover

La interfaz de repositorio permite a cualquier usuario con la copia de la autorización 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 menús contextuales. Las carpetas se deben mover de una en una, sino múltiples recursos de la misma carpeta se pueden copiar o mover juntos.

Copiar y mover acciones no son posibles en la interfaz de búsqueda, sólo 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 tenían antes de la mudanza. Si desea que los objetos tengan otros permisos, debe configurar los permisos de nuevo después de la mudanza (véase "Permisos" en la página 57).

Para copiar o mover carpetas y recursos: 1. Inicie sesión como un usuario que tiene los permisos necesarios para la carpeta o recurso.

2.

3.

Haga clic en Ver> Repositorio, y expanda las carpetas para mostrar el objeto que desea copiar o mover.

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 Mayús-clic, pero sólo 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 ubicación 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 Edición

Los diferentes tipos de recursos tienen diferentes formas de ser editado. Para los usuarios finales que trabajan con interactivo recursos, la edición incluye principalmente el Abrir en Designer acción en el menú contextual de los cuadros de mando y Ad Vistas hoc. Los procedimientos de la siguiente tabla se describen adicionalmente en la Guía del usuario de JasperReports Server. Tabla 3-4 Recursos que los usuarios finales pueden editar

Tipo de recurso

Ad Hoc vistas

Cómo editar

Edición Professional. Los usuarios seleccionan Abrir en Designer y modificar la vista interactiva. Después 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 excepción: los administradores puede crear un archivo JSP y establecerla como una vista de informe personalizado.

Dashboard Edición Professional. Los usuarios seleccionan Abrir en Designer y modificar la salpicadero de forma interactiva. Después de cambiar el contenido, los usuarios pueden sobrescribir la tablero existente o guardarlo como un nuevo tablero de instrumentos.

Informe de salida es un archivo almacenado en el repositorio. Estos archivos no se pueden editar, sólo descargado o eliminado.

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 también pueden editar JasperReports. Para obtener más información, consulte "Estructura JasperReport" en la página 45. Cuando los usuarios Run un informe, éste se muestra en el visor de informes interactivos. Si los datos instantáneas están habilitadas, el informe se muestra con datos que antes era devuelto por la fuente de datos. Cuando instantáneas de datos no están habilitados, el servidor pregunta el origen de datos y ejecuta la consulta del informe. Después 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 función de los permisos del usuario.

Informe Version Edición Professional. Los usuarios pueden seleccionar Editar para cambiar los valores almacenados como parámetros de entrada.

Recurso Contiene

JasperReport

Para el resto de recursos de la siguiente tabla, la edición es accesible sólo 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 sólo los administradores pueden editar

Tipo de recurso

Fuente de datos

Tipo de datos

Dominio

Archivo

Control de entrada

Lista de valores

Consulta

Cómo editar

Los administradores seleccionar Editar desde el menú contextual de estos recursos. Edición de éstos recursos utiliza el mismo cuadro de diálogo que se utilizó para definir el recurso cuando es primero añadido a JasperReports Server. Los administradores pueden ver la definición actual de un recursos o cambiar los valores que definen a un recurso. Por ejemplo, usted podría ver el tipo de datos de un control de entrada, cambiar una consulta, o subir un nuevo archivo en un archivo de recursos.

En el caso de Dominios, usted también tiene acceso al Diseñador de dominio se utiliza cuando creación del dominio. Puede agregar tablas y campos, cambiar los filtros, o cambiar el mostrar las características de los elementos del dominio. Para obtener más información acerca de Dominios, ver la Guía del usuario de JasperReports Server.

Para todos los otros tipos de recursos, consulte el procedimiento para la creación de ellos en "Otros Recursos en el repositorio "en la página 91.

Al editar un recurso, hay varias limitaciones:

•

•

Puede modificar el nombre o la descripción 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 ubicación del recurso. Algunos cuadros de diálogo para la edición de un recurso incluyen la guardan ubicación, pero el campo es sólo para información. Para cambiar la ubicación del recurso, véase "Copiar y Mover "en la página 52. Para los recursos de archivo, no se puede ver el nombre del archivo que se ha subido, ni en la mayoría de los casos y descargar ver el contenido del archivo. Su única opción es subir un nuevo archivo para reemplazar el viejo. •

3.3.7 Eliminación 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 también eliminar el permiso de todos los recursos y carpetas que la carpeta eliminada contiene, porque todo el contenido de la carpeta eliminada se eliminan también. Las carpetas se deben eliminar de una en una, sino múltiples recursos se pueden eliminar juntos.

No se puede deshacer de una eliminación.

El repositorio no pierde de vista que los recursos son referenciados por otros recursos. No permite borrar recursos si están 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 todavía 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 definición de un JasperReport o una Dominio, usted puede ver los recursos que hace referencia. A continuación, 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 sesión como un usuario que tenga permiso para eliminar la carpeta o recurso.

2.

3.

En el repositorio, navegar o buscar el objeto que desea eliminar.

Haga clic derecho en el objeto y haga clic en Eliminar en el menú contextual que aparece.

54


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, sólo 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 búsqueda, 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 diseñar la estructura del repositorio para su implementación.

Múltiples organizaciones sólo están disponibles en la edición profesional de JasperReports Server.

3.4.1 Organización de carpetas

En el repositorio, cada organización tiene su propia rama, contenida en una carpeta con el nombre de la organización. JasperReports servidor automáticamente restringe la vista de los usuarios y el acceso a la rama del repositorio en su carpeta de organización. Los administradores de la organización pueden crear cualquier estructura de carpetas necesaria dentro de la organización. La carpeta de la parte superior de una organización está contenido en una carpeta llamada Organizaciones de la organización matriz. Top- organizaciones de nivel están contenidos en una carpeta llamada Organizaciones en la raíz de la jerarquía de carpetas. Los administradores pueden ver y navegar a la carpeta de organizaciones, y si se crean las suborganizaciones, pueden también ver todas las carpetas y recursos en la suborganización. Como administradores de la organización de padres, que pueden también crear carpetas y recursos en la suborganización.

De forma predeterminada, los usuarios de una organización también pueden ver y crear carpetas y recursos en cualquier suborganización. Para evitar esto, los administradores pueden cambiar los permisos de la carpeta Organizaciones o carpetas de organizaciones individuales.

La carpeta de Organizaciones en cada organización 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 suborganización cuando el administrador crea una nueva organización a través de la Administrar> Organizaciones página. 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 más información, consulte "Carpetas predeterminadas para Organizaciones "en la página 28

3.4.2 Consideraciones de diseño

El diseño cuidadoso del repositorio JasperReports servidor lleva a un ambiente claro y sólido para su BI medio ambiente y el acceso, pero seguro fácil para los usuarios. Una de las decisiones más importantes es cómo desea que sus organizaciones y los usuarios acceder a los recursos: el que los recursos son compartidos a través de las organizaciones en lugar de que son específicos a una organización en particular. Esto generalmente se descompone en varios escenarios, en función de los recursos que las organizaciones necesitan: • Las organizaciones tienen recursos privados - Organizaciones disponer de fuentes de datos independientes, informes, vistas

OLAP, etc Esto sería típico de una organización con los departamentos. Estos recursos privados se almacenan en cada carpetas propias de la organización, y tal vez sólo unos pocos recursos, como los logotipos de la compañía serían compartidas entre ellos. Organizaciones compartir recursos - Los recursos se mantienen en las carpetas públicas en el que puedan ser utilizados por todos organizaciones y usuarios. Es posible que las fuentes de datos comunes e informes a través de los clientes, pero el

•

55


•

•

datos subyacente se divide por la organización. Seguridad a nivel de datos restringe lo que los usuarios ven cuando se ejecuta informes públicos y vistas OLAP. Compartir recursos de la Organización, pero tienen algunas personalizaciones - Por ejemplo, los usuarios de la organización crean informes que son privadas y se almacenan localmente, sino que acceden a los recursos de las carpetas públicas. Las organizaciones tienen una organización jerárquica - Usted puede tener una organización que contiene otros organizaciones. Por defecto, la organización matriz puede acceder a todos los recursos de sus organizaciones de niños. Si usted no quiere esto, debe evitar la creación de suborganizaciones o personalizar multi-organización del servidor arquitectura.

3.4.3 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 jerarquía de las organizaciones, las referencias son en relación al usuario acceder a ellos. JasperReports servidor transforma referencias relativas a lugares reales de recursos en el repositorio basado en la organización del usuario y la carpeta principal de la organización. Por defecto, las ubicaciones de carpeta se transforman en las formas siguientes:

• Para los miembros de la organización, las ubicaciones en / public no se transforman, pero los de la organización del principal carpeta se transforman a la ubicación 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 también se hace referencia a / Public / sharedLogo, el servidor obtiene el recurso en / público / 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 sólo funciona si hay una carpeta en la raíz del repositorio imágenes 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 sesión como ese usuario a través de la Gestionar> Usuarios página.

Esta transformación permite URIs para hacer referencia a diferentes recursos en función de la organización del usuario que acceda a ellas. Por ejemplo, un informe puede tener un logo específico de la organización 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 ubicación con respecto a la carpeta principal de su organización. Cada organización que utilice este informe debe tener una carpeta llamada / imágenes que contienen un recurso de imagen con la orgLogo ID. Cuando un usuario en cualquier organización se ejecuta el informe, el servidor obtiene la específica organización imagen y la muestra.

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.

Para las tareas de mantenimiento en las unidades de informe de una organización, vistas OLAP y conexiones OLAP, debe iniciar sesión en que esa organización y hacer las tareas allí. No se puede administrar los recursos como superusuario u otro administrador de la organización. Los tres recursos (unidades de informes, vistas OLAP y conexiones OLAP) no pueden hacer referencia a objetos a través de organizaciones o incluso en su propia organización matriz. ¿No se transformará la referencia; lo haría

Hay tres excepciones a las referencias están transformadas. En estos casos, las referencias deben ser literal:

• • •

•

También, debido a que estas referencias no se transforman, se debe observar lo siguiente:

•

56


debe tomarse literalmente y fracasaría. 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 sesión como administrador de la organización utilizando las referencias. Ver "Prueba de permisos de usuario" en la página 62.

3.4.4

• •

•

•

Mejores Prácticas

Las mejores prácticas para los recursos en un repositorio compartido por múltiples organizaciones son las siguientes:

El sistema administrador debe iniciar sesión como usuario de la organización con el fin de mantener o ejecutar recursos de la organización. Recursos con referencias absolutas a los recursos en carpetas organización sólo funcionan para los usuarios dentro de la organización o una organización de padres. Si un JRXML que accede a recursos de la organización con URIs debe correr a través de las organizaciones, entonces todos las organizaciones deben tener carpetas idénticas, nombres de objetos y tipos de objetos que se espera para esos recursos. La carpeta pública 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

Sin acceso

Acciones Otorgadas en carpetas del repositorio y Recursos

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.

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.

•

•

•

•

•

•

•

Leer + Supr •

•

•

•

Consulte la carpeta o recurso de cualquier diálogo 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

Ejecución de un informe en el fondo

Programar un informe para ejecutarlo más 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

Sólo ejecución

Sólo Lectura

57


Permiso

Leer + Escribir

Acciones Otorgadas en carpetas del repositorio y Recursos

•

•

•

•

Guarde las opciones de informe para un JasperReport Eliminar opciones de informe

Copie los recursos en una carpeta con este permiso

Editar recursos

Añadir 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 descripción Abra una vista especial en el Editor Ad Hoc o un panel de control en el diseñador

Modificar y sobrescribir un Especial vista, informe o cuadro de mandos existente

Añadir un recurso JasperReport al repositorio (subir una JRXML)

Editar la definición de un recurso JasperReport en el repositorio (reemplazar el JRXML)

Establezca los permisos (por función y por usuario) en una carpeta o recurso. Este delegados eficazmente ciertas tareas de administración del repositorio.

Añadir (crear) un recurso en una carpeta

Edición de un recurso, por ejemplo los componentes de una unidad de informes o en un dominio

Leer + Escribir + Supr •

•

•

•

•

•

•

•

•

Administrar •

Administrar y PAPEL _ADMINISTRATOR

•

•

Permisos aplican al navegar o buscar en el repositorio, así como cuando se utiliza cualquier diálogo que acceda a el repositorio, como por ejemplo cuando se navega por las carpetas para guardar un informe. Tenga en cuenta que:

•

•

•

Copiado hace no preservar los permisos en un objeto. Los usuarios pueden copiar un objeto de sólo lectura, péguelo en un carpeta de lectura-escritura, a continuación, editar el objeto. Para más detalles, consulte "Copiar y mover" en la página 52 Copia y corte (en movimiento) acciones sólo pueden completarse si el usuario ha Leer + Escribir + Delete acceso a la carpeta en la que se pega el objeto. Para más detalles, consulte "Copiar y mover" en la página 52 Corte, eliminar y configurar permisos en las carpetas se permite sólo si el usuario tiene el mismo permiso en todos los contenidos de la carpeta. Corte y eliminación de recursos a granel se permite sólo si el usuario al menos ha Leer + Eliminar el permiso de todos los recursos seleccionados. Eliminación de un recurso o el contenido de una carpeta sólo está permitido si no hay otros recursos dependen de ellos. Para obtener más detalles, consulte "Eliminación de carpetas y recursos" en la página 54

•

3.5.1 La herencia de permisos

De acuerdo con la arquitectura de permiso, hay una configuración de permisos para cada usuario y rol en cada carpeta y recursos en el repositorio. Para simplificar la definición 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 explícitamente 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 explícitamente, que el permiso se aplica, independientemente de los de la carpeta principal.

El uso de este mecanismo, los administradores pueden gestionar grandes jerarquías de contenido y mantenerlos seguros. Cuando el administrador establece un permiso de forma explícita, 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 definición explícita de los suyos. Permisos que son

58


asignado en la carpeta de la parte superior de una organización se heredan a través de toda la organización. Los permisos que se establecen en la carpeta raíz o (si se utiliza la edición profesional de JasperReports Server) carpeta de Organizaciones por el sistema administrador se heredan a través de múltiples organizaciones. Por ejemplo, el administrador de sistema puede hacer que todas las organizaciones de sólo lectura de forma predeterminada para los usuarios comunes, y cada organización administrador puede crear carpetas específicas 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 más roles puede tener múltiples permisos definidos o heredados en cualquier carpeta o recurso determinado. De hecho, cada permiso tiene que ser definido en la raíz, 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 través 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.

¿Cómo JasperReports Servidor determinar la autorización 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 más restrictivo, como Sin acceso, se establece de forma explícita, el permiso menos restrictivo como Lectura Sólo se aplica, independientemente de si se hereda o establece explícitamente.

3.5.3 Permisos de administrador

La arquitectura de la autorización del servidor JasperReports distingue entre los administradores y todos los demás usuarios. Los administradores se definen como usuarios, ya sea con ROLE_SUPERUSER (disponibles en la edición profesional de JasperReports Server), ROLE_ADMINISTRATOR, o ambos. Por su diseño, los administradores de sistemas con la ROLE_SUPERUSER siempre tienen acceso Administrar irrevocable de todo el repositorio, incluyendo a la contenido de cada organización. El administrador del sistema no puede modificar los permisos para ROLE_ SUPERUSUARIO, para evitar el bloqueo o no puede administrar algún recurso. Por lo tanto, el administrador de sistema puede establecer permisos para todos los demás usuarios, en cualquier carpeta o recurso, y en cualquier organización, si es necesario. En particular, el administrador del sistema puede modificar los permisos para ROLE_ADMINISTRATOR, por ejemplo, para compartir algunos recursos a través de todas las organizaciones al hacerlos de sólo lectura a todo el mundo, incluida la organización administradores.

Los administradores de organización son usuarios de la organización con el ROLE_ADMINISTRATOR, como el jasperadmin defecto creado en cada organización. De forma predeterminada, los administradores de la organización tienen los permisos Administrar a todo en su organización, salvo que el administrador del sistema ha cambiado a un permiso menor. Sin embargo, la organización los administradores no pueden cambiar los permisos concedidos a ROLE_ADMINISTRATOR, para evitar que se anule la configuración del administrador de sistema y de encerrarse fuera de una carpeta o recurso.

3.5.4 Ejecutar permiso de sólo

Al igual que en los sistemas de archivos, sólo permiso de ejecución 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 sólo se aplica a las carpetas, así, evitando que aparecen en el árbol de carpetas cuando los usuarios navegar en el repositorio, y aún así permitir que los recursos que contienen a heredar el único permiso de ejecución. Este es útil para ocultar carpetas y recursos, como fuentes de datos que sólo los administradores y los roles de los analistas de datos necesitan acceder en el repositorio. Sin embargo, si su sólo ejecutar carpeta contiene sólo lectura los recursos, los recursos están ocultas cuando se navega carpetas, pero se puede encontrar, ya sea accidental o intencionalmente, mediante el uso de la Búsqueda repositorio.

59


Al igual que con todos los demás permisos, ejecutar permiso de sólo 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 ejecución, 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.

Ocultación de un recurso con ejecutar permiso de sólo 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 raíz hay acceso y los permisos debe ser definido explícitamente. En la práctica, la instalación por defecto del repositorio contiene datos de la muestra con una mezcla de no acceso, ejecutar solamente, de sólo 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 común para los permisos, lo que permite a los usuarios ver la recursos que puedan acceder y ocultar los que no pueden, mientras que los administradores tienen acceso completo. Le recomendamos que se familiarice con el mecanismo de permisos mediante la visualización y la configuración de permisos en los datos de la muestra, tal como se describe en la siguiente sección.

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 sólo puede establecer los permisos en ese específico de recursos.

Para establecer permisos en una carpeta o recurso en el repositorio: 1. Inicie sesión 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 diálogo 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 diálogo que aparecen los permisos por rol

En sistemas con múltiples organizaciones, los usuarios y los roles que se muestran incluyen sólo los que están dentro del ámbito de el usuario. Por ejemplo, en la organización única forma predeterminada, el administrador de la organización no puede ver el permiso para el administrador de sistema (superusuario) O para ROLE_SUPERUSER. En la figura anterior, se puede ver los permisos basados en roles por defecto en la carpeta Tipos de datos de muestra de entrada como se ve por el administrador organización (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 sólo 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 función de administrador o nombre de usuario, para evitar que se eliminando su capacidad para establecer permisos.

4.

5.

En el cuadro de diálogo, haga clic en Usuario para ver los permisos asignados a los usuarios específicos. Haga clic en Papel durante la visualización de usuario 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 instalación por defecto, todos los permisos se definen por papel; Por lo tanto, todos los permisos de los usuarios son No Acceso heredado de la raíz. El figura muestra una de sólo lectura autorización 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 todavía se ejecute sólo debido a los ajustes en Figura 3-5.

61


Figura 3-6 Permisos de diálogo que aparecen los permisos de usuario

6.

7.

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.

Haga clic en Aceptar para guardar los cambios y cerrar los permisos de diálogo cuando haya terminado. Puede abrir varios cuadros de diálogo 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 través de varias carpetas o organizaciones.

Hay dos casos especiales, cuando la configuración de permisos:

• Si un recurso hereda un permiso, por ejemplo, de sólo 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 continuación, establecer el permiso explícito, a continuación, 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 diálogo sigue mostrando el asterisco como si se hereda el permiso. Pero cuando el padre está más tarde le dio un diferente permiso, por ejemplo, de lectura y escritura, el recurso conserva su explícito permiso de sólo lectura en lugar de heredar de lectura-escritura.

• Para restablecer el nivel de permiso para que una vez más hereda de su carpeta padre, seleccione una diferente nivel de permisos y haga clic en Aplicar, a continuación, seleccione el permiso con el asterisco y haga clic en Aplicar de nuevo.

3.5.7 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 también se recomienda al agregar nuevos usuarios, roles, y recursos, y cuando usted hace grandes modificaciones a la configuración de control de acceso.

Para comprobar los permisos de usuario: 1. Inicie la sesión como administrador.

2. 3.

4.

Seleccione Gestionar> Usuarios. Seleccione la organización del usuario, a continuación, navegar o buscar para el usuario cuyos permisos se está probando. En el panel Usuarios, seleccione el usuario.

62


5. En el panel Propiedades, haga clic en Entrar como usuario. Aparece la página de inicio del usuario seleccionado. La información de inicio de sesión en la esquina superior derecha muestra que son iniciar la sesión como ese usuario.

6.

7.

8.

9.

En el repositorio, navegar o buscar las carpetas y los recursos a prueba.

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.

Cuando haya comprobado los permisos del usuario, haga clic en Salir.

Aparece su propia página de inicio.

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 configuración de control de acceso que no se ha probado no proteger los datos adecuadamente.

63


64

CAPÍTULO 4 FUENTES DE INFORMACIÓN


Un origen de datos es un recurso en el repositorio que define cómo y dónde 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 contraseña.

JasperReports Server proporciona tipos de fuentes de datos para las bases de datos relacionales, la mayoría 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 través 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 conexión directa al servidor de base de datos utilizando su driver JDBC. Después

instalación, drivers JasperReports Serverincludes JDBC para acceder a las bases de datos más populares: MySQL, PostgreSQL, Oracle, SQL Server y DB2. A partir del lanzamiento 5.6.1, el servidor también 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 través 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 máximo número de conexiones simultáneas 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 aplicación servidor para acceder a una conexión 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 configuración del servidor de aplicaciones determina la número 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 están disponibles para todas las bases de datos que soportan JDBC.

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 través de Cloudera 5 Hive o Impala. Utiliza el lenguaje de consulta Hive (HiveQL) que es similar a SQL, pero distinta. Todos los demás Hadoop- Fuentes de datos colmena debe utilizar el controlador JDBC se ha descrito anteriormente.

•

Grandes almacenes de datos que no son compatibles con JDBC tienen un origen de datos personalizado: •

•

65


• Fuente de datos MongoDB - Esta fuente de datos personalizada para MongoDB MongoDB soporta propia consulta de Jaspersoft Idioma.

Amazon Web Services (AWS) fuentes de datos - acceso a los datos almacenados en el almacén de datos utilizando AWS JasperReports Server, ya sea en las instalaciones o en la nube. Fuente de datos virtual - Le permite combinar múltiples fuentes de datos en una sola fuente de datos y unirse a ellos dentro de un dominio. También 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 diagnóstico interno - Una fuente de datos personalizada para propios datos de diagnóstico del servidor. El diagnóstico información sólo está disponible para los administradores de sistemas (superusuario por defecto). Para obtener más información, consulte "Utilización los datos de diagnóstico en los informes "en la página 236.

Por último, JasperReports Server también admite algunas fuentes de datos especializadas: •

•

• •

En el caso de análisis de datos, JasperReports Server es compatible con las fuentes de datos OLAP (como Mondrian y XML / A conexiones). Para obtener información sobre las fuentes de datos de análisis, consulte la Jaspersoft última guía OLAP.

Puede ampliar JasperReports Server para admitir cualquier fuente de datos personalizado. Fuentes de datos personalizados consisten en Clases Java de implementación, un catálogo de mensajes, y una definición de frijol de primavera. Para obtener más información sobre las fuentes de datos personalizadas, consulte la Ultimate Guide servidor JasperReports.


• • • • • • • • • •

Orígenes de datos JDBC Administración 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 orígenes de datos virtuales Fuentes de datos de frijol

4.1 Orígenes 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 dirección URL y las credenciales para acceder a su base de datos, junto con la base de datos específica de cualquier parámetros de configuración. JasperReports Server incluye controladores JDBC para las bases de datos más 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 más información sobre los controladores JDBC, consulte "Controladores de Gestión de JDBC" en la página 68. Para crear una fuente de datos JDBC: 1. Inicie sesión como administrador.

2. 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 página y especificar una ubicación de carpeta más tarde. Si ha instalado los datos de ejemplo, la carpeta sugerida es Orígenes de datos.

66


Aparece la página Nuevo origen de datos.

3.

4.

En el campo Tipo, seleccione JDBC Data Source.

La página se actualiza para mostrar los campos necesarios para una fuente de datos JDBC. Escriba un nombre y una descripción opcional para la fuente de datos. El identificador de recurso se rellena automáticamente basa en el nombre.

Figura 4-1 Configuración 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 "Gestión de Controladores JDBC" en la página 68.

Figura 4-2 Seleccionar el controlador JDBC

6. 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 típico para el proveedor de base de datos especificado. Los tres campos se combinan automáticamente para crear la URL JDBC que utilizará el servidor para acceder a la base de datos. Para obtener más información acerca de JDBC URL, incluyendo parámetros opcionales, consulte la sección de solución de problemas "URL de base de datos JDBC" en la página 249.

7. Escriba el nombre de usuario de base de datos y la contraseña. Estas son las credenciales que el servidor utilizará para acceder a la base de datos.

67


Figura 4-3 Prueba de la conexión 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 relación 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 datos en la base de datos. La lista de zonas horarias es configurable, como se describe en "Especificación Husos horarios adicionales "en la página 267. En caso de duda, deje el campo en blanco Zona horaria.

8.

9.

Si aún no lo ha especificado la carpeta del repositorio, haga clic en Examinar ... elegir uno en el Guardar ubicación campo.

Haga clic en Prueba de conexión para validar la fuente de datos. Si la validación falla, asegúrese de que los valores que introducidos son correctos y que la base de datos se está ejecutando. Para diagnosticar problemas de conexión JDBC, puede activar el registro como se describe en la sección de solución de problemas "Inicio de sesión de operaciones JDBC" en la página 247. 10 Cuando la prueba es correcta, haga clic en Guardar. El origen de datos aparece en el repositorio.

4.2 Administración 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-instalar-

El administrador del sistema (usuario root) puede agregar controladores JDBC para otras bases de datos de las siguientes maneras: • Durante la instalación. Para obtener más información, consulte la Guía de instalación del servidor

JasperReports.

68


• En cualquier momento a través de la interfaz de usuario. Como se describe en el procedimiento siguiente, el administrador del sistema puede agregar, reemplazar o quitar controladores JDBC a través de la interfaz de usuario, sin necesidad de reiniciar el servidor.

Sólo el administrador del sistema puede gestionar los drivers JDBC, pero una vez que se suben, que están 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 más información, consulte "Controladores JDBC en JBoss" en la página 248.

Para agregar un controlador JDBC: 1. Inicie la sesión como administrador del sistema (superusuario en las ediciones comerciales, jasperadmin en la comunidad ediciones).

2.

3.

4.

Seleccione Crear> Fuente de datos desde el menú principal.


La página se actualiza para mostrar los campos necesarios para una fuente de datos JDBC. El selector desplegable para el campo Controlador JDBC muestra los controladores JDBC que están disponibles y los que no están instalados.

Figura 4-4 Visualización de la lista de controladores JDBC disponibles

5.

6.

Si desea agregar un controlador que no se ha instalado, seleccione de la lista, a continuación, haga clic en Agregar controlador. El Aparece diálogo Seleccionar controlador. Si usted todavía no ha obtenido el controlador, haga clic en el vínculo para Descarga e Instalación de los controladores de base de datos. Esa página en el sitio web de la comunidad de Jaspersoft tiene vínculos con los controladores JDBC más utilizados. Después descargar un controlador para el sistema de archivos, puede volver al cuadro de diálogo Seleccionar controlador.

Figura 4-5 Adición de un controlador JDBC

69


7.

8.

En el cuadro de diálogo Seleccionar controlador, haga clic Explorar para localizar el archivo JAR del controlador correspondiente. Si el conductor tiene más de un archivo JAR, haga clic en el Explorar botón que aparece después de seleccionar el primer archivo. Haga clic en Subir para instalar el controlador y ponerla a disposición 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 Guía de instalación del servidor JasperReports.

Para actualizar un controlador JDBC: 1. Inicie la sesión como administrador del sistema (superusuario en las ediciones comerciales, jasperadmin en la comunidad ediciones).

2.

3.

4.

5.



La página se actualiza para mostrar los campos necesarios para una fuente de datos JDBC. El selector desplegable para el campo Controlador JDBC muestra los controladores JDBC que están disponibles y los que no están instalados.

Para actualizar un controlador que ya se ha instalado, seleccione de la lista, a continuación, haga clic en Editar conductor. El Select De diálogo del controlador aparece y le informa de que la selección de un controlador sobrescribe el existente.

Figura 4-6 Actualización de un controlador JDBC

6.

7. 8.

En el cuadro de diálogo 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 disposición de inmediato. Ahora puede utilizar este controlador para crear una fuente de datos, y también se instalará el controlador al otro administradores crean fuentes de datos.

Para eliminar un driver JDBC cargada: 1. Inicie la sesión como administrador del sistema (superusuario en las ediciones comerciales, jasperadmin en la comunidad ediciones).

2.

3. 4.

5.

Seleccione Ver> Repositorio y abra la carpeta Propiedades del sistema en la raíz.

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 instalación.

Haga clic en Retire junto al conductor que desea eliminar.

70


Figura 4-7 Extracción 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 próxima vez que utilice el asistente para nuevo origen de datos.

4.3 Fuentes de datos JNDI

La fuente de datos JNDI accede a una conexión 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, sólo 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 través de JNDI. Usted debe especificar el nombre del servicio JNDI de una conexión JDBC. El servidor de aplicaciones también debe tener la conductores y JDBC apropiadas pueden configurar para usarlos.

Para obtener información sobre la configuración de una conexión JNDI en el servidor de aplicaciones, consulte las siguientes secciones: • • •

"JNDI Servicios en Apache Tomcat" en la página 250 "Trabajar con fuentes de datos" en la página 247 "JNDI Servicios en WebLogic" en la página 250

Para crear una fuente de datos JNDI: 1. Inicie sesión como administrador.

2. 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 página y especificar una ubicación de carpeta más tarde. Si ha instalado los datos de ejemplo, la carpeta sugerida es Orígenes de datos. Aparece la página Nuevo origen de datos.

3. En el campo Tipo, seleccione JNDI de origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos JNDI.

71


4. Rellene los campos requeridos, junto con cualquier información opcional.

El nombre del servicio es el nombre que el servidor de aplicaciones expone a través de JNDI. Muestra la siguiente figura valores para la conexión 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 página

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 relación con Tiempo del Meridiano de Greenwich (GMT), debe especificar una zona horaria para que el servidor puede convertir fecha y hora valores leídos 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 "Especificación Husos horarios adicionales "en la página 267. En caso de duda, deje el campo en blanco Zona horaria.

5. Haga clic en Prueba de conexión para validar la fuente de datos. Si la validación falla, asegúrese de que los valores que introducidos son correctos, que la base de datos se expone a través de JNDI, y que la base de datos se está ejecutando. Asimismo, consulte la sección de solución de problemas "Servicios de JNDI en Apache Tomcat" en la página 250. Cuando la prueba es correcta, haga clic en Guardar. El origen de datos aparece en el repositorio.

6.

Para obtener más información acerca de la configuración y la exposición de una conexión de base de datos JNDI en el nivel de servidor de aplicaciones, consulte la documentación proporcionada con el servidor de aplicaciones.

72


4.4 Fuentes de datos de AWS

Amazon Web Services (AWS) proporcionan la computación 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 presentación de informes: • •

Amazon Relational Database Service (RDS) Almacén de datos Amazon Redshift

JasperReports Server puede acceder a cualquiera de estos servicios cuando se define una fuente de datos con la correcta información de configuración 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 continuación, utiliza estas credenciales para configurar correctamente los grupos de seguridad para mantener la conexión entre JasperReports Server y la fuente de datos AWS, incluso cuando la dirección 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 más información, consulte https://www.jaspersoft.com/cloud. Para crear un origen de datos de AWS: 1. Entre en JasperReports Server como administrador.


3.

4.

En el campo Tipo, seleccione AWS origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos de AWS. Introduzca un nombre, una descripción opcional y la ubicación en el repositorio para almacenar la fuente de datos.

Figura 4-9 Configurar el tipo de origen de datos y Propiedades de la página

5. Bajo el encabezado Configuración de AWS, especificar sus credenciales de Amazon en una de las siguientes maneras:

73


Figura 4-10 Selección 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á automáticamente 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. Bajo el encabezado Seleccionar un origen de datos de AWS, especifique los detalles de la conexión de la fuente de datos de AWS que que desea utilizar para conectarse: a.

b.

Seleccione la región AWS desde el desplegable.

Haga clic en el Encontrar Mis Fuentes de datos de AWS botón. La fuente de datos de AWS consulta su entorno y muestra las fuentes de datos disponibles, como se muestra en la siguiente figura.

c.

d.

Seleccione el origen de datos.

Introduzca su nombre de usuario, contraseña y nombre de base de datos. La fuente de datos de AWS consulta tu entorno y agrega el controlador y URL apropiada.

74


Figura 4-12 Seleccione una sección AWS origen de datos

7. Cuando haya introducido toda la información, haga clic en Probar conexión.

Si la conexión 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 después de uno o dos minutos. Los realiza la prueba las siguientes acciones: • • •

Valida el nombre de usuario y contraseña. Crea un grupo de seguridad de base de datos. Añade la dirección 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 dirección IP de forma manual, ya que tener un complejo VPC topología, véase "Configuración de Amazon Web Services" en la página 197. También puede cambiar el controlador JDBC por defecto a través de la configuración.

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 más información acerca de Cassandra, consulte http://cassandra.apache.org/. La fuente de datos Cassandra se basa en un nuevo controlador que tiene ciertas limitaciones en cómo se pueden estructurar sus datos y acceso:

75


•

• •

La versión actual de Cassandra no admite valores NULL en los datos. Todos los campos obligatorios deben tener valores por defecto no NULL. Esto también significa que los controles de entrada no puede ser nulo y se les debe dar un valor. La versión actual del controlador no admite las funciones de agregado (suma, min, max). Para los parámetros de consulta, la versión actual del controlador es compatible con $ X (EN ...), pero no hay otras funciones $ X.

Como se actualiza el controlador de Cassandra para incluir más 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, diseñar sus datos Cassandra con las siguientes directrices:

• •

Especifique el Permitir el filtrado sufijo para acelerar las consultas. Todos los campos de referencia en DONDE cláusulas 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 página 86. Fuentes de datos Cassandra se pueden utilizar en temas ad hoc, pero no son compatibles con la optimización de consultas. Usted debe configurar los límites de consulta para manejar grandes volúmenes de datos (véase "Ad Hoc Políticas de datos para grandes datos" en la página 181). Debe configurar la memoria JVM para manejar la cantidad esperada de datos (véase el JasperReports Guía de instalación del servidor).

4.5.1

1.

2.

Crear un origen de datos Cassandra

Inicie sesión como administrador.

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 página y especificar una ubicación de carpeta más tarde. Si ha instalado los datos de ejemplo, la carpeta sugerida es Orígenes de datos. Aparece la página Nuevo origen de datos.

3. En el campo Tipo, seleccione Cassandra origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos Cassandra.

76


Figura 4-13 Cassandra datos fuente de la página


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.

Haga clic en Probar conexión para comprobar los valores que ha entrado. Asegúrese de que el puerto se establece en 9042, debido a que el prueba de conexión también trabajará con el puerto equivocado (9160). Cuando haya terminado, haga clic en Guardar. El origen de datos aparece en el repositorio.

4.5.2 El aumento de los límites de descriptor de fichero para Cassandra

Muchos usuarios han informado de errores durante la visualización de muchos informes de una fuente de datos Cassandra. Cassandra general necesita más que el límite predeterminado de descriptores de archivos abiertos (1024).

77


Para aumentar el número de descriptores de archivos, los administradores necesitan para cambiar los límites de seguridad en el Casandra linfáticos y en los sistemas operativos que se ejecutan JasperReports servidor. Para probar esta configuración, puede aumentar los límites de la sesión 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 añadir los siguientes ajustes:

* Nofile suave 32768 * Duro nofile 32768 raíz nofile suave 32768 raíz dura nofile 32768 * Memlock suave ilimitada * Duro memlock ilimitada raíz memlock suave ilimitada raíz dura memlock ilimitada * Suave ilimitada * Disco ilimitado raíz suave ilimitada raíz 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 versión 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 través de un Cloudera 5 servidor solamente. JDBC Data Source con controlador JDBC Hive - La mayoría 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 todavía 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 página 86. Fuentes de datos CDH 5 Hive-Impala se pueden utilizar en temas ad hoc, pero no apoyan la consulta optimización. Usted debe configurar los límites de consulta para manejar grandes volúmenes de datos (véase "Ad Hoc Políticas de datos para grandes datos" en la página 181). Debe configurar la memoria JVM para manejar la cantidad esperada de datos (véase el JasperReports Guía de instalación del servidor).

El controlador JDBC para Colmena funciona mayoría 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 creación 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-serán lentos para rellenar la lista de opciones. Usted debe configurar los límites de consulta y tiempo de espera para manejar la latencia (vea "Ad Hoc Políticas de datos para Big Datos "en la página 181). Debe configurar la memoria JVM para manejar la cantidad esperada de datos (véase el JasperReports Guía de instalación del servidor).

En general, los informes basados en JDBC-Hive fuentes de datos son los más 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 lo necesite durante el día. Para crear una fuente de datos JDBC Hive, siga el mismo procedimiento que en el "Orígenes de datos JDBC" en la página 66. Para crear una fuente de datos CDH 5 Hive-Impala: 1. Inicie sesión como administrador.


3. En el campo Tipo, seleccione CDH 5 Hive-Impala origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos Hadoop-Hive.

Figura 4-14 Hadoop-Hive datos fuente de la página

79



La URL de JDBC depende de qué tipo de servidor que esté utilizando:

Hive 2:

Impala:

jdbc: hive2: // <nombre de host>: 10001 / default

jdbc: hive2: // <nombre de host>: 21050 /; auth = noSasl

5. Cuando haya terminado, haga clic en Guardar. El origen de datos aparece en el repositorio.

4.7 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 basándose 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 página 86. Fuentes de datos MongoDB se pueden utilizar en temas ad hoc, pero no son compatibles con la optimización de consultas. Usted debe configurar los límites de consulta para manejar grandes volúmenes de datos (véase "Ad Hoc Políticas de datos para grandes datos" en la página 181). Debe configurar la memoria JVM para manejar la cantidad esperada de datos (véase el JasperReports Guía de instalación del servidor).

Para crear una fuente de datos MongoDB: 1. Inicie sesión como administrador.


3. En el campo Tipo, seleccione MongoDB origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos MongoDB.

80


Figura 4-15 MongoDB datos fuente de la página

4.

5.

6.

Rellene los campos requeridos, junto con cualquier información opcional.

El MongoDB URL tiene la forma: MongoDB: // <nombre de host>: 27017 / <base de datos>

El esquema se utiliza sólo 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 página 87.

Cuando haya terminado, haga clic en Guardar. El origen de datos aparece en el repositorio.

MongoDB está diseñado para acceder a través de llamadas a la API en una aplicación o un shell de comandos. Como consecuencia, no tiene un lenguaje de consulta definido. Para escribir consultas para orígenes 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 representación textual de las estructuras de datos que es a la vez humano-y legible por máquina.

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 visión general de la Jaspersoft MongoDB Query Language, con términos-SQL equivalente entre paréntesis:

• Recuperar todos los documentos (filas) de la colección determinada (tabla):

81


{'collectionName': 'cuentas'}

•

{

De todos los documentos de la colección 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 sólo los documentos (filas) de la colección determinada (tabla) que responden a la consulta (cláusula where). En este caso, la fecha es mayor que-o-igual al parámetro 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 también soporta características avanzadas de MongoDB como mapa-reducir funciones y agregación que están más allá del alcance de este documento. Para obtener más información, 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 múltiples fuentes de datos JDBC y JNDI y ponerlos a disposición a unir a través de un dominio. Usted puede combinar cualquier número 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 también hacen fuentes Cassandra, Hadoop-Hive, y MongoDB datos disponibles en Dominios. En este uso, la fuente de datos virtual actúa 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 página 86.

•

Una fuente de datos virtual puede envolver una sola fuente de datos para los datos grandes, o combinar cualquier número 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 través 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 más información sobre los dominios, consulte el capítulo "Creación de Dominios" en la Guía del usuario de JasperReports Server.

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 añade como prefijo para las tablas de la fuente de datos original para asegurar que los nombres de las tablas son únicos a través de la fuente de datos virtual. Para crear una fuente de datos virtual: 1. Inicie sesión como administrador.


3. 4.

En el campo Tipo, seleccione Datos Virtual Fuente. Rellene los otros campos requeridos, junto con cualquier información opcional.

83


5.

6.

Localice las fuentes de datos que desea utilizar en el panel Orígenes 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 Orígenes 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; también 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. 7.

La siguiente figura muestra los valores para crear una fuente de datos virtual mediante la combinación 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 Creación 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 configuración de zona horaria en un virtual fuente de datos.

84


Puede editar una fuente de datos virtual para añadir 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. Extracción de una fuente de datos a partir de una de datos virtual fuente modifica sólo la fuente de datos virtual; la fuente de datos que ha extraído permanece en el repositorio. Para editar una fuente de datos virtual: 1. Inicie sesión como administrador.

2.

3. 4.

5.

Haga clic en Ver> Repositorio y ampliar el árbol de carpetas para buscar la carpeta que contiene el origen de datos.

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 Orígenes de datos disponibles y haga doble clic. Para eliminar una fuente de datos, seleccione en el panel Orígenes 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.

4.8.1 Consideraciones sobre el rendimiento

Fuentes de datos virtuales se basan en el motor Teiid manejar múltiples fuentes de datos y combinar los resultados de ellos. Cómo diseñar las tablas en cada una de sus fuentes de datos y cómo se combinan en una unión lata de dominio afectar significativamente el rendimiento.

Hay varias cuestiones a tener en cuenta al diseñar una solución 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 través 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 administración del caché" en la página 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 más se puede empujar hacia abajo, el más pequeño de los conjuntos de datos que se debe manejar en la memoria Usted debe diseñar 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 unión entre fuentes de datos.

•

Por ejemplo, si crea una copia duplicada de una tabla de dimensiones fecha en ambos de sus fuentes de datos, que pueden ser unido mucho más eficiente. Si esta tabla existía en una sola base de datos, el motor Teiid necesitaría para recuperar todas las filas de la otra base de datos y realizar la unión en sí. Con esta tabla en ambas bases de datos, la Teiid motor puede empujar hacia abajo todo el tiempo-dimensión se une a las bases de datos individuales y llevar a cabo una final se unen en conjuntos de datos mucho menor.

Para obtener más información acerca de la optimización de sus datos para su uso en Teiid, consulte http://www.jboss.org/teiid/.

4.8.2 Inicio de sesión para orígenes de datos virtuales

Si usted tiene problemas con sus conexiones de datos a través 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 información sobre cómo habilitar el registro, consulte "Configuración de registros del sistema" en la página 192.

85


4.9 Conectores grandes datos para los orígenes de datos virtuales A partir de JasperReports Servidor 5.6, las fuentes de datos virtuales también 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 información de conexión 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 razón, cuando una fuente de datos para los datos grande envuelto en una fuente de datos virtual, la fuente de datos resultante tiene las siguientes limitaciones: • Los conectores de Cassandra, Hadoop, MongoDB y en las fuentes de datos virtuales no soportan parámetros de consulta

($ 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 parámetros 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 agregación. El conector MongoDB para fuentes de datos virtuales no admite la operaciones de búsqueda, agregación 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 través de una vista especial o informe.

Cuando envuelto en una fuente de datos virtual, puede acceder a Cassandra, Hadoop, y MongoDB a través de un Dominio, Tema de dominio, Ad Hoc vista, y Ad Hoc informe. Una fuente de datos virtual puede contener cualquier combinación 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 optimización 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 optimización 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 más información acerca de la optimización de consultas, consulte Consulte "Ad Hoc Políticas de datos para grandes datos "en la página 181.

• •

•

Sin embargo, hay ventajas significativas en el acceso a grandes volúmenes de datos a través de fuentes de datos virtuales: •

•

•

Para obtener más información acerca de Teiid, consulte 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 página 75 "Hadoop Hive-Fuentes de datos" en la página 78 "Fuentes de datos MongoDB" en la página 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


debe reiniciar JasperReports Server después de cualquier modificación en el valor de esquema. Para obtener más información, consulte "Esquema relacional para MongoDB Connector" en la página 87.

2.

3.

Crear una fuente de datos virtual como se describe en "Fuentes de datos virtuales" en la página 82. En el diálogo de creación 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 más fuentes de datos grandes, o cualquier mezcla de datos grandes, Fuentes de datos JDBC y JNDI. Crear un 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 demás características de un dominio.

4.

4.9.2 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 colección denominada cliente en MongoDB con un documento incrustado llamado Dirección. El lado derecho muestra el esquema correspondiente para uso en el de datos virtual conector de fuente.

{ "_id": 10, "Name": "John Doe", "Edad": 27, "Género": "macho",

"Dirección": { "_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), número entero edad, varchar de género (50)) OPCIONES (ACTUALIZABLE 'TRUE'); CREAR dirección 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 asignación automática 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 :: Código •MongoDB :: Minkey y MongoDB :: MaxKey Como resultado, sus documentos deben utilizar identificadores enteros y no MongoDB :: OID. Cuando se cambia el mapeo o añadir una nueva colección 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 extensión clave, ya que le permite hacer uso de las costumbres o los datos exótica 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 parámetros que llenan el informe.

Para utilizar un origen de datos de frijol, primero debe configurar el frijol de primavera subyacente y ponerla a disposición en el contexto de la aplicación web del servidor. Por ejemplo, debe agregar una definición de frijol a uno de los WEB- INF / ApplicationContext * Xml. El frijol se debe resolver en un ReportDataSourceService ejemplo, ya sea directamente o por medio de una fábrica no- método argumento. Se puede utilizar cualquier método de instancias primavera (por ejemplo, un constructor o de la fábrica) y frijol alcance (por ejemplo, singleton o prototipo) para el frijol servicio de origen de datos. El ReportDataSourceService instancia es responsable de suministrar parámetros de la fuente de datos para la JasperReport. Custom ReportDataSourceService implementaciones pueden seguir dos enfoques:

• Si la implementación puede proporcionar los datos que se utiliza para llenar un informe, que necesita para envolver los datos en una adecuado JRDataSource aplicación y pasar los datos utilizando el REPORT_DATA_SOURCE informe parámetro. 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 parámetros de conexión definidos por el ejecutor de consultas. Los parámetros de conexión son generalmente obtenido a partir de las propiedades de la instancia de servicio de fuente de datos.

•

Por ejemplo, usted podría poner en práctica un servicio de fuente de datos Hibernate que se inyecta en una fábrica de sesiones. La fábrica crearía una sesión de Hibernate que se pasa como un valor para la HIBERNATE_SESSION parámetro. El ejecutor de consultas JasperReports Hibernate utiliza entonces el parámetro para ejecutar el informe de consultas HQL. El ReportDataSourceService interfaz contiene dos métodos: setReportParameterValues y closeConnection. El primero proporciona valores de los datos y parámetros de conexión; 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 través de la primavera, se puede añadir la fuente de datos de frijol a la repositorio.

Para crear una fuente de datos de frijol: 1. Inicie sesión como administrador.

2. 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 página y especificar una ubicación de carpeta más tarde. Si ha instalado los datos de ejemplo, la carpeta sugerida es Orígenes de datos. Aparece la página de nuevo origen de datos, como se muestra en la siguiente figura.

3.

4.

En el campo Tipo, seleccione Frijol de origen de datos.

La información en la página cambia para reflejar lo que se necesita para definir una fuente de datos de frijol. Rellene los campos requeridos, junto con cualquier información opcional.

Si el servicio de fuente de datos es que se crea una instancia a través de un método de fábrica del grano de primavera, usted debe también introduzca el nombre del método.

5. Haga clic en Prueba de conexión para validar la fuente de datos.

Si la validación falla, asegúrese 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 página

89


90

CAPÍTULO 5 OTROS RECURSOS EN LA GUARDAMUEBLES


El capítulo anterior presentó fuentes de datos que son necesarios para crear cualquier informe. Pero también el repositorio tiendas a otros recursos que son necesarios para los informes. En este capítulo se entra en detalles sobre cómo 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 administración de JasperReports Server, dependiendo de cómo los usuarios finales crear y consumir informes.

• Si tiene usuarios que son competentes en la creación 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 técnico usuarios. Administradores todavía tienen que definir todos los recursos para los informes que solicitan sus usuarios.

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

•


• • • • • • •

5.1 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 múltiples JasperReports. Ver las consultas de ejemplo en la carpeta / Supermart Demo / Común en el repositorio. La reutilización de una consulta le permite adaptar los informes a los diferentes públicos. 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 reutilización de un simplifica la consulta mantenimiento de los informes, así, ya que todos los informes devuelven los mismos datos. Además, la separación de la consulta de la

91


JRXML hace que sea más fácil de mantener un gran número de informes cuando se cambia la fuente de los datos y las necesidades de consulta ser actualizado. Consulte la Guía del usuario del servidor JasperReports para obtener instrucciones completas sobre cómo usar informes JRXML. Por otro medio de adaptar los informes a diferentes audiencias, consulte el capítulo de Dominios en ese manual. Recursos de consulta también se pueden utilizar para rellenar los controles de lista de entrada, como se describe en "Los controles de entrada basados en consultas" en la página 99 y "Cascading Controles de entrada" en la página 105.

Para crear un recurso de consulta reutilizable: 1. sesión como administrador.

2.

3.

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.

Haga clic derecho en la carpeta y seleccione Agregar recurso> Consulta en el menú contextual.

Aparece la página Agregar consulta.

Figura 5-1 Agregar consulta - Nombre de la página de consulta

4. Introduzca un nombre y una descripción opcional para la consulta y haga clic en Siguiente. El identificador de recurso se rellena automáticamente. El enlace aparece una página de origen de datos.

92


Figura 5-2 Añadir Consulta - Link a Página de orígenes 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.

•

Después de hacer clic A continuación, Definir el que aparezca la página de consultas.

Figura 5-3 Agregar consulta - Definir la página de consulta

6. 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 sólo para compatibilidad con versiones anteriores y no se debe elegir para el nuevo de Dominio consultas basadas.

7. 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 más (como EJBQL, xPath y MDX). Sin embargo, JasperReports Server se admite consultas en lenguajes de consulta adicionales si hay una consulta configurado correctamente- aplicación albacea para cada idioma adicional cuando se despliega el servidor.

Una fuente de datos de frijol especializado puede ser utilizado para soportar múltiples lenguajes de consulta. Para obtener información acerca de frijol fuentes de datos, se refieren a "Fuentes de datos de frijol" en la página 88. Otra opción es añadir 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 extensión 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 numérico valor. El tipo de datos determina qué usuarios pueden introducir en el campo de texto para que se corresponda con el tipo de la parámetro en el informe. Además, el tipo de datos puede restringir el valor, por ejemplo el establecimiento de un rango para un número o la fecha, o la aplicación de un patrón, como una dirección de correo electrónico en las cadenas. Todo esto se controla a través del tipo de datos asociado con el control de entrada. Los tipos de datos pueden representar uno de cuatro tipos: • • • •

Texto Número Fecha Fecha / hora

Para crear un recurso de tipo de datos: 1. Inicie sesión como administrador.

2.

3.

Haga clic en Ver> Repositorio y ampliar el árbol de carpetas para localizar la carpeta en la que desea crear la tipo de datos. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.

Haga clic derecho en la carpeta y seleccione Agregar recurso> tipo de datos en el menú contextual.

Aparece la página Agregar tipo de datos.

94


Figura 5-4 Añadir Datatype Página

4.

5.

Escriba un nombre y una descripción opcional para el tipo de datos. El identificador de recurso se rellena automáticamente. Seleccionar el tipo de el tipo de datos, así como información relacionada con el tipo.

En este ejemplo, seleccione Texto como el tipo de nuestro tipo de datos; usted tiene otras opciones también: • Texto - Para los tipos de datos de texto, se puede especificar una expresión regular en el Patrón campo. La expresión

es utilizado para validar el texto que el usuario envía. Por ejemplo, puede introducir una expresión que pone a prueba para direcciones de correo electrónico. Número - Con los tipos de datos numéricos, se puede controlar el rango de valores aceptables especificando los valores mínimo y máximo, y si los valores especificados son ellos mismos aceptable (mínimo es estricta / máxima es de estricta casillas de verificación). Si un Estricto casilla de verificación está seleccionada, el valor especificado es no aceptable.

Por ejemplo, para un campo por ciento, es posible especificar un mínimo de 0y un máximo de 100. Si lo hace No quieren aceptar el 0 por ciento, que le echa Mínimo es estricta. Si desea aceptar el 100 por ciento, usted desea borrar Máximo es estricta.

• Fecha y Fecha / Hora - Para estos tipos de datos, hay un widget de calendario en el que se puede seleccionar el valores mínimos y máximos 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.

•

6.

En este ejemplo se crea un tipo de datos muy básicos para cualquier tipo de entrada de texto.

5.3 Listas de valores

Lista de valores son los recursos que definen una lista estática de valores para los controles de entrada de selección única o de selección múltiple. Para cada selección 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 más de estas etiquetas como botones de radio, casillas de verificación, o listas desplegables.

95


Para crear una lista de valores de recursos: 1. Inicie sesión como administrador.

2.

3.

Haga clic en Ver> Repositorio y ampliar el árbol de carpetas para localizar la carpeta en la que desea crear la lista de valores. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.

Haga clic derecho en la carpeta y seleccione Añadir recursos> Lista de valores en el menú contextual.

Aparece la página Agregar lista de valores.

Figura 5-5 Añadir Lista de valores Página

4.

5.

Escriba un nombre y una descripción opcional para el tipo de datos. El identificador de recurso se rellena automáticamente. Introduzca el nombre y el valor de cada elemento de la lista y haga clic en Añadir. El nombre y el valor son a la vez tratan como cadenas. Los usuarios sólo ven la etiqueta en un control de entrada que utiliza el lista, y el informe sólo recibe el valor. Para eliminar un elemento, haga clic en Eliminar al lado de su valor.

6. Cuando haya definido todos los valores de la lista, haga clic en Enviar. La lista de valores de recursos aparece en el repositorio.

5.4 Controles de entrada

Cualquier JasperReport se puede parametrizar de manera que su salida generada es una función de los valores dado en tiempo de ejecución (filtros de consulta), más o menos que su trazado se cambia para adaptarse a diferentes usuarios (tales como el cambio del título). Al escribir JRXML, se puede declarar parámetros y dar cabida a cualquier valor de tiempo de ejecución que necesita ser superado en el ejecutor de consultas, el motor de renderizado, o el motor de cálculo. Sin embargo, la información de parámetros en un archivo JRXML no proporciona todo JasperReports Server necesita para construir una interfaz de usuario completa y solicitan a los usuarios los valores. También 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 selección única o múltiple de selección, y el widget para mostrar los valores posibles, por ejemplo, en la lista desplegable o casillas de verificación. Se requiere opciones de visualización, como etiquetas y si el valor. El nombre del parámetro correspondiente en el JRXML.

96


Cuando un usuario ejecuta el informe, el servidor utiliza la información 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 parámetros en JRXML del informe. El control de entrada también determina el tipo de control que el usuario interactúa con: • Boolean - Representada como una casilla de verificación. Estos controles de entrada devuelven un java.lang.Boolean oponerse

a la reportar el motor en respuesta a la selección 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 numérico, 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 selección única devuelve un solo valor. Selección múltiple - Representada como una lista de valores (desplazables) o un conjunto de casillas de verificación. A la entrada de selección múltiple el control devuelve una colección de valores.

•

•

•

Una característica avanzada de los controles de entrada de selección única o de selección múltiple es que los valores que se presentan pueden ser el resultado de una consulta dinámica. La consulta recupera los valores reales de la fuente de datos antes de presentarlos como opciones para el usuario. Estas consultas pueden contenerse parámetros, por ejemplo basados en el usuario que ha iniciado sesión en o la selección de un control de entrada anterior. Los parámetros de consulta se describen en el último servidor JasperReports Guía. Los controles de entrada se basan en otros recursos en el repositorio, como tipos de datos, listas estáticas de valores, o consultas. Usted puede gestionar estos recursos de la misma manera a manejar otros recursos; puede definir localmente (disponible sólo para el control de entrada) o hacer referencia a ellos externamente (la reutilización de un recurso en el repositorio). Para obtener más información, consulte "Recursos Locales y referencias externas" en la página 47.

Ad Hoc vistas basan en Dominios y Temas de dominio siempre utilizan los controles de entrada definidos localmente que son creado automáticamente en función de los filtros elegidos. Ellos no pueden hacer referencia a controles de entrada almacenados en la repositorio, y no se debe modificar. Para obtener más información, consulte la JasperReports usuario del servidor Guía.

Algunos controles de entrada se basan en consultas para poblar sus opciones. Estos controles más complejos se describen en "Los controles de entrada basados en consultas" en la página 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 parámetro en el control de entrada debe coincidir con el nombre del parámetro en el informe. No

error se produce si hay una falta de coincidencia en los nombres, pero en tiempo de ejecución, NULL se pasa como el valor de la parámetro en lugar de los valores reales. El control de entrada y su parámetro 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 excepción.

•

En esta sección se explica cómo crear un recurso de control de entrada en el repositorio. Para hacer referencia a controles de entrada en una JasperReport, ver la Guía del usuario de JasperReports Server.

Para crear un recurso de control de entrada: 1. Inicie sesión como administrador.

97


2.

3.

Haga clic en Ver> Repositorio y ampliar el árbol de carpetas para localizar la carpeta en la que desea crear la control de entrada. Si ha instalado los datos de ejemplo, la carpeta sugerida es Tipos de datos de entrada.

Haga clic derecho en la carpeta y seleccione Agregar recurso> Control de entrada en el menú contextual.

Aparece la página Agregar control de entrada.

Figura 5-6 Agregar control de entrada Page

4.

5.

6.

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 cómo utilizar el control.

Para este ejemplo, utilice el símbolo Seleccione el texto para el título del informe.

En la práctica, el texto del mensaje suele ser el mismo que el parámetro, por lo que el nombre del parámetro es automáticamente llenado en el texto del mensaje. Si ha utilizado un indicador diferente, seleccione el nombre automático y reemplazarlo withe el nombre exacto del parámetro asociado con el control. Recuerde, el nombre del parámetro debe ser el igual que en los informes que utilizan este control de entrada.

Para este ejemplo, el nombre del parámetro es título. La descripción es opcional.

7. Seleccione las opciones para el control.

En este ejemplo, seleccione Obligatorio y Visible; usted tiene otras opciones también:

•Obligatorio - Obliga al usuario final para proporcionar un valor. •Sólo lectura - Muestra el valor del parámetro sin permitir que el usuario final para modificarlo. •Visible - Hace que el control de entrada visible en el diálogo de opciones de informe. Haga clic en Siguiente.

Las páginas subsiguientes dependen del tipo de control de entrada que eligió anteriormente: • • •

Tipos de Boole no requieren más información. Los de una valor requieren un recurso de tipo de datos para caracterizar lo que el usuario puede introducir. Tipos de selección única y de selección múltiple basados en listas estáticas requieren una lista de los valores de los recursos.

8.

98


9. •Tipos de selección única y de selección múltiple basados en consultas requieren un recurso de consulta. En este ejemplo de un solo valor, aparece la página Ubicar tipo de datos. Elija la opción de seleccionar un tipo de datos de el repositorio y haga clic en Examinar. Desde el diálogo 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 página 94.

Si usted elige para definir un tipo de datos, el asistente le guiará a través del mismo procedimiento que en el sección "Tipos de datos" en la página 94. A continuación, 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 también 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 dinámico 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 estática de valores, realizan un consulta para recuperar una lista de valores. Por ejemplo, un informe podría tener un parámetro de la ciudad, y la entrada basado en consultas control podría mostrar la lista de ciudades que existen en los datos. Debido a que las consultas utilizan la sintaxis estándar, puede incluir filtros en una cláusula WHERE. En el ejemplo anterior, podría limitar la lista de ciudades en cierta país.

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. 1.

2.

3.

Inicie la sesión como administrador.

Explorar el repositorio y seleccione la carpeta donde desea crear el control de entrada basado en consultas.

Haga clic derecho en la carpeta y seleccione Agregar recurso> Control de entrada. Aparecerá el cuadro de diálogo Agregar control de entrada:

99


Figura 5-8 Adición de un control de entrada - Nombrando

4. Seleccione el tipo de control de entrada basado en consultas de la lista desplegable Tipo. Esta elección determina cómo el control de entrada muestra a los usuarios, ya sea en forma de lista desplegable, un conjunto de botones de radio, una lista de selección múltiple, o un conjunto de casillas de verificación. En este ejemplo, elegimos una selección única de control de entrada basado en consultas. Especifique el texto del mensaje, nombre de parámetro, descripción opcional y opciones de apariencia de la misma manera como en la definición de un control de entrada regular. Haga clic en Siguiente. Debido a que hemos seleccionado uno de los tipos basados en consultas, aparece la página Ubicar Consulta:

5.

6.

Figura 5-9 Adición de un control de entrada - Localización de la consulta

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.

7. Haga clic en Siguiente para definir la consulta de recursos local. Aparecerá el cuadro de diálogo de nombres consulta:

100


Figura 5-10 Adición de un control de entrada - Nombrar la consulta

Aunque el recurso de consulta no es visible en el repositorio, todavía puede tener un nombre, ID y opcional Descripción 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 automáticamente. Luego haga clic en Siguiente. Aparece la página de enlace de la fuente de datos:

Figura 5-11 Adición de un control de entrada - Vinculación a un origen de datos

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 selección por defecto de no vincular a una fuente de datos.

9. Haga clic en Siguiente. Aparecerá la página de definición de la consulta:

101


Figura 5-12 Adición de un control de entrada - Definición de la consulta

10. Seleccione el lenguaje de consulta, en este ejemplo de SQL, e introduzca una cadena de consulta. La instrucción 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, país, estado y ciudad, y el campo de país se utiliza para limitar los valores a un solo país. La cláusula ORDER BY se asegura de que los valores de la consulta se ordenan alfabéticamente 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 página 104.

11 Haga clic en Guardar para completar la definición de consulta. Aparece la página de valores de parámetros:

Figura 5-13 Adición de un control de entrada - Configuración de los valores de los parámetros

En la página de valores de los parámetros, se define qué campo en los resultados de la consulta se muestran, y que campo contiene valores que se convierten en el valor del parámetro cuando elegido.

a. 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 parámetro correspondiente en el informe.

102


b. A continuación, especifique las columnas visibles, que son los campos cuyos valores aparecen en el control de entrada que el usuario elige entre. En el caso más simple, introduzca mismo campo que la columna de valor. Si agrega múltiples 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

Sólo 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 visualización también puede ser totalmente diferente, por ejemplo, mostrar el nombre completo de un representante de ventas, pero el uso de la identificación de empleado como el valor devuelto por el control de entrada. El único restricción es que todos los campos que se utilizan en la lista de valores o exhibición deben ser seleccionados por la consulta.

5.5.2 Parámetros incorporadas para controles de entrada basados en consultas

El LoggedInUser y LoggedInUserName parámetros están 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 parámetros estándar son También establecía que los informes si se definen como parámetros en la JRXML. Tabla 5-1 Parámetros incorporadas para controles de entrada basados en consultas

Nombre del parámetro

LoggedInUser

Tipo

Usuario

Notas

El usuario que ha iniciado sesión. Este parámetro no está disponible en controles de entrada de consulta, pero se utiliza como un parámetro en el informe.

El nombre de usuario del usuario actual.

El nombre completo del usuario actual.

La dirección de correo electrónico del usuario actual.

LoggedInUserName

LoggedInUserFullName

LoggedInUserEmail Dirección

LoggedInUserEnabled

LoggedInUserExternally Definido

LoggedInUserTenantId

Cadena

Cadena

Cadena

Boolean

Boolean

Indica si el usuario actual está habilitada.

Indica si el usuario actual está autenticado externamente.

En las ediciones comerciales, el nombre de la organización del usuario actual.

Las funciones asignadas al usuario actual. Esto es útil para parámetros que utilizan $ X.

Cadena

LoggedInUserRoles Colección <String>

103


Nombre del parámetro

LoggedInUserAttributes

Tipo

Mapa <String, String>

Notas

Los atributos de perfil del usuario conectado. Este parámetro no es utilizable en los controles de entrada de consulta, pero es utilizado como un parámetro para el informe. Si el usuario no tiene atributos, el parámetro es un mapa vacío.

Los nombres de los atributos del perfil del usuario conectado. Esto es útil para los parámetros que utilizan $ X. Si el usuario tiene sin atributos, el parámetro es un mapa vacío.

Los valores de los atributos del perfil del usuario conectado. Esto es útil para los parámetros que utilizan $ X. Si el usuario tiene sin atributos, el parámetro es un mapa vacío.

Para el usuario que ha iniciado sesión en, el valor del atributo a juego el nombre pasa como <Atributo-name> (Como ATT1). Si no hay ninguna coincidencia, el parámetro está vacía.

Este parámetro sólo está disponible si se ha definido en una consulta o como un parámetro de informe.

LoggedInUserAttribute Nombres

Colección <String>

LoggedInUserAttribute Valores

Colección <String>

LoggedInUserAttribute_ <Atributo-name>

Cadena

5.5.3 Las consultas basadas en el dominio

En el caso de informes que utilice un dominio como origen de datos (opción disponible en la edición 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 página 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 sólo 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 diseño 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 artículo 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, Utilizaría 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 parámetro para el informe. A veces, es posible que desee el control de entrada para mostrar más información de la que el valor real devuelto. Al igual que con controles de entrada estándar 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 ambigüedades, puede incluir el estado y el país en su pantalla. En ese caso, la consulta basado en el dominio también debe recuperar esos artículos:

<Consulta> <QueryFields> <QUERYFIELD id = "expense_join_store.ej_store_store_city" /> <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 país de los controles de entrada" en la página 109, deberá añadir 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 añade automáticamente):

EE.UU. EE.UU. EE.UU. EE.UU.

| | | |

CA | Los Angeles CA | San Francisco OR | Portland WA | Redmond

Por último, la consulta basado en el dominio también tiene la opción de filtrar los resultados de la consulta, como se muestra en la siguiente ejemplo:

<Consulta> <QueryFields> <QUERYFIELD id = "expense_join_store.ej_store_store_city" /> <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 expresión Domel (Expresión de dominio de idiomas) que las referencias la ID completa de los campos, incluyendo cualquier ID de conjuntos. Para obtener más información acerca de Domel, consulte la JasperReports Guía del usuario de Server. El <QueryFilterString> etiqueta en una consulta de dominio es equivalente a la cláusula 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 selección realizada en un control de entrada anterior. Controles de entrada en cascada se crean mediante el uso de parámetros en la cadena de consulta de un control de entrada relacionada. En otra palabras, el parámetro 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 todavía puede generar una lista de cientos de ciudades para recorrer. A pesar de que cada ciudad es fácil de se identifica con el Estado, el desplazamiento a través 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 alfabético 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 parámetro para el informe.

El usuario realiza dos selecciones de las listas más cortas, lo que es más fácil y más rápido que usando una larga lista de municipales y estatales nombres. El segundo control de entrada está vacío, mostrando ninguna selección, 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 número especialmente grande de las ciudades, más controles de entrada en cascada podrían ser utilizado para reducir la lista, como región o estado. Se cargan los valores para cada control sólo cuando el anterior de entrada se ha seleccionado, para hacer una experiencia de usuario cómoda y rápida. Los valores de los parámetros determinados por cada control de entrada en cascada pueden o no se pueden utilizar en el informe. Para ejemplo, si el informe sólo muestra los datos acerca de una ciudad, el control de entrada país sólo existe para acelerar la elección de la ciudad. Sin embargo, si el informe también muestra información como promedio de la ciudad en comparación con el promedio de los países de dado medida, el parámetro de país también se utiliza en el informe.

5.6.1 Los parámetros en las consultas de control de entrada

La sustitución de parámetros 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 sustitución de parámetros, y $ P $ P! y los parámetros de $ X (para las consultas SQL) son apoyado. La notación $ X tiene dos formas principales explican en la lista siguiente: • $ P {parameter_name}

El valor del parámetro se sustituye en la consulta. En los casos en que el parámetro contiene una cadena, los mecanismos de sustitución inserta los caracteres propios de escape para crear SQL válida. Use esto para con una sola seleccionar los controles de entrada y operadores de comparación 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 parámetro puede ser nulo, y campo = NULL no es de SQL válida. En lugar de utilizar $ {X IGUAL, ...}, como se explica a continuación.

• $ P {parameter_name}

El valor del parámetro se trata como texto sin formato. El servidor sustituye el parámetro con el valor de la control de entrada sin realizar la comprobación 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 verificación de la igualdad y maneja el caso en que el valor del parámetro es nulo. Utilice esta todas partes en lugar de la antigua columna = $ P {parameter_name} sintaxis. El $ {X IGUAL ...} sintaxis realiza la siguiente sustitución antes de presentar la consulta:

columna = valor_parámetro - cuando valor_parámetro no es nulo

columna es NULL - cuando valor_parámetro es NULL

106


• $ X {IN, columna, parameter_name} o $ {X NO EN, columna, parameter_name}

Utilice este parámetro para conectar en cascada con una selección múltiple de controles de entrada. Los $ X {EN} ... operador es cierto cuando el valor del campo coincide con uno cualquiera de los múltiples valores del control de entrada. En el ejemplo de los países / ciudades, nos puede permitir al usuario elegir cualquier número de países, y mostrar todas las ciudades en los países seleccionados. El control de entrada basado en consultas tendría la siguiente consulta:

seleccione la ciudad de CUENTAS donde $ {X IN, país, países}

Si el usuario selecciona los valores de Canadá, México y Estados Unidos en la selección múltiple de control de entrada PAÍSES, la $ X {} sintaxis se traduce en la siguiente consulta para el control de entrada CIUDADES:

seleccione la ciudad desde donde CUENTAS país IN ('EE.UU.', 'Canada', 'México')

Al definir estos parámetros en un informe, no utilice un defaultValueExpression elemento. Debido a una limitación en JasperReports Server, estos parámetros son nulos cuando una defaultValueExpression es proporcionado.

La sintaxis $ X también es compatible con los siguientes operadores. Todos ellos están diseñados para manejar la entrada nula mediante la generación 0 = 0 cuando el valor del parámetro es nulo:

Sintaxis Parámetro

$ {X MAYOR, columna, parámetro}

$ X {[MAYOR, columna, parámetro}

$ {X MENOS, columna, parámetro}

$ {X MENOS], columna, parámetro}

$ X {ENTRE, columna, start_param, end_param}

$ X {ENTRE], columna, start_param, end_param}

$ X {[ENTRE, columna, start_param, end_param}

$ X {[ENTRE], columna, start_param, end_param}

Significado

columna> parámetro

columna> = parámetro

columna <parámetro

columna <= parámetro

start_param <column <param final

start_param <column <= parámetro final

start_param <= columna <param final

start_param <= columna <= parámetro final

Para obtener más información sobre el uso de $ P $ P! y $ X para construir consultas dinámicas, consulte la JasperReports último Guía y el Ultimate Guide iReport. El número de parámetros que se pueden utilizar en una consulta es arbitraria, al igual que el número de controles de entrada que pueden definirse en un JasperReport es arbitraria. Además de los parámetros de control de entrada estándar, una entrada en cascada consulta de control puede utilizar los parámetros integrados descritos en "Parámetros integradas para entrada basados en consultas Controles "en la página 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 país 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 parámetro denominado CITY y la consulta siguiente informe:

select * from cuentas donde $ {X IGUAL, billing_address_city, CIUDAD}

En la banda de detalle, añadimos 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 Añadir> Control de entrada. Este control de entrada muestra la lista de países en los que cuentas están 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 PAÍS (el nombre para mostrar puede ser "País"). Establezca la entrada Tipo de control de Soltero consulta de selección. 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 PAÍS

La consulta es una consulta simple para seleccionar los países. 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 país, está ahora listo.

Figura 5-16 El control de entrada PAÍS

Ahora que tenemos un país de control de entrada con nombre, podemos hacer referencia al parámetro PAÍS 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 definición es también un Individual Seleccione Queryof Tipo SQL. La consulta para CITY utiliza un $ {X IGUAL, ..., PAÍS} parámetro en su donde condición:

109


seleccionar distintos shipping_address_city de CUENTAS donde $ {X IGUAL, shipping_address_country, PAÍS} 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 diálogo 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 país.

Figura 5-17 en cascada Control de entrada Mostrando País 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 capítulo, los recursos de archivos son creados por los administradores para que puedan ser referenciados por Jasper Reports. Servidor JasperReports soporta los siguientes archivos: Tabla 5-2 Tipos de recursos de archivos

Tipo de Archivo

CSS

Fuente

Descripción

Cascading Style Sheet archivo que ayuda a definir la interfaz de usuario como parte de un tema.

Fuente True Type (TTF) Archivo de ampliar el conjunto de fuentes disponibles en un informe y permitir la incrustación de fuentes en el PDF de salida, si es necesario (ver "Fuentes" en la página 111).

Cualquier formato de imagen con el apoyo de la JVM (Java Virtual Machine), tales como JPEG, GIF y PNG. Las imágenes pueden ser referenciados en JasperReports, y también en los archivos CSS.

Las bibliotecas que proporcionan funcionalidad para sus informes (ver "JAR Files" en la página 111)

La definición de un informe en un lenguaje de definición de informe basado en XML JasperReports '. Un archivo JRXML se puede cargar por separado para su uso en múltiples JasperReports.

Imagen

JAR

JRXML

110


Tipo de Archivo

OLAP esquema

Paquete de Recursos

Descripción

Define los datos en un cubo OLAP, incluyendo cómo agregar las dimensiones.

Un archivo .properties Java que contiene pares de valores clave para la localización de los informes (ver "Recursos Bundles" en la página 111)

Un archivo JRTX contiene una plantilla de estilo que se puede compartir entre JasperReports.

Archivo XML utilizado en Dominios y análisis para definir la seguridad a nivel de datos.

Plantilla de estilo

XML

La forma en que las fuentes, los archivos JAR y paquetes de recursos se asocian con los informes se explica con más 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 píxel perfecto. El servidor puede usar cualquier fuente que están disponibles para su JVM como lógica o fuentes físicas. Esta solución 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 ejecución. Una forma de asegurarse de que el servidor tiene la fuente correcta es subirlo al repositorio la creación de un recurso de archivo. A continuación, el informe puede referirse a URI de la fuente en el repositorio. Para obtener más información acerca de cómo trabajar con las fuentes y exportación de PDF, consulte la documentación 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 código utilizando expresiones JRXML. Esto proporciona una gran flexibilidad para la incorporación de la lógica de negocio u otra utilidad código en la generación de informes. En algunos casos, usted puede hacer que el código de terceros disponibles para el proceso de generación de informe mediante la adición de la librerías necesarias para la aplicación classpath del servidor cuando se despliega. En otros casos, subir el tercer partido o archivos JAR adicionales al repositorio mediante la creación de un recurso de archivo. A continuación, el informe se puede consultar el código 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 específico de la localidad. Si subes dichos paquetes de recursos mediante la creación 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 extensión. Por ejemplo, el paquete de recursos predeterminado podría llamarse MyReport.properties, y su francés MyReport_fr.properties traducción. Para obtener más información acerca de paquetes de recursos para los informes, consulte la Guía del usuario de JasperReports Server.

111


5.7.4 Creación de un archivo de recursos

Los administradores deben organizar los recursos de archivos en carpetas en el repositorio para que sean más fáciles de encontrar cuando creación de referencias.

Para agregar un recurso de archivo: 1. Inicie la sesión como administrador.

2.

3.

Seleccione Ver> Repositorio y busque la carpeta principal del nuevo recurso en el panel de carpetas del lado izquierdo.

En el panel de carpetas, haga clic en la carpeta principal y seleccione Agregar recurso> Archivo en el menú contextual, a continuación, seleccione el tipo de recurso que añadir. En este ejemplo, seleccione Añadir Recursos> Archivo> Fuente. El Add File Aparece el diálogo. Ingrese la información requerida para el recurso de archivo. En adición al nombre y la ID, sólo 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 diálogo 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 Adición de un recurso del archivo

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 confirmación de la adición también aparece en la parte superior de la página.

5.7.5 Edición de un archivo de recursos

El siguiente ejemplo muestra cómo editar un recurso de archivo.

Para editar un recurso de archivo: 1. Inicie sesión como administrador.

2. En el repositorio, navegar o buscar el recurso.

112


3. Haga clic con el recurso y seleccione Editar en el menú contextual. El cuadro de diálogo Editar archivo aparece como el Cuadro de diálogo Agregar archivo a excepción de algunas propiedades que no se pueden cambiar. En este ejemplo, editamos la fuente recurso creado en "Creación de un archivo de recursos" en la página 112.

Figura 5-19 Edición de un archivo de recursos

4. Utilice el cuadro de diálogo Editar para ver o modificar la definición de los recursos y sus valores. En la figura anterior, se puede ver cómo se cambió el campo Descripción. También puede cambiar el contenido del recurso de archivo por especificando otro archivo que desea cargar. El campo Vía 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. 5.

113


114

CAPÍTULO 6 TEMAS


Temas en JasperReports Server son un mecanismo para definir y personalizar la interfaz de usuario (UI) a través de Hojas de Estilo en Cascada (CSS), el estándar web para definir el aspecto del contenido HTML. Un tema es la conjunto de todos los archivos CSS e imágenes asociadas que definen la apariencia de la interfaz de usuario. Los temas se guardan como presentar los recursos en carpetas en el repositorio, con menús especiales en carpetas temáticas para la activación, cargando, y la descarga de un tema. Puede almacenar cualquier número de temas en el repositorio, y los administradores pueden cambiar entre ellos, proporcionando una manera fácil y rápida 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 organización, o se basan en la herencia del tema a usar el mismo tema en todas partes sin necesidad de configurarlo explícitamente. El mecanismo de herencia también es compatible con una mezcla de ajustes explícitos y heredados, para que pueda prevalecerá sobre los ajustes o la imagen de una organización local, pero heredarán 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 actualización con el fin de trabajar con el nuevo conjunto de archivos. Para obtener más información, consulte los procedimientos de actualización de la JasperReports Servidor Guía de instalación.


• • • • •

Introducción a los Temas ¿Cómo funcionan los temas Administrar Temas Crear Temas Trabajar con archivos CSS

6.1 Introducción 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 fácilmente 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 código HTML, sí definen y generan a partir de JSP (JavaServer Pages) y JavaScript. Un tema es una colección de archivos CSS e imágenes asociadas que especifican la apariencia de la totalidad o parte del usuario interfaz. Un tema sólo controla cómo se muestra la interfaz, por ejemplo, fuentes, colores, espacios, líneas, y la imagen elementos de la interfaz de usuario. No controla lo que parece, como el contenido de los menús o el efecto de hacer clic en un botón.

Los temas se definen a nivel mundial en la raíz del repositorio y de forma individual en cada organización. Cada usuario de un determinado organización ve el mismo tema, pero diferentes organizaciones puede tener sus propios temas. Sólo los administradores puede establecer el tema. Los administradores pueden añadir, cargar, editar, copiar y borrar los archivos que componen el tema, sólo al igual que otros recursos en el repositorio. El repositorio ofrece acciones especiales en carpetas temáticas para descargar y subir temas como ZIP (archivo comprimido) archivos, y para activar el tema.

Los temas se integran completamente con la arquitectura multi-organización en JasperReports Server. Algunos características de los temas tratados en este capítulo se aplican sólo a las implementaciones que tienen licencia para utilizar múltiples organizaciones. Sin embargo, las implementaciones de una sola organización utilizan la misma arquitectura, por ejemplo, hay son las anulaciones y herencia entre los temas de la organización predeterminada única y la raíz del sistema.

El mecanismo de los temas es jerárquica y muy flexible, lo que permite a los administradores cambiar fácilmente el mundial apariencia o establecidos anulaciones específicos de la organización. Por ejemplo, todos los siguientes escenarios son posibles con el mecanismo temas:

Escenario

Utilice el tema por defecto sin cambios.

Descripción

La interfaz de usuario ha sido actualizada por razones de claridad y espacio. Después de un instalación estándar, el tema por defecto se establece en el nivel de la raíz y es heredado automáticamente 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.

Puede especificar las anulaciones de reglas CSS individuales o sustituir las imágenes en la tema del sistema. Es fácil crear o subir los archivos nuevos y activar su personalizaciones. El mecanismo de herencia asegura que cada organización utiliza este nuevo tema y se actualiza en tiempo real cuando se modificarlo.

Con una experiencia de CSS o Jaspersoft Servicios Profesionales, puede cambiar todo el aspecto y la sensación del servidor. La interfaz de usuario del servidor puede ser adaptado a coincidir o mezclarse con casi cualquier otro diseño web. La herencia mecanismo asegura una vez más que cada organización utiliza el nuevo tema, mientras que le permite manejar la interfaz de un único conjunto de archivos.

Usted puede dar a cada organización o suborganización una personalización de la tema predeterminado, por ejemplo, un nuevo logotipo, manteniendo todos los demás aspectos de la el tema del sistema. El beneficio de este enfoque es que el tema del sistema aún se puede modificar y heredado por todas las organizaciones, al tiempo que conserva las anulaciones a nivel de organización.

Este enfoque se puede combinar con la anterior, de modo que anula se aplican a la tema personalizado.

Modificar rápidamente el tema por defecto.

Crear un tema totalmente nuevo.

Anulación de temas para personalizar el Interfaz de usuario para todas las organizaciones.

116

Capítulo 6 Temas

Escenario

Crear un nuevo tema en cada organización.

Descripción

Para los proveedores de SaaS, cada organización puede ser un cliente diferente, que necesita una interfaz especial. El mecanismo de temas permite a cada organización totalmente definir la interfaz de usuario y aún conservan la manivela y la herencia de su suborganizaciones propios. En tales implementaciones, cada administrador organización 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 simultánea: • •

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 después de la activación de los archivos del tema. Sin embargo, a través 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 más. El resto de la interfaz se hereda del tema por defecto o algún tema personalizado. Sin embargo, decimos que MyLogo es el tema activo, y cada usuario de la misma organización ve el tema MyLogo.

6.2 ¿Cómo funcionan los temas

Los temas se guardan en una carpeta llamada Temas especiales que aparecen en la raíz del repositorio y en cada organización. Cada carpeta Themes contiene un tema por defecto que no puede ser editada y cualquier número de la costumbre carpetas temáticas. 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 raíz, el tema por defecto contiene la definición completa de todos los estilos que constituye el tema por defecto incluido en JasperReports Server. En la organización Temas, el valor predeterminado es un sistema tema generado que contiene todos los estilos heredados por la organización dada. Ninguna de las carpetas del tema por defecto pueden ser modificados, incluso por los administradores. En este capítulo se utiliza la siguiente terminología para distinguir entre los temas a nivel de la raíz y de nivel de organización. En la siguiente tabla, la carpeta principal de cualquier organización se llama Organización, y -tema activo es el nombre de la carpeta del tema que ha sido activado:

Nombre

Tema por defecto

Carpeta

root> Temas> por defecto

Descripción

La interfaz de usuario no modificada de JasperReports Server, tal como aparece en la primera instalación. El tema por defecto se define en la carpeta predeterminada en la carpeta Themes en la raíz del repositorio.

El tema activo establecido en el nivel raíz. Todos los usuarios de todas las organizaciones ver este tema a menos que haya un tema específico de la organización que es activado. El tema del sistema también se utiliza para la página de acceso. Cuando JasperReports Server se instala por primera vez, el tema por defecto es activa, por lo que también es el tema del sistema.

Tema Sistema root> Temas> -tema activo

117


Nombre

Heredado tema

Carpeta

Organización> Temas> default

Descripción

La combinación de todos los temas activos en las organizaciones de padres de un dada la organización, de acuerdo con las reglas de herencia. Para cualquier propuesta organización, el tema heredado por esa organización se almacena en la carpeta predeterminada de carpeta Temas de esa organización.

El tema que los usuarios de una organización determinada pueden ver, ya que un administrador ha hecho que sea activo en el nivel de organización o sistema. Los usuarios ven una combinación del tema activo y heredada, dependiendo de los archivos en el tema activo y las reglas de herencia.

Tema activo Organización> Temas> activo- tema

No puede modificar los archivos del tema por defecto a través del repositorio. Si intenta hacerlo por eludiendo el repositorio, sin darse cuenta, podría cambiar las reglas de tal manera que se convierte en la interfaz de usuario inutilizable. En esta situación, debe volver a instalar JasperReports Server para recuperarse.

La siguiente figura muestra el tema por defecto en la carpeta Themes en la raíz del repositorio. El nombre de la carpeta (y sus subcarpetas) están en negrita para indicar que es el tema activo.

Figura 6-1 El tema por defecto en la carpeta de temas de raíz

6.2.1 Archivos temático

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 imágenes. Además, el tema por defecto contiene el samples.css archivo que sólo es utilizado por el Ver > IU Muestras la página se describe en la sección "User Las muestras de interfaz "en la página 129. Los archivos overrides_ie7.css y overrides_ie8.css sólo se cargan con las hojas de estilo en el navegador del usuario es Internet Explorer 7 u 8, respectivamente.

118

Capítulo 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 actualización con el fin de trabajar con el nuevo conjunto de archivos. Para obtener más información, consulte la actualización procedimientos en el Guía de instalación del servidor JasperReports.

Las imágenes 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 también incluye el archivo favicon.ico que aparece en las pestañas del navegador. Hay aproximadamente 60 archivos de imagen en el tema por defecto. Las tiendas temáticas predeterminadas referenciados archivos de imagen en una carpeta llamada imágenes. En un tema personalizado, hay dos maneras de para cambiar una imagen del tema por defecto: • •

Utilice una carpeta de imágenes 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 imágenes, 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 podría referirse a "MisImágenes / miarchivo.png" si crea una carpeta MisImágenes nombrados en la carpeta del tema y subir su imágenes allí. En cualquier lugar en Internet. Siguiendo el estándar CSS, el CSS personalizado puede referirse a las imágenes, o cualquier ayudante presentar, con una dirección 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 múltiples 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 continuación. Para los usuarios de la edición profesional: 1.

2.

1.

2.

La carpeta del tema activo para la organización del usuario.

El tema heredado almacena en la carpeta con el nombre <organización> / Temas / default.

La carpeta del tema activo.

El tema heredado almacena en la carpeta llamada / Temas / default.

Para otros usuarios:

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 organización es el segundo tarea del mecanismo de herencia.

El servidor mantiene el tema heredado en cada organización 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 organización y hace una copia de los mismos en cada niño organización. Por niveles anidados de las organizaciones, el algoritmo se repite en cada nivel después de actualizar la copia de el tema heredado. De esta manera, los cambios se propagan hacia abajo a cada organización.

119


La propagación de los cambios a los temas heredados es computacionalmente intensivas y puede tomar varios momentos después de hacer un cambio a un tema. Sin embargo, la determinación de la herencia cuando se realizan cambios es una compensación efectiva para que los archivos CSS para representar la petición 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 estándar 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 más rápida 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 fácilmente cualquier número de reglas, y administrar a todos en un solo archivo. Por ejemplo, si desea aumentar el tamaño del texto en todos los botones en el tema por defecto, usted puede hacer esto 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 sólo tendrá que cambiar un número 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 sería si desea aumentar el tamaño de los propios botones en el tema predeterminado. Usted tendría que volver a escribir la mayoría de las reglas en el archivo buttons.css y crear imágenes para los nuevos botones. En este caso, es mucho más fácil copiar el archivo buttons.css que copiar docenas de reglas en el archivo overrides_custom.css. Aún se podía utilizar el archivo overrides_custom.css para ajustar el espaciamiento de los elementos alrededor de los botones, ya que habría menos de esas normas a modificar.

Jaspersoft recomienda utilizar el método de las anulaciones personalizados para la mayoría de los temas personalizados. Un tema personalizado cambia apariencias simples como colores, tipos de letra y espaciado tiene relativamente pocas reglas y es fácilmente manejable en un único archivo. Y muchos cambios se pueden hacer mediante la copia y modificación de archivos de imagen en el tema personalizado, sin necesidad de escribir ningún reglas CSS. Sólo si cambia el diseño fundamental o la apariencia de la interfaz de usuario, ¿Debería considerar la copia y modificación del otro archivo CSS. Copia y de los archivos CSS de modificación es más 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 reglamentación son accidentalmente borrado o modificado, incluso por un solo personaje, el tema podría no funcionar correctamente. Además, el reglas sin modificar en la copia de su archivo ahora anulan las actualizaciones realizadas en el mismo archivo en uno de los padres organización. 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 organización 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 todavía 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 mostraría 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 raíz del repositorio y cada organización tiene una carpeta Themes donde se almacenan los temas activos y heredados. En el navegador de repositorios, la

120

Capítulo 6 Temas

Temas de carpeta y carpetas temáticas individuales tienen acciones especiales para los administradores de manejarlos. Usted puede También utilice la búsqueda repositorio para encontrar los archivos CSS y de imagen. Las carpetas y acciones para el manejo de temas sólo son visibles para los administradores. La carpeta Themes tiene Execute- sólo 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 sección ofrece los procedimientos básicos para la administración de los temas existentes. Para crear carpetas temáticas y archivos, consulte "Creación de Temas" en la página 124. Para obtener información acerca de cómo trabajar con CSS en temas, consulte "Con Trabajo Archivos CSS "en la página 127.

6.3.1

1.

2.

3.

Ajustar el tema del sistema

Acceda a JasperReports Server como administrador del sistema (superusuario en la edición profesional; jasperadmin en otras ediciones).

Haga clic en Ver> Repositorio y expandir la carpeta Themes si es necesario.

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 Configuración de un tema del sistema

Tan pronto como se actualiza la pantalla, se ve el efecto del nuevo tema. Observe cómo el tema pods_summer cambia los colores y el logotipo en la interfaz de usuario con sólo el archivo overrides_custom.css e imágenes.

121


Figura 6-3 El Tema pods_summer Muestra

Debido a que el tema del sistema se establece en el nivel de la raíz, el nuevo tema aparece a todos los usuarios en todas las organizaciones, a menos que la organización tiene su propio tema. Además, el tema del sistema establecido aquí se aplica a la página de inicio de sesión, como se muestra en la siguiente figura.

Figura 6-4 La página de entrada según lo visto con el tema Nuevo Sistema

Los siguientes procedimientos se supone que el tema del sistema todavía se establece en el tema por defecto.

6.3.2

1.

Establecimiento de una Organización Temática

Los usuarios profesionales de edición pueden dar diferentes temas para sus organizaciones.

Acceda a JasperReports Server como administrador organización (jasperadmin).

122

Capítulo 6 Temas

En un servidor con licencia para utilizar varias organizaciones, especifique el ID de organización o alias en la página de inicio de sesión.

2. Haga clic en Ver> Repositorio y expandir la carpeta Themes si es necesario. Carpeta del tema de la organización es se muestra en la siguiente figura.

Figura 6-5 Organización Temas Visto por Organización administración

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 organización y es heredado por todos suborganizaciones, en su caso.

Los administradores de la organización pueden así personalizar la interfaz de usuario mediante la creación y activación de nuevos temas dentro de su organización.

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 sólo se aplica a los administradores de sistemas. Los administradores de organización no puede modificar el ROLE_ ADMINISTRADOR permiso, incluso en suborganizaciones. Deben solicitar que el administrador de sistema realice el procedimiento para ellos.

1.

2. 3.

4.

5. 6.

Acceda a JasperReports Server como administrador del sistema (superusuario o jasperadmin).

Haga clic en Ver> Repositorio. Los usuarios de la edición Comunidad puede saltar al paso 5. Expanda la carpeta Organizaciones. Busque el nombre de la organización en la que desea restringir el acceso a los temas y ampliar su carpeta.

Haga clic en el nombre de la carpeta Temas y seleccione Permisos. Cambie el permiso para que el ROLE_ADMINISTRATOR de Administrar a Sólo ejecución.

123


Figura 6-6 Restringir jasperadmin Acceso a la Organización Temas

Estableciendo Sólo ejecución de acceso, los administradores de la organización 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 diálogo de permisos permite. Usted inadvertidamente podría hacer que la interfaz de usuario inaccesible.

7.

8.

Para restringir el acceso a todas las organizaciones, repita paso 4 a el paso 6 para cada organización 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 organización y suborganización en el servidor. Para mayor información, consulte "La colocación de temas en la plantilla de carpeta" en la página 127.

6.4 Crear Temas

Hay tres formas de crear las carpetas y archivos que componen un tema:

• • •

Creación de carpetas temáticas 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 colocación de Temas en la plantilla de carpeta - Inicializar temas automáticamente en múltiples organizaciones despliegues.

En esta sección se explica solamente cómo almacenar archivos CSS en el repositorio. Para obtener información acerca de la creación de archivos CSS contenidos, ver "Trabajar con archivos CSS" en la página 127.

6.4.1 Creación de carpetas temáticas 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 menús de repositorio para crear carpetas temáticas. Los administradores del sistema pueden crear carpetas temáticas y archivos en el nivel de sistema o en cualquier organización. Los administradores de la organización pueden crear carpetas temáticas y archivos en su organización o cualquier suborganización.

124

Capítulo 6 Temas

Para crear carpetas temáticas y recursos de archivo: 1. Inicie sesión como un administrador con acceso a la ubicación en la que desea colocar el tema.

2.

3.

Haga clic en Ver> Repositorio y ampliar el árbol de carpetas para ver la carpeta Themes donde desea colocar el tema.

Haga clic derecho en la carpeta Temas y seleccione Agregar carpeta. Dale a tu carpeta un nombre y una descripción opcional como haría al crear cualquier carpeta. El nombre de la carpeta se utiliza como el nombre del tema.

Carpetas temáticas y los archivos se pueden crear, copiar o mover cualquier parte del repositorio, pero sólo pueden Esta entrada se activa, cargada o descargada cuando se coloca correctamente en una carpeta Temas.

4. Haga clic derecho en la nueva carpeta y seleccione Añadir Recursos> Archivo> CSS, y utilizar el diálogo 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 imágenes a su tema, crear todas las carpetas de imágenes y cargar archivos de imagen con Agregar recurso> Archivo > Imagen. Repita paso 4 y paso 5 para crear todos los archivos y las imágenes que usted necesita. Si varios temas utilizan los mismos archivos o imágenes, puede copiar y pegar los recursos de archivos o carpetas de imágenes 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 después de volver a cargar la página en su navegador.

5.

6.

7.

Interactuar con carpetas temáticas y archivos a través del repositorio es una manera conveniente y flexible para crear una tema. Sin embargo, este método tiene la limitación de que, al igual que otros recursos del repositorio, no se puede descargar los archivos o imágenes para editarlas. Para este propósito, el repositorio de descarga especial y proporciona subir acciones en carpetas temáticas.

6.4.2 Archivos Cargar Tema postal

El proceso de creación de un tema a menudo comienza con los archivos de un tema existente que modifique con CSS y editores de imágenes 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 número 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 sesión como un administrador con acceso al tema que desea descargar.

2.

3.

4.

5.


Haga clic derecho en la carpeta del tema que desea descargar y seleccione Descarga el Tema. Esta selección de menú aparece sólo en carpetas temáticas dentro de la carpeta Temas.

El servidor le pide que guarde el archivo con el nombre <tema-name> Zip. Guárdalo en cualquier lugar de su ordenador. Utilice una utilidad de archivo o la compresión para extraer los archivos del archivo ZIP y guardarlos en su ordenador.

Una vez que tenga los archivos de temas extraídos 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 raíz / Motivos (como superusuario). Guarde el archivo extraído en su equipo y crear el tema personalizado en otra carpeta, puede copiar y editar los archivos CSS y las imágenes del tema por defecto. Ver "Prioridad CSS Esquema y anulaciones personalizados "en la página 120 para una explicación de cómo 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 imágenes que constituyen su tema en una carpeta de su ordenador. 2. Utilice una utilidad de archivo o de compresión para crear un archivo ZIP estándar de los contenidos de su carpeta de

temas.

El archivo ZIP debe incluir sólo el contenido de su tema, no a la carpeta del tema en sí.

1.

2.

3.

Inicie sesión como un administrador con acceso a la ubicación en la que desea cargar el tema.


Haga clic derecho en la carpeta Temas y seleccione Subir un Tema.

Figura 6-7 Carga de un tema en una Organización

4. En el diálogo 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 diálogo de carga postal para sobrescribir un tema existente. Debe especificar un nombre del tema que todavía 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 imágenes en el archivo ZIP. Si tuviera subcarpetas en su tema, que se crean así. Después de subir el archivo ZIP tema, puede activarlo para ver efecto de su tema en la interfaz de usuario.

Creación 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 "Creación de carpetas temáticas y de recursos de archivo" en la página 124. De hecho, después de una carga inicial, es mucho más fácil de actualizar archivos individuales de esta manera que para crear el archivo ZIP y subirlo de nuevo.

126

Capítulo 6 Temas

6.4.3 La colocación 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 creación, nuevas organizaciones siempre heredan su tema de los padres organización, pero con un tema personalizado ya presente puede ahorrar tiempo al personalizar y activarlo para la nueva organización.

La plantilla de carpeta en cada organización contiene una carpeta Temas y una carpeta predeterminada vacía. No modificar la carpeta predeterminada vacío, 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 opción 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 organización matriz.

Si desea restringir el acceso a los temas en organizaciones creadas, también puede configurar los permisos en el Temas de la carpeta en la plantilla de carpeta. Para ello, siga el procedimiento en "Restricción del acceso a los temas" en la página 123.

6.5 Trabajar con archivos CSS

Esta sección no es un tutorial CSS sino más bien una colección de trucos y consejos para trabajar con el CSS que hace los temas en servidor JasperReports. Esta sección 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. Además, hay muchos editores diferentes para CSS y herramientas para probarlo, por lo que las recomendaciones de esta sección son sólo una manera de desarrollar un tema.

6.5.1 Tema Desarrollo Workflow

La elección importante para hacer la hora de desarrollar un tema es si utilizar las anulaciones temáticos simples o duplicar y modificar los archivos de tema, como se describe en la sección "CSS Esquema de prioridades y personalizada anulaciones "en la página 120. Por lo general, el alcance de las modificaciones determina qué método utilizar. Una vez que haya tomado esa determinación, usted está listo para crear su tema. Los principales pasos en un tema flujo de trabajo de desarrollo son los siguientes:

Paso

1. Descargar el tema por defecto para que tenga una copia de la los archivos y las reglas CSS que desea modificar.

2. Crea tus nuevas reglas CSS, archivos CSS y archivos de imagen.

Referencia

"Descarga e postal Carga Tema Files" en la página 125

"Firebug Plug-in para Firefox" en la página 128, una herramienta para ayudarle a crear reglas CSS

"Creación de carpetas temáticas y de recursos de archivo" en la página 124

"Plataforma de prueba" en la página 128 y "Usuario Las muestras de interfaz "en la página 129

3. Sube tus nuevos archivos a una plataforma de prueba, y activar el tema o colocarlos en un tema activo.

4. Verifique sus cambios dondequiera que se produzcan en la interfaz de usuario.

127


Paso

5. Repita paso 2 a través paso 4 para todos sus cambios hasta el tema está finalizado.

6. Despliegue su tema a sus usuarios.

Referencia

"Ajustar el tema del sistema" en la página 121 o "Configuración de una Organización Temática" en la página 122.

6.5.2 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 código HTML, JavaScript, y las reglas CSS de las páginas web a medida que navega. Tiene una interfaz dinámica que le permite seleccionar un elemento de la página web, y que muestra las reglas CSS específicas que aplicar al elemento. También le permite modificar esas reglas e inmediatamente ver el efecto en la página web. La herramienta Firebug es ideal para modificar temas en JasperReports Server. Una vez que encuentre las páginas 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 través 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 número de línea de la regla, de modo que usted puede encontrar fácilmente 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 fácilmente que la regla está activa y qué regla anula.

Para obtener más información 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 organización (si utilizando la edición 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 activación, y las reglas de pruebas de CSS, no debe desarrollar temas en un servidor de producción.

En el caso más simple, se puede desarrollar y probar sus temas antes de poner su servidor JasperReports en producción. Al probar su servidor durante el despliegue, puede desarrollar sus temas sin afectar usuarios reales.

Para implementaciones multi-organización que están en producción, puede probar en el servidor de producción, siempre y cuando se crea una organización de pruebas. La organización de pruebas hereda de la tema del sistema, la creación de una prueba muy realista entorno en el que se puede ver cómo su tema anula el tema heredado. Asegúrese de que su organización de pruebas refleja sus organizaciones reales, por ejemplo, que tienen vistas OLAP si sus organizaciones reales realizan OLAP análisis. Esto puede ayudarle a probar su tema con los elementos de la interfaz de usuario que sus usuarios de la organización ver más. Para las implementaciones de una sola organización que no tienen una licencia para crear organizaciones, usted puede probar sus temas en una segunda instalación del servidor. Por ejemplo, usted podría descargar la copia de evaluación de JasperReports Servidor e instalarlo en el mismo equipo en el que se desarrolla el tema. Esto le permite ver cómo su tema

128

Capítulo 6 Temas

aparece ya sea como un tema del sistema o en la organización por omisión. Al igual que en el caso de la organización del ensayo, prueba de su tema con todas las características de servidor, por ejemplo, el Ad Hoc Editor, Diseñador de paneles, controles de entrada en informes, programación, y similares. Cuando el tema es bien probado-y casi completo, usted debe probar en el servidor de producción. Cargue su tema a la carpeta Themes donde tiene la intención de implementar, pero no lo activa. Inicie sesión como un usuario de prueba y añadir el siguiente parámetro a cualquier URL, por ejemplo, la página principal de URL:

Y theme = <tema-name>

Esto activa el tema para el usuario de prueba en todas las páginas a las que accede hasta los tiempos de la sesión de usuario a cabo. Este le permite navegar toda la aplicación y ver el efecto de su tema en el entorno de producción, sin afectar a otros usuarios.

Para establecer el tema en el valor predeterminado añadir el parámetro & 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, también puede usar Firebug para mirar el Reglas CSS que están involucrados, aunque los errores no aparecen en Firefox.

6.5.4 Modificación de la presentación de Jaspersoft OLAP

Jaspersoft OLAP se basa en un módulo llamado JPivot para mostrar los datos al realizar el análisis OLAP. El JPivot módulo no utiliza todas las características del nuevo marco de interfaz de usuario, pero es compatible con algunas personalizaciones a través de temas. Por ejemplo, no utiliza paneles que se pueden ocultar, y las imágenes de los iconos no se almacenan en un tema. Sin embargo, algunas características de visualización de la tabla de análisis son controlados por el tema, mediante el uso de la analysisView Identificación en el dataDisplays.css archivo de tema.

Por ejemplo, puede cambiar las líneas entre las celdas de la tabla de análisis con la siguiente regla en su archivo overrides_custom.css:

td #analysisView {border: delgado sólido negro; }

6.5.5 Interfaz de usuario de ejemplo

Al probar su tema, usted debe buscar en su efecto a través de todas las páginas y cuadros de diálogo de JasperReports Server. Sus pruebas de organización 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 página muestra la interfaz de usuario es una nueva página que se incluye con el nuevo diseño de la interfaz. Sólo es accesible a administradores: 1.

2.

3. 4.

Inicie sesión como administrador en el entorno de prueba en el nivel donde quieres poner a prueba tu tema (superusuario o jasperadmin de una organización o suborganización).

Si no lo ha hecho, cargue su tema a la carpeta Temas en este nivel. Ver "Creación de Temas "en la página 124.

Seleccione Ver> IU Muestras desde el menú principal en cualquier página. Mira todos los componentes de la muestra en cada una de las galerías de la muestra. Por ejemplo, los botones galería espectáculos todos los diferentes tipos de botones en todos los estados de acción posible.

129


Figura 8.6 Todos los componentes de botón posibles en las galerías de la muestra

5. Al hacer clic en los diseños estándar, la muestra sustituye a la página de ejemplos. Seleccione Ver> IU Muestras desde el menú principal de nuevo para volver a las galerías.

La página 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.

Visualización de las galerías de la muestra puede ayudarle a encontrar rápidamente 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 tenía planeado. Tener un tema bien probado minimiza las posibilidades de errores al activar el tema en su servidor de producción.

130

CAPÍTULO 7 IMPORTACIÓN

Y EXPORTACIÓN

Las herramientas de importación y de exportación le permiten extraer recursos o agregar recursos a un servidor JasperReports repositorio. Los servicios públicos también se encargan de las tareas programadas, usuarios y roles que el servidor almacena internamente. Importación y exportación puede ser útil cuando se migra de una versión de JasperReports Server o cuando se mueve entre la prueba y entornos de producción.

JasperReports Server proporciona una interfaz de usuario y las utilidades de línea de comandos para realizar la importación y la exportación. El funcionalidad en la interfaz de usuario (UI) sólo está disponible para los administradores de sistemas (superusuario por defecto) y la utilidades de línea de comandos requieren acceso al sistema de archivos donde está instalado el servidor. Este capítulo contiene las siguientes secciones:

• • • •

Importación y exportación Catálogos Importación y exportación a través de la interfaz de usuario web Importación y exportación a través de la línea de comandos Alternos Scripts Import-Export

7.1 Importación y exportación Catálogos

La salida del comando de exportación y la entrada al comando de importación se llama un catálogo. 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 sólo el contenido que necesita, por ejemplo, una función y sus usuarios. Los recursos en el repositorio menudo tienen dependencias en otros recursos, por ejemplo, un informe que se basa en imágenes, tipos de datos de entrada, y una fuente de datos. Exportación de un recurso incluye todas sus dependencias, aunque se almacenan en carpetas que no se especificaron en el comando de exportación. Importación de un catálogo 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 catálogo se puede exportar, ya sea como una jerarquía de carpetas y archivos, o como un único archivo zip (archivo comprimido) que contiene la misma información. Independientemente del formato de catálogo, el contenido del catálogo no están 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 catálogo no está definido públicamente, 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 métodos de lectura y escribir objetos en el servidor. Para obtener más información, consulte la Guía de Servicios Web JasperReports Server.

131


A partir de JasperReports Server 5.5, las contraseñas de usuario y contraseñas de origen de datos se cifran en exportada catálogos, así como en la base de datos interna del servidor. Usted todavía debe tomar las medidas apropiadas para asegurar el archivo de catálogo del acceso no autorizado. Los archivos de catálogo contienen metadatos sensibles como nombres de usuario, URL de base de datos, y las organizaciones internas o externas. Los archivos de catálogo también pueden contener datos en forma de informar de salida, como el PDF de un informe ejecutivo.

7.1.1 Configuración de la clave de cifrado Import-Export

A partir de JasperReports Server 5.5, todas las contraseñas sensibles en catálogos exportados son encriptados para mayor seguridad. En orden por dos servidores compartan el contenido cifrado de un catálogo exportado, deben compartir una clave privada. El valor por defecto clave es una cadena de 128 bits AES almacenada en un archivo de configuración. Este cifrado es independiente de la propia encriptación interna del servidor. Todas las contraseñas de usuario se almacenan cifradas en la base de datos interna, como se describe en "Cifrado de contraseñas de usuario" en la página 164. El cifrado de importación y exportación sólo se aplica a catálogos de exportación.

Configuración de la clave de cifrado Import-Export

Archivo de configuración

... / WEB-INF / applicationContext-security.xml

Propiedad

<Nombre de propiedad = "keyBytes"> <Valor> 0x2b 0x6C 0x34 0x22 0x44 0x42 0x6F 0xb5 0x7f 0x34 0xD3 0x5a 0x1f 0x92 0xCD 0xDC </ value> </ Propiedad>

Frijol

ImportExport Cifrado

Descripción

Establezca el valor de la propiedad de los keyBytes a la mismo valor hexadecimal (16 bytes = 128 bits) en todos los servidores que intercambiarán exportación catálogos.

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 después de su instalación, y usted debe configurarlo con la tecla de un servidor existente, si tiene uno. De esta manera todos sus servidores y todos los catálogos de exportación utilizarán el misma clave y ser compatibles entre sí.

7.1.2 Importación sin cifrar Catálogos

Las versiones anteriores a 5.5 no encriptan las contraseñas de los usuarios a la exportación. Estas contraseñas aparecen en texto simple dentro de los archivos del catálogo de exportación. Por compatibilidad con versiones anteriores, aún se admiten catálogos sin cifrar y se puede importar a un nuevo servidor, incluso cuando se configura una clave de cifrado. Las contraseñas que se cifran mediante una operación de exportación en JasperReports Server 5.5 o posterior tienen cifrado marcadores, contraseñas para mayores sin los marcadores se pueden detectar y se importan como texto sin formato. Una vez de texto plano contraseñas se importan, se almacenan internamente con el cifrado, y se cifrarán en cualquier exportación futuro.

7.2 Importación y exportación a través de la interfaz de usuario web JasperReports servidor proporciona funcionalidad para importar y exportar recursos y usuarios a través de la interfaz de usuario:

132


• • •

•

Exportación desde la interfaz de usuario del repositorio Exportación desde la interfaz de usuario de configuración Importación desde la interfaz de usuario de configuración 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 página 132. Entonces usted debe entrar en el almacén de claves contraseña cuando se le solicite por la operación de importación. Asegúrese de que la ubicación de salida especificada para una exportación es de escritura al usuario local que ejecuta el servidor de aplicaciones contiene JasperReports Server.

Cuando la importación y exportación a través de la interfaz web, recuerde lo siguiente:

•

7.2.1 Exportación desde la interfaz de usuario del repositorio

Para exportar los recursos individuales o toda una carpeta del repositorio: 1. Inicie la sesión como administrador del sistema (superusuario por defecto).

2.

3.

4.

Seleccione Ver> Repositorio. También puede exportar los informes ad hoc vistas, cuadros de mando, y vistas OLAP desde la Biblioteca página. Localice el recurso que desea exportar. Seleccione uno o más 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 Exportación en el menú contextual. Aparecerá el cuadro de diálogo Recursos de Exportación:

Figura 7-1 Exportación Recursos de diálogo en el Repositorio

5.

6.

Especifique el nombre del archivo zip para el catálogo exportado. Para descargar el catálogo, el diálogo sólo es compatible con el formato de archivo zip.

Especifique las siguientes opciones si lo desea:

• Desactive la Incluya los permisos del repositorio casilla para exportar los recursos y carpetas sin permisos. Tras la importación, 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 selección. Haga clic en Exportar. El servidor genera el archivo de catálogo zip y su navegador le pide que guarde el archivo. Dependiendo del tamaño del repositorio y las opciones que haya seleccionado, puede tardar varios minutos a generar el archivo de catálogo. 7.

133


Los recursos se exportan junto con las dependencias, incluso si no se encuentran en la seleccionada carpetas. Para obtener más información, consulte "Importar y exportar catálogos" en la página 131.

7.2.2 Exportación desde la interfaz de usuario de configuración

Para exportar usuarios y roles, además de, o en lugar de contenido del repositorio, utilice las páginas de configuración del servidor para los administradores del sistema. Esta página ofrece más opciones que la exportación contextual de la interfaz de usuario del repositorio. A partir de JasperReports Server 5.5, todas las exportaciones contienen contraseñas encriptadas y si va a importar a un diferente servidor, debe configurar una clave de cifrado en ambos servidores. Ver "Configuración del cifrado Import-Export Clave "en la página 132 para más detalles.

Para exportar los datos a través de la interfaz web: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2. Seleccione Administrar> Configuración del servidor y seleccione Exportación en el panel de

la izquierda.

Figura 7-2 Interfaz de usuario para la Exportación

3.

4.

Especifique el nombre del archivo zip para el catálogo exportado.

La interfaz de usuario web sólo admite el formato de archivo zip. Utilice las casillas de verificación y de múltiples listas de selección para elegir el contenido de su archivo de catálogo exportado: a. Comprobar Exportación 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 modificación de los recursos.

Desactive la casilla para Exportación Todo y seleccionar sólo los usuarios y roles para exportar.

b.

134


Si ha desactivado la casilla de Exportación Todo, debe especificar los usuarios y roles para exportar.

Los botones de selección 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 botón de radio, puede seleccionar los usuarios para exportar; el servidor también exporta el roles asignados a los usuarios seleccionados. 5. Para seleccionar usuarios y roles específicos: a.

b.

6.

a. b.

7.

Seleccione Exportar seleccionado individualmente roles y usuarios.

El Seleccione los usuarios y Seleccione los roles listas se vuelven activas. Seleccione los usuarios y roles para exportar.

Seleccione Exportar usuarios con roles seleccionados. Seleccione las funciones que desea exportar. El servidor también exportará los usuarios que se asignan los roles. Los usuarios asignados a los roles seleccionados se resaltan.

Para seleccionar los usuarios: a. b.

8.

9.

Seleccione Papeles de exportación asignados a usuarios seleccionados. Seleccione los usuarios que desea exportar. También se exportaron sus roles. Las funciones asignadas a los usuarios seleccionados se resaltan.

En ediciones comerciales de JasperReports Server, puede comprobar Incluye eventos de auditoría y Incluya eventos de monitoreo según sea necesario.

Haga clic en Exportaciones. El servidor genera el archivo de catálogo zip y su navegador le pide que guarde el archivo. Dependiendo del tamaño del repositorio y las opciones que haya seleccionado, puede tardar varios minutos a generar el archivo de catálogo.

Para seleccionar las funciones:

7.2.3 Importación desde la interfaz de usuario de configuración

Las páginas de configuración para los administradores de sistemas incluyen una interfaz de usuario para simplificar el procedimiento de importación. Esta importación opera en una instancia en ejecución de un servidor, y todos los recursos importados son visibles de inmediato. En Además, todos los ajustes de configuración o de seguridad en el catálogo importado se aplique inmediatamente, sin necesidad de reiniciar el servidor. A partir de JasperReports Server 5.5, todas las exportaciones contienen contraseñas encriptadas y si va a importar a un diferente servidor, debe configurar una clave de cifrado en ambos servidores. Ver Configuración de la clave de cifrado Import-Export para más detalles.

No se puede utilizar la interfaz de usuario de importación para importar un catálogo de una JasperReports Server 5.2 o anterior si era creado con la opción "exportar todo". Archivos de los temas contenidos en los catálogos de exportación previos versiones del servidor se sobrescriben temas nuevos, pero no son compatibles y causan visualización HTML errores. Para importar un catálogo de una versión anterior del servidor, utilice la línea de comandos de utilidad <JS- instalar> /buildomatic/js-import.bat o .sh con la opción --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 continuación, rehacer sus cambios en el archivo basado en pageSpecific.css en el apuntar servidor desde 5.5 o posterior. Para obtener más información, consulte "Descarga e postal Carga Tema Files" en la página 125.

135


Para importar datos a través de la interfaz web: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2. Seleccione Administrar> Configuración del servidor y seleccione Importación en el panel de

la izquierda.

Figura 7-3 Interfaz de Usuario para Importación

3.

4.

Haga clic en Explorar para elegir el archivo de catálogo zip importar. La interfaz de usuario web sólo admite el formato de archivo zip. Puede importar cualquier archivo de catálogo zip creado por la interfaz de usuario de exportación o la utilidad de exportación de línea de comandos. Utilice las casillas de verificación para cambiar el comportamiento de la operación de importación: • Cuando se activa, el Actualización opción sólo importará los recursos que son más recientes que los que tienen la

misma URI en el repositorio actual. El Saltar actualizaciones de usuario opción le permite mantener la definición actual de cualquier usuario que también existen en el catálogo importado. Cuando se activa, el Incluye eventos de acceso opción importa los tiempos de modificación de los recursos de el catálogo. Cuando se desactiva, los recursos mantengan sus tiempos de acceso existentes, si ya existen. En ediciones comerciales de JasperReports Biblioteca, la Incluye eventos de auditoría y Incluya el monitoreo eventos determinar si el acceso y eventos de supervisión del catálogo, si los hay, son importados. El Incluya la configuración del servidor opción determina si la configuración del sistema se actualiza de la catálogo. Hay dos requisitos previos con el fin para el catálogo que contiene los valores de configuración: •La configuración del servidor originario deben ser modificados a través de la interfaz de usuario. Por lo tanto, ajustes sólo registro, Ad Hoc Ajustes, Ajustes de AWS y Configuración OLAP se ven afectados. Para obtener más información, consulte "Configuración Ajustes en la interfaz de usuario "en la página 172 •El catálogo debe exportarse con la opción de "todo" de la interfaz de usuario o el utilidad de línea de comandos.

Cuando se importan los valores del servidor, que entran en vigor de inmediato y que aparecen en la interfaz de usuario de configuración.

5. Haga clic en Importar.

El servidor carga el archivo de catálogo zip e importa su contenido en el repositorio. Dependiendo del tamaño del catálogo y las opciones que haya seleccionado, puede tardar varios minutos para realizar la importación.

•

•

•

136


7.3 Importación y exportación a través de la línea de comandos

Si ha instalado JasperReports Server desde el instalador binario, se configuraron las utilidades de línea de comandos por el instalador. Si ha instalado la distribución de archivos WAR, debe seguir las instrucciones de "Configuración de Importación-exportación de utilidades "en la página 141 antes de poder ejecutar las utilidades.

Las utilidades de importación y exportación son shell scripts localizados en los <js-install> carpeta / buildomatic: Ventanas: <js-instalación> \ buildomatic \ js-import.bat <Js-instalación> \ buildomatic \ js-export.bat Linux: <js-install> /buildomatic/js-import.sh <Js-install> /buildomatic/js-export.sh

Los ejemplos de este capítulo utilizan los comandos de Windows acortado sin la extensión bat opcional en el línea de comandos. Si está ejecutando JasperReports servidor en Linux, asegúrese de añadir la extensión de archivo .sh.

Al utilizar los servicios de importación y exportación, tenga en cuenta lo siguiente:

•

• • •

Servidor JasperReports debe interrumpirse cuando se usan las utilidades de importación y exportación. Esto es muy importante para la utilidad de importación para evitar problemas con las memorias caché, configuración y seguridad. Todas las opciones de línea 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 Configuración de la clave de cifrado Import-Export. A continuación, debe introducir la contraseña del almacén de claves cuando impulsada por el comando de importación. Asegúrese de que la ubicación de salida especificada para una exportación es de escritura para el usuario que ejecuta el comando. Todos los URIs son las rutas de repositorios que se originan en la raíz. Las rutas de repositorios que se muestran en este capítulo suponen está utilizando una edición comercial del servidor. En la edición de la comunidad, los caminos no son organizaciones, por ejemplo:

Ediciones comerciales: Proyecto de la Comunidad:

/ Organizaciones / organization_1 / informes / interactive / CustomersReport / Informes / interactive / CustomersReport

• •

7.3.1 Exportación desde la línea de comandos

Uso: js-exportación [OPCIONES]

Jaspersoft recomienda que deje la instancia del servidor antes de ejecutar la utilidad de exportación. Para obtener instrucciones ver el Guía de instalación del servidor JasperReports.

Especifica los recursos del repositorio, tales como informes, imágenes, carpetas y tareas programadas para exportar al sistema de archivos. También puede exportar las definiciones internas de los trabajos programados, usuarios, roles, además de datos de auditoría existentes. El exportación de salida es conocido como un repositorio de catálogo; o bien es un archivo o un conjunto de archivos en una estructura de carpetas:

137


Tabla 7-1 Opciones en js-exportación Comando

Opción

--everything

Explicación

Exportar todo excepto de auditoría y datos de seguimiento: todos los recursos del repositorio, permisos, informe de empleo, usuarios y roles. Si ninguna configuración de servidor han sido modificado en la interfaz de usuario, los están incluidos también.

Esta opción es equivalente a: --uris --repository-permisos --Informe-jobs --calendars --users --roles

--help

--include-access-eventos

--output-dir

--output-zip

--Informe-jobs

Muestra una breve información sobre las opciones disponibles.

Los eventos de acceso (fecha, hora y nombre de usuario de la última modificación) se exportan. Ruta de acceso de un directorio en el que se creará la carpeta del catálogo de salida. Ruta de acceso y nombre de archivo del archivo de catálogo zip de salida para crear. 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 opción 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 exportación incluirá todas y todos los calendarios de todo tipo (fiestas, recurrente, ...) definida en el planificador. Cuando calendarios están presentes en una exportación catálogo, siempre se procesan y agregan a la importación.

Cuando esta opción está presente, los permisos del repositorio se exportan junto con cada carpeta y recursos exportados.

Esta opción sólo debe utilizarse en conjunción con --uris.

--roles Comma lista de funciones a la exportación separado; si no hay papeles están especificados con esta opción, todos los papeles se exportan.

Cuando esta opción está presente, cada exportación función activa la exportación de todos los usuarios pertenencia a la función. Esta opción sólo debe utilizarse en conjunción con --roles.

Comma lista de carpetas o recursos URIs separados en el repositorio.

Lista separada por comas de los usuarios a la exportación separado; si ningún usuario se especifican con este opciones, todos los usuarios se exportan. Exportación de un usuario incluye todos los atributos de usuario y, con el fin de mantener la coherencia, también exporta todos los roles asignados al usuario. Cuando especificando los usuarios, debe dar su ID organización si es aplicable, por ejemplo: --users superusuario, "jasperadmin | organization_1", ...

--include-auditoría-eventos

--include-Monitoring eventos

Incluya datos de auditoría de todos los recursos y usuarios en la exportación. Incluya datos de seguimiento de todos los recursos y usuarios en la exportación.

--calendars

--repository-permisos

--role usuarios

--uris

--users

Las contraseñas de usuario están encriptados durante la exportación por defecto, pero catálogos exportados pueden contener datos sensibles. Tome las medidas apropiadas para asegurar el archivo de catálogo del acceso no autorizado.

138


Ejemplos:

•

•

Exportar todo en el repositorio:

js-exportación --everything mi_exportación --output-dir

Exportar el informe CustomersReport unidad / / interactive / informe a una carpeta de catálogo:

js-exportación --uris / organizaciones / organization_1 / informes / interactive / Mi_exportación CustomersReport --output-dir

• Exportar los / las imágenes y / carpetas de fuentes:

js-exportación --uris / organizaciones / organization_1 / imágenes / organizaciones / ORGANIZATION_ 1 / informes --output-dir mi_exportación

•

•

•

Exportar todos los recursos (salvo los usuarios, roles y horarios de trabajo) y sus permisos a un catálogo zip:

js-exportación --uris / --repository-permisos --output-zip myExport.zip

Exportar todos los recursos y las tareas de informe:

js-exportación --uris / --Informe-empleo / mi_exportación --output-dir

Exportar los trabajos de informes de la unidad / informes / informe interactivo / CustomersReport:

js-exportación --Informe-jobs / organizaciones / organization_1 / informes / / CustomersReport mi_exportación --output-dir interactivo

•

•

Exportar todos los roles y usuarios:

mi_exportación js-exportación --roles --users --output-dir

Exportar los papeles ROLE_USER y ROLE_ADMINISTRATOR junto con todos los usuarios que pertenecen a cualquiera papel:

js-exportación --roles ROLE_USER, ROLE_ADMINISTRATOR --role usuarios --output-dir mi_exportación

El --uris opción le permite especificar uno o más URIs de recursos. Un URI puede especificar un recurso como un informe. En este caso, todos los recursos asociados (tales como imágenes, subinformes, fuentes de datos, paquetes de recursos y de clase archivos) se exportan. Un URI también puede especificar una carpeta. Si se especifica una carpeta, la operación de exportación exporta todo recursos y carpetas contenidos en la carpeta. Además, recursivamente a través de todas sus subcarpetas.

La carpeta denominada Temp en la raíz y en todas las organizaciones es una carpeta especial. Ninguna de las carpetas o recursos en una carpeta Temp se exportan.

7.3.2 Importación desde la línea de comandos

Ver "Importación y exportación a través de la línea de comandos" en la página 137 de directrices al ejecutar el utilidades de línea de comandos.

Cuando se utiliza la utilidad de línea de comandos js-importación, el servidor debe ser detenido para evitar problemas con cachés, configuración y seguridad. Consulte las instrucciones en el Guía de instalación del servidor JasperReports.

Uso: js-importación [OPCIONES]

Lee un catálogo repositorio del sistema de archivos y crea el recurso con nombre en el servidor JasperReports repositorio. El catálogo repositorio debe haber sido creado por la interfaz de exportación o el js-exportación comando, ya sea como un archivo ZIP o una estructura de carpetas.

139


A partir de JasperReports Server 5.5, todas las exportaciones contienen contraseñas encriptadas y si va a importar a un diferente servidor, debe configurar una clave de cifrado en ambos servidores. Ver Configuración de la clave de cifrado Import-Export para más detalles. Tabla 7-2 Opciones en js-importación Comando

Opción

--help

--input-dir

--input-zip

--update

Explicación

Muestra una breve información sobre las opciones disponibles.

Sendero para importar un catálogo de un directorio.

Ruta de acceso y nombre de archivo para importar un catálogo de un archivo zip. Recursos en el catálogo sustituyen a las del repositorio si sus URIs y tipos partido.

Cuando se utiliza con --update, los usuarios del catálogo no se importan o se actualizan. Uso esta opción para importar catálogos sin sobrescribir los usuarios definidos actualmente.

Restaura los eventos de acceso (fecha, hora, nombre de usuario y de la última modificación) en recursos importados.

Edición Professional. Importa los datos de auditoría que existe en el catálogo.

Edición Professional. Importa los datos de vigilancia que existe en el catálogo.

--skip-user-update

--include-access-eventos

--include-auditoría-eventos

--include-Monitoring eventos

--include-servidor-settings Determina si la configuración del sistema se actualiza desde el catálogo. Hay son dos requisitos previos con el fin para el catálogo que contiene los valores de configuración:

• La configuración del servidor de origen deben ser modificados a través de la interfaz de usuario (Ajustes del registro, Ad Hoc Configuración Ad Hoc caché y Configuración OLAP). Para obtener más información, consulte "Configuración Ajustes en la interfaz de usuario "en la página 172. El catálogo debe exportarse con la opción de "todo" por parte del usuario interfaz o la utilidad de línea 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 catálogo que incluye un tema, como por ejemplo cuando se utiliza --export-todo, desde una versión de servidor 5.2 o antes a la versión 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 ción tema contiene la pageSpecific.css archivo, debe quitarlo desde el archivo ZIP antes cargar y, a continuación, rehacer sus cambios en el archivo basado en pageSpecific.css en el servidor de destino desde 5.5 o posterior. Para obtener más información, consulte "Descarga y Cargar postal Tema Archivos "en la página 125.

Ejemplos:

•

•

Importe el archivo de almacenamiento catálogo myExport.zip:

js-importación --input-zip myExport.zip

Importar la carpeta del catálogo MYDIR, en sustitución de los recursos existentes si sus URIs y tipos coinciden con los encontrados en el catálogo:

140


js-importación --input-dir MYDIR --update

•

•

Importe el archivo de almacenamiento catálogo myExport.zip pero ignorar cualquier usuario que se encuentran en el catálogo:

js-importación --input-zip myExport.zip --update --skip-user-update

Importar la carpeta del catálogo MYDIR con eventos de acceso:

js-importación --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 operación de creación 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 opción. Tenga en cuenta que, si el recurso en el catálogo de exportación es de un tipo diferente de el recurso existente, el servidor devuelve un error y se salta la operación de actualización.

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 modificación antes de la exportación se restaura en la importación para cada recurso. La carpeta de catálogo se debe haber creado con eventos de acceso. Si no realiza la importación de acceso eventos, o si no existen en los archivos importados, se utilizan la fecha y hora de la importación.

7.3.3 Configuración de Importación-Exportación Utilidades

Si ha instalado JasperReports Server desde el instalador binario, las utilidades de importación y exportación se han configurado por el instalador. Si ha instalado la distribución de archivos WAR, debe configurar varios archivos antes de poder utilizar el servicios de importación y exportación. Otra opción es utilizar el "Scripts Alternos Import-Export" en la página 142 porque no requieren ningún configuración, independientemente del método de instalación.

1. Dependiendo de la base de datos que utilice, copie el archivo de configuración de la instalación: 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 específicos de su instalación. Para obtener más información acerca de la configuración de este archivo, ver el Guía de instalación 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 contraseña del sistema porque js-importación y exportación-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:

•<js-install> /buildomatic/build_conf/default/js.jdbc.properties •<js-install> /buildomatic/build_conf/default/js.quartz.properties (sólo para DB2 y PostgreSQL) Asegúrese 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-

4.

141


7.4 Alternos Scripts Import-Export

Independientemente de su método de instalación, JasperReports Server proporciona una tercera forma de ejecutar la importación-exportación los comandos. Buildomatic es otro script de línea de comandos que se basa en la Apache Ant herramienta para automatizar instalaciones. Incluye metas (sub-comandos) para realizar operaciones de importación y exportación con las mismas opciones como los scripts. Los siguientes ejemplos comparan los dos comandos:

Scripts de Shell:

Buildomatic:

js-export.sh --everything --output-file = js-catálogo-exp.zip

js-ANT-exportación todo -DexportFile = js-catálogo-exp.zip

Ambos tipos de scripts se encuentran en el <Js-instalación> / buildomatic carpeta.

7.4.1 Correr Importar de Buildomatic

El importación objetivo para hormiga tiene la siguiente sintaxis:

Ventanas: js-hormiga importación -DimportFile = <nombre de archivo> [-DimportArgs = "<importación-options>"]

Linux y ./js-hormiga importación -DimportFile = <nombre de archivo> [-DimportArgs = \ "<importación-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 más de una opción de importación. En Linux, todas las comillas dobles marcas (") Debe ser escapado con una barra invertida (\).

Al realizar una gran importación utilizando js-hormiga, el servidor debe ser detenido (o sea puesto en un modo con reducción de la carga) para evitar problemas con las memorias caché, configuración y seguridad.

Los ejemplos siguientes son comandos típicos de importación en Windows:

js-import-help-pro js-hormiga importación -DimportFile = mi-reports.zip js-hormiga importación -DimportFile = my-datasources -DimportArgs = "- Actualización"

Los ejemplos siguientes son comandos típicos de importación en Linux:

./js-import-help-pro

./js-hormiga importación -DimportFile = mi-reports.zip

./js-hormiga importación -DimportFile = mi-datasources.zip -DimportArgs = \ "- update \"

7.4.2 Ejecución de las Exportaciones de Buildomatic

El exportación objetivo para hormiga tiene la siguiente sintaxis:

Ventanas: exportación js-hormiga -DexportFile = <nombre de archivo> -DexportArgs = "<-opciones de exportación>"

Linux y ./js-hormiga exportación -DexportFile = <nombre de archivo> -DexportArgs = \ "<-opciones de exportación> \" Mac OSX:

El formato de archivo de exportación es un archivo ZIP o un conjunto de archivos con un nuevo nombre de directorio. Si se especifica la extensión zip para su archivo de salida, un archivo ZIP se crea automáticamente. De lo contrario, un directorio con los archivos y sub- directorios se crea como un conjunto de archivos sin comprimir.

142


El exportArgs argumento requiere comillas dobles (") Y pueden contener más de una opción de exportación, como se muestra en estos ejemplos de Windows:

js-hormiga de exportación-help-pro exportación js-hormiga -DexportFile = mi-domains.zip -DexportArgs = "- URI / organizaciones / organization_1 / Dominios" js-hormiga exportación -DexportFile = mis-informes-y-users.zip -DexportArgs = "- URI / organizaciones / organization_1 / informes --users jasperadmin | organization_1, joeuser | organization_1 " exportación js-hormiga -DexportFile = my-fuentes de datos -DexportArgs = "- URI / organizaciones / organization_1 / datasources --roles ROLE_USER" js-hormiga exportación -DexportFile = js-everything.zip -DexportArgs = "- todo"

En Linux, todas las comillas dobles (") Y otros personajes, como la barra vertical (|), Que separa de inicio de sesión nombres de usuario y organización deben ser escapados con una barra invertida (\). Además, al enumerar los nombres de usuario, incluya la lista entre comillas simples ('), Como se muestra en este ejemplo Linux:

./js-hormiga de exportación-help-pro

./js-hormiga exportación -DexportFile = mis-informes-y-users.zip -DexportArgs = \ "- URI / organizaciones / organization_1 / informes --users 'jasperadmin \ | organization_1, joeuser \ | organization_1' \ "

143


144

CAPÍTULO 8

•

Seguridad de aplicaciones

En este capítulo se describen las opciones de configuración que protegen JasperReports Server y sus usuarios de acceso no autorizado. Las propiedades de configuración aparecen en dos ubicaciones:

Algunas propiedades deben configurarse durante la fase de instalación e implementación, para que los usuarios accedan a la servidor. Estas opciones se configuran a través de los archivos utilizados por los scripts de instalación. Estos ajustes sólo disponibles al realizar una instalación de archivo WAR. Otras propiedades están ubicadas en archivos en diferentes carpetas después de la instalación. Archivos de las rutas de configuración son en relación al directorio <js-install>, que es la raíz de la instalación de JasperReports Server. Para cambiar el configuración, editar estos archivos y reiniciar el servidor.

•

Debido a la ubicación de los archivos que se describen en este capítulo varían con el servidor de aplicaciones, las rutas especificadas en este capítulo son en relación con el archivo WAR desplegado para la aplicación. 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 ubicación 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 capítulo. Cambios involuntarios pueden provocar errores inesperados en todo JasperReports Server que puede ser difícil de solucionar. Antes de cambiar los archivos, copia de seguridad en un lugar fuera de la instalación de JasperReports Server.

No modifique la configuración que no se describen en la documentación. A pesar de que algunos ajustes puede Parece sencillo, valores distinto al predeterminado puede no funcionar correctamente y causar errores.


• • • • • • • • • •

El cifrado de contraseñas en los archivos de configuración Configuración de opciones de contraseña de usuario Configuración del usuario Sesión inactiva Prevención CSRF Configuración Configuración de validación de entrada La restricción de la subida de archivos Cómo ocultar los mensajes de seguimiento de pila Definición de una política de varios dominios para Flash El cifrado de las contraseñas de usuario El cifrado de sesión de usuario Inicio de sesión

145


8.1 El cifrado de contraseñas en los archivos de configuración

En JasperReports Server versión 5.5 o mayor, una nueva característica permite a los administradores ofuscan contraseñas que aparecer en los archivos de configuración. Esto satisface los requisitos de auditoría de seguridad y protege las contraseñas de ser observado por personas no autorizadas. Por lo general, las siguientes son encriptados: • • •

• •

La contraseña para la base de datos interna de JasperReports Server (JasperServer). Las contraseñas de las bases de datos de muestra (foodmart y sugarcrm). En Tomcat y tcServer, contraseñas en definiciones de recursos JNDI.

La contraseña para el servidor de correo utilizado por el planificador (quartz.mail.sender.password) La contraseña para la autenticación LDAP externo.

También puede cambiar la configuración para cifrar los siguientes:

Las contraseñas en archivos de configuración se cifran durante la instalación JasperReports Server. Si la instalación despliega en el servidor de aplicaciones Tomcat, la contraseña de la base de datos se encriptan automáticamente en el JNDI configuración también (en el context.xml archivo).

Seguridad de la contraseña 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 contraseñas de configuración. Mientras que uno puede pedir contraseñas en cada reinicio del servidor, no es práctico para mayoría de los usuarios. La única forma práctica de garantizar la seguridad de las contraseñas es a través de la copia de seguridad y restricción de el acceso al archivo de propiedades del almacén de claves.

8.1.1

1.

El cifrado de contraseñas de configuración en Tomcat (o primavera tcServer)

Para cifrar las contraseñas en una instalación de Tomcat o tcServer, modificar el procedimiento de instalación de la siguiente manera:

Dependiendo de la base de datos que utilice, copie el archivo de configuración de la instalación 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:

• • •

Introduzca los valores específicos a su instalación. Introduzca la contraseña en texto plano. Activar el cifrado de archivos de configuración 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 "Codificación de Propiedades adicionales en default_master.properties "en la página 147. •Opcionalmente, cambie la configuración de cifrado de archivos de configuración como se describe en "Opciones de cifrado" en la página 149. Ejecutar el script de instalación buildomatic (JS-instalación) y todos los demás pasos de la instalación de acuerdo con la Guía de instalación del servidor JasperReports. Esto tendrá los siguientes efectos:

a.

b.

c.

4.

•

Las contraseñas 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.

Las contraseñas encriptadas se propagan a todos los archivos de configuración. Los ingresos y los archivos de instalación se copian en sus ubicaciones finales.

En todos los archivos de configuración del servidor en ... / WEB-INF / applicationContext * .xml.

3.

Después de la instalación, las contraseñas se cifran en los siguientes lugares:

146


• •

En las definiciones de JNDI en ... / META-INF / context.xml. En los archivos default_master.properties que permanece después de la instalación.

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 contraseñas de configuración en los servidores de la empresa

La mayoría de los servidores de la empresa, como JBoss, Glassfish, WebSphere, WebLogic, y tienen formas de propiedad para establecer cifrado de la contraseña. Debe utilizar estos métodos de encriptación. JasperReports Server no establece automáticamente contraseñas cifradas para estos servidores durante el despliegue. En este caso, puede además cifrar la contraseñas en el archivo buildomatic después de la implementación: 1. Implementar JasperReports Server para el servidor de la empresa tal como se especifica en el Instalación del servidor

JasperReports Guía. La instancia de servidor JasperReports resultante tendrá las contraseñas de origen de datos JNDI sin cifrar. Si desea encriptar estas contraseñas, consulte la documentación de su servidor de aplicaciones. Después de que el servidor se ha configurado correctamente, cifrar los archivos de configuración del servidor JasperReports como de la siguiente manera: a.

b.

En default_master.properties, activar el cifrado descomentando encrypt = true.

Ejecute el objetivo js-hormiga de refresco-config, Lo que eliminará y volver a crear todos los archivos de configuración sin implementarlos en el servidor de aplicaciones. Ahora los archivos buildomatic tendrán la base de datos contraseñas encriptadas. Aún debe ser capaz de ejecutar la importación / exportación 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 contraseña (s) base de datos a texto sin formato en sus default_master.properties y empezar de nuevo con el paso 1.

2.

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 aplicación a través de la primavera propertyConfigurer frijol en applicationContext-webapp.xml.

Si una propiedad se define a través de JNDI, recomendamos que señala que hay frente a la encriptación:

<Property name = "password"> <Jee: jndi-lookup JNDI name = "java: comp / env / emailPassword" /> </ Propiedad>

El siguiente ejemplo de código 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 contraseña 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 más probable que se define a través de la propertyConfigurer frijol. Buscar a través 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 default- master.properties, se encripta antes de la instalación de la siguiente manera:

1.

2.

3.

4.

Establezca la contraseña deseada para quartz.mail.sender.password en default-master.properties:

quartz.mail.sender.password = xxyyzz

Elimine el comentario de la encrypt = true propiedad en el mismo archivo. Elimine el comentario propsToEncrypt = dbPassword en default-master.properties.

Añadir quartz.mail.sender.password a propsToEncrypt:

148


quartz.mail.sender.password = xxyyzz encrypt = true propsToEncrypt = dbPassword, quartz.mail.sender.password

5.

6.

Configurar e instalar su instalación guerra JasperReports Server como se describe en el JasperReports Servidor Guía de instalación.

Compruebe que report.scheduler.mail.sender.password fue cifrada en ambos-master.properties defecto y en /WEB-INF/js.quartz.properties.

8.1.4 Contraseña de cifrado para la autenticación externa

A partir de JasperReports Servidor 5.6, es posible cifrar las contraseñas en la autenticación externa archivos de configuración de LDAP y la autenticación de base de datos externa. Para ello, hemos introducido propiedades de contexto a la configuración de ejemplo los archivos en lugar de cadenas simples. Por ejemplo, si usted está usando LDAP para la autenticación, el archivo de configuración 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 través 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 instalación o actualización. 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 = contraseña

Para cifrar la propiedad de contraseña, usted también establecer lo siguiente:

external.ldapPassword = xxyyzz encrypt = true propsToEncrypt = dbPassword, external.ldapPassword

8.1.5 Opciones de cifrado

En los scripts de instalación buildomatic, las contraseñas se encriptan de forma simétrica: la misma clave secreta se utiliza para tanto el cifrado y el descifrado. La clave y el archivo de almacén de claves que contiene son generados al azar en cada máquina durante la primera instalación JasperReports Server. Todas las posteriores instalaciones JasperReports Server en el mismo servidor confiar en el mismo almacén de claves; que no se regeneran la tecla.

149


El almacén 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 almacén 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 almacén de claves y archivos de propiedades del almacén de claves a través de las variables ks y ksp ambientales, respectivamente. Por defecto, las contraseñas de bases de datos están cifrados con el algoritmo AES-128 en el modo Cipher Block Chaining con Relleno PKCS5. El algoritmo AES es el estándar de encriptación de la industria actual. Usted puede optar por modificar la nivel de cifrado, seleccionando un algoritmo diferente, un tamaño de clave más 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

build.key.algo

build.key.size

Descripción

Algoritmo utilizado para cifrar las propiedades de los archivos de configuración. Tamaño de la clave de cifrado como en AES-128.

Para aumentar el tamaño de la clave, si no se ha hecho antes, es posible que tenga instalar "Unlimited Política Jurisdicción Fuerza Archivos" en el sitio de Oracle para su versión de Java. Para instalar los archivos, descargar US_export_policy.jar y local_policy.jar. DESPUÉS 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 tendría que agregar el proveedor de Castillo Hinchable para que la lista de Archivo% JAVA_HOME% / jre / lib / security / java.security:

security.provider. <número ss> = org.bouncycastle.jce.provider.BouncyCastleProvider

enc.transformation El llamado modo de cifrado. Ver el ver de Java javax.crypto doc- documenta- para entender los modos y las carnes de mejor.

AES / CBC / PKCS5 Relleno

16 (bytes)

Por defecto

AES

128 (bits)

enc.block.size El tamaño 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.

Una lista separada por comas de las propiedades para cifrar. propsToEncrypt dbPassword

8.2 Configuración de opciones de contraseña de usuario Las opciones de contraseña del usuario determinar si las contraseñas pueden ser recordados por el navegador, si los usuarios pueden cambiar sus propias contraseñas, y si los cambios de contraseña son obligatorios u opcionales.

Por defecto, las contraseñas se almacenan en un formato cifrado en la base de datos privada del servidor. Para obtener información acerca de cómo cambiar la forma contraseñas están encriptadas, consulte "Cifrado de contraseñas de usuario" en la página 164

150


8.2.1 Configuración de la memoria Contraseña

La mayoría de los navegadores tienen una función de "recordar contraseñas" que almacena las contraseñas para el usuario. JasperReports Servidor puede enviar la propiedad autocomplete = "off" para indicar que las contraseñas de sus usuarios no deben almacenarse o llenos en forma automática. Los usuarios deben introducir su nombre de usuario y la contraseña completa cada vez que se conecten. Como política general de seguridad, contraseñas sensibles no deben ser almacenados en los navegadores. La mayoría de los navegadores no protegen las contraseñas con una contraseña maestra por defecto, lo que los hace vulnerables. Configuración de autocompletar en off ayuda a asegurar que los usuarios de JasperReports Server no almacenan sus contraseñas, evitando de esta manera que esto sea posible la seguridad riesgo. Comportamiento real depende de la configuración del navegador del usuario y cómo el navegador responde a la autocomplete = "off" propiedad. Entrar cifrado se describe en la sección "Cifrado Usuario Sesión Registro "en la página 167 no es compatible con memoria contraseña en el navegador. Independientemente de la configuración de autocompletar, el código JavaScript que implementa el cifrado de sesión despeja el campo de la contraseña antes de enviar la página. Como resultado, la mayoría de los navegadores no lo hará aviso para recordar la contraseña de inicio de sesión cuando el cifrado está habilitado, incluso si el usuario dispone de una memoria de contraseña habilitado en su navegador.

Cuando autoCompleteLoginForm Es cierto, como en la instalación por defecto, usted debe asegurarse de que todos los de su los usuarios tienen una contraseña maestra en su navegador.

Memoria contraseña en el navegador


... / WEB-INF / JasperServer-servlet.xml

Propiedad

autoCompleteLoginForm

Valor

cierto <Default> falsa

Descripción

Cuando es false, el servidor establece autocomplete = "off" en la página de inicio de sesión y los navegadores no llenarán en o mensaje para guardar contraseñas de Jaspersoft. Cuando true, la propiedad de autocompletado no se envía a todos, y el comportamiento del navegador depende de usuario configuración.

8.2.2 Habilitar caducidad de la contraseña

Si las políticas de seguridad requieren que los usuarios que cambien sus contraseñas a intervalos regulares, puede activar caducidad de la contraseña. En este caso, JasperReports Server solicita a los usuarios que cambien sus contraseñas en el intervalo usted especifique. Por ejemplo, si se establece la caducidad de contraseña de 90 días, el servidor solicita que sus usuarios cambien sus contraseñas cada tres meses. Cuando la contraseña de un usuario caduca, el usuario no puede iniciar sesión hasta que cambie de su contraseña. El valor por defecto es 0; en este caso, las contraseñas no caducan y los usuarios no se les solicita. Cuando se activa esta opción, el servidor activa automáticamente la Cambiar la contraseña opción en la página de inicio de sesión, aunque allowUserPasswordChange se establece como falsa.

Si los usuarios son autenticados externamente, por ejemplo, con LDAP, no activar esta opción.

151


Opción Administración de contraseñas


... / WEB-INF / JasperServer-servlet.xml (controla la página de Inicio de sesión) ... / WEB-INF / applicationContext-security-web.xml (controla los servicios web)

Propiedad

passwordExpirationInDays

Valor

0<Default> <Cualquier otro valor>

Descripción

Establezca el valor a cualquier valor positivo, distinto de cero para especificar el número de días después de que un contraseña caduca.

8.2.3 Permitir que los usuarios cambien sus contraseñas

Para permitir que los usuarios cambien sus contraseñas, esta configuración hace que la Cambiar la contraseña enlace aparece en la Página de registro. Por defecto, esta opción es falsa, y un administrador debe definir contraseñas de usuario por primera vez o restablecer una contraseña olvidada. Habilitar la opción de caducidad de la contraseña (que se describe en la sección anterior) automáticamente permite la capacidad de los usuarios a cambiar sus contraseñas.




... / WEB-INF / JasperServer-servlet.xml

Propiedad

allowUserPasswordChange

Valor

falsa <Default> cierto

Descripción

Establezca el valor en cierto para permitir que el Cambiar Contraseña enlace. Cualquier otro valor deshabilita.

8.2.4 Hacer cumplir Contraseña Patrones

Si permite que los usuarios o de la fuerza para cambiar sus contraseñas, puede cumplir las pautas contraseñas válidas. Tal patrones de contraseña se utilizan normalmente para asegurar contraseñas fuertes, como una longitud mínima y una mezcla de mayúsculas, minúsculas y números. El patrón predeterminado acepta cualquier contraseña de cualquier longitud, incluyendo un vacío contraseña.


152




... / WEB-INF / applicationContext.xml

Propiedad

allowedPasswordPattern

Frijol

userAuthority Servicio

Descripción

Una expresión regular que coincide válida contraseñas. El patrón por defecto ^. * $ partidos cualquier contraseña. Cambie la expresión regular para hacer cumplir los patrones tales como:

•

•

•

Longitud mínima y máxima de la contraseña

Ambos caracteres en mayúsculas y minúsculas

Al menos un número o un carácter especial

Asegúrese de que su patrón permite espacios en blanco y caracteres internacionales si es necesario por su usuarios.

Al cumplir un patrón contraseña, debe establecer el siguiente mensaje para informar a los usuarios por qué su contraseña fue rechazada. Asegúrese de ajustar el mensaje en todos los lugares que se utilizan.



... / WEB-INF / bundles / jsexceptions_messages [_locale] .properties

Propiedad

exception.remote.weak.password

Descripción

Mensaje muestra a los usuarios cuando la contraseña coincidencia de patrones falla.

8.3 Configuración del usuario Sesión inactiva

El tiempo de espera de sesión de usuario es la longitud de tiempo de la sesión de un usuario puede permanecer inactiva antes de que el servidor registra automáticamente la salida de usuario. JasperReports Server ahora implementa un recordatorio emergente que indica a los usuarios su sesión está a punto de expirar y les da la oportunidad de continuar sin ser desconectado.

Usuario Sesión inactiva


... / WEB-INF / web.xml

153


Usuario Sesión inactiva

Propiedad

<Session-config> <Session-timeout>

Valor

20 <Default>

Descripción

Ajuste el número de minutos que una sesión de usuario puede permanecer inactivo antes de la desconexión automática. 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 sesión también se aplica a la duración de una sesión permanece en la memoria después de una llamada de servicios web acabados. Si hay otra llamada de servicio web con las mismas credenciales dentro del período de tiempo de espera, el servidor reutiliza la misma sesión. Si el tiempo de espera es demasiado corto para este caso, es posible que tenga problemas de rendimiento causados por un alta carga de las llamadas de servicio web. A la inversa, si el tiempo de espera es demasiado largo, una sesión de usuario puede permanecer activo durante mucho tiempo (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 período de sesiones en memoria no se actualiza con los cambios de roles hasta que el usuario se desconecta de forma manual (que finaliza el período de sesiones) y registra de nuevo (La creación de una nueva sesión).

8.4 Prevención CSRF Configuración

Cross-Site Request Forgery (CSRF) es un exploit en el que el atacante se hace pasar por una sesión de usuario válido para poder tener información o realizar acciones en nombre del atacante. En JasperReports Server, el marco de seguridad protege cada página 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-OFG5- ZL6X

En la configuración predeterminada del servidor, la prevención de CSRF está activo. Jaspersoft no recomienda cambiar este ajuste:

Prevención CSRF


... / WEB-INF / classes / ESAPI / security-config.properties

Propiedad

security.validation.csrf.on

Valor


Descripción

Resulta prevención CSRF encendido o apagado. De forma predeterminada, Prevención CSRF está encendido. Cualquier otro valor además de mayúsculas y minúsculas "false" es equivalente a verdadera.

8.5 Configuración de validación de entrada

Para bloquear las amenazas de seguridad potenciales, tales como cross-site scripting y de inyección SQL, el marco de seguridad tiene un poderoso mecanismo para validar todas las entradas de usuario y valores pasados a los informes. Validación 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 versión anterior del servidor se puede bloquear, y los usuarios pueden ver los errores al introducir valores. En particular: •

•

Nombres y valores de los parámetros no pueden tener etiquetas (<y >). Si sus datos de negocio contiene etiquetas, es necesario actualizar la configuración de seguridad para permitir que ellos. Consultas SQL deben comenzar con SELECT y no pueden tener comentarios. Varias consultas separadas por semi dos puntos (;) También están prohibidos. Si sus informes o dominios tienen este tipo de consultas, es necesario o bien cambiarlos o actualizar la configuración 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 función de su nivel de amenaza percibida.

Se agregaron reglas de validación de entrada para cumplir con las pautas de seguridad para aplicaciones web. Desactivación de entrada validación o modificación de las reglas de validación puede hacer que el servidor sea más vulnerable a los ataques web.

Validación de entrada es un mecanismo complejo que se configura en los siguientes archivos:

Archivo

<Js-webapp> / WEB-INF / classes / ESAPI / seguridad- config.properties

<js-webapp> /WEB-INF/bundles/security.properties

<Js-webapp> / WEB- INF / classes / ESAPI / security.properties

<Js-webapp> / WEB- INF / classes / ESAPI / validation.properties

Contenido

Configuración de nivel superior para la habilitación o deshabilitación de entrada validación.

Texto de los mensajes de error de validación se muestra a los usuarios. Define las reglas de validación de entrada para cada campo de la páginas web del servidor y de entrada del reporte.

Define las expresiones regulares utilizadas en las normas de seguridad.

Validación 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 sección "UTF-8 Configuración "en la página 256.

Validación de entrada está activada por defecto al instalar JasperReports Server. Para desactivar uno o más de los características de protección:

Validación de entrada



155


Validación de entrada

Propiedad

security.validation.input.on

Valor


Descripción

Activa la validación de entrada en el campo o fuera de la aplicación web del servidor. Cualquier otro valor además de mayúsculas y minúsculas "false" es equivalente a verdadera.

Activa la validación de consultas SQL o desactivar en el servidor. Cualquier otro valor además de casos insensible "false" es equivalente a verdadero.

security.validation.sql.on cierto <Default>

falsa

8.5.1 Mensajes de Error del Seguro

Cuando los bloques de validación de entrada de entrada que viola una regla de seguridad, el servidor muestra un error. Por defecto, el mensajes de seguridad son intencionalmente genérica 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 genérico. Usted puede cambiar el mensaje y el número de error. Elija cualquier combinación de números o cartas de manera que los administradores pueden buscar fácilmente los registros para detectar violaciónes de seguridad.

Mensajes de validación de entrada


... / WEB-INF / bundles / security.properties

Propiedad

message.validation.input

Valor

Se ha producido un error. Por favor, póngase en contacto con su sistema administrador. (5321) <default>

Se ha producido un error. Por favor, póngase en contacto con su sistema administrador. (6632) <Default>

message.validation.sql

Establezca estas propiedades a los mensajes y códigos de error que coinciden con el resto de la aplicación. El objetivo es mostrar una mensaje que los atacantes no reconocerán como un error de seguridad, sin embargo, que los administradores pueden identificar de forma exclusiva en el troncos. Si traduce su aplicación a otros idiomas, asegúrese de crear una copia de la configuración regional específica de este archivo y traducir estos mensajes también.

8.5.2 Edición de entrada reglas de validación

Reglas de validación de entrada determinan lo que se permite la entrada cuando los usuarios envían información al servidor. Este información general consiste en pares de valores de parámetros, por ejemplo, los campos de un formulario de entrada. Para cada conocida par parámetro-valor, una regla de validación de entrada define lo siguiente: • ¿Qué caracteres están permitidos en el nombre del parámetro.

156


• •

•

¿Qué caracteres están permitidos en el valor de entrada. La longitud máxima permitida para el nombre del parámetro y el valor de la entrada (el mismo límite se aplica tanto por separado). Ya sea que el valor puede estar en blanco.

Los caracteres permitidos son determinados por una expresión regular llamado un validador. Los validadores se nombran regulares expresiones que se pueden utilizar en cualquier número de reglas de validación de entrada. A pesar de que los validadores se pueden utilizar en varias reglas, cada regla de validación deben ser lo más específico posible a la entrada permitida. Las reglas de validación de entrada predefinidos en JasperReports servidor están diseñados 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 validación de entrada para permitir su entrada. 1. Busque el mensaje "FALLO DE SEGURIDAD" en sus registros que fue creado por el error de seguridad. Para obtener más

información sobre los registros, consulte "Configuración de registros del sistema" en la página 192. El mensaje de registro contiene el nombre del parámetro y el contexto en el que se usa el parámetro. Haga una copia de seguridad del archivo <js-webapp> /WEB-INF/classes/esapi/security.properties, luego abrirlo para edición.

Busque el nombre del parámetro y el contexto. Por ejemplo, esta es la regla de validación de entrada para las entidades parámetro en la página Administrar funciones:

Entidades = Alpha, AlphaNumPunctuation, 5000, verdaderos, entidades-Manage_Roles_context

2.

3.

La regla de validación de entrada tiene el siguiente formato:

<Parámetro> = <nameValidator>, <valueValidator>, <charLimit>, <blankAllowed>, <parámetro> [!] - <Context> _context

4. Modifique la regla para permitir su entrada:

a. 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 sección. Si su entrada es atípicamente larga, aumentar el límite de caracteres.

No cambie ninguna otra parte de la regla.

b.

c.

5.

• •

•

Guarde los cambios y volver a implementar la aplicación web JasperReports Server o reiniciar el servidor de aplicaciones.

Trate de mantener el límite de caracteres tan cerca del valor esperado como sea posible. Trate de usar un validador que es lo más cercano a los valores esperados como sea posible. Si el valor de un parámetro se espera que sean sólo números, a continuación, utilizar el validador numérico. La mayoría de los validadores están listas blancas que especifican patrones de caracteres que se permiten. Un validador puede estar precedida por un signo de exclamación (!) 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 más fáciles de definir como listas blancas, otros como listas negras. Si un parámetro puede tener valores radicalmente diferentes o el mismo parámetro se utiliza en diferentes situaciones, a continuación, se puede aplicar más de una regla para ese parámetro. Para ello, basta con copiar una regla de parámetros y añadir enteros incrementales en el nombre del parámetro. Por ejemplo:

standAlone = Alfa, Alfa, 50, es cierto, standAlone-Report_PopupMenu_context

Recomendaciones:

•

Actualizado al:

standAlone = Alfa, ALPHANUM, 50, es cierto, standAlone-Report_PopupMenu1of3_context

Autónoma2 = 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 parámetro, cada regla se aplica en el orden indicado hasta que se pasa (Equivalente a un OR lógico). Si todos ellos fallan, entonces la entrada se bloquea y se notifica al usuario con la mensaje de error genérico. Las reglas que no siguen apareciendo como las advertencias de seguridad en los registros. Use la numeración en los nombres de contexto, como se muestra arriba, para identificar fácilmente estos mensajes falsos positivos. Cuando se utiliza varias reglas, definen la norma más utilizada o la norma más permisiva primera para optimizar la validación y reducir los mensajes de registro de falsos positivos.

8.5.3 Creación de expresiones Validator

Los validadores están basadas en Java expresiones regulares que especifica qué caracteres están permitidos (lista blanca) o prohibido (lista negra), dependiendo de cómo se utiliza en una regla de validación.

No modificar las expresiones de validación por defecto se proporcionan con el servidor. Estas expresiones han sido probado a fondo por Jaspersoft para proporcionar seguridad razonable de validación de entradas permitiendo al mismo tiempo el uso general de la aplicación. También, un validador se puede utilizar en varias reglas de validación de entrada, por lo que la modificación ellos pueden tener consecuencias no deseadas. Debieras siempre crear nuevos validadores con nuevos nombres.

1.

2.

Haga una copia de seguridad del archivo <js-webapp> /WEB-INF/classes/esapi/validation.properties, luego abrirlo para edición.

Localice el validador se utiliza en la regla de validación de entrada que desea modificar, por ejemplo, el validador Alfa expresión permite ninguna carta en cualquier idioma:

Validator.Alpha = ^ [\\ p {L} \\ p {M}] * $

3. Copie toda la regla en una línea nueva y darle un nuevo nombre con el siguiente formato:

Validador. <ValidatorName> = <RegularExpression>

Recuerde utilizar dobles barras invertidas (\\) En las propiedades de archivos para una barra invertidas en la expresión. Usted También 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.

Utilice el nuevo nombre del valor validador en su regla de validación de entrada, tal como se describe en el procedimiento anterior. Guarde los cambios y volver a implementar la aplicación web JasperReports Server o reiniciar el servidor de aplicaciones.

8.5.4 Validando parámetros nuevos de entrada

Si personaliza JasperReports Server para aceptar los nuevos parámetros de entrada, se debe añadir la entrada correspondiente reglas de validación a fin de mantener la seguridad del servidor. 1.

2.

Haga una copia de seguridad del archivo * <js-webapp> /WEB-INF/classes/esapi/security.properties*, luego abrirlo para edición.

Crear una nueva regla de validación de entrada que tiene el siguiente formato:

<Parámetro> = <nameValidator>, <valueValidator>, <charLimit>, <blankAllowed>, <parámetro> - <context> _ contexto

El contexto es la cadena que aparecerá en el registro cuando se produce un error de validación de seguridad, así que debe contener el nombre exacto del parámetro.

158


3. Mira las normas existentes en el archivo <js-webapp> /WEB-INF/classes/esapi/validation.properties para encontrar validadores para el nombre del parámetro y el valor que permita que su nueva entrada. Si es necesario, cree un nuevo validador expresiones, como se describe en el procedimiento anterior. Guarde los cambios y volver a implementar la aplicación web JasperReports Server o reiniciar el servidor de aplicaciones.

4.

8.5.5 Validación de consulta

Validación de consulta es un caso especial de validación de entrada, donde el servidor se asegura de que todas las consultas se emiten por el servidor cumple con un patrón preestablecido para una consulta de seguridad. Cuando la validación de consultas está habilitada, todas las consultas en informes y Los dominios utilizan las siguientes validador: Validator.ValidSQL = ^ \\ s * ((i) seleccionar?) \\ S + [^;] + $

Como resultado:

• •

Comentarios de SQL están prohibidos. Asegúrese de que tiene sólo una sentencia de consulta ejecutable por consulta. Varias consultas separadas por semi dos puntos (;) Serán 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, sólo utilizan la instrucción SELECT. La siguiente declaraciones están prohibidos:

DROP, INSERT, UPDATE, DELETE

• Si desea utilizar procedimientos almacenados, debe agregar la siguiente validador para el archivo <js-webapp> / WEB- INF / classes / ESAPI / validation.properties:

Validator.ValidSPROC = ^ \\ s * \\ (((i) llamada) \\ s + [^;]? + \\) $

Y a continuación, modificar la regla de validación para el parámetro correspondiente o campo en el que desea permitir procedimiento almacenado llama. Si desea permitir las llamadas a procedimientos almacenados, además de seleccionar las declaraciones, especifique múltiples reglas de validación como se muestra en la sección "Edición de Reglas de validación de entrada "en la página 156. • Cuando falla la validación SQL, los registros contienen el mensaje descrito en "Error Personalización de Seguridad Mensajes "en la página 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, póngase en contacto con el administrador del sistema. (6632)

org.owasp.esapi.errors.ValidationException: SQL_Query_Executor_context: no válido de entrada. Por favor, cumplir con regex ^ \ s * ((i) seleccionar?) \ S + [^;] + $ con una longitud máxima de 50000

8.5.6 Configuración adicional

Los archivos de configuración contienen algunos ajustes predeterminados diversos para el marco de seguridad. En particular, se definir la acción por defecto para la entrada que no tiene reglas de validación. Cambiar estos valores predeterminados es posible, pero no recomienda:

159


Validación avanzada de entrada



Propiedad

log.msg.security.off

Valor predeterminado

SEGURIDAD para [% s] es OFF

Descripción

Si la seguridad está desactivado, este se registrará el mensaje. Este mensaje en los registros puede alertar administradores si la seguridad configuración ha sido manipulado con.

Si un parámetro de petición no es anteriormente conocido, este mensaje es conectado.

Si hay un error en la seguridad archivos de configuración, este mensaje es conectado. Este es un error grave y debe ser resuelta por el administrador.

msg.no.rule No hay ninguna regla para el parámetro [% s]. Utilizando validación por defecto en la entrada = [% s].

msg.cannot.load Configuración de seguridad [% s] no se pueden cargar.


... / WEB-INF / classes / ESAPI / security.properties

Propiedad

DEFAULT


Alfa, AlphaNumPunctuation Soportes, 200000, es cierto, DEFAULT

Descripción

Si un parámetro de entrada no tener alguna regla de validación definida, se aplica esta regla de validación. El validador para los valores, AlphaNumPunctuation- Soportes es bastante permisiva, y puede ser cambiado a algo más restrictiva. El DEFAULT nombre de la propiedad es una palabra clave y nunca debe ser cambiado.

8.6 La restricción de la subida de archivos Varios cuadros de diálogo 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 tamaño. El siguiente procedimiento es el límite global de carga de archivos para todo el servidor. Cualquier única carga que supera este límite provocará un error y un mensaje de seguimiento de la pila. Se pretende que sea un máximo absoluto para evitar un peor error de falta de memoria que afecta a todo el servidor.

160


Global Tamaño del archivo límite de subida Archivo de configuración

... / WEB-INF / js.config.properties

Propiedad

file.upload.max.size

Valor

-1 <Default>

Descripción

El tamaño máximo de bytes permitidos para cualquier carga de archivos. El valor predeterminado, -1, significa que no hay límite para el tamaño del archivo, y un archivo lo suficientemente grande podría causar un error fuera de la memoria en el JVM. Algunas cargas de archivos, como la importación a través de la interfaz de usuario son necesariamente grande y debe ser tomado en cuenta. Establezca este valor más grande que su importación esperado más grande y menos de la memoria disponible.

Los siguientes ajustes se aplican a la mayoría de los cuadros de diálogo 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 tamaño del archivo y el patrón de nombre de archivo.

Subir archivo Restricciones


... / WEB-INF / fluye / fileResourceBeans.xml

Propiedad

maxFileSize

Valor

-1 <Default>

Descripción

El tamaño máximo en bytes permitido para un archivo subido a través de la mayoría de los cuadros de diálogo de la interfaz de usuario. Si un proceso de carga excede este límite, el servidor muestra un mensaje de error útiles. El valor predeterminado, -1, significa que no hay límite para el tamaño del archivo, y una carga podría alcanzar el límite global si se establece, o un error de falta de memoria. Por lo general, los archivos requeridos en recursos son más pequeños, y un límite de 10 MB es razonable.

Una expresión regular que coincide con nombres de archivo permitidos. El expresión por defecto coincide con todos los nombres de archivo de uno o más personajes. Una expresión más restrictiva, como [a-zA-Z0-9] {1200} \. [A-zA-Z0-9] {1,10} limitaría subidas en el alfa- nombres numéricos con una extensión.

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 línea de WEB-INF / js.config.properties:

my.filename.validation = El nombre de la subida nombre del archivo debe contener sólo caracteres alfanuméricos personajes y tienen una extensión válida.

fileNameRegexp ^. + $ <Default>

nomArchivo ValidationMessageKey

<Null /> <Default>

161


El siguiente procedimiento restringe la extensión del archivo cargado. Los cuadros de diálogo de carga de sólo buscar archivos con las extensiones dadas. Añadir o eliminar extensiones para cambiar las restricciones de tipo de archivo:

Subir archivo Extensiones


<JasperServer-pro-guerra> /scripts/resource.locate.js

Propiedad

ALLOWED_FILE_ RESOURCE_EXTENSIONS

Valor

Por defecto, las siguientes extensiones están 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"

8.7 Cómo ocultar los mensajes de seguimiento de pila Por defecto, muestra JasperReports Server pila huellas en ciertos mensajes de error. Seguimientos de pila revelan algunos información acerca de la aplicación, y expertos en seguridad recomiendan que una aplicación no los muestra. El siguiente procedimiento se apaga seguimientos de pila en los mensajes de error. Sin embargo, los mensajes de error más graves siguen mostrando Las excepciones de Java sin el seguimiento de la pila.

Cómo ocultar los mensajes de seguimiento de pila Archivo de configuración

... / WEB-INF / applicationContext-security-web.xml

Propiedad

showStacktrace Mensaje

Frijol

webAppSecurity Filtro

Descripción

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 aplicación web JasperReports Server para que este cambio surta efecto.

8.8 Definición de una política de varios dominios para Flash Por razones de seguridad, una animación 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 fusión 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 política de varios dominios que permite explícitamente. El archivo crossdomain.xml, situado en la raíz 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 diálogo 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 sólo permite el acceso desde el dominio de ejemplo o cualquiera de sus subdominios. Este ejemplo está diciendo que el servidor con el archivo, únicamente confía 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>

Detrás 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 política:

<-Domain-policy cruz> <Allow-access-from domain = "myserver.example.com" /> <Allow-access-from domain = "miservidor" /> </ Cross-domain-policy>

Al utilizar los servicios web, utilice el allow-http-request-headers-desde elemento de modo que las acciones codificados en el encabezado de solicitud están permitidos. El siguiente ejemplo permite solicitudes estándar y solicitudes de servicio web de cualquier subdominio de example.com.

<-Domain-policy cruz> <De control de sitio permitidos-cross-domain-políticas = "master-only" /> <Allow-access-from domain = "*. Example.com" /> <Allow-http-request-headers-de dominio = "*. Example.com" headers = "*" asegurar = "true" /> </ Cross-domain-policy>

Para obtener una descripción de todas las propiedades posibles, consulte la especificación de archivo de política entre dominios. Para definir una política de varios dominios para los informes basados en Flash, cree un archivo, como los anteriores en el servidor que está accediendo contiene los datos. Asegúrese de colocar el archivo crossdomain.xml en la raíz del espacio de archivos que se de ser servido. Por ejemplo, si utiliza Apache Tomcat, coloque sus archivos en las siguientes ubicaciones:

Archivo

crossdomain.xml

Datos XML (* xml)

Componente de Flash (swf *)

Ubicación

<Página web-B-tomcat-dir> /webapps/ROOT/crossdomain.xml

<Página web-B-tomcat-dir> / webapps / ROOT / <any-dir> / *. Xml

<Página web-A-tomcat-dir> / webapps / <nombreapl> / <any-dir>

163


8.9 El cifrado de las contraseñas de usuario Las contraseñas 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 contraseña está habilitada en JasperReports Server y contraseñas 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 contraseña del usuario, o cambiar el algoritmo de cifrado y especifique la clave de sal que se usa para iniciar el algoritmo de cifrado. Para configurar la contraseña de cifrado del usuario: 1. Como precaución, 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

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 documentación.

2.

3.

Ahora puede detener el servidor de aplicaciones. Usted debe salir de su base de datos en ejecución. Exporta todo el contenido del repositorio, lo que incluye los perfiles de usuario y sus contraseñas, con el siguientes comandos. Tenga en cuenta que hay dos guiones (-) Delante de las opciones de comandos:

Ventanas: cd <js-instalación> \ buildomatic js-export.bat --everything --output-dir js-backup-catálogo

Linux: cd <js-instalación> / buildomatic js-export.sh --everything --output-dir js-backup-catálogo

En la operación de exportación, las contraseñas se descifran utilizando los sistemas de cifrado de contraseña de usuario existentes y re-codificadas con la clave de cifrado de importación-exportación. Este es un cifrado independiente que asegura que las contraseñas nunca están en texto plano, incluso cuando éste se exporte. Para obtener más información, consulte "Ajuste de la-Export Import clave de cifrado" en la página 132

4. Edite las propiedades en la tabla siguiente para configurar diferentes sistemas de cifrado. Tanto el servidor como el de importaciones scripts de exportación acceder a los perfiles de usuario y deben ser configurados de manera idéntica. Realice los mismos cambios en ambos archivos: Tabla 8-1 Configuración de usuario Contraseña Encryption

Archivos de configuración

<JasperServer-pro-guerra> /WEB-INF/applicationContext-security.xml <Js-install> /buildomatic/conf_source/iePro/applicationContext-security.xml

Propiedad

allowEncoding

Frijol

passwordEncoder

Descripción

Con la configuración por defecto de verdadera, contraseñas de los usuarios son cifrada cuando se almacena. Cuando falso, contraseñas de usuario se almacenan en texto sin cifrar en JasperReports Servidor de base de datos privada. Jaspersoft no recomienda cambiar esta configuración.

164


keyInPlainText passwordEncoder Cuando verdadera, la secretkey valor se da como una llanura cadena de texto. Cuando falso, el valor es un secretkey representación numérica que puede ser analizado por Java Método Integer.decode (). Por defecto, este ajuste es falso, y la secretkey es en notación hexadecimal (0xAB).

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 representación numérica dependiendo el valor de keyInPlainText.

El nombre del algoritmo usado para procesar la llave, por por defecto Desede.

El nombre de la transformación de cifrado utilizada para cifrar contraseñas, de forma predeterminada Desede / CBC / PKCS5Padding.

secretkey passwordEncoder

secretKeyAlgorithm passwordEncoder

cifrado Transformación

passwordEncoder

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 notación hexadecimal o 24 caracteres en texto plano para el cifrado por defecto (desede / CBC / PKCS5Padding). Diferentes algoritmos esperan diferente clave longitudes. Para obtener más información, consulte Java javax.crypto documentación.

5. A continuación, deje caer su existente JasperServer base de datos, donde las contraseñas tenían la antigua codificación, y recrear un vacío JasperServer base de datos. Siga las instrucciones de su servidor de base de datos: •Caídas y Recreando la base de datos en PostgreSQL •Caídas y Recreando la base de datos en MySQL •Caídas y Recreando la base de datos en Oracle •Caídas y Recrear en la base de datos en Microsoft SQL Server Importa tus contenidos del repositorio exportados con los siguientes comandos. La operación de importación 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 contraseñas se cifran utilizando la nueva configuración de cifrado.

Tenga en cuenta que hay dos guiones (-) Delante de las opciones de comandos:

Ventanas: cd <js-instalación> \ buildomatic js-import.bat --input-dir js-backup-catálogo

6.

Linux: cd <js-instalación> / buildomatic js-import.sh --input-dir js-backup-catálogo

Durante la operación de importación, las contraseñas se descifran con la clave de cifrado de importación-exportación y vuelva a cifrada en la base de datos con la nueva configuración de cifrado de contraseña de usuario. Para obtener más información, consulte "Ajuste de la-Export Import clave de cifrado" en la página 132. 7.

8.

9.

El uso de un cliente de base de datos como la Herramienta de ardilla, comprobar el contenido de la JIUser tabla en la JasperServer base de datos y verificar que los valores de las columnas contraseña están cifrados. Reinicie el servidor de aplicaciones. Su base de datos ya debe estar en ejecución.

Acceda a JasperReports Server para verificar que el cifrado funciona correctamente durante el registro en el proceso.

165


8.9.1

1.

2.

3.

Caídas y Recreando la base de datos en PostgreSQL

Cambie el directorio a <Js-instalación> / buildomatic / install_resources / sql / postgresql.

Iniciar psql usando una cuenta de administrador como postgres:

psql -U postgres

La caída de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema:

caer JasperServer base de datos; crear base de datos de codificación JasperServer = 'utf8'; \ C JasperServer \ I js-pro-create.ddl \ I quartz.ddl

8.9.2

1.

2.

3.

Caídas y Recreando la base de datos en MySQL

Cambie el directorio a <Js-instalación> / buildomatic / install_resources / sql / mysql.

Acceda a su cliente de MySQL:

mysql-u root-p

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

1.

2.

3.

Caídas y Recreando la base de datos en Oracle

Cambie el directorio a <Js-instalación> / buildomatic / install_resources / sql / oracle.

Acceda a su cliente SQLPlus, por ejemplo:

sqlplus sys / sys as sysdba

La caída de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema:

SQL> SQL> SQL> SQL> SQL>

caer JasperServer usuario cascada; crear JasperServer usuario identificado por contraseña; conectar JasperServer / contraseña @ Js-pro-create.ddl @ Quartz.ddl

8.9.4

1.

2.

Caídas y Recrear en la base de datos en Microsoft SQL Server

Cambie el directorio a <Js-instalación> / buildomatic / install_resources / sql / sqlserver.

La caída de la JasperServer base de datos, crear uno nuevo y cargar el JasperServer esquema por medio de la Utilidad sqlcmd:

166


cd <js-instalación> \ 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 sesión de usuario Inicio de sesión De 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, también conocido como HTTPS. Habilitación de HTTPS, tal como se documenta en la JasperReports última guía Server, requiere un certificado y una configuración 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 contraseñas, aparecen sin cifrar en el tráfico de red. Dado que las contraseñas nunca deben ser visibles, JasperReports Server proporciona un mecanismo independiente para la encriptación de los valores de contraseña sin utilizar HTTPS. El mecanismo de cifrado se utiliza en la siguiente casos:

• •

•

Las contraseñas enviadas desde la página de acceso. Las contraseñas enviadas desde el cuadro de diálogo de cambio de contraseña (véase "Opciones de contraseña Configuración de usuario" en la página 150). Las contraseñas enviadas desde las páginas de administración de usuarios por un administrador.

Cuando un navegador solicita una de estas páginas, el servidor genera un par de claves pública-privada y envía el público clave junto con la página. Una JavaScript en la página solicitada cifra la contraseña cuando los mensajes de los usuarios a la servidor. Mientras tanto, el servidor guarda su clave privada y la utiliza para descifrar la contraseña cuando llega. Después descifrar la contraseña, el servidor continúa con los métodos usuales de autentificación.

Cifrado de sesión no es compatible con la memoria contraseña en el navegador. Con independencia de la función de autocompletar configuración se describe en la sección "Configuración de Memoria contraseña "en la página 151, el código JavaScript que implementa cifrado de sesión despeja el campo de la contraseña antes de enviar la página. Como resultado, la mayoría de los navegadores nunca se aviso para recordar la contraseña cifrada. La desventaja de cifrado de inicio de sesión es el procesamiento adicional y la complejidad añadida de los servicios web de inicio de sesión. Por compatibilidad con versiones anteriores, el cifrado de inicio de sesión está desactivado por defecto. Para habilitar el c ifrado de inicio de sesión, establezca la siguientes propiedades. Después de hacer los cambios, vuelva a implementar la webapp JasperReports Server o reiniciar el servidor de aplicaciones.

Si el cifrado de inicio de sesión está habilitada, los servicios web y los parámetros de URL también deben enviar encriptado contraseñas. Las aplicaciones deben obtener primero la clave del servidor y luego cifrar la contraseña antes de enviarlo. Consulte la Guía de Servicios Web JasperReports Servidor y JasperReports Servidor último Guía, respectivamente.

167


Entrar Encryption



Propiedad

encryption.on

Valor

truefalse <Default>

Descripción

Activa el cifrado de inicio de sesión o desactivar. El cifrado es desactivada de forma predeterminada. Cualquier otro valor además de casos insensible "false" es equivalente a verdadero. Algoritmo de cifrado; Actualmente, sólo el RSA es apoyado.

La longitud de las claves de cifrado generadas. Esto afecta a la fuerza de cifrado y la longitud de la cadena cifrada.

Cuando es verdadero, una clave se generará por cada solicitud única. Cuando es false, la clave será generada una vez por instalación de la aplicación. Vea las descripciones en Dinámica de clave de encriptación y Estática clave de cifrado a continuación.

encryption.type RSA <Default>

encryption.key.length potencia entera de 2 1024 <Default>

encryption.dynamic.key cierto <Default> falsa

Cifrado tiene dos modos, dinámicas y estáticas, tal como se determina por el encryption.dynamic.key parámetro. Estos modos proporcionan diferentes niveles de seguridad y se describen adicionalmente en las siguientes secciones.

8.10.1 Dinámica de clave de encriptación

La ventaja de la encriptación de la contraseña al iniciar sesión es para evitar que sea visto, sino también para evitar que se que se utiliza. Para el cifrado de contraseñas para lograr esto, la contraseña debe estar encriptada de manera diferente cada vez que se enviado. Con el cifrado de clave dinámico, el servidor utiliza un nuevo par de claves pública y privada con cada solicitud de inicio de sesión. Cada vez que alguien inicia una sesión, el servidor genera un nuevo par de claves y envía la nueva clave pública al JavaScript en la página que envía la contraseña. Esto asegura que la contraseña cifrada es diferente cada vez que se envía, y un potencial atacante no será capaz de robar la contraseña cifrada para acceder o enviar una solicitud diferente.

Debido a que es más seguro, cifrado de clave dinámico es el valor por defecto cuando se activa la codificación. El desventaja de claves dinámicas es que la generación de claves se ralentiza cada inicio de sesión, aunque no es generalmente visible para usuarios. Otro efecto de cifrado de clave dinámico es que no permite recordar las contraseñas en el navegador. Si bien esto puede ser un inconveniente, en realidad es más seguro para no almacenar las contraseñas en el navegador (donde que pueden verse comprometidos) y requieren teclear la contraseña para cada inicio de sesión (porque las computadoras pueden ser robado). Ver "Configuración de Memoria contraseña" en la página 151.

8.10.2 Estática clave de cifrado

Si no se desea el cifrado de clave dinámico, JasperReports Server también admite el cifrado de clave estática. En este caso, una par de claves único es generado automáticamente en el primer inicio de sesión del usuario y sigue siendo el mismo para todo el servidor

168


instalación. Debido a que la clave es siempre el mismo, el valor cifrado de la contraseña de un usuario es siempre el mismo. Esto significa que un atacante podría robar la contraseña cifrada y utilizarlo para acceder al servidor.

Cifrado de clave estática es muy inseguro y sólo se recomienda para la instalación del servidor de intranet donde el tráfico de la red es más protegido. La única ventaja de cifrado estática sobre ningún cifrado en absoluto es que contraseñas no pueden ser descifrados y se utilizan para atacar otros sistemas en los que los usuarios puedan tener la misma contraseña. Antes de configurar encryption.dynamic.key = false utilizar el cifrado estática, también debe configurar el seguro archivo llamado almacén de claves, donde se mantiene el par de claves. Asegúrese de personalizar los parámetros de almacén de claves que figuran en el siguiente tabla para hacer que su archivo de almacén más único y seguro.

Por razones de seguridad, siempre cambiar las contraseñas del almacén de claves por defecto inmediatamente después de instalar el servidor.

Configuración del almacén de claves (cuando encryption.dynamic.key = false)



Propiedad

keystore.location

Valor

keystore.jks <Default>

Descripción

Ruta de acceso y nombre del archivo de almacén de claves. Este parámetro es una ruta absoluta o un archivo en la ruta de clase webapp, por ejemplo <Tomcat> / webapps / JasperServer-pro / WEB- INF / classes>. Por defecto, el archivo es keystore.jks se entrega con el servidor y no contiene ninguna tecla.

Contraseña para el archivo de almacén de claves conjunto. Este contraseña se utiliza para verificar la integridad del almacén de claves. Nombre por el que se recupera la clave única de almacén 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 almacén de claves.

Contraseña para la clave cuyo alias se especifica por keystore.key.alias.

keystore.password jasper123 <Default>

keystore.key.alias jaspe <Default>

keystore.key.password jasper321 <Default>

Al cambiar el alias de clave, no se eliminará la vieja llave; que puede ser utilizado de nuevo restableciendo el seudónimo de claves. Además, una vez clave ha sido creado con una contraseña, no podrá cambiar la contraseña a través del almacén de claves configuración. Para eliminar las claves o cambiar una contraseña de almacén de claves, el administrador del servidor debe utilizar el Java keytool.exe utilidad en el directorio bin del JRE o JDK. Si cambia la contraseña del almacén de claves o la tecla contraseña, la configuración de almacén de claves anterior debe reflejar los nuevos valores o de inicio de sesión fallará para todos los usuarios.

169


170

CAPÍTULO 9 CONFIGURACIÓN DEL SISTEMA

Puede cambiar el comportamiento predeterminado de JasperReports servidor editando la configuración del sistema. El configuración se define por un conjunto de propiedades y sus valores. Las propiedades de configuración se almacenan en dos lugares: • Todas las propiedades se almacenan en archivos de configuración ubicados en varias carpetas bajo las <js-install>

directorio, que es la raíz de la instalación JasperReports Server. Para cambiar la configuración, puede editar estos archivos y luego reiniciar el servidor. Algunas de las propiedades editado más comunes están disponibles para el administrador de sistema a través 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 después de reiniciar el servidor (en la versión 5.0).

•

En este capítulo se describe un subconjunto de las propiedades en los archivos de configuración. Los ajustes que afectan a la seguridad cubierto en "Seguridad de aplicaciones" en la página 145. Configuración de la función de auditoría está cubierta en "Configuración de Auditoría y Supervisión" en la página 223. Más opciones se describen en la JasperReports Servidor Guía de instalación.

Debido a la ubicación de los archivos que se describen en este capítulo varían con el servidor de aplicaciones, las rutas especificadas en este capítulo son en relación con el archivo WAR desplegado para la aplicación. 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 ubicación 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 capítulo. Cambios involuntarios pueden provocar errores inesperados en todo JasperReports Server que puede ser difícil de solucionar. Antes de cambiar los archivos, copia de seguridad en un lugar fuera de la instalación de JasperReports Server.

No modifique la configuración que no se describen en la documentación. A pesar de que algunos ajustes puede Parece sencillo, valores distinto al predeterminado puede no funcionar correctamente y causar errores.


Además de la configuración descrita en este capítulo, también 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 información sobre cómo desplegar el portlet, consulte la documentación en el paquete de descarga de portlets.

171



• • • • • • • • • • • • •

Ajustes de configuración en la interfaz de usuario Configuración para el uso de proxies Configuración para la persistencia de sesión Configuración Ad Hoc Habilitación de datos instantáneas Configuración de registros del sistema Configuración de servicios Web de Amazon Configuración de los dominios Configuración de JasperReports Biblioteca Configuración del funcionamiento del control de entrada Configuración del Programador Configuración del latido del corazón Configuración de la Ayuda en línea

9.1 Ajustes de configuración en la interfaz de usuario

Desde la versión 5.0, los cambios en los ajustes de configuración en las interfaces de usuario JasperReports Server son persistentes a través de los reinicios del servidor. Anteriormente, los cambios en la configuración de la interfaz de usuario no se guardan, y al reiniciar, ajustes de configuración se revertirá a los valores almacenados en los archivos de configuración. Para realizar cambios de configuración persistentes a través de la interfaz de usuario del servidor JasperReports: 1. Inicie la sesión como administrador del sistema (superusuario por defecto).

2. Seleccione Administrar> Configuración del servidor:

3. Seleccione una categoría de ajustes o acciones de administrador desde el panel izquierdo de la Configuración:

172


Figura 9-1 La interfaz de usuario para los valores de configuración

4. Encontrar el ajuste que desea cambiar y editar su valor de configuración. 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 configuración individual. Estos ajustes y acciones de los administradores están documentados en sus respectivas secciones:

Ajustes

Configuración del registro Ad Hoc Ajustes

Ad Hoc caché

Configuración OLAP

Configuración de AWS

Importación

Exportación

Documentación

"Configuración de registros del sistema" en la página 192 "Ajustes de consulta ad hoc" en la página 178

"Ad Hoc administración del caché" en la página 184

Guía del usuario de Jaspersoft OLAP

"Configuración de Amazon Web Services" en la página 197

"Importación desde la interfaz de usuario de configuración" en la página 135 "Exportación desde la interfaz de usuario de configuración" en la página 134

Al ver o modificar los valores de configuración que aparecen en la interfaz de usuario (Ajustes del registro, Ad Hoc Ajustes y Configuración OLAP), tener en cuenta las siguientes pautas:

•

•

Las páginas de configuración de la pantalla de un subconjunto de las opciones de configuración que están disponibles en los archivos de configuración. Por lo tanto, también existen todos los ajustes en la interfaz de usuario en un archivo de configuración. Por defecto, las páginas de configuración de la pantalla los valores de configuración que existen en la configuración correspondiente presentar. Si modifica los archivos y reiniciar el servidor, la nueva configuración de archivos tengan efecto en el servidor y son visible en la interfaz de usuario.

173


• Cuando se cambia un valor en las páginas de configuración, la nueva configuración surta efecto inmediatamente, pero el nuevo valor es no escrito en el archivo de configuración 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 raíz del repositorio y sólo es visible para el administrador de sistema (superusuario).

Propiedades Figura 9-2 El Sistema Folder Visible a Sistema de administradores

Sólo los ajustes de configuración que tienen un valor modificado en las páginas de configuración 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 configuración. Sin embargo, cada ajuste es independiente, por lo que un valor que no se haya modificado la interfaz de usuario de configuración se lee desde el archivo correspondiente. Las páginas de configuración de la pantalla los valores de configuración que están en vigor en el servidor. Por lo tanto, ajustes en el GlobalPropertiesList aparece en las páginas de configuración en el que se pueden cambiar de nuevo si es necesario.

Tenga en cuenta que los valores de configuración que aparecen en las páginas de configuración son posiblemente una mezcla de valores cargados desde los archivos de configuración y de la GlobalPropertiesList persistente.

• Haga clic con el GlobalPropertiesList y seleccione Editar para ver los valores de configuración 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 configuración en su lugar, haga clic en Retire junto a ese ajuste y a continuación, reinicie el servidor. De lo contrario, Jaspersoft no recomienda modificar esta lista de valores directamente.

174


Figura 9-3 El GlobalPropertiesList contiene los valores de configuración persistentes

•

•

El GlobalPropertiesList también incluye controladores JDBC configurados durante la instalación oa través de los datos asistente de creación de fuente. Para obtener más información, consulte "Gestión de Controladores JDBC" en la página 68. El almacenamiento de los valores de configuración en el GlobalPropertiesList en el repositorio permite exportarlos a los servidores o los re-importación diferente después de una actualización del servidor. Para obtener más información, consulte "Importación desde la Configuración de la interfaz de usuario "en la página 135,

9.2 Configuración para el uso de proxies

Al configurar JasperReports Server para utilizar un servidor proxy, hay dos configuraciones adicionales para que en el configuración del servidor. JasperReports servidor expone algunas URLs a sí mismo a través de la interfaz de usuario y al usar el planificador para enviar mensajes de correo electrónico. 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.

Configuración para el uso de proxies



175


Configuración para el uso de proxies

Propiedad

deploy.base.url

Descripción

Establezca esta propiedad en la dirección URL completa para la exposición de la JasperReports ServerUI a través del proxy. Esta URL debe incluir el nombre de la aplicación, por ejemplo: http://bi.example.com/jasperserver-pro


... / WEB-INF / js.quartz.properties

Propiedad

report.scheduler.web.deployment.uri

Descripción

Esta es la URL base utilizada por el planificador de generar enlaces a los informes en los correos electrónicos. Establezca esta propiedad la dirección URL completa, incluyendo nombre de la aplicación, que exponer a través de su proxy. Debe ser el mismo que deploy.base.url.

9.3 Configuración para la persistencia de sesión

Muchos servidores de aplicaciones tienen la capacidad de almacenar las sesiones de usuario, mientras que una aplicación web está en línea, por ejemplo, cuando cambiar los archivos de configuración JasperReports Server. El servidor de aplicaciones se acuerda de toda la información acerca de un usuario de sesión, como el identificador de sesión y en qué página se está viendo, y cuando se reinicia la aplicación web, el usuario sesión 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 redistribución de una aplicación web en el servidor de aplicaciones, sólo al reiniciar la aplicación web.

JasperReports Server es compatible con una forma limitada de persistencia de sesiones. Cuando la persistencia de sesión 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 visualización de contenido de la carpeta. Buscando el repositorio, incluyendo todos los filtros de búsqueda y resultados. Diálogo de permisos del repositorio, incluyendo el estado y las selecciones. Cuadro de diálogo Agregar carpeta. Añadir diálogos de recursos, incluyendo la adición o edición de una fuente de datos, JasperReport, y otros objetos del repositorio. Copiar, cortar y pegar los recursos en el repositorio. Programación de un informe que incluya toda la información como un calendario y notificaciones.

Si el servidor no está disponible cuando se usan las páginas o cuadros de diálogo anterior, el usuario verá una pausa sólo cuando realizar una acción en estas páginas, como por ejemplo la presentación. Cuando el servidor ha terminado de reiniciarse, el usuario puede continuar interactuando con estas páginas o cuadros de diálogo. Si el usuario no realiza ninguna acción mientras el servidor está disponible, que ni siquiera puede notar que hubo un fracaso. Sin embargo, para otros diálogos interactivos en JasperReports Server, el Estado es demasiado grande como para almacenar en la sesión del usuario. Las siguientes funciones no son compatibles con la persistencia de sesión:

176


•

•

•

•

•

•

Ad Hoc editor - El estado del diseño 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. Diseñador 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 clasificación y filtrado no puede ser salvos, por lo que se pierden los cambios no guardados. Diseñador 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 expresión MDX actual no puede ser restaurado, por lo que cualquier tendrían que ser creado de nuevo los cambios no guardados. Diálogos de administración (al crear o editar una organización, un usuario o rol) - La información introducida en un diálogo de administración 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 sesión, el servidor muestra un mensaje acerca de la sesión que no pudo ser totalmente restaurada, y el servidor redirige al usuario a la página principal. El usuario debe relanzar la característica interactiva y volver a crear cualquier trabajo no guardado.

Persistencia de sesiones también afecta a las llamadas de servicio web. La API REST apoya un inicio de sesión para almacenar un ID de sesión, y con persistencia permitido, que identificador de sesión seguirá siendo válida cuando se reinicia el servidor de aplicaciones. Esto simplifica el código que necesitan para manejar los tiempos de espera. En general, las llamadas de servicio web no apoyan el trabajo interactivo, como el diseño de una vista especial, un tablero de instrumentos, un dominio, o explorar los datos en OLAP, para que no sean afectados por la falta de persistencia de sesiones en esos casos. Sin embargo, las llamadas de servicio web se ven afectados en el siguiente caso:

• Informe de ejecución - Todos API asíncrona exige correr y exportación de informes se basan en la gran Objeto JasperPrint que no puede persistir. Cuando el servidor se reinicia, las llamadas asincrónicas volverán errores porque los informes no se pudieron guardar en la sesión. Su aplicación debe detectar este error y incluir el código para volver a ejecutar el informe.

JasperReports Server también soporta la replicación de sesión entre varias instancias del servidor en un cluster. Sin embargo, la repetición de sesiones tiene las mismas limitaciones, ya que se basa en la persistencia de sesiones. Para obtener más información, consulte la Ultimate Guide servidor JasperReports.

El siguiente procedimiento muestra la configuración en JasperReports Server y la aplicación Apache Tomcat servidor para habilitar la persistencia de sesiones. Para otros servidores de aplicaciones, consulte la documentación de ese servidor.

Para configurar JasperReports Server y Apache Tomcat para la persistencia de sesión: 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 asignación correspondiente para la ClusterFilter y elimine también. También 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. Añadir la siguiente propiedad a su entorno JVM:

-Dorg.apache.catalina.session.StandardSession.ACTIVITY_CHECK = True

4. Reinicie el servidor de aplicaciones Apache Tomcat.

9.4 Configuración Ad Hoc

Ad Hoc funcionalidad sólo está disponible para los usuarios de la edición 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 configuración ad hoc y caché. En esta sección se tratan los siguientes aspectos a configurar Ad Hoc:

• • • • • • •

Ad hoc Ad hoc Ad hoc Ad hoc Ad hoc Ad hoc Ad hoc

Configuración de la consulta Políticas de datos Políticas de datos para Big Data Plantillas de informe y Generadores Archivo de configuración Administración del caché Configuración de filtros OLAP

9.4.1 Ad Hoc Configuración 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 Guía del usuario de Jaspersoft OLAP.

Los ajustes ad hoc incluye lo siguiente:

• Configuración general para modificar la interfaz de usuario Ad Hoc editor: •Configurar Vista Consulta. Determina si los usuarios pueden ver un botón 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 Gestión de caché "en la página 184). •Visualizar Null como Zero. Determina la aparición de valores nulos en tablas de referencias cruzadas y gráficos de series de tiempo. Por De forma predeterminada, esta opción está deshabilitada y los valores nulos se muestran como celda vacía de referencias cruzadas o desaparecidos

178


•

•

puntos en los gráficos 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 gráficos. Límites de la consulta para preservar los recursos utilizados por las consultas cuando visitas Ad Hoc se diseñan y ejecutan: •Especial Filtro de lista de valores límite de filas. El número máximo 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 límite se excede cuando los usuarios definir filtros, JasperReports Server muestra un mensaje en ese sentido. Ajuste a un valor más bajo puede mejorar el rendimiento. •Especial Límite fila del conjunto de datos. El número máximo 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 límite es alcanzado. Ajuste a un número inferior puede mejorar el rendimiento, pero sus informes puede no reflejar el conjunto de datos. •Especial Tiempo de espera de consulta. El número 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 número inferior puede prevenir excepciones cuando los usuarios ejecutan Ad Hoc vistas. Ajuste a un número mayor puede prevenir los cálculos complejos de tiempo de espera, pero puede usar más conexiones de base de datos. Políticas de datos que determinan cómo JasperReports Server maneja la carga de datos y el procesamiento de ciertos tipos Ad Hoc de visitas. Ver Ad Hoc Políticas de datos en la siguiente sección.

Para configurar los ajustes de consultas ad hoc: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2. 3.

4.

Seleccione Administrar> Configuración del servidor y seleccione Ad Hoc Ajustes en el panel de la izquierda. Establezca los valores de configuración como se describe anteriormente. 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 versión 5.0, Ad Hoc ajustes realizados a través de la interfaz de usuario son persistentes, incluso si se reinicia el servidor. Para obtener más información, consulte "Ajustes de configuración en la interfaz de usuario" en la página 172.

9.4.2 Ad Hoc Políticas de datos

Instantáneas de datos, descritos en Datos Snapshots y habilitación Datos Snapshots, aplicará únicamente a los informes aparece en el visor de informes. Esta sección cubre las políticas de datos que sólo se aplican a las vistas en el Ad Hoc Editor.

Políticas de datos determinan cómo los datos están en caché y donde se producen determinados cálculos. 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. Políticas 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 sólo 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 sólo 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 también 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 visualización 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 verificación, el servidor carga todo el conjunto de campos que tengan relación con un tema o dominio en la memoria, y luego aplica los cálculos necesarios, agrupación, clasificación y agregación. Este es también 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 tamaño y la complejidad de sus informes. Informes con campos calculados, clasificación costosa, agrupación o

agregación 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 número de usuarios de la edición y ejecución de Ad Hoc visitas. Si usted tiene un gran número de usuarios que crean y correr Ad Hoc vistas, el rendimiento puede ser mejor cuando el servidor optimiza las consultas. Implementaciones con un menor número de usuarios puede funcionar mejor cuando las opciones están desactivadas. Las características de rendimiento de la fuente de datos. Si la base de datos u otro origen de datos está ajustada para máximo 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 generaría. La cantidad de memoria asignada a la máquina virtual Java de JasperReports Server (JVM). Si la JVM del servidor de aplicaciones que aloja JasperReports Server se asigna un montón 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 desactivación de la configuración, abrir y guardar algunos informes representativos, y probar su rendimiento. Si el el rendimiento mejora, deje la configuración discapacitados y abrir y guardar los informes restantes.

Las políticas 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 agregación 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 agregación 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 política de datos para un informe existente, seleccione el ajuste de la política apropiada, abrir la vista correspondiente en el Editor Ad Hoc, y guardar el informe de nuevo.

•

Para configurar las políticas de datos de anuncio: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2.

3.

Seleccione Administrar> Configuración del servidor y seleccione Ad Hoc Ajustes en el panel de la izquierda. 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 versión 5.0, Ad Hoc ajustes realizados a través de la interfaz de usuario son persistentes, incluso si se reinicia el servidor. Para obtener más información, consulte "Ajustes de configuración en la interfaz de usuario" en la página 172.

9.4.3 Ad Hoc Políticas 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 visualización de sus datos mediante la solicitud de distinta contar cálculos de la fuente de datos, en contraposición a la realización de los cálculos en la memoria. Servidores de bases de datos por lo general están optimizados para estos cálculos, lo que mejora el rendimiento general del Editor Ad Hoc.

Especial para Big Data


... / WEB-INF / applicationContext-adhoc.xml

Propiedad

CalcMethod

Frijol

Distinto Cuente

Descripción

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.

Después de hacer este cambio, vuelva a implementar la aplicación web JasperReports Server o reiniciar el servidor de aplicaciones. Realización de los agregados de recuento diferente en la base de datos sólo 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 ningún 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 cálculos 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 más información sobre la interfaz de plantilla de informe, consulte la Guía del usuario de JasperReports Server. En esta sección se explica cómo 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 línea visualización y no restringir el tamaño de los contenidos para la impresión. Para configurar una plantilla diferente, modifique el siguiente propiedad:

Por defecto Plantilla Especial



Propiedad

defaultTemplateUri

Frijol

util: mapa id = "informe Generador DefaultConf "

Descripción

Especifique la ruta al repositorio de su nuevo default plantilla. Asegúrese 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 Modificación de la Plantilla Ad Hoc Carpetas

Plantillas ad hoc deben ser subidos a carpetas específicas en el repositorio. Las carpetas predeterminadas son / templates (en cada organización) y / public / templates. Para establecer diferentes carpetas, modificar la siguiente propiedad:

Especial Carpetas Plantilla



Propiedad

templateURIParent SQLPatternList

Frijol

adhocEngine Servicio

Descripción

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, asegúrese de actualizar la definición del defecto Ad Hoc plantilla como se describe en la sección anterior.

Además, las plantillas de organización incluyen la carpeta adhoc / templates para que aparezca en cada nueva organización. Usted debe actualizar todas las plantillas de la organización si se cambia o elimina el valor% / templates. Para obtener más información, consulte "Carpetas predeterminadas para las Organizaciones" en la página 28.

9.4.4.3 Adición 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.

2.

3.

Compile la clase y colocar el archivo JAR resultante en <js-webapp> / WEB-INF / lib.

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:

182


<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 añadir una etiqueta de interfaz de usuario para su generador personalizado. La clave tiene la forma ADH_REPORT_GENERATOR_ <generador-id>. Añadir 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. Reinicie el servidor o volver a implementar la aplicación 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.

9.4.5 Ad Hoc del archivo de configuración

Las siguientes propiedades se encuentran entre los que se puede configurar en el directorio WEB-INF / applicationContext- archivo adhoc.xml: Tabla 9-1 Propiedades configurables en WEB-INF / applicationContext-adhoc.xml

Propiedad

JrxmlScriptURI

Descripción

La ubicación 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.

Las ubicaciones de repositorio donde Temas deben residir. Los valores predeterminados son / Adhoc / temas y / / adhoc / temas públicos.

realmsURI y realmsURIParent SQLPatternList

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

aruFolder

Descripción

La ubicación 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 específicamente para contenido del usuario, especifique esta carpeta; Por ejemplo, / userviews. La ubicación del repositorio donde JasperReports Server guarda los informes creados a partir de Ad Hoc vistas. El valor predeterminado es / temp relativo a la raíz 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 automática, pero los archivos pueden acumularse en ciertos casos. Como parte de mantenimiento regular, debe eliminar periódicamente los archivos de estas carpetas.

tempFolderName

maxSafeGroupMembers El número máximo 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 confirmación. Este límite es una salvaguarda para evitar problemas de rendimiento al agrupar un campo con demasiados valores. El predeterminado es 100 Set nivel más alto para permitir que más grupos aparezcan sin preguntar usuarios.

Esta propiedad se encuentra en el actualSizeReportGenerator frijol. Con el configuración 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 histórico). 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 añade fila adicional por debajo de los encabezados de columna para el espaciamiento.

createColumn CrosstabHeaders

Las ubicaciones URI del repositorio son en relación con todos y cada organización en la instancia del servidor. Para ejemplo, para un usuario de la organización predeterminada, la URI / adhoc en realidad se refiere a / Organizaciones / organization_1 / adhoc.

9.4.6 Ad Hoc administración 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 comparación de las dos cachés, consulte "La comparación con Jaspersoft OLAP caché" en la página 188. Para obtener instrucciones sobre ajuste de la caché OLAP, consulte la Guía del usuario de Jaspersoft OLAP.

JasperReports Server puede caché temporalmente ad hoc conjuntos de resultados de la consulta para su reutilización. 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 la propia consulta, la fuente de datos URI, y los parámetros utilizados cuando se emitió la consulta. El almacenamiento en caché reduce las cargas de bases de datos y entrega conjuntos de datos para el usuario utiliza con frecuencia-rápidamente. El almacenamiento en caché se aplica cuando informes se crean, así como cuando se ejecutan. JasperReports Server versión 5.0 introduce una nueva caché

184


aplicación llamada Ehcache que permite al administrador ver la caché de tamaño de memoria de entrada y establecer límites 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 parámetro 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 través de los usuarios editando el / WEB- Archivo / applicationContext-datarator.xml INF. El siguiente código configura el cacheKeyInterceptor frijol ignorar las credenciales de los usuarios registrados cuando la creación de las claves de caché:

<Nombre de propiedad = "ignoredParameters"> <Lista> ... <Valor> LoggedInUser </ value> <Valor> LoggedInUserName </ value> </ List> </ Propiedad>

Reinicie JasperReports Server después de guardar el archivo modificado.

9.4.6.2 Configuración de la caché

El almacenamiento en caché mejora el rendimiento general de la recuperación de datos y la clasificación, 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 automáticamente los conjuntos de datos periódicamente. Por defecto, los conjuntos de datos se eliminan de la memoria caché si no se accede durante 30 minutos. Ellos son También despejado después de 90 minutos, independientemente de la forma en que se accedió recientemente. Para configurar la frecuencia con la que la memoria caché se borra automáticamente, edite el archivo de configuración siguiente:

Ad Hoc de caducidad de caché


... / WEB-INF / adhoc-ehcache.xml

Propiedad

maxBytesLocalHeap


300m

Descripción

El uso de memoria máximo de toda la memoria caché, por por defecto 300 MB. Uso kpara kilobytes, mpara megabytes, y gpara gigabytes.

Si se deja sin límites, la caché Ad Hoc puede utilizar todo memoria disponible en su JVM. Establezca este valor de acuerdo la memoria disponible de su servidor, el tamaño de su conjuntos de datos, y el número de entradas de caché que esperas basado en el uso concurrente Ad Hoc y los ajustes de tiempo a continuación. Jaspersoft recomienda establecer este valor a cerca de mitad del tamaño máximo del montón que ha configurado para el JVM (ajuste -Xmx).

185


Ad Hoc de caducidad de caché

timeToIdleSeconds 1800 El número de segundos de espera después 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 ningún límite.

El tiempo máximo que un conjunto de datos se almacena en la memoria caché, incluso si se está accediendo repetidamente. Asegura que rancio datos se reemplazan periódicamente. El valor predeterminado es equivalente a 90 minutos. Utilice 0 (cero) para ningún límite.

timeToLiveSeconds 5400

Reinicie JasperReports Server después de modificar estos valores.

9.4.6.3 Borrar manualmente el caché

Los administradores también pueden utilizar la interfaz de servidor para ver las consultas cuyos conjuntos de datos están en la memoria caché. Los administradores pueden ver la consulta completa, pero nunca el contenido del conjunto de datos. La página Hoc Ad caché también pantallas RENDIMIENTO Los datos sobre cada consulta. Esta información puede ser útil cuando se trata de resolver problemas de rendimiento cuestiones. La interfaz muestra varios valores para cada consulta: • •

•

•

Edad (min: seg) - Tiempo desde el conjunto de datos se almacenan primero en la caché. Query (ms) - Tiempo en milisegundos a partir de 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) - Tamaño en megabytes del conjunto de datos resultante se almacena en la entrada de la caché.

La página Hoc Ad caché también permite a los administradores para eliminar manualmente los conjuntos de datos si es necesario. Extracción de una conjunto de datos de la caché de fuerza al servidor a obtener nuevos datos la próxima 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 sesión como administrador del sistema (superusuario por defecto). 2. Haga clic en Administrar> Configuración del servidor y seleccione Ad Hoc caché en el panel de la

izquierda. Aparece la página 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 Administración Web

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 diseño del Dominio y las selecciones del usuario en el cuadro de diálogo Data Selector. El Ad Hoc Página Caché sólo muestra las primeras líneas de una consulta, así como el origen de datos. 3.

4.

5.

6.

Para eliminar todos los conjuntos de datos, haga clic en Borrar todo en la parte inferior de la página de Ad Hoc caché. Esto también borra la Teiid caché utilizado por las fuentes de datos virtuales, incluyendo una fuente de datos virtual que envuelve una fuente de datos para los datos grandes. Para eliminar un conjunto de datos específicos de la caché, y haga clic en Claro junto a la consulta correspondiente. Para encontrar una entrada de caché específico, puede cambiar la clasificación 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 específica, incluyendo la cadena de consulta completa, haga clic en la propia consulta en el Query & Columna de origen. Aparecerá la página de detalles, que muestra información adicional para la consulta seleccionada, tales como el número de filas en el conjunto de datos en caché.

187


Figura 9-5 Conjunto de datos típico en Ad Hoc caché

9.4.6.4 Comparación con Jaspersoft OLAP caché

En la siguiente tabla se contrastan las características 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

Estructura de caché

JasperReports Servidor

Cachés de Resultados se llevan a cabo en la consulta nivel: texto de la consulta y el lenguaje, además de los datos URI de origen y los parámetros de consulta.

No por defecto, pero se puede habilitar como descrito en Configuración de la caché Granularidad, anteriormente.

Jaspersoft OLAP

Cachés de Resultados se llevan a cabo en el análisis nivel de conexión: esquema de base de datos más conexión.

Sólo hay una caché; se comparte a través de todas las consultas y los usuarios.

Compartir

Seguridad

Poblar

Aplicado a la caché de control de manera que los usuarios no se les permite ver los datos privilegiados. Consultas pueblan la memoria caché. También puede programar informes para rellenar previamente la memoria caché fuera de las horas.

Limitado por la memoria JVM disponibles (montón). No configurable.

Se está quedando sin memoria es inusual. Sólo puede ocurrir si una sola consulta devuelve demasiados elementos para la memoria disponible. El informe de falla con un error de falta de memoria.

Tamaño

188


Caché de funciones

De tiempo automático política de caché basado


Configurable, como se describe en Configuración de la caché anteriormente.

Jaspersoft OLAP

En situaciones de poca memoria, elementos almacenados en caché son eliminado automáticamente por JVM basura colección; los artículos usados menos recientemente-son limpiado primero. No hay manera de eliminar de datos basado en el tiempo que ha estado en memoria.

Regiones de caché pueden ser definidas y borran programación con API.

Clearing seleccionado conjuntos de datos de forma manual

Configurable, como se describe en sección manualmente Borrar la caché anteriormente.

Configurable, como se describe en Manualmente Borrar la caché anteriormente.

Borrado de toda conjuntos de datos de forma manual

En JasperReports Server, seleccione Gestionar> Configuración del servidor, a continuación, seleccione OLAP Ajustes y haga clic en Flush caché OLAP. Para métodos adicionales, ver la Jaspersoft Ultimate Guide OLAP.

9.4.6.5 Desactivación de la Ad Hoc caché

Desactivación sea caché es una configuración de todo el servidor que se aplica a todas las fuentes de datos o conexiones utilizadas en cualquier Ad Hoc vista. Asegúrese de que otros puntos de vista no se ven afectados negativamente por este cambio.

Hay dos razones para considerar la desactivación de la caché Ad Hoc:

•

•

Usted tiene una base de datos de alto rendimiento que devuelve resultados tan rápido 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 información 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 "Configuración de la caché" en la página 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> Configuración del servidor> Configuración OLAP página. Para obtener más información, consulte la Guía del usuario de Jaspersoft OLAP.

Además, 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 Configuración 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 límite en el número de artículos en un filtro. De forma predeterminada, el límite es de 250 posibles valores.

189


Si sus filtros llegan a este límite y su lista de valores se trunca, primero debe considerar el uso de un filtro diferente operación. Por ejemplo, en lugar de "la ciudad es una de <lista>," uso "de la ciudad comienza con <letra>." Si usted todavía tiene que cambiar este límite, modifique la siguiente propiedad:

Especial Límite Filtro OLAP


... / WEB-INF / applicationContext-adhoc-dataStrategy.xml

Propiedad

maxFilterValues

Frijol

mdxDataStrategy

Descripción

Establezca el valor en el número máximo de filtro que valora esperar. Al establecer este valor más alto que el valor por defecto de 250 puede causar problemas de rendimiento.

9.5 Habilitación de datos instantáneas

La función de instantánea de datos se introdujo en JasperReports Server versión 4.7 a los datos del informe en el servidor de la tienda. Instantáneas de datos crean un cambio significativo en la experiencia del usuario: • Sin instantáneas de datos - Cada vez que el usuario ejecuta un informe, el servidor consulta la fuente de datos y muestra el

datos más 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 liberación 4.7. Con instantáneas 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 más adelante ver los datos de la instantánea guardada, no de consultar el origen de datos. Los informes que se accede a través de las API de servicios web también se basan en el salvado instantánea. Para informes grandes o informes que ve frecuentemente, la instantánea PERSISTED proporciona una significativa ganancia en el rendimiento y reduce la carga en los orígenes de datos. Cada usuario que tenga acceso al informe verá los datos de la misma instantánea. Para los usuarios que así lo requieran, el visor de informes proporciona un botón de forma manual actualizar la instantánea de datos en cualquier momento. Además, cuando el planificador ejecuta un trabajo en un informe que siempre actualiza la instantánea. Instantáneas de datos se implementan en JasperReports Servidor 4.7, pero deben estar habilitadas manualmente.

Si usted tiene una nueva instalación de JasperReports Server, a continuación, habilitar instantáneas para obtener el servidor completo funcionalidad. En el futuro, las instantáneas de datos persistentes pueden ser activadas por defecto. Si está actualizando desde una versión anterior 4.7, primero proceder con el procedimiento de actualización y verificar la resultado, como se indica en la Guía de instalación del servidor JasperReports. Entonces, antes de habilitar los datos instantáneas, notifiquen a los usuarios sobre esta nueva funcionalidad. Instantáneas de datos se almacenan en el repositorio del servidor, que debe tener una capacidad adecuada. Si usted tiene una gran número de informes o reportes muy grandes, considere el rendimiento de la base de datos de repositorio antes permitiendo a las instantáneas. 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 instantáneas. Como alternativa, puede desactivar las instantáneas de forma selectiva como describe a continuación.

•

Jaspersoft alienta permite instantáneas de datos con las siguientes recomendaciones:

•

•

•

9.5.1 Configuración Global Snapshot de datos

La configuración de nivel de servidor determina si la función de instantánea está disponible o no en el servidor:

190


Configuración del servidor de nivel de datos de instantáneas


... / WEB-INF / applicationContext-data-snapshots.xml

Propiedad

instantánea Persistencia Activado

Frijol

dataSnapshot Servicio

Descripción

Cuando se establece en verdadera, permite que el informe JasperReports servidor espectador para guardar instantáneas de datos en el repositorio y abierta la próxima vez que se ejecute el informe. Por defecto, está ajustado a falsa.

También hay una propiedad llamada snapshotRecordingEnabled que cachea una instantánea en el informe visor de memoria cuando la clasificación y columnas de filtración 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 visualización 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 configuración de instantánea de datos

En el nivel de informe, la propiedad que se puede especificar para desactivar las instantáneas en un informe específico 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 instantáneas 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 instantáneas en el nivel de informe. En el caso anterior:

• •

Instantáneas de datos están habilitadas en el servidor, por lo que la mayoría de los informes de los usan. Si hay algunos informes que no se benefician de instantáneas de datos, los informes pueden deshabilitar de forma explícita instantáneas 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 "Configuración de JasperReports Biblioteca "en la página 206:

Datos instantáneas predeterminada Configuración de informes de nivel Archivo de configuración

... / WEB-INF / classes / jasperreports.properties

Propiedad

net.sf.jasperreports.data.cache. con persistencia = false

Descripción

Cuando se establece en falso, el predeterminado para todo el servidor de informes es No utilice instantáneas de datos, sin embargo, todavía están 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 instantáneas de control: • • •

Instantáneas de datos están habilitadas en el servidor. Pero el defecto a nivel de servidor se establece en false, por lo que la mayoría de los informes no se utilicen. Si hay algunos informes que se benefician de instantáneas de datos, esos informes se permiten explícitamente instantáneas en su propio JRXML con:

net.sf.jasperreports.data.cache.persistable = true

9.5.3 Datos instantáneas 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 instantáneas de datos están habilitados en los informes, el trabajo siempre actualiza la instantánea de datos con estos nuevos datos después de que se ejecuta. De esta manera, cuando se programa un informe, también se actualiza la instantánea de datos periódicamente, ya sea por hora, día, semana, o lo que se adapte a sus necesidades de datos. Cuando instantáneas de datos están habilitadas en el servidor, la interfaz de programador tiene una opción adicional para los datos de salida instantánea. Al seleccionar esta opción, tal como se muestra en la siguiente figura, genera una copia del informe con el nuevo instantánea de datos. Esta copia se almacena en el repositorio como un JasperReport, idéntico al informe que se está ejecutando. Over tiempo, esto creará un archivo de los datos del informe. Si desactiva la opción Formato de salida de datos de instantáneas, ninguna copia del informe se guarda con la nueva instantánea de datos, pero la instantánea de datos en el informe original todavía se actualiza cuando se ejecuta el trabajo. Además, debe seleccionar al menos un otro formato de salida con el fin de programar el informe.

Opción de salida Figura 9-6 La Data Snapshot en el Programador

Por último, cuando las instantáneas de datos están habilitadas, también puede actualizar a través de llamadas de servicios web REST. Cuando especificando el informe para funcionar con el servicio rest_v2 / reportExecutions, puede agregar argumentos explícitamente actualizar o no actualizar la instantánea de datos asociada. Para obtener más información, consulte la Web JasperReports Servidor Guía de Servicios.

9.6 Configuración de registros del sistema En esta sección se describen los ajustes que controlan la información JasperReports Server escribe en sus registros.

Los archivos de registro contienen información importante acerca de cómo 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 configuración de registro predeterminado es WEB-INF \ log4j.properties.

192


9.6.1 Gestión de Configuración del registro

Para establecer los niveles de registro actuales: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2. 3.

Seleccione Administrar> Configuración del servidor y seleccione Configuración del registro en el panel de la izquierda. En el panel de Configuración de registro que aparece, utilice los selectores desplegables para cambiar el nivel de registro para cada clase y estando conectado.

Configuración del registro del sistema 9-7 Figura

La página 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 versión de servidor JasperReports 5.0, estos ajustes se mantendrán incluso si se reinicia el servidor. Por lo tanto los valores de la configuración del registro página que están en vigor en el servidor puede ser diferente de la configuración del archivo log4j.properties. Para obtener más información, consulte "Ajustes de configuración en la interfaz de usuario" en la página 172.

Los cuatro niveles de registro indican el tipo de evento que se registra por un registrador:

Ajuste

ERROR

WARN

Nivel de Información

Escribe una información mínima para el registro de la descripción de las fallas de los programas serios. Escribe mensajes de error y de advertencia en el registro. Los mensajes de advertencia contienen cautelar información para ayudarle a decidir si los eventos registrados requieren su atención.

193


Ajuste

INFO

Nivel de Información

Escribe error, de aviso e informativos en el registro. Mensajes informativos describen acontecimientos importantes, como los que afectan al rendimiento de la aplicación.

Escribe error, advertencia, informativos y mensajes adicionales en el registro. Los mensajes de depuración son muy detallado y, a menudo voluminosos. Utilice este ajuste sólo para diagnosticar un problema. DEBUG puede el rendimiento del sistema de impacto y no debe utilizarse en entornos de producción. Si varios madereros se establecen en DEBUG, el servidor puede generar enormes troncos, y el rendimiento puede verse afectado.

DEBUG

Ajuste predeterminado registrador raíz de JasperReports Server es ERROR, como se ha configurado en log4j.properties. Un maderero que no tiene un valor asignado hereda la configuración de su padre en log4j.properties. La siguiente tabla muestra el nombre de cada registrador tal como aparece en la página Configuración de registro, el identificador que se utilizará para encontrar un especial de registro en el archivo de registro, así como una descripción del registrador.

Logger Nombre

Ejecutor de consultas SQL

Identificador Conectarse

JRJdbcQueryExe cuter

Descripción

Registros de texto y valores de los parámetros de SQL para las consultas que son dirigidas por el ejecutor de consultas SQL.

Texto y valores de parámetros de registros de SQL para las consultas asociado con los controles de entrada.

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 parámetro cuyo valor viene de otro control de entrada. Cuando el valor del parámetro se cambia, la consulta se vuelve a ejecutar automáticamente, posiblemente cambiar la lista de valores para su control de entrada.

Registros de uso de la memoria caché de resultados de la entrada en cascada consultas de control.

Valor de control de entrada consultas

Entrada en cascada parámetro de control resolución

valueQueryLog

FilterCore

Entrada en cascada resultado de la consulta de control almacenamiento en caché

Hibernate SQL

TokenControlLogic

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.

Registros de las diferentes actividades de la política 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.

Ad Hoc política de datos tala

CommonDomain- DataStrategy

SubFilterInputControl- Generador

Otros

SQL generado para Consultas de dominio

JdbcBaseDataSet Consultas SQL generadas a partir de los registros de consultas utilizando un Dominio.

194


Logger Nombre

Conexión el manejo de Dominios

Expresión a JSON convertidor

Basado Domain- pruebas de seguridad


DataSourceResolverImpl

Descripción

Registros de uso de conexiones JDBC utilizados por Dominios a ejecutar consultas SQL.

ExpressionJSON Converter

Seman- ticLayerSecurityResolver Impl

DomainFilterResolver

Registra información acerca de la conversión entre Domel y JSON, que es utilizado por los filtros de Ad Hoc.

Registros de actividad relacionada con la Columna de dominio y de fila seguridad de nivel.

Entrada en cascada resolución de control para dominios

Registra la misma actividad que el registrador FilterCore (Cascading resolución parámetro de control de entrada) anterior, pero añade información específica de dominio consultas.

Registra información acerca del ciclo de vida de los conjuntos de datos que se almacenan en caché en la memoria cuando visitas Ad Hoc son visitada.

Registra el tiempo que tarda una consulta dirigida por la consulta SQL ejecutor para regresar los datos a un informe.

Ad Hoc caché actividad

CachedData

Momento para SQL consultas ejecutadas por informes

Ad hoc WorkingDataSet

JsCon- trolledJdbcQueryExecuter

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.

Registros de actividad del Editor Ad Hoc.

Registros de actividad adicional de la específica ad hoc Editor tabla de referencias cruzadas a los informes.

Registros clases Groovy generados a partir de Domel expresiones utilizadas por el Editor Ad Hoc para los filtros y campos calculados.

Registra la información acerca de AJAX solicitudes realizadas por Ad Editor Hoc y el Diseñador de paneles, incluido el informe parámetros y tiempos de respuesta. Activar este ajuste cuando se quiere entender el Editor Ad Hoc y Diseñador de paneles o si usted ha encontrado un error o tiempos de respuesta lentos.

Contraloría General

Controlador de tabla de referencias cruzadas

AdhocAjaxController

AdhocCrosstabAjaxController

Código Groovy generación de conjuntos de datos de memoria

Ad Hoc AJAX peticiones

GroovyGenerator

adhocAjaxRequests

195


Logger Nombre

Ad Hoc caché actividad


com.jaspersoft.commons. datarator.CachedData

Descripción

Rastrea el ciclo de vida de los conjuntos de datos gestionada por el Ad Hoc caché mientras hacen la transición entre estados. Este registro salida incluye información de la Ad Hoc caché en un formato que se presta a la solución de problemas. Utilice esta ajuste para entender cómo 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 página Configuración de registro si usted sabe sus nombres de las clases. Para agregar un registrador a la página desde la interfaz web: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2. 3.

4.

Seleccione Administrar> Configuración del servidor y seleccione Configuración del registro en el panel de la izquierda. Desplácese hasta la parte inferior de la página. Ingrese nombre de clase de logger en el campo de texto. Ver otras propiedades en la página de la guía, 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 página de Configuración de registro de nuevo. Para obtener información sobre cómo agregar los madereros a esta página en forma permanente, consulte "Adición de un Logger a la página Configuración de registro "en la página 197.

9.6.2 Los archivos de registro de configuración

Puede editar el archivo de configuración de registro para establecer leñadores, 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 configuración del registro de la interfaz de usuario, los ajustes son persistentes en el repositorio, son no escrito a los archivos de configuración, y tienen prioridad sobre los archivos de configuración. Sin embargo, cada ajuste es independiente, por lo que un valor que no se haya modificado la interfaz de usuario Configuración de registro se toma de la correspondiente presentar. Para obtener más información, consulte "Ajustes de configuración en la interfaz de usuario" en la página 172. Nombres de registrador se definen en la fuente de Java. Los madereros pueden tener cualquier nombre, pero la convención 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 importación y exportación, editar un archivo diferente.

Funcionalidad para iniciar sesión Importar / Exportar


Ubicación del archivo

<Js-instalación> \ buildomatic \ conf_source \ iePro

WEB-INF \ log4j.properties en la instalación del servidor JasperReports

196


Si el registrador se define en el archivo de configuración, pero está comentada, basta con quitar el carácter de comentario (#) añadir el registrador. De lo contrario, agregar nombre de clase de logger y configurarlo para que el nivel de registro deseado.

La forma de una definición 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 estándar, 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 Adición de un registrador a la página Configuración de registro

Si usted sabe de un registrador de log4j que utiliza JasperReports Server, puede agregarlo a la página Configuración de registro disponible para el superusuario. Para agregar un registrador, editar un archivo de configuración.

Debido a editar archivos de texto puede ser propenso a errores, Jaspersoft recomienda agregar los madereros de la web interactuar introduciéndolos en el campo de texto en la página de Configuración de registro. Sólo editar el archivo de configuración si necesitará agregar permanentemente el registrador.

Para editar la lista de registradores que se mostrarán en la página: 1. Editar el archivo logger_descriptions_pro.properties encontrado en WEB-INF / paquetes en su servidor JasperReports instalación.

2. Añadir una nueva línea y especificar nombre de clase de logger y una breve descripción del mismo. Los trabajos deben ser en forma <Logger-classname> = <description>.

Ver otras propiedades en el archivo de la guía, 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 configuración regional Inglés. Puede especificar etiquetas para otras configuraciones regionales mediante la edición del archivo de propiedades Descripción logger para ese idioma. Por ejemplo, para añadir la etiqueta en francés, añada una entrada al archivo logger_descriptions_pro_fr.properties. Para obtener más información sobre apoyo a otros idiomas, consulte "Localización" en la página 253.

9.7 Configuración de servicios Web de Amazon

Si tiene acceso a los datos almacenados en Amazon Web Services (AWS) fuentes de datos, los siguientes parámetros controlan cómo JasperReports servidor interactúa con su entorno de Amazon: • •

La página de configuración de AWS permite cambiar la configuración del grupo de seguridad sin necesidad de reiniciar el servidor. El archivo de configuración AWS permite cambiar el controlador JDBC se utiliza con fuentes de datos de AWS.

Para obtener más información acerca de las fuentes de datos de AWS, consulte "Fuentes de datos de AWS" en la página 73.

197


Para cambiar la configuración del Grupo de Seguridad de AWS: 1. Inicie la sesión como administrador del sistema (superusuario por defecto). 2.

3.

Haga clic en Administrar> Configuración del servidor. El Configuración del registro Aparecerá la página. Haga clic en Configuración de AWS en el menú de la izquierda. Aparece el panel de configuración de AWS:

Figura 9-8 Configuración de AWS Página

4. Modifique los siguientes ajustes:

Hemos creado un grupo de seguridad de AWS DB (mediante dirección IP) en cada zona RDS, por JasperReports Instancia de servidor. El grupo de seguridad permite conexiones desde el servidor JasperReports específica y la instancia de base de datos de AWS especificado.

•

•

Activar Cambios Grupo de Seguridad AWS: Esta casilla de verificación 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 dirección 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 añadirá 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,

198


5.

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 Descripción: Este texto será utilizado para el campo de descripción junto al grupo de seguridad o grupos en la consola AWS. •Security Group entrada IP Pública: La mayoría de los usuarios sobre EC2 deben dejar el campo en blanco. JasperReports Server determina la dirección IP automáticamente. Si está ejecutando JasperReports Servidor fuera de EC2, entonces usted debe determinar su dirección IP e ingresarla en este campo. Es también posible con topología EC2 complejo que implica Nubes Privadas Virtuales (VPC) que usted necesita para proporcionar su dirección 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 opción. Haga clic en Cambiar después de cada modificación. Los cambios serán efectivos inmediatamente en el servidor.

Para cambiar el controlador JDBC se utiliza con fuentes de datos de AWS: 1. Abra el archivo ... / WEB-INF / applicationContext-webapp.xml para su edición.

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. Guarde el archivo y reinicie JasperReports Server.

9.8 Configuración de los dominios

Para usos avanzados de Dominios, hay algunas configuraciones usted puede considerar:

• • •

Deshabilitar la validación de dominios Comprobar Optimización del copo de nieve de esquema se une Configuración del funcionamiento del Dominio de Dependencia

Al utilizar dominios con ciertas construcciones de bases de datos específicas, puede que tenga que configurar JasperReports Servidor: • • • • •

Habilitación de Oracle sinónimos Habilitación campos CLOB Habilitación Tipos de propiedad La extensión de JDBC de tipo Mapping Acceso a vistas materializadas

199


9.8.1 Deshabilitar la validación de dominios Comprobar

De forma predeterminada, JasperReports Server valida un Dominio en contra de su fuente de datos para asegurarse de que el diseño de dominio mapas adecuadamente a las tablas subyacentes. Esta validación se produce cuando un archivo de diseño de dominio se carga en el servidor. Si el origen de datos es muy grande y compleja, esta validación puede llevar mucho tiempo. Si la validación lleva demasiado tiempo, puede desactivarla. En este caso, JasperReports Server supone el diseño de dominio es válida, y simplemente lo sube sin el cheque. Usted puede desactivar la validación mediante la edición del archivo de configuración siguiente:

Configuración de la validación de dominios Comprobar Archivo de configuración

... / WEB-INF / applicationContext-semanticLayer.xml

Propiedad

skipDomainDatabase Validación

Frijol

slConfig

Descripción

De forma predeterminada, esta propiedad se establece en FALSE;

en este caso, JasperReports Server valida los diseños de dominio en contra de sus fuentes de datos. Póngalo en TRUE desactivar esta comprobación de validación.

Si no existen las tablas y campos que se hace referencia en el diseño 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 Optimización 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 más 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 configuración por defecto tiene un mejor rendimiento en los casos más comunes con menos mesas.

Configuración de dominio Únete Optimization



Propiedad

specialOptimizationOn

Frijol

gráfico Operaciones

Descripción

El ajuste predeterminado de falsa maneja los casos típicos Dominios de 10-100 basado en tablas. Para copo de nieve esquemas que normalmente tienen 100 o más tablas, o para topologías de base de datos que causan lenta unen actuación en vistas Ad Hoc, establece esta propiedad a cierto para optimizar las uniones en el editor de Ad Hoc.

200


9.8.3 Configuración 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 debería 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 visión 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 fórmula 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 después de la verificación:

• 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 actualización 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 causarán errores en cualquier dependiente de la vista. Si un campo está en uso por una visión, y esta configuración está apagado y permite que el dominio que se suprima ese campo, la vista hará una excepción 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 campos, la vista aún se pueden abrir, pero cualquier acción en ese campo provocará un error. El único escenario para desactivar este ajuste es cuando se elimina un campo del origen de datos, y la Dominio no puede ser modificado porque el campo está siendo utilizado por algunas dependencias. A continuación, deberá editar manualmente las dependencias de modo que no causen errores.

• defaultAddToDomainDependents - Este ajuste determina si un campo que se añade a un dominio es añadido automáticamente a cada vista dependiente Ad Hoc. Cuando está activado, cualquier nuevo campo agregado a un dominio se añade 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 Archivo de configuración


Propiedad

defaultDomainDependents BlockAndUpdate

Frijol

configuración Frijol

Descripción

El ajuste predeterminado de cierto significa que dominio modificación se bloqueará si cualquier vista Ad Hoc utiliza los campos modificados. Si no hay Ad Hoc usos vista los campos modificados, la modificación 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 están 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


Configuración Adiciones dominio de dependencia



Propiedad

por defecto AddToDomainDependents

Frijol

configuración Frijol

Descripción

Cuando defaultDomainDependents BlockAndUpdate está ajustado a cierto Y este ajuste es cierto (Por defecto), cualquier campo que se añade 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 estarán disponibles cuando un usuario abre un vista ad hoc dependiente.

9.8.4 Habilitación de Oracle sinónimos

De forma predeterminada, los dominios no puede acceder a sinónimos en una base de datos Oracle. Establezca la siguiente propiedad para habilitarlos. Si accede a la base de datos de Oracle a través de JNDI, también es necesario para configurar la conexión JNDI. Tenga en cuenta que el servicio de metadatos de Oracle funciona mucho más lento cuando son sinónimos en su alcance.

Habilitación de Oracle sinónimos



Propiedad

includeSynonyms ForOracle


... \ META-INF \ context.xml

Frijol

jdbcMeta Configuración

Descripción

Establezca el valor en true:

<Valor> true </ value>

202


Habilitación de Oracle sinónimos

Propiedad

accessToUnderlying ConnectionAllowed

Frijol

<ResourceName = "Jdbc / oracle" ...

Descripción

Si utiliza JNDI, añada el siguiente Inmueble:

accessToUnderlying ConnectionAllowed = "true"

9.8.5 Habilitación 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 implementación del controlador JDBC de Oracle la CLOB Tipo JDBC para los campos CLOB.

Apoyo CLOB para Oracle



Propiedad

jdbc2JavaType Mapping

Frijol


Descripción

Esta propiedad contiene un mapa de campo de base de datos tipos a tipos Java. Busque la línea de CLOB es comentado:

<-! Clave de entrada = valor "CLOB" = "" / ->

Modificarlo de la siguiente manera: <Clave de entrada = "CLOB" value = "java.lang.String" />

Utiliza la implementación 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

jdbc2JavaType Mapping

Frijol


Descripción

Esta propiedad contiene un mapa de tipos de campo de base de datos a tipos Java. Encuentra las siguientes líneas: <-! 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 Habilitación Tipos de propiedad

JasperReports Server proporciona una correlación de tipos JDBC a Java para todos los tipos estándar 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 tipos con una configuración especial. Como requisito previo, el tipo de propiedad debe ser lógicamente equivalente a una de las clases de Java siguientes:

java.lang.Boolean

java.lang.Byte

java.lang.Character

java.lang.Double

java.lang.Float

java.lang.Integer

java.lang.Long

java.lang.Short

java.lang.String

java.math.BigDecimal

java.sql.Date

java.sql.Time

java.sql.Timestamp

java.util.Date

Hay dos maneras de crear una asignación para un tipo de propiedad, como se muestra en la siguiente tabla:

•

•

Modificar la asignación genérica para tipos numéricos. De forma predeterminada, cualquier tipo numérico que no coincide con uno de los otros tipos se asignan a BigDecimal. Crear una correlación 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

jdbc2Java TypeMapping

Frijol


Descripción

• Para modificar la asignación genérica, editar esta línea:

<Clave de entrada = "NUMERIC" value = "java.math.BigDecimal" />

• Añadir 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 asignación genérica, no bajo OTROS:

<Clave de entrada = valor "NVARCHAR" = "java.lang.String" />

9.8.7 La extensión de JDBC de tipo Mapping

Algunos tipos de bases de datos no están aún 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 configuración:

La extensión de JDBC de tipo Mapping



Propiedad

codeToJdbcType Mapping

Frijol


Descripción

Esta propiedad contiene un mapa de tipo de base de datos códigos a tipos JDBC. Por defecto, los códigos 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 Acceso a vistas materializadas

Dominios acceso tablas y vistas por omisión, 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 estándar 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 () documentación. Cuando usted sabe la cadena correspondiente a su tipo de tabla, agregue el valor siguiente configuración:

Acceso a vistas materializadas



Propiedad

tableTypes

Frijol


Descripción

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 Configuración de JasperReports Biblioteca

Características 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 configuración 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 específico), y Element (definido en el JRXML y aplica a elementos específicos del informe). Propiedades globales se definen en el ... / WEB- INF file / classes / jasperreports.properties.

Para obtener más información sobre la configuración JasperReports Library, consulte http://jasperreports.sourceforge.net/config.reference.html. Las siguientes secciones destacan algunas de las opciones disponibles:

• • • • • • •

Extendiendo JasperReports Biblioteca Cambiar el límite de referencias cruzadas El establecimiento de un Chart Tema Global Desactivación de interactividad en el Visor de informes Habilitación de las XHTML o HTML Exportadores Activación de Flash o HTML5 para Pro Charts Configuración de un motor de JavaScript para la gráfica de representación de informes

9.9.1 Extendiendo JasperReports Biblioteca

Puede extendJasperReports Biblioteca mediante la implementación de las interfaces públicas que expone.

206


Tal implementación normalmente se almacena en un archivo JAR (Java Archive) que contiene un archivo llamado jasperreports_ extension.properties, especifica una clase de fábrica. La clase especificada utiliza para crear instancias de un registro de extensión. El registro de extensión especifica uno o más objetos de extensión, cada una de las cuales corresponde a una biblioteca JasperReports punto de extensión representada por una interfaz Java. Coloque esta JAR en la classpath JasperReports Library, y su extensión está disponible automáticamente.

Para obtener más información, consulte JasperReports última guía Biblioteca.

9.9.2 Cambiar el límite 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 máximo. Para ello, edite el archivo de configuración siguiente:

Opción informe de tabla cruzada de configuración



Propiedad

net.sf.jasperreports. crosstab.bucket. measure.limit

Descripción

Este valor representa el número máximo de células multiplicado por el número de medidas en la tabla de referencias cruzadas. El valor por defecto es 100000.

Introduzca valores grandes para permitir a sus usuarios crear más grande, más crosstabs complicados; introducir valores pequeños para restringir ellos. Si usted experimenta OutOfMemoryExceptions después de cambiar esta valor, pruebe a ajustarla a un número menor, o configurar la JVM para permitir más memoria que se utilizará.

9.9.3 El establecimiento de un Chart Tema Global

Temas Gráfico de controlar el aspecto y el tacto de los gráficos generados por JasperReports Server. Gráfico de temas pueden ser aplicada en el nivel de el servidor o el informe individual: • Para aplicar un tema a nivel del informe, selecciónelo en el diseño del informe en Jaspersoft iReport Designer.

Tenga en cuenta que también se puede aplicar un tema a elementos de gráfico individuales, también. Tenga en cuenta que un tema gráfico puede ser incluido en una unidad de informe como un recurso; en este caso, el tema sólo está disponible para gráficos en esa unidad de informe. Para aplicar un tema a nivel de servidor, copie la tabla JAR tema a la ubicación correcta y editar su archivo de configuración.

•

Un tema gráfico es un archivo JAR que define la apariencia de un gráfico. Una vez que haya creado la tabla JAR tema archivo, copiarlo en el directorio WEB-INF \ lib. Gráfico de temas en esta ubicación están disponibles para cualquier tipo de gráfico en el instancia del servidor; también pueden establecerse como el tema gráfico global. Para establecer un tema como el tema gráfico predeterminado, edite el archivo de configuración siguiente:

207


Global Informe sobre el Tema



Propiedad

net.sf.jasperreports. chart.ChartTheme

Descripción

El nombre de un tema gráfico que se encuentra en la ... / WEB-INF / lib directorio.

Jaspersoft recomienda crear sus temas gráfico en Jaspersoft iReport Designer. Haga clic en Archivo> Nuevo> Gráfico Temática, a continuación, utilizar Jaspersoft iReport Designer para archivar el nuevo tema gráfico como un JAR.

Gráfico de temas no se aplican a Ad Hoc vistas de cartas.

9.9.4 Desactivación 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 través de todo el servidor mediante la edición de una configuración presentar.

Interactividad en el Visor de informes



Propiedad

net.sf.jasperreports. components.table.interactive

Descripción

De forma predeterminada, esta propiedad se establece en verdadera; en este caso, interactividad está activada en el visor de informes. Póngalo en falsa desactivar la interactividad.

Al cambiar esta configuración en este archivo de configuración cambia el comportamiento de todo el servidor. También puede configurar este comportamiento en el informe, tabla o nivel de columna al superar propiedades JRXML del informe.

9.9.5 Habilitación 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 opción predeterminada los exportadores de las versiones anteriores del servidor (HTML y xhtml), El nuevo exportador HTML (html2) Es más informes al exportar perdonar que tienen elementos superpuestos tiempo que evita que el texto se desconecte debido a problemas de medidas de fuente.

Esta configuración afecta a todos los casos cuando se exporta HTML, incluyendo cuando los informes se exportan desde el informe espectador y cuando están programados para producir una salida HTML.

208


Para utilizar un exportador HTML mayores en JasperReports Server, edite el archivo de configuración siguiente:

Exportadores HTML



Propiedad

com.jaspersoft.jasperreports. export.html.type

Descripción

Determina cuál de los exportadores HTML se utiliza. Válido valores son:

• html2 es el exportador HTML predeterminado. Maneja elementos de informe superpuestos con más gracia que la otros exportadores.

xhtml era el exportador HTML por defecto en las versiones de 4,5 de 5,0. Jaspersoft continúa apoyando este exportador. Se ocupa de los elementos del informe se superponen con más gracia que el HTML exportador. Sin embargo, está sujeta a la fuente desajustes métricas 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 continúa para apoyar este exportador. No maneja la superposición elementos con tanta gracia como los demás exportadores.

•

•

Tenga en cuenta que las propiedades son mutuamente excluyentes; sólo puedes tener uno sin comentarios a la vez.

A partir de JasperReports Server versión 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 características interactivas; la HTML y xhtml exportadores no los apoyan.

9.9.6 Activación 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 gráfico utilizando HTML5, en su lugar. Por ejemplo, Pro Gráficos 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 sólo están disponibles en la edición 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 gráfico no se rindió.

Rendir Pro Listas usando HTML5, edite el archivo de configuración siguiente:

209


Pro Gráficos Procesador



Propiedad

com.jaspersoft.jasperreports. fusion.charts.render.type

Descripción

Determina cuál 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 gráfico en HTML5.

html5 es el más nuevo procesador para Pro Charts. Úsalo si no puede ser compatible con Flash.

•

Tenga en cuenta que esta propiedad sólo se aplica a los informes que se basan en Pro Gráficos y sólo afecta a la vista previa HTML y exportación. Normalmente, esta propiedad se establece en el nivel de servidor; para anular la configuración de nivel de servidor para un Chart Pro específica informe, debe establecer esta propiedad en el nivel de informe, y también 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 configuración de fusión. Si esta propiedad no es establecido, la com.jaspersoft.jasperreports.fusion.charts.render.type propiedad se omite en el informe nivel.

9.9.7 Configuración de un motor de JavaScript para la gráfica de representación de informes

Dependiendo de las circunstancias, un elemento gráfico determinado (por ejemplo, un gráfico, 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 gráfico. Cuando está programado para ejecutarse fuera de plazo o ejecuta en segundo plano, un motor interno hace que el gráfico.

Por defecto, el motor de JavaScript interno de JasperReports Server es Rhino, que es una excelente solución para la mayoría casos; la mayoría 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 informes basados en la tabla en el fondo o cuando están programados: • • • •

Bajo rendimiento al generar tablas o gráficos que contienen grandes volúmenes de datos complejos. Fuera de mensajes de memoria. Escala incorrecta cuando se imprimen ciertos informes Pro Gráfico. 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 generación de informes gráficos 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 versión correcta para su medio ambiente. Descargar PhantomJS e instalarlo en el equipo que hospeda JasperReports Server. A un alto nivel, instalar PhantomJS incluye la ampliación de un archivo. Para obtener instrucciones de instalación, consulte la documentación proporcionado con PhantomJS.

210


Una vez PhantomJS está instalado, debe apuntar JasperReports Server para su ubicación. Puede configurar varios opciones independientemente: Highcharts generación, Pro generación Gráficas, Pro generación de widgets y Pro Mapas generación.

Estos son los ajustes a nivel de servidor. En un servidor determinado, todas las cartas del mismo tipo (Highcharts o Fusión (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:

Configuración del motor de JavaScript para Highcharts



Propiedad

com.jaspersoft.jasperreports. highcharts.phantomjs. executable.path

Descripción

Esta propiedad apunta a que el motor debe utilizar el servidor de generar gráficos Highcharts basada en los informes que se ejecutan en el fondo o se han programado.

Por ejemplo, si está usando Windows y se expandía la PhantomJS archivo 1.8.1 ZIP en la raíz de la unidad C::

com.jaspersoft.jasperreports.highcharts. phantomjs.executable.path = C: \\ phantomjs-1.8.1- phantomjs.exe ventanas \\

com.jaspersoft.jasperreports. highcharts.phantomjs. tempdir.path

El directorio temporal donde PhantomJS almacena su salida. Por De forma predeterminada, JasperReports Server espera esta salida en la ubicación definido por Java java.io.tmpdir propiedad del sistema.

com.jaspersoft.jasperreports. highcharts.phantomjs. executable.timeout

El número máximo de milisegundos de espera para la salida desde PhantomJS. Después 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:

Configuración del motor de JavaScript para Pro Gráficos (Fusion)



211


Configuración del motor de JavaScript para Pro Gráficos (Fusion)

Propiedad

com.jaspersoft.jasperreports. fusion.phantomjs. executable.path

Descripción

Esta propiedad apunta a que el motor debe utilizar el servidor de generar Charts Pro (basado en la fusión) en los informes que se ejecutan en el fondo o se han programado.

Por ejemplo, si está usando Windows y se expandía la PhantomJS archivo 1.8.1 ZIP en la raíz de la unidad C::

com.jaspersoft.jasperreports.fusion. phantomjs.executable.path = C: \\ phantomjs-1.8.1- phantomjs.exe ventanas \\

com.jaspersoft.jasperreports. fusion.phantomjs. tempdir.path

El directorio temporal donde PhantomJS almacena su salida. Por De forma predeterminada, JasperReports Server espera esta salida en la ubicación definido por Java java.io.tmpdir propiedad del sistema.

com.jaspersoft.jasperreports. fusion.phantomjs. executable.timeout

El número máximo de milisegundos de espera para la salida desde PhantomJS. Después de ese tiempo, los tiempos de trazar. El por defecto es 3000.

Por defecto, cuando los informes basados en la fusión 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 más información, consulte "Habilitación Flash o HTML5 para Pro Listas "en la página 209.

9.10 Configuración del funcionamiento del control de entrada Al definir los controles de entrada de texto, el comportamiento por defecto del servidor permite cadenas vacías, incluso si ha

configurado una expresión regular y se controla la entrada obligatoria. Utilice este ajuste para hacer cumplir la expresión regular incluso en cadenas vacías, lo que obliga al usuario que proporcione un valor conforme para el control de entrada.

Del funcionamiento del control de entrada Archivo de configuración

... / WEB-INF / applicationContext-cascade.xml

Frijol

applyRegexpToEmptyString

Descripción

El valor por defecto de falsa da el comportamiento tradicional: incluso si un expresión regular se define, no se aplica a cadenas vacías.

Si usted quiere hacer cumplir estrictamente la expresión regular, incluso en cadenas de entrada vacías, establezca esta propiedad en verdadera.

212


9.11 Configuración del Programador

Los informes ejecuta la programación en el fondo de acuerdo con un cronograma definido por el usuario (también llamado un trabajo). Usted puede configurar los siguientes aspectos del planificador: • • • • •

Configuración de la directiva de fallo de encendido Scheduler Configuración del Programador notificaciones de error La restricción de salida del sistema de archivos Extracción Opciones Notificar Programación de intervalo Adición de un Holiday Exclusión Calendario

9.11.1 Configuración 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 línea, su base de datos está en línea, o el número de hilos es limitado. En este caso, usted puede configurar el comportamiento del planificador para reintentar el informe o saltarse esta ejecución programada. Puede establecer una política de fallo de encendido diferentes para cada tipo de horario de trabajo: solo trabajo, trabajo de repetir, y trabajo calendario. Políticas de falla de encendido se definen en la documentación Scheduler cuarzo y otros recursos en línea:

http://quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lección-05

http://quartz-scheduler.org/documentation/quartz-2.x/tutorials/tutorial-lección-06

http://nurkiewicz.blogspot.com/2012/04/quartz-planificador-fallo de encendido-instructions.html

Configuración Scheduler Política fallo de encendido


... / WEB-INF / js.quartz.properties

Propiedad

report.quartz.misfirepolicy. singlesimplejob

Descripción

Establece la política 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


Configuración Scheduler Política fallo de encendido

report.quartz.misfirepolicy. repeatingsimplejob

Establece la política de fallo de encendido para repetir trabajos a una de las siguientes valores: •

•

•

•

•

•

SMART_POLICY

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

report.quartz.misfirepolicy. calendarjob

Establece la política 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

9.11.2 Configuración del Programador notificaciones de error

Por defecto, si un informe programado se ejecuta, pero se produce un error, el programador envía un correo electrónico al propietario horario y para todos los administradores de JasperReports Server en la misma organización. Esto es además de cualquier falla direcciones de notificación especificados en el Notificaciones ficha del asistente programador. Para recibir estos las alertas de error del programador, los administradores deben tener un correo electrónico válido definido en sus cuentas de usuario. También puede configurar el programador para enviar notificaciones de error a diferentes usuarios en función de los roles, o apague notificaciones de error.

Configuración del Programador notificaciones de error


... / WEB-INF / applicationContext-report-scheduling.xml

Llave de la entrada

administrador Papel

Frijol

cuarzo Programador

Descripción

Este ajuste determina la función a la que el fracaso planificador se enviarán las notificaciones. Todos los usuarios de la organización con este papel y una dirección válida de correo electrónico se define en su perfil de usuario recibir la notificación por correo electrónico. Por defecto, este ajuste es ROLE_ ADMINISTRADOR.

214


Configuración del Programador notificaciones de error

disableSending AlertToAdmin

cuarzo Programador

Determina si las notificaciones de error se envían a la función en la la configuración anterior. Por defecto, este ajuste es falso, significando que las notificaciones se envían. Establezca este valor en cierto desactivar notificaciones de error de programador que se envían a los administradores (o el papel se ha definido anteriormente).

Determina si las notificaciones de error se envían a la sched- propietario ule. Por defecto, este ajuste es falso, lo que significa que notificación caciones se envían. Establezca este valor en cierto desactivar planificador notificaciones de error que se envían al propietario horario.

disableSending AlertToOwner

cuarzo Programador

9.11.3 La restricción de salida del sistema de archivos

Las salidas del planificador de informes a través de varios canales. La mayoría de los informes se envían por correo electrónico, pero los informes también se pueden escribir a FTP carpetas. También puede configurar el programador para escribir informes al sistema de archivos local del servidor. Esta opción 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

enableSaveToHostFS

Descripción

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 también 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 escribirán salida para el sistema de archivos (FTP y correo electrónico 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 Extracción Opciones Notificar Programación de intervalo

Cuando los usuarios programan informes, pueden especificar que el informe ejecuta periódicamente a intervalos regulares. Para sencilla recidiva, el intervalo predeterminado se puede expresar en días, horas o minutos. Si es necesario evitar que los usuarios de la programación de informes frecuentes, puede limitar los intervalos de días o de horas editando el siguiente fichero de configuración:

Programación de opciones de intervalo


... / WEB-INF / fluye / reportJobBeans.xml

Sección actualizar

recurrenceIntervalUnits

Descripción

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 programación 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 estática-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 Adición de un Holiday Exclusión Calendario

El calendario de exclusión apoyo planificador que especifique días o tiempos cuando se debe ejecutar ningún informe, incluso si el horario se activa entonces. Por ejemplo, puede que no desee un informe para ejecutarse en un día festivo cuando la datos financieros no tendrían 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 serán excluidos de la programación. Actualmente, el único método para definir un calendario de vacaciones es a través de la API REST. Se puede utilizar cualquier navegador plug-in que actúa 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> <ExcludeDay> 18/04/2014 </ excludeDay> <ExcludeDay> 04/21/2014 </ excludeDay> <ExcludeDay> 05/01/2014 </ excludeDay> <ExcludeDay> 05/08/2014 </ excludeDay> <ExcludeDay> 05/29/2014 </ excludeDay> <ExcludeDay> 09/06/2014 </ excludeDay> <ExcludeDay> 07/14/2014 </ excludeDay> <ExcludeDay> 15/08/2014 </ excludeDay> <ExcludeDay> 11/01/2014 </ excludeDay> <ExcludeDay> 11/11/2014 </ excludeDay> <ExcludeDay> 12/24/2014 </ excludeDay> <ExcludeDay> 25/12/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 también muestra la respuesta exitosa desde el servidor.

Figura 9-9 Creación 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 Programación.

Figura 9-10 Selección 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 sólo se enumeran los calendarios de tipo vacaciones. Uso de la API REST, sin embargo, puede crear y administrar cualquier número de calendarios y actualizar cualquier programar para utilizarlos. Para obtener más información, consulte la Guía de Servicios Web JasperReports Server.

9.12 Configuración del latido del corazón

Durante la instalación (o la primera vez que un administrador inicia sesión en), se le solicitará una vez para participar en Programa Heartbeat de Jaspersoft, que reporta información técnica a Jaspersoft sobre su aplicación, tales como el sistema operativo, JVM, servidor de aplicaciones, base de datos (tipo y versión), los tipos de fuentes de datos, y Edición del servidor JasperReports y número de versión.

Si cambia de opinión, puede cambiar el comportamiento de los latidos del corazón mediante la edición del archivo de configuración siguiente:

Opciones Heartbeat



Propiedad

heartbeat.enabled = true

Descripción

Cuando esta propiedad se establece en verdadera, JasperReports Servidor reporta información sobre el entorno de Jaspersoft una vez a la semana. Cuando se establece en falso, información no es enviado.

Determina si se le pide al administrador (la próxima vez que inicie sesión en la interfaz web) sobre si se debe permitir datos de los latidos del corazón que se envíen. Típicamente, nunca hay causa editar esta propiedad directamente. Indica si un usuario ha concedido el servidor permiso para enviar datos de ritmo cardíaco. Al establecer esta propiedad a falsa impide el envío de datos.

heartbeat.askForPermission.enabled

heartbeat.permissionGranted.enabled

Todos estos ajustes son propiedades que son sustituidos en el heartbeatBean en el ... / WEB- Archivo / applicationContext-heartbeat.xml INF.

218


9.13 Configuración de la Ayuda en línea

JasperReports Server Edition profesional incluye un sistema de ayuda en línea que describe la interfaz web. Si su los usuarios no tienen conexión a Internet, o si usted no desea proporcionar acceso a este sistema, puede configurar el servidor para ocultar los vínculos de ayuda completamente.

Opciones de configuración de Ayuda en línea


... / WEB-INF / applicationContext-webHelp.xml

Propiedad

showHelp

Frijol

WebHelp

Descripción

Determina si los enlaces de ayuda se muestran en las JasperReports Interfaz de usuario Web Server. Los valores válidos son cierto y falsa.

El Ayuda enlace aparece en la esquina superior derecha de las páginas 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 versión de JasperReports Server. No cambie este valor.

Define el nombre de la página por defecto para pasar al servidor web que aloja el sistema de ayuda. El único valor válido es Default_CSH.htm para esta propiedad.

Mapas contextos en la aplicación de los identificadores de temas en el sistema de ayuda. Muchas páginas de la aplicación web se configuran para la sensibilidad al contexto. Cuando un usuario hace clic Ayuda en una página de este tipo, JasperReports Server carga un tema específico en el sistema de ayuda. El tema que aparece está determinada por un mapa en el archivo applicationContext-webHelp.xml. Los únicos valores válidos son los valores por defecto.

pagePrefix WebHelp

helpContextMap WebHelp

219


220

CAPÍTULO 10 diagnósticos de Server


JasperReports Server proporciona amplias de diagnóstico de manera que los administradores pueden controlar la salud y el rendimiento del servidor que ejecuta. En la versión 5.0, el servidor aumenta el registro de auditoría con los datos de vigilancia que es más fácil informar en contra. La versión 5.0 también introduce diagnóstico que proporcionan información en tiempo real acerca de el servidor en ejecución, tales como el uso de memoria. Todas estas herramientas pueden ayudarle a solucionar problemas y analizar rendimiento. • Tiendas de Auditoría eventos clave que son de interés para los administradores de sistemas, tales como nombre de usuario

/ tiempo de cierre de sesión, el usuario, informe generado, detalles del informe y tamaños de objetos. Los eventos auditados se pueden guardar y se mudaron a un archivo automáticamente después de un número determinado de días. El monitoreo se basa en eventos de auditoría y proporciona un dominio multidimensional para crear Ad Hoc visitas. Esto le ayuda a generar informes que contienen las métricas 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. Diagnóstico proporcionan datos en tiempo de ejecución que da la salud general de la instancia del servidor. Por ejemplo, se incluye valores tales como usuarios registrados, actualmente en ejecución, informes regulares y el uso de memoria y desempeño en la caché Ad Hoc. Los datos de diagnóstico se expone en una fuente de datos personalizada y puede ser fácilmente se ve en un informe o integrado con consolas de administración estándar de la industria.

Eventos que se audita y monitoreados Configuración de Auditoría y Supervisión El uso de los datos de auditoría Uso de la Monitorización de Datos Importación y exportación de datos de eventos Tiempo Real Diagnósticos La exposición de Diagnóstico A través de un agente JMX de Jaspersoft El uso de los datos de diagnóstico en los Informes Excluyendo Atributos de diagnóstico Desactivación de Tiempo Real Diagnósticos

•

•


• • • • • • • • • •

221


10.1 Eventos que se audita y monitoreados

En términos generales, un evento de auditoría es cualquier operación atómica que puede ser registrada por el sistema de auditoría. Propiedades de eventos y los atributos son características del evento; que pueden ser definidos internamente o en el código personalizado. Auditoría y vigilancia se basan en el mismo registro de eventos, por lo que los eventos de auditoría también están disponibles en el seguimiento de las fuentes de datos, Dominios e informes. La siguiente tabla muestra los eventos de auditoría definidas y la información 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 configuración applicationContext-audit.xml para la especificación completa de los eventos.

Evento

Inicia la sesión o cerrar sesión Entrar como

Ejecutar informe o ejecutar un informe integrado dentro de cualquier otro informe

Información recopilada

El tiempo y el ID de usuario (registrado por cada evento)

Usuario conectado como

•

•

•

•

•

•

•

•

•

Planificación de informe creado, eliminado o actualizado

Informe de ejecución programada

•

•

•

•

•

Crear informe en Ad Hoc Editor •

•

Recursos visitada por cualquier motivo (por ejemplo, como punto de vista, utilizado en el informe, etc)

Recursos añadido o actualizado

•

•

•

•

Recursos o carpeta eliminada

Permisos añadido, actualizados o borrados

Informe de referencia

Fuente de datos referenciada

Parámetros y valores de informe

Consultas de informes (por ejemplo, SQL, dominio, HQL, SQL generado)

Inicio de ejecución, extremo

Tiempo de ejecución de la consulta (en milisegundos) Informe de tiempo de representación (en milisegundos) Parámetros de almacenamiento en caché Los errores que se produjeron

Informe de referencia

Parámetros y valores de Programación

Informe de salida

Parámetros de Informe de entrega (como el correo electrónico) Mismos parámetros que cuando se ejecuta el informe

Campo añade como una columna

Campo añade como un grupo

Referencia de Recursos

Tipo de recurso

Referencia de Recursos

Tipo de recurso

Recursos o carpeta referenciada

•

•

Recursos o carpeta referenciada

Permisos anteriores (antes de la actualización)

222


Evento

Usuario agregado, actualizado o borrado, también cambio de contraseña de usuario

Información recopilada

•

•

•

•

•

•

ID (identificación) de usuario Nombre de usuario

Email

Bandera Activado

Bandera externa

Atributos del perfil

Identificación de roles Nombre de la función

Organización Rol

Organización ID

Descripción Organización

Papel añadido, actualizado o borrado •

•

•

Organización añadido, actualizado o borrado •

•

10.2 Configuración de Auditoría y Supervisión

Las funciones de auditoría y de supervisión se basan en el mismo subsistema en JasperReports Server. Los ajustes para Configuración de la auditoría y la supervisión están ubicados en el archivo / applicationContext-audit.xml WEB-INF. El se utilizan los frijoles y las propiedades de este archivo para habilitar la auditoría y la supervisión, establezca las opciones de archivo y seleccione que se registran los eventos.

10.2.1 Habilitación de Auditoría y Supervisión

Debido a que la auditoría y la supervisión comparten el mismo subsistema, hay una opción de configuración master para encender la subsistema, y los ajustes individuales para la auditoría y monitoreo. Esto le permite activar cada función independiente, o apagar el subsistema completo para evitar cualquier sobrecarga de una función no utilizada. De forma predeterminada, la auditoría y la supervisión subsistema está apagado.

Habilitación de Auditoría y Supervisión Opciones



Propiedad

audit.enabled = false

Descripción

Establezca esta propiedad cierto para permitir la auditoría y subsistema de supervisión. Dado el valor por defecto de la otra configuración, sólo la auditoría está activada cuando este ajuste es primer set a verdadera.

223


Habilitación de Auditoría y Supervisión Opciones

monitoring.enabled = false Una vez audit.enabled = true, establecer esta propiedad en cierto a habilitar la supervisión. Más precisamente, este valor controla la registro de los acontecimientos en las tablas utilizadas por el monitoreo Dominio.

De forma predeterminada, los objetos de gran tamaño de impresión de la memoria no son das confi- porque eso puede afectar al rendimiento. Si desea tem- ralmente habilitar la auditoría para el uso de la memoria de los objetos de impresión en los informes, establezca este valor en verdadera.

audit.sizeof.enabled = false


... / WEB-INF / applicationContext-audit.xml

Propiedad

isAuditPersistence Activado

Frijol

auditoría Servicio

Descripción

Establezca esta propiedad falsa para deshabilitar el registro de eventos en el tablas utilizadas por el dominio de auditoría. Esto le permite apagar datos de auditoría, manteniendo los datos de seguimiento.

Evite apagar el seguimiento y la auditoría de la persistencia. En su lugar, apague todo el subsistema con audit.enabled = false.

10.2.2 Opciones de copia de Auditoría

El archivo es un mecanismo para mover los datos de auditoría 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 auditoría, que nunca acceder a registros de auditoría más de una semana o meses. Debido a que los datos de auditoría 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 automáticamente los datos de auditoría a las tablas de bases de datos separadas después de un cierto tiempo. Si desea crear informes sobre los datos de auditoría históricos, Jaspersoft proporciona también un dominio para el acceso los registros de auditoría archivados. También puede configurar la función de auditoría para suprimir datos archivados antiguos más tiempo si no necesitarlo.

Usted debe establecer el intervalo de archivado a un nivel que equilibre su necesidad de registrar y auditar el acceso a datos con el rendimiento de su servidor en grandes tablas de auditoría. Utilice los siguientes parámetros de configuración para cambiar el archivo comportamiento.

Opciones de copia de Auditoría


... / WEB-INF / applicationContext-audit.xml

224


Opciones de copia de Auditoría

Propiedad

maxAudit EventAge ToArchive

maxAudit EventAge

Frijol

auditService

Descripción

El número de días que se conservan los datos de auditoría en el activo base de datos. El valor predeterminado es 30 Los datos anteriores se mueve a la archivo. El número de días que se guardan los datos. Se eliminan los datos más. El valor predeterminado es 0 (cero), lo que significa que los datos de edad nunca es suprimido.

Define la frecuencia del trabajo archivado en cron sintaxis. El valor predeterminado, 0 0 5 *?, es cada día a las 05 a.m.

Define la frecuencia de la auditoría delete (purga) de empleo en cron sintaxis. El valor predeterminado, 0 0 3 *?, es cada día a las 3 a.m.

auditService

cronExpression auditEvent ArchiverTrigger

auditEvent PurgerTrigger

cronExpression

El cronExpression propiedades utilizan un Planificador cuarzo expresión cron que especifica el gatillo repitiendo como segundos, minutos, horas, días del mes, mes, día de la semana.

10.2.3 Desactivación 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 configuración applicationContext-audit.xml. Eventos que se registran son utilizados tanto por la auditoría y seguimiento de los subsistemas, por lo tanto, para desactivar un evento hace que no esté disponible tanto para la auditoría 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 través de un servicio web. Tipos de eventos para el acceso a través 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, excepción" />

Desactivar con la |sintaxis. Por ejemplo:

<Clave de entrada = valor "CreateFolder" = "Nombre de carpeta, folderLabel, | folderDescription, excepción" />

• Utilice la opción "Todos excepto" * | sintaxis para especificar sólo la propiedad discapacitados. Todos los demás se registran. Por ejemplo: <Clave de entrada = valor "CreateFolder" = "* | folderDescription" />

225


10.3 Uso de los Datos de Auditoría

JasperReports Server hace que los datos disponibles para los administradores de auditoría a través de dominios y varios preparados vistas e informes. Estos se encuentran en la carpeta / Public / Auditoría del repositorio.

Figura 10-1 Informes de Auditoría en el Repositorio

Hay dos dominios y dos conjuntos de informes creados para acceder a los datos de auditoría:

•

•

Auditar los informes de auditoría y de dominio - Utilice estos para ver los datos de auditoría en curso; van en contra de la activa base de datos de auditoría. Informes de auditoría archivados Auditoría 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 idénticos-que sólo se diferencian en las tablas de base de datos que se tiene acceso en cada caso. Para crear un Grupo de Acción View basado en los Dominios de auditoría, seleccione Crear> Especial View, seleccionar el Dominios ficha en el Selector de Datos, y expandir las carpetas para seleccionar uno de los Dominios de auditoría.

226


Figura 10-2 Selección de un dominio de Auditoría para Crear un Grupo Especial Ver

Para obtener instrucciones sobre el uso de dominios en los informes, consulte el capítulo especial en Guía del usuario de JasperReports Server. Para documentación de Dominios en general, consulte el capítulo Dominios en el mismo manual. Las siguientes secciones explican los contenidos de los dominios y los informes que se proporcionan.

10.3.1 Auditar Artículos de dominio

Los Dominios de auditoría exponen los campos de las tablas de registro de auditoría almacenados en la base de datos interna del servidor. Al igual que con todos los ámbitos, las tablas de la base están 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 auditoría (Auditoría de dominio y Auditoría Archivo de dominio). Estos artículos corresponden a la información 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. Artículos de dominio en la siguiente tabla se utilizan en eventos generales, así como los eventos del repositorio:

Dominio de artículo

Fecha

Prop largo Valor

Tipo Prop

Descripción

Fecha del evento ocurrido.

clob valor de la propiedad de evento, tales como consulta.

Tipo de inmueble evento, como la carpeta de destino, según mapa de eventos en archivo de configuración.

string valor de la propiedad de evento, tales como nombre de la carpeta. Evento Hora en que ocurrió.

Valor Prop

Tiempo

227



Tipo de evento

Tipo de solicitud

Tipo de recurso

URI de recursos

Descripción

Tipo de evento, como ahorrar recursos, según mapa de eventos en el archivo de configuración. Repositorio tipo de petición de evento.

Tipo de repositorio de recursos acceder en evento.

URI de recursos del repositorio.

Artículos de dominio en la tabla siguiente se registran para los eventos de usuario:


E-mail

Activado

Externo

Nombre completo

Contraseña cambiada

Organización

Nombre de Usuario

Descripción

Dirección de correo electrónico de usuarios de eventos (usuario en tiempo de evento). Ya sea de usuarios de eventos es actualmente un usuario. Si el usuario evento fue un usuario externo.

Nombre completo del usuario evento. Ya sea evento fue un cambio de contraseña

Organización de usuarios de eventos.

ID de usuario del usuario de eventos.

Artículos de dominio en la siguiente tabla se registran los eventos de rol:


Externo

Nombre de función

Organización

Descripción

Si el papel se define en un sistema externo.

Nombre de la función en el evento.

Organización de la función en el evento.

Artículos de dominio en la tabla siguiente se registran cuando se genera un informe:


Fecha

Tiempo

URI de recursos

Tipo de recurso

Descripción

Fecha que se genere el informe.

El tiempo se genere el informe.

URI de recursos repositorio accesible para el informe.

Tipo de repositorio de recursos para acceder informe.

228



Origen de datos URI

Tiempo de ejecución de la consulta Informe Rendering

Informe de Ejecución Hora

Descripción

URI de la fuente de datos accesible para el informe.

Tiempo de ejecución de la consulta en la base de datos.

Tiempo para preparar resultados de la consulta para la exhibición. Tiempo total para ejecutar la prestación informe (informe de ejecución de la consulta + + gastos generales). Overhead incluye tareas como recursos del repositorio de carga (Unidad de informe, la fuente de datos, etc) y la obtención de una conexión DB partir de los datos fuente.

Especificación de la consulta del informe.

ID de usuario del usuario de eventos. Organización de usuarios de eventos.

Nombre del campo utilizado en tabla de referencias cruzadas

Consulta

Nombre de Usuario

Organización

Tabla de referencias cruzadas Grupo Campo

10.3.2 Informes de Auditoría y Ad Hoc Vistas

Los informes de auditoría y sus puntos de vista son blanco de forma predeterminada, ya que la auditoría está desactivada de forma predeterminada y no existen datos de auditoría. Para ver estos informes, primero habilitar la auditoría como se describe en "Auditoría de Configuración y Monitoring "en la página 223, luego esperar a que la actividad del usuario para generar eventos.

Un número de Ad Hoc vistas e informes basados en los Dominios de auditoría están dentro de la / Auditoría / Auditoría Pública Carpeta Informes. Los mismos puntos de vista y los informes también se proporcionan en el Archivo de Informes de Auditoría subcarpeta. Estos informes son idénticos, excepto que utilizan el dominio de Auditoría Archivo y corren en contra de los datos de auditoría archivados. Como con todo el material de auditoría, estos informes sólo son visibles para los administradores. Los informes están diseñados para cubrir las necesidades de auditoría comunes y pueden utilizarse tal cual. Cuando está habilitada la auditoría y se graban los eventos de auditoría, que contendrán up-to-the-minute registros de eventos en el servidor. Usted puede ejecutar los informes o programarlos según sea necesario. La vista ad hoc usado para crear cada informe se incluye también. Puede abrir estos en el editor de Ad Hoc para explorar los datos de auditoría en tiempo real. También puede modificar estos puntos de vista en el Editor Ad Hoc para generar nuevos informes para satisfacer sus requisitos de auditoría. Los siguientes puntos de vista y los informes se proporcionan: • • •

• • •

Informe de auditoría - Ejemplo genérico de un informe de una auditoría que muestra eventos comúnmente 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 ejecución para identificar lenta informes. Repositorio de Recursos Informe - Muestra los recursos del repositorio y sus eventos asociados. Ejecución 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 específico.

229


10.4 Uso de la Monitorización de Datos

JasperReports Server hace los datos de seguimiento disponibles para los administradores a través 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 Acción View basado en los Dominios de auditoría, 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 capítulo especial en Guía del usuario de JasperReports Server. Para la documentación de Dominios en general, ver el capítulo de Dominios en el mismo manual. Las siguientes secciones explican los contenidos de los dominios y los informes que se proporcionan.

10.4.1 Monitoreo Artículos 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 están unidas, y los campos se presentan como elementos que se pueden utilizar en el modo Ad Vistas hoc. En esta versión de JasperReports Server, los campos de monitoreo se limitan a los que la ejecución record report eventos:


Día

Edición de Acción

Descripción

Día del mes, el informe termina de ejecutarse.

El Ad Hoc paso de edición que el usuario acaba de realizar (nulo para la ejecución del informe):

•

•

•

•

insertDimensionInAxisWithChild - Se añadió una dimensión.

addMeasure - Se añadió una medida.

setProperty - Una propiedad se ha establecido. moveDimension - Una dimensión se conmovió.

230



Contexto Evento

Descripción

El contexto que provocó la ejecución del informe. Los valores posibles son:

•

•

•

ui - El informe corrió de forma interactiva desde la interfaz de usuario.

servicios web - El informe se ejecuta a través de servicios web.

interna - El informe se desarrolló entre un proceso interno, por lo general el planificador.

Tipo de evento El tipo de informe que se ha ejecutado. Los valores posibles son:

•

•

ejecución de informes - Un informe que iba desde el repositorio.

edición ad hoc - Un informe que iba desde un punto de vista especial que se está editando.

Hora

Identificación del Minuto

Mes

Tiempo de ejecución de la consulta Informe Rendering

Informe URI

Time Stamp

Informe de ejecución total Tiempo

Hora que el informe termine de ejecutarse.

Número de ID del evento de monitoreo.

Minute que el informe termine de ejecutarse.

Mes que reportan terminado de ejecutarse.

El tiempo dedicado a ejecutar la consulta SQL en la base de datos.

El tiempo dedicado a rendir el informe después de recibir los resultados de la consulta (conjunto de datos). Ruta de repositorio del informe que se ejecutó.

Tiempo y fecha que el informe se termina de ejecutarse, incluyendo milisegundos.

El tiempo total empleado que ejecuta el informe. Normalmente, este es un poco más que el suma de la ejecución de la consulta y la representación 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 obtención de una conexión DB desde la fuente de datos.

El usuario que ejecutó el informe.

La organización que contiene el usuario que ejecutó el informe.

Año que el informe termine de ejecutarse.

Nombre de Usuario

Organización usuario

Año

10.4.2 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 auditoría que el monitoreo depende está desactivada por defecto y no existen datos de auditoría. Para ver estos informes, primero habilitar la auditoría como se describe en la sección "Configuración de Auditoría y Supervisión "en la página 223, luego esperar a que la actividad del usuario a generar eventos.

Un número de Ad Hoc vistas e informes basados en el dominio de vigilancia están dentro de la / Monitoreo / Vigilancia Pública Informes carpeta.

231


Los informes están diseñados para cubrir las necesidades comunes de seguimiento y se puede utilizar tal cual. Cuando se activa la monitorización y se registran los eventos de auditoría, los informes contendrán hasta al minuto los registros de eventos en el servidor. Puede ejecutar los informes o programarlos según sea necesario. La vista ad hoc usado para crear cada informe se incluye también. Puede abrir estos en el editor de Ad Hoc para explorar los datos de monitoreo en tiempo real. También puede modificar estos puntos de vista en el Editor Ad Hoc para generar nuevos informes para satisfacer sus requisitos de supervisión. 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 ejecución de alto bajas. Informe de Seguimiento de detalles Notificar - Una tabla de referencias cruzadas que muestra los tiempos de ejecución de informes en un eje y muchos dimensiones, tales como una jerarquía de tiempo, el usuario y la organización, y el tipo de evento en el otro eje ,.

Figura 10-4 Monitoreo Ver Ad Hoc con el análisis multidimensional

10.5 Importación y exportación de datos de eventos

Los datos de auditoría y monitoreo pueden ser importados y exportados con las utilidades descritas en el capítulo "Importar y exportación "en la página 131.

• • • •

los datos de auditoría de exportación, utilizan la --include-auditoría-eventos opción en el comando de exportación. usuario de los datos de vigilancia de las exportaciones del --include-monitoreo-eventos opción en el comando de exportación. datos de auditoría importación, la importación del catálogo que contiene los datos de auditoría con el --include-auditoría-

eventos opción. datos de monitoreo para las importaciones, importar el catálogo que contiene los datos de auditoría con el --include-

Monitoring eventos opción.

Los datos en las carpetas temporales no se exporta.

Para Para Para Para

232


10.6 Real-Time Diagnóstico

Con JasperReports Server 5.0, Jaspersoft introduce la instrumentación completa del servidor para que pueda proporcionar real información de diagnóstico el momento en que el uso de memoria, informes concurrentes que se está ejecutando, las estadísticas de caché, y mucho Más. Mientras que la auditoría y la supervisión proporcionan un registro histórico de eventos en el servidor, se muestran los diagnósticos el estado actual del servidor y su Virtual Machine (JVM) entorno Java. Por ejemplo, puede utilizar la información de diagnóstico para ajustar la configuración de JVM para optimizar la memoria basado en el tamaño de los conjuntos de datos típicos de la memoria caché Ad Hoc. Y debido a que los datos de diagnóstico está disponible a través de un tema, puede crear vistas Ad Hoc que le ayuden a analizar el rendimiento de su servidor e identificar el desempeño cuellos de botella antes de que sucedan. La función de diagnóstico se basa en el estándar de Java Management Extensions (JMX) de la industria para reunir en tiempo de ejecución de datos y lo exponga a otras interfaces de administración. JasperReports Server implementa varios elementos de la Arquitectura JMX: •

•

•

•

Nueva JMX logró frijoles que se utilizan para recopilar y mantener los datos de diagnóstico, tales como el número de concurrentes informes. Su propio agente JMX, como un servidor, que responde a las solicitudes JMX y expone la información de la beans gestionados. Las conexiones a los frijoles JMX logrado existentes en otros componentes como Ehcache para incluir su datos de diagnóstico. Las conexiones con otros agentes JMX como agente JVM para recopilar diagnósticos del sistema.

Para obtener más información acerca de JMX, consulte http://docs.oracle.com/javase/tutorial/jmx/. Hay dos maneras de utilizar los datos de diagnóstico de JasperReports del servidor: • Si usted tiene una consola de gestión externa que puede conectarse a un agente JMX, puede utilizarlo para conectarse a

agente JMX del servidor. Es probable que también desee conectarse a agente JMX de la JVM también. Usted puede a continuación, ver el tiempo real de los datos de diagnóstico de servidor JasperReports integrados con los datos de su otro servidores de la consola de administración. Consolas de administración a menudo ofrecen más 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 información desde el beans gestionados en el servidor y en la JVM. A continuación, puede crear JasperReports que acceden a esta fuente de datos y presentar estos datos de diagnóstico en un informe que se adapte a sus necesidades. Jaspersoft también proporciona un informe y un anuncio Tema Especial para demostrar esto.

•

10.7 La exposición de Diagnóstico a través del agente JMX de Jaspersoft

De forma predeterminada, la característica de diagnóstico está configurado para permitir el acceso a los datos de diagnóstico a través de un mando a distancia consola de gestión que soporte JMX. Esto le permite integrar el diagnóstico de JasperReports Server con su estrategia global de gestión 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 administración acceder al JMX agente dotado de JasperReports Server, y el acceso está garantizado por los mismos usuarios, contraseñas y roles utilizados por la interfaz web del servidor.

10.7.1 Conexión con el agente JMX

Para conectar la consola de administración de agente JMX del JasperReports Server, iniciar una nueva conexión desde la consola y especifique la siguiente cadena de conexión:

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 conexión 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 contraseña, debe dar a un usuario con las siguientes funciones: Ediciones comerciales: Proyecto de la Comunidad:

ROLE_SUPERUSER, en consecuencia, por defecto, el superusuario usuario ROLE_ADMINISTRATOR, en consecuencia, por defecto, el jasperadmin usuario

Las siguientes secciones explican cómo modificar los valores por defecto de conexión para:

• • •

El nombre de la conexión El puerto JMX Los roles necesarios

10.7.2 Configurar el nombre del puerto y la conexión

El nombre de la conexión es el nombre registrado para el agente JMX con la invocación del método remoto (RMI) servicio. Si usted tiene más de una instancia JasperReports Server en un solo servidor de aplicaciones, es necesario cambiar la nombre de la conexión 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 conexión, editar uno de los archivos siguientes: • •

En la distribución de archivos WAR antes de la instalación: <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 líneas siguientes y editar los valores para el número de puerto y la conexión 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 conexión JMX desde una consola de administración 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 configuración:

<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 configuración:

<Util: lista id = "diagnosticAllowedRolesCe" value-type = "java.lang.String"> <Valor> ROLE_ADMINISTRATOR </ value> </ Util: lista>

En ambos casos, se puede cambiar la función existente o añadir líneas adicionales que contienen alternativo <Valor> ROLE_ nombre </ value>.

10.7.4 Desactivación de conexiones remotas a la agente JMX

De forma predeterminada, las conexiones remotas a un agente JMX están habilitados y configurados como se describe en "Conexión a la JMX Agent "en la página 233. . Para deshabilitar las conexiones remotas, edite el archivo applicationContext-diagnostic.xml y hacer la siguiente cambios:

• • • •

Comentario Comentario Comentario Comentario

Salida Salida Salida Salida

la totalidad JMXAuthenticator frijol. la totalidad jMXregistry frijol. la totalidad jasperJMXServerConnector frijol. o eliminar la propiedad depende-en = "jMXregistry" en el jasperJMXServer frijol.

Para comentar una sección de este archivo XML, lo rodean con <! - y -> etiquetas.

10.7.5 Conexión alternativa a través del servicio del servidor de aplicaciones JMX

La mayoría de los servidores de aplicación también tienen un agente JMX, y si se configuran correctamente, pueden descubrir el Agente y JasperReports servidor JMX exponer la información de diagnóstico. Sin embargo, esta conexión tiene algunos importantes implicaciones de seguridad: •

•

Cuando el servidor de aplicaciones descubre y se conecta con el agente JMX, tiene pleno acceso al diagnóstico información. Si el agente JMX del servidor de aplicaciones está configurado para el acceso remoto, el administrador remoto también tiene acceso a la el agente JasperReports servidor JMX - sin necesidad de proporcionar el nombre de usuario JasperReports Server y contraseña. En otras palabras, al confiar en el servidor de aplicaciones para acceder a la información de diagnóstico, usted también permitiendo que cualquier persona que confíe el servidor de aplicaciones se conecten. La conexión entre los dos agentes JMX es recíproca. Si el acceso remoto sigue activado en la Agente JasperReports servidor JMX, un gerente remoto que se conecta a él también ve el contenido de la aplicación servidor de agente JMX. En otras palabras, el agente JMX del servidor de aplicación también es confiar en cualquier persona que confiamos para conectar a nuestro agente JMX (con nuestro nombre de usuario y contraseña).

•

Para conectarse automáticamente al agente JMX del servidor de aplicaciones, suponiendo que haya alguno disponible, edite el default_ master.properties archivo antes de implementar la aplicación web del servidor JasperReports, y añadir la siguiente línea:

diagnostic.jmx.usePlatformServer = true

Si el servidor de aplicaciones Apache Tomcat es, por ejemplo, una conexión JMX local llamada Catalina parece a nadie el acceso a la agente JasperReports servidor JMX.

235


10.8 Uso de los datos de diagnóstico en los Informes

Además de las conexiones JMX remoto, JasperReports Server hace de los datos de diagnóstico disponibles para administradores de informes internos. Los siguientes recursos son visibles para el administrador de sistema (superusuario

por por defecto) en el repositorio: • • •

/ Public / diagnóstico / Diagnostic Data Source - Una fuente de datos personalizado que devuelve todos los campos de diagnóstico. / / / Informe de Diagnóstico Diagnóstico Pública - Un informe que muestra casi todos los campos de diagnóstico individual. / Public / Ad Hoc Componentes / Temas / Tema Diagnóstico - Un recurso JRXML que se puede utilizar como un tema de crear una vista especial de la utilización de campos de diagnóstico.

Figura 10-5 Informe de Diagnóstico en el Repositorio

El tema de diagnóstico y el informe se basan en el origen de datos de diagnóstico. Esta es una fuente de datos personalizada que encapsula la información JMX y la hace disponible como fuente de datos para los informes. Además, hay una Datos de diagnóstico interno Tipo de fuente que se puede utilizar para crear una nueva fuente de datos. Si elimina accidentalmente el fuente de datos de diagnóstico, seleccione Crear> Origen de datos, establecer el tipo de diagnóstico interno de origen de datos, y establecer el nombre y la ubicación para volver a crearla. La siguiente figura muestra el principio del informe de diagnóstico. Este informe muestra casi todos los campos que es disponible a través de JMX y el subsistema de diagnóstico. Este informe sirve como una referencia para los datos de diagnóstico. El informe también es muy útil cuando la configuración del servidor, ya que muestra muchas opciones de configuración del servidor así como la información del sistema, como el uso de memoria. Usted puede utilizar esta información para afinar el rendimiento de la instancia de JasperReports Server.

236


Figura 6.10 Contenido del Informe de Diagnóstico

Atributos 10.9 Excluyendo diagnóstico

La función de diagnóstico JasperReports servidor expone un conjunto de beans gestionados (MBeans), cada uno con un número de Atributos JMX. Por defecto, todos los atributos de todos los MBeans están disponibles. Si desea limitar lo que se expone, puede excluir ninguno de los atributos o frijoles enteros a través del archivo de configuración 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 información 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 podría 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 Diagnósticos

Por defecto, el subsistema de diagnóstico JMX siempre está activada, pero el acceso externo está protegido con contraseña y requiere la apertura del puerto de diagnóstico en el servidor de seguridad como se describe en "Diagnóstico exponiéndolo con JMX Agent de Jaspersoft "en la página 233. Si desea desactivar todos los accesos externos, consulte "Remote Desactivación Las conexiones con el agente JMX "en la página 235. Internamente, el subsistema de diagnóstico es pasivo y no tiene ningún impacto en el rendimiento hasta que se accede en un informe a través de la fuente de datos de diagnóstico. Sin embargo, si desea desactivar diagnósticos en tiempo real completamente, cambiar el nombre o eliminar los siguientes archivos: • •

applicationContext-diagnostic.xml applicationContext-diagnóstico-pro.xml

En ese caso, la fuente de datos de diagnóstico, el informe muestra, y la muestra Tema describen en "Uso de la Datos de diagnóstico en los informes "en la página 236 no funcionará bien. Ellos pueden ser borrados del repositorio.

239


240

APÉNDICE A RESOLUCIÓN DE PROBLEMAS


Este apéndice contiene las siguientes secciones:

• • • • • • • • • • • • • •

Número 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 electrónico Programador Ejecución de Tareas eliminadas Gráficos que no aparece en Excel de Exportación Trabajar con fuentes de datos Hadoop Hive-Reports no se ejecuta Volviendo a la página inicial Antiguo

A.1 Número de usuarios ha superado el

Cuando hay más usuarios definidos en el servidor y su licencia lo permite, la página de inicio de sesión muestra una advertencia; los usuarios pueden iniciar sesión. Después de un período de gracia de 24 horas, se envía un correo al administrador y los usuarios ya no pueden iniciar sesión. funcionalidad mayoría servidor está desactivada. Para volver a habilitar la funcionalidad de servidor: •

•

Contacto Ventas Jaspersoft para la compra de licencias de usuario adicionales. Al instalar la nueva licencia, el servidor sea completamente funcional para todos los usuarios. Retire los usuarios hasta que el número de cuentas de usuario en el servidor está de acuerdo con su licencia. Cuando el servidor funcionalidad está desactivada, los administradores pueden iniciar sesión y seleccionar Gestionar> Usuarios para eliminar el usuario cuentas. Para obtener más información, consulte "Gestión de usuarios" en la página 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 número predeterminado de conexiones es de 20, pero si ejecuta muchos informes simultáneamente en contra de la misma fuente de datos que pueden llegar a la límite de conexión y ver el rendimiento sea menor. En particular, utilizando las API de servicios Web, clientes resto puede lanzar fácilmente muchas ejecuciones de informes al mismo tiempo y alcanzar el límite.

El tamaño de agrupación de conexiones está limitado para evitar tener demasiada memoria permanentemente asignado a las conexiones. Pero si usted necesita más conexiones concurrentes sobre una base regular, usted puede aumentar el límite con el siguiente configuración:

La reducción del límite de tamaño para Ad Hoc Dimensiones



Propiedad

<Constructor-arg type = "int" value = "20" />

Frijol

dataSource ObjectPool Fábrica

Descripción

Cambie el valor por defecto para que coincida con su concurrente conexiones. Asegúrese de que tiene suficiente memoria para manejar las conexiones y el informe concurrente ejecuciones.

Si está utilizando fuentes de datos JNDI, puede configurar el número de conexiones en el servidor de aplicaciones. Para más información, consulte las secciones sobre JNDI en "Trabajar con fuentes de datos" en la página 247.

A.3 Los campos no mencionados en Ad Hoc Editor

El editor de Ad Hoc sólo 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 edición 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 numérico.

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 información sobre cómo habilitar el registro, consulte "Configuración de registros del sistema" en la página 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 visión 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.

Utilice la sintaxis $ R en el tema para especificar la tecla adecuada para la etiqueta de cada campo deseado.

Sube el paquete de recursos como un recurso del Tema.

2.

3.

Al abrir el tema en el Editor de Ad Hoc, las etiquetas se muestran correctamente en el paquete de recursos.

Este método 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 configuración regional que se establecen en su navegador.

Para obtener más información acerca de la localización de JasperReports Server, consulte "Localización" en la página 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 envía listas de valores para el servidor con una operación 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 operación POST. Algunos servidores de aplicaciones están configurados para rechazar tan grande de entrada por defecto.

Por ejemplo, si selecciona 100 000 valores en un filtro especial en una instalación predeterminada en Tomcat, Tomcat registrar un error y redirigir al usuario a la página 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 excepción que redirige a errorPage.jsp java.lang.NullPointerException

Si aplica filtros para campos con un gran número de valores distintos, asegúrese de que su servidor de aplicaciones está configurado para aceptar gran entrada. La siguiente tabla muestra cómo configurar Apache Tomcat. Para otros servidores de aplicaciones, consulte la documentación de su servidor de aplicaciones sobre las operaciones POST.

Configure Apache Tomcat para aceptar grandes valores de filtro


<Tomcat> /conf/server.xml

243



Propiedad

<Port = protocolo de conectores "8080" = "HTTP / 1.1" connectionTimeout = "20000" redirectPort = "8443" URIEncoding = "UTF-8" MaxPostSize = "0" />

Descripción

Añadir la MaxPostSize parámetro para ajustar el número de bytes aceptado por el servidor de aplicaciones; "0" indica que hay no hay límite. Para obtener más información, consulte la Tomcat documentación.

A.6 Ad Hoc dimensiones demasiado grandes

Una dimensión 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 dimensión 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 dimensión y todas las células.

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 están 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 operación de base de datos y una gran carga de procesamiento en el anuncio Editor Hoc. Para limitar este impacto, se puede configurar un límite en el número de miembros en cualquier dimensión.

El proceso interno que calcula grupos, dimensión, y los miembros se llama el categorizador. Cambie el siguiente configuración para reducir este límite y evitar problemas de rendimiento con grandes dimensiones de cardinalidad.

La reducción del límite de tamaño para Ad Hoc Dimensiones


... / WEB-INF / applicationContext-catFactory.xml

Propiedad

maxMembers

Frijol

baseCategorizer

Descripción

Por defecto, el límite se establece en 100.000 miembros por dimensión. Cuando se alcanza el límite, todos los demás miembros se agrupan en un miembro denominado "Otros". Establezca esta propiedad en un valor más bajo en base a su datos típicos y redacción de informes.

Además, las dimensiones y los grupos pueden estar anidados en varios niveles, por ejemplo, País, Provincia y Ciudad. Si sus datos fila tiene 100 países, y cada país 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 también tiene dos dimensiones columna, cada con 10 miembros, habrá 100 columnas en la tabla de referencias cruzadas y un millón de células cuando todas las dimensiones son completamente expandido. Este escenario tiene varias implicaciones:

• • • • •

Dimensiones anidadas y dimensiones altas de cardinalidad crear rápidamente 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 más de 10 miembros y evitar la anidación muchos niveles en cada eje. Utilice filtros como controles de entrada en lugar de su escondite y dimensiones en expansión en la tabla de referencias cruzadas.

244


Por ejemplo, es poco probable que un usuario puede leer los datos ampliado para más de un país a la vez. La gran informe en este ejemplo puede ser reemplazado con dos informes, uno que sólo tiene la dimensión y permite que el país usuario comparar los valores agregados de todos los países, y otro que muestra todas las provincias y ciudades para un solo país seleccionado de una lista de filtro desplegable. Ambos informes se ejecutará mucho más rápido 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 páginas web cargadas desde URLs personalizados especificados cuando el diseño del salpicadero. Estas direcciones URL pueden incluso incluir parámetros de los controles de entrada. Sin embargo, si la URL toma demasiado tiempo para cargar, JasperReports Server mostrará un mensaje de error en lugar del contenido. Si usted espera que la dirección URL personalizada para tomar más de 10 segundos, puede cambiar el tiempo de espera predeterminado de la siguiente manera:

Configuración del cuadro de mandos URL Cargando Tiempo de espera Archivo de configuración

... / scripts / dashboard.designer.js

Propiedad

CUSTOM_URL_IFRAME_TIMEOUT

Descripción

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 impresión de un cuadro de mandos, puede haber un problema con el tamaño del control de entrada valores. Los valores de control de entrada se pasan como parámetros de la URL de esta página, y el servidor de aplicaciones pueden limitar la longitud de la dirección URL que incluye los parámetros. Para evitar este límite y permitir un gran número de valores de control de entrada en la vista de impresión salpicadero, edite la siguiente archivo de configuración, o su equivalente en el servidor de aplicaciones.



<Tomcat> /conf/server.xml

Propiedad

<Port = protocolo de conectores "8080" = "HTTP / 1.1" connectionTimeout = "20000" redirectPort = "8443" URIEncoding = "UTF-8" MaxPostSize = "0" maxHttpHeaderSize = 65535 />

Descripción

Añadir la maxHttpHeaderSize parámetro para ajustar el número de bytes aceptados en la URL por el servidor de aplicaciones; "65535" equivale a 64 KB. Para obtener más información, consulte la Documentación de Tomcat.

245


Programador A.9 Enviar varios mensajes de correo electrónico En caso de que usted tiene un clúster 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 electrónico. El comportamiento depende del tiempo de ejecución de la informes están 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 parámetro en <WAR-file> /WEB-INF/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 después de este retraso. Debido a que los programadores no se comunican directamente, el segundo planificador no puede distinguir entre un nodo que tenía un fracaso y un nodo que todavía se está ejecutando un trabajo. El valor predeterminado se corresponde con 15 minutos. Este parámetro se puede ajustar de la siguiente manera: •

•

Si ha programado los informes que tardan mucho tiempo en ejecutarse, más de 15 minutos, es posible que vea múltiple mensajes de correo electrónico. Aumentar este parámetro en un intervalo más largo de lo esperado de tiempo de ejecución de su informe más largo. Por otro lado, si usted tiene pequeños informes que terminan rápidamente, 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 crítico programada, puede reducir este parámetro, pero el valor debe todavía superar su esperado informe más largo Ejecutar- tiempo.

Reinicie todas las instancias del servidor después de cambiar este parámetro.

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 través del usuario interfaz. El servidor ya no crea estos puestos de trabajo "huérfanos", pero puede aparecer de nuevo cuando se actualiza o importar un catálogo que los contiene. Si ha importado accidentalmente trabajos huérfanos, hacer cambio de configuración se muestra a continuación y reinicie el servidor.

Eliminación automática de Orphan Jobs


... / WEB-INF / applicationContext-report-scheduling.xml

Entrada

autoDeleteBroken UriReportJob

Frijol

cuarzo Programador

Descripción

Si su repositorio tiene trabajos huérfanos que causan errores, cambiar esta propiedad de falsa (El predeterminado) a verdadera. Se detectan y eliminan sólo empleos huérfanos antes de que funcionen, por lo que se eliminarán todos los trabajos huérfanos gradualmente con el tiempo.

246


A.11 Gráficos que no aparece en Excel de Exportación

Al exportar un informe a Excel, JasperReports servidor normalmente elimina las imágenes que decoran el informe y que no encajan en el diseño centrado en los datos de Excel. Sin embargo, JasperReports Server también convierte cualquier gráficos a las imágenes 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 explícitamente, las imágenes de gráfico 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 Imágenes en Excel Exportación



Propiedad

net.sf.jasperreports. export.xls.ignore.graphics

Descripción

De forma predeterminada, esta propiedad se establece en verdadera; en este caso, las imágenes y las imágenes de gráficos del informe no aparecen cuando exportados a Excel. Establezca esta propiedad falsa para hacer tabla las imágenes 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 contraseña 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, también requieren el usuario concede a incluir el host específico a partir del cual se permiten conexiones. De lo contrario, al probar la conexión JDBC, una conexión no puede permitirse siquiera aunque el nombre de usuario y la contraseña son correctos. Para obtener más información, consulte la Documentación de MySQL la configuración de usuarios.

Una manera fácil 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 máquina 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 configuración 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


• • • • •

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

A.12.2 Controladores JDBC

A partir de JasperReports Server 5.1, la gestión de controlador JDBC se automatiza y simplifica. JasperReports Servidor se entrega con controladores para algunas bases de datos, que figuran en el cuadro de diálogo para la creación de fuentes de datos. Si el controlador JDBC para su base de datos no está incluido, el administrador del sistema puede cargar fácilmente el controlador y utilizarlo inmediatamente en un fuente de datos. Para obtener instrucciones sobre la actualización de drivers JDBC sin necesidad de reiniciar el servidor, consulte "Controladores de Gestión de JDBC" en la página 68. Para obtener instrucciones sobre cómo agregar controladores JDBC cuando se utiliza JBoss, consulte la siguiente sección.

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:

Configuración de JBoss para controladores JDBC


... / META-INF / jboss-despliegue-structure.xml

Propiedad

ruta del recurso-root = "<controlador> .jar"

Descripción

Busque el elemento raíz de los recursos para el controlador JDBC que añadido y descomentar. El nombre del archivo JAR debe coincidir exactamente con el nombre del controlador JDBC que cargar. Puede agregar un nuevo elemento raíz de recursos si el Controlador JDBC de su elección no se da en el comentado lista.

3. Reinicie JBoss.

A.12.4 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 definición 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 instalación de JasperReports Server en Linux desde un RPM usando apt-get, rpm, o yum, el PostgreSQL integrado sólo permite que el usuario que es dueño de PostgreSQL para conectarse. Introduzca el siguientes comandos para conectar:

su - postgres psql -U postgres

• Muchas bases de datos, incluyendo MySQL, también requieren que los permisos de usuario Nombre de host específico desde que se permiten conexiones. De lo contrario, al probar la conexión JDBC, una conexión puede no ser permitido a pesar de que el nombre de usuario y la contraseña son correctos. Por ejemplo, véase la Documentación de MySQL para la configuración de usuarios.

Una manera bastante fácil 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 típicas contra su base de datos.

A.12.5 JDBC URL de base de datos

Cuando usted elige un driver JDBC, el asistente de creación de fuente de datos que solicita los elementos de la dirección URL que son necesarios para su base de datos. En algunos casos, puede que tenga que añadir 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 específico de base de datos y base de datos. La siguiente tabla muestra las direcciones URL predeterminadas y números de puerto, como así como ejemplos de argumentos opcionales soportados por las bases de datos más comunes:

Base de datos

PostgreSQL

MySQL y MariaDB

Ingres

Oracle

SQL Server

JTDS SQL Server conductor

DB2

Por defecto JDBC URL base de datos

jdbc: postgresql: // <host>: 5432 / <db-name>

jdbc: mysql: // <host>: 3306 / <db-name> useUnicode = true y characterEncoding = UTF-8?

jdbc: ingres: // <host>: II7 / <db-name>; CURSOR = READONLY; auto = multi

jdbc: oracle: thin: @ <host>: 1521: ORCL

jdbc: sqlserver: // <host>: 1433; nombredebasededatos = <db-name>; SelectMethod = cursor

jdbc: jtds: sqlserver: // <host>: 1433 / <db-name>

jdbc: db2: // <host>: 50000 / <db-name>: driverType = 4; currentSchema = <schema- nombre>; fullyMaterializeLobData = true; fullyMaterializeInputStreams = true; progressiveStreaming = 2; progresssiveLocators = 2

jdbc: vertica: // <host>: 5433 / <db-name>

jdbc: informix-sqli: // <host>: 1526 / <db-name>: INFORMIXSERVER = <nombre-servidor>

jdbc: sybase: Tds: <host>:? 5433 ServiceName = <service-name>

Vertica

Informix

Vertica

249


A.12.6 Servicios JNDI en Apache Tomcat

Si tiene problemas con una conexión JNDI, es necesario mirar a la definición JNDI para su base de datos en su servidor de aplicaciones. Esta sección 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 documentación.

Una conexión JNDI en Tomcat se define en dos archivos diferentes. Asegúrese de que ambos tienen la siguiente información:

• <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> <Descripción> 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>

También puedes ver los siguientes puntos:

• •

Asegúrese de que el controlador para su conexión 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 sección correspondiente en el Solución de problemas Apéndice del Guía de instalación del servidor JasperReports. Consulte la Documentación de Apache Tomcat para fuentes de datos JNDI.

•

A.12.7 Servicios JNDI de JBoss

Después de definir servicios JNDI en el servidor de aplicaciones JBoss, JasperReports Server no detecta automáticamente los nuevos servicios. Para utilizar los nuevos servicios JNDI como fuentes de datos en el servidor, siga estos pasos:

1.

2.

3.

4.

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.

Modificar jboss-web.xml para incluir una referencia a esta fuente de datos.

Debido a que los archivos de configuración de implementación tales como web.xml se modificaron, redistribuir los JasperReports Aplicación de servidor.

Ahora puede definir la fuente de datos JNDI en el repositorio, como se describe en "Fuentes de datos JNDI" en la página 71.

A.12.8

1.

Servicios JNDI en WebLogic

Añada la siguiente definición a la <Referencia descriptor> nodo WEB-INF / weblogic.xml:

Siga estos pasos para configurar JasperReports Server para utilizar fuentes de datos JNDI con WebLogic:

250


<Resource-description> <Res-ref-name> TestDatabase </ res-ref-name> <Jndi-name> jdbc / TestDatabase </ jndi-name> </ Resource-description>

2. Añada la siguiente definición de WEB-INF / web.xml:

<Resource-ref> <Descripción> 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.

En la consola de administración de WebLogic, agregar un origen de datos con TestDatabase como el nombre JNDI. Reinicie la instancia-JasperServer pro utilizando la consola de administración de WebLogic.

A.12.9 Creación de un origen de datos en SQL Server mediante la autenticación de Windows

Si su base de datos es Microsoft SQL Server y se utiliza la autenticación de Windows (también denominada seguridad integrada), utilizar el siguiente procedimiento para crear una fuente de datos. 1.

2.

3.

4.

5.

6.

7.

8.

9.

Ir a la descargar página para Microsoft SQL Server JDBC Driver 3.0.

No utilice la versión 4.0 de este controlador, ya que no va a funcionar.

Descargue y ejecute el archivo ejecutable de extracción: 1033 \ sqljdbc_3.0.1301.101_enu.exe

Abra la carpeta extraída sqljdbc_3.0 \ enu \ auth, y luego o bien la x64 o la subcarpeta x86, dependiendo de si su versión de Windows de 64 bits o de 32 bits, respectivamente.

Copie el sqljdbc_auth.dll archivo a la carpeta de que su servidor de aplicaciones busca automáticamente archivos DLL. Para Tomcat, este es el <tomcat> \ bin.

Reinicie el servidor de aplicaciones. Acceda a JasperReports Server como administrador y.



La página se actualiza para mostrar los campos necesarios para una fuente de datos JDBC. Escriba un nombre y una descripción 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, añada 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 Contraseña, escriba cualquier cadena no esté en blanco que desee, por ejemplo, "ninguno". 15 Configure los campos de la zona horaria y Guardar ubicación si es necesario. 16 Haga clic en Prueba de conexión y verifique que la conexión 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 versión más reciente del servidor, por ejemplo después de una actualización. La razón 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 demás servidores de la colmena, crear una fuente de datos JDBC que utiliza el controlador JDBC Hive. Para obtener instrucciones, consulte "Hadoop Hive-Data Fuentes "en la página 78. 2.

3.

Actualice sus informes basados en Hadoop Hive-para utilizar la nueva fuente de datos. Eliminar la vieja fuente de datos importados,.

A.14 Volviendo a la página inicial Antiguo

JasperReports Server 5.5 introduce una nueva página de inicio con más funcionalidad y el acceso a más características en la servidor. Si la instalación o personalizaciones requieren la página principal viejo con los botones grandes, puede especificar que el servidor utilice la página de inicio de edad.

1.

2.

Abra el <js-webapp> file /WEB-INF/flows/homeFlow.xml.

Busque la siguiente línea:

<Vista de estado id = "Homeview" vista = "módulos / home / home">

3. Sustituya el valor vista como se muestra en el siguiente ejemplo:

<Vista de estado id = view "Homeview" = "módulos / old_home / home">

4. Reinicie el servidor o volver a implementar la aplicación web JasperReports Server.

252

ANEXO B LOCALIZACIÓN

De forma predeterminada, JasperReports Server se presenta en el idioma Inglés (versión estadounidense), pero es compatible con otros idiomas, así, con traducciones que incluyen formatos de datos y paquetes de recursos. Los idiomas soportados son el portugués de Brasil, chino (simplificado), francés, alemán, italiano, japonés y español. Las traducciones están incluidos en la instancia de JasperReports servidor por defecto; ver la aplicación en un lugar específico, seleccione antes de iniciar la sesión.

Si usted necesita para apoyar un idioma que no sea apoyado a los queridos, usted puede localizar JasperReports Server, incluyendo la traducción a un idioma diferente al proporcionar etiquetas y los mensajes en el idioma preferido. Para otros lugares, es posible que también tenga que cambiar la configuración regional predeterminada y la zona horaria. En este capítulo se describe la procedimientos y unos pocos ejemplos.

Para obtener información sobre la localización de Dominios, temas, y los informes, consulte la Guía del usuario de JasperReports Server. Este capítulo contiene las siguientes secciones:

• • • • •

Configuración del servidor JasperReports para Multi-byte Fuentes UTF-8 Configuración Cambio de codificación de caracteres Creación de una configuración regional Configuración de JasperReports servidores que ofrece una configuración regional

B.1 Configuración del servidor JasperReports para Multi-byte Fuentes

Aunque los paquetes de traducción para barco chino y japonés con JasperReports Server, los tipos de letra que utiliza por por defecto no son compatibles con estos idiomas. Por lo tanto, si su organización 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 configuración de fuentes para circunstancias especiales. Por ejemplo, puede configurar Jaspersoft OLAP para ofrecer diferentes opciones en el Gráfico fuente predeterminada campo en el cuadro de diálogo Opciones de gráfico. 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 sección se describen los pasos que puede que tenga que tomar, dependiendo de la funcionalidad que utiliza y las locales que apoya. Las tareas de esta sección requieren que editar estos archivos:

253


Nombre del archivo

jpivot_internal_messages.properties

Ubicación

WEB-INF / interna

Propósito de ediciones

Especificación de las fuentes de carta para Jaspersoft OLAP Comunidad

Especificación de las fuentes de carta para Jaspersoft OLAP Profesional y Empresa

La incrustación de fuentes en PDF

Ja_pro_internal_messages.properties WEB-INF / interna

userConfig.xml WEB-INF / JPivot / impresión

B.1.1 Activación de fuentes asiáticas del este

La configuración 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 varían, dependiendo de su versión de Windows.

1.

2. 3.

4.

5.

6.

7.

8.

En el Panel de control, haga clic en Regional y de idioma.

En el diálogo regional y de idioma, seleccione la Teclados e idiomas tab. En la ficha, instalar el idioma (s) que usted necesita.

Si es necesario, instale las modificaciones de teclado relacionados.

Cierre el panel de control.

Busque el archivo fontconfig.properties.src en el directorio C: \ Archivos de programa \ <JRE_DIRECTORY> \ lib. En el archivo, busque la siguiente línea:

sequence.allfonts = alfabético / default, dingbats, símbolo

Cambie la línea para incluir las fuentes de Asia Oriental que usted necesita, tales como los siguientes:

sequence.allfonts = alfabético / default, dingbats, símbolo, coreano, japonés, chino- ms936, 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 Configuración de Gráficos Ad Hoc para fuentes asiáticas

La fuente predeterminada para la leyenda de un gráfico Ad Hoc no admite algunos caracteres asiáticos, como el japonés glifos kana. Fuentes predeterminadas para informes ad hoc se definen en el archivo siguiente:

254


Cambiar Hoc Ad Gráfico Leyenda Fuentes


... / WEB-INF / adhoc / themes / default.new.jrxml

Propiedad

Nombre style = "ChartLegend" fontName =

Valor

"Sans DejaVu" <Default>

"SansSerif"

Descripción

El valor por defecto, DejaVu Sans, no incluir glifos kana, y por lo tanto la leyenda contiene símbolos en blanco.

Si la máquina servidor tiene sistema japonés fuentes disponibles, estableciendo el valor a SansSerif debería funcionar en la mayoría de las configuraciones de fuente de Java.

Después 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 máquina del servidor, puedes añadir la siguiente manera:

1.

2.

3.

4.

5.

Empaquetar una fuente japonesa como una extensión JAR fuente. Añadir el nuevo JAR a la carpeta / lib WEB-INF del archivo WAR del servidor JasperReports.

Editar el archivo default.new.jrxml como se describe más 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 debería mostrar ahora correctamente en el Visor de informes, pero la vista correspondiente no puede mostrar las leyendas del gráfico correctamente dentro del editor de Ad Hoc.

B.1.3 Configuración de las opciones de OLAP para gráficos 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 Gráfico fuente predeterminada campo en el cuadro de diálogo Opciones de gráfico del Vista OLAP. Esto puede ser necesario si se implementa locales que América 1 no admite. De diálogo Opciones de gráfico de una vista OLAP incluye la Gráfico fuente predeterminada campo, lo que permite a los usuarios seleccionar el letra a utilizar en los gráficos. 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 gráfico: 1. Guarde el archivo jpivot_internal_messages.properties con un nuevo nombre que refleja la nueva configuración regional. Por ejemplo, para el japonés, el nuevo archivo se llamaría 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 Edición 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 más 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

4.

5.

Guarde el archivo.

Reinicie JasperReports Server.

B.1.4 La incrustación 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 sección para que las fuentes disponibles para formateo XSL de JasperReports Servidor Objeto (XSL-FO) del procesador. Debe tener derechos de distribución 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 métricas. Para obtener más información, consulte la Documentación de Apache FOP.

Puede incrustar cualquier fuente Unicode utilizando este procedimiento, aunque ficheros más grandes pueden tener significativamente más grande capacidad de memoria. Con el fin de mantener los requisitos de memoria pequeña, Jaspersoft recomienda que utilice la más pequeña archivo de fuente que puede, como SimHei para apoyar el chino, japonés y coreano.

B.2 UTF-8 Configuración

JasperReports Serveruses UTF-8 (8-bit Unicode Transformation Format) codificación de caracteres. Si su base de datos servidor o servidor de aplicaciones utiliza una forma de codificación de caracteres diferente, puede que tenga que configurarlos para apoyar UTF-8. En esta sección se proporciona información para configurar la codificación 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 codificación de caracteres por defecto no es UTF-8, puede que tenga que hacer cambios similares para apoyar a ciertos lugares. Para obtener más información, consulte la documentación de su servidor de aplicaciones o de bases de datos.

B.2.1 Tomcat

Por defecto, Tomcat utiliza ISO-8859-1 (ISO Latin 1) codificación 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 América 1 no admite, debe cambiar el formato de codificación 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 distribución 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 código:

<! - 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 sección, inserte la línea siguiente antes de la etiqueta de cierre:

URIEncoding = "UTF-8"

3. Por ejemplo, después de los cambios, la sección podría 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" URIEncoding = "UTF-8" </ Connector>

4.

5.

Guarde el archivo.

Reinicie Tomcat.

B.2.2 JBoss

Desde JBoss utiliza Tomcat como su conector Web, los cambios de configuración en "Tomcat" en la página 256) también 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 configuración, a continuación, reiniciar JBoss.

B.2.3 PostgreSQL

JasperReports Server requiere PostgresSQL utilizar UTF-8 codificación 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 codificación JasperServer = 'utf8';

257


B.2.4 MySQL

Por defecto, MySQL utiliza la norma ISO-8859-1 (ISO Latin 1) codificación de caracteres. Sin embargo, JasperReports Server requiere MySQL a usar UTF-8 codificación de caracteres para la base de datos que almacena su repositorio, así como para las fuentes de datos. La forma más 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 también requiere que el useUnicode y characterEncoding parámetros 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 parámetros se puede agregar a la JDBC URL en WEB-INF / context.xml. La siguiente es una muestra definición de recursos de ese archivo:

<Recursos name = "jdbc / JasperServer" auth = tipo "Container" = "javax.sql.DataSource" maxActive = "100" maxIdle = "30" maxWait = "10000" 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 típicamente server / default / deploy. El siguiente es un ejemplo de una definición de recursos en una de esos archivos XML:

<-Tx-datasource locales> <Nombre JNDI jdbc / JasperServer /> <Conexión-url> ? jdbc: mysql: // localhost / JasperServer useUnicode = true & amp; characterEncoding = UTF-8 </ Conexión-url> <Com.mysql.jdbc.Driver clase controlador /> <Nombre de usuario jasperadmin /> <Contraseña 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 edición 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 más información 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 línea del script:

# Establezca el argumento predeterminado -Djava.endorsed.dirs

rem Establecer el argumento predeterminado -Djava.endorsed.dirs

Linux Ventanas

2.

Linux Ventanas

Agregue la siguiente línea antes de ella:

JAVA_OPTS = "$ JAVA_OPTS" -Doracle.jdbc.defaultNChar = true

establecer JAVA_OPTS =% JAVA_OPTS% -Doracle.jdbc.defaultNChar = true

Desde JBoss también utiliza JAVA_OPTS pasar opciones a la JVM, puede agregar la misma JAVA_OPTS línea bin / run.sh (Linux) y bin / run.bat (Windows). Añádelo antes de esta línea:

Linux Ventanas

# Configuración de los directorios java aprobado

Configuración rem los dirs java aprobado

B.3 Cambio de codificación de caracteres

Dependiendo del software de terceros que utiliza y los lugares que usted apoya, es posible que también tenga que configurar JasperReports Server y su huésped. Los pasos descritos en esta sección sólo son necesarios en determinadas circunstancias, como si va a utilizar una forma de codificación de caracteres UTF-8 que no puede manejar. Para utilizar una forma de codificación de caracteres que no sea UTF-8, debe configurar JasperReports Server, su aplicación servidor, y el servidor de base de datos.

Las tareas de esta sección requieren que se modifique el siguiente archivo:

Nombre del archivo

applicationContext.xml

Ubicación

WEB-INF


Cambiar la codificación de caracteres

B.3.1 Configuración del servidor JasperReports

Para configurar JasperReports Server para un formulario de codificación diferente, debe editar el archivo applicationContext.xml. Para especificar una forma de codificación 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 codificación escriba su uso del servidor del servidor de base de datos y la aplicación. Por ejemplo:

<Bean id = "encodingProvider" class = "com.jaspersoft.jasperserver.api.common.util. StaticCharacterEncodingProvider "> <Valor constructor-arg = "UTF-16" /> </ Bean>

3.

4.

Guarde el archivo.

Reinicie JasperReports Server.

B.3.2 Configuración del servidor de base de servidor de aplicaciones y

Si desea utilizar una codificación de caracteres que no sea UTF-8, puede que tenga que configurar el software de terceros que JasperReports Server se basa en. Para obtener más información, consulte la documentación asociada a su servidor de aplicaciones y el servidor de base de datos. Para Tomcat, puede especificar una codificación de caracteres diferente al seguir pasos similares a los descritos en "Tomcat" en la página 256 y "Configuración de UTF-8" en la página 256.

Este paso sólo es necesario si va a admitir configuraciones regionales que requiere una codificación de caracteres diferente, como UTF-16. Además de este cambio, el servidor de aplicaciones y base de datos deben estar configurados para utilizar el codificación de caracteres que usted requiere. Para obtener más información, consulte la documentación asociada a su software de terceros.

B.3.3 Configuración de Análisis 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 interactúa con (si se trata de la base de datos del repositorio o un base de datos accesible a través 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, podría dar una orden similar a la siguiente:

crear base de datos de codificación foodmart_ja = 'utf8';

2. La dirección 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 definición URL de la base de datos de ejemplo Foodmart podría ser similar a la siguiente:

<Name = "jdbc / MondrianFoodMart_ja" auth = tipo "Container" = "javax.sql.DataSource" maxActive = "100" maxIdle = "30" maxWait = "10000" username = "postgres" password = "postgres" driverClassName = "org.postgresql.Driver" url = "jdbc: postgresql: // localhost: 5432 / foodmart_ja" />

3. Opciones de codificación deben agregarse a la cadena de conexión 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 conexión:

jdbc: postgresql: // localhost: 5432 / foodmart_ja

260


B.4 Creación de una configuración regional Cuando desea crear otras localidades para JasperReports Server, la traducción es solamente un aspecto de la localización. Creación de una configuración regional incluye las siguientes tareas:

• • •

La traducción de las etiquetas y los mensajes. Cambio de formatos de fecha. Cambio de máscaras de formato.

Las tareas de esta sección requieren que editar estos archivos:

Archivo

* archivos .properties

jasperserver_config.properties

adhoc_masks

Ubicación

WEB-INF \ paquetes

WEB-INF \ paquetes

WEB-INF \ paquetes


La traducción de las etiquetas y mensajes

Cambio de formatos de fecha

Cambio de máscaras de formato

B.4.1 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 ... / WEB- INF / lía directorio. Los archivos de propiedades contienen todas las etiquetas y los mensajes utilizados en JasperReports Server y Jaspersoft OLAP. Un paquete incluye un entorno local por omisión (por ejemplo, jasperserver_messages.properties), que está escrita en los Estados Unidos Inglés. Entonces se compone de todos los archivos de propiedades con el mismo nombre base, pero diferente configuración regional (como jasperserver_messages_fr.properties). Cada archivo se traduce todas las cadenas del archivo predeterminado en el idioma determinado por la configuración regional. El lenguaje de programación Java tiene normas para locales especificando y locales alternativos y que la determinación de locale en el haz de usar.

Por defecto los paquetes de recursos en JasperReports Servidor

Presente en ... / WEB-INF / paquetes

AdHocFiltersBundle.properties

adhoc_masks.properties

adhoc_messages.properties

calendar.properties

CommonBundle.properties

createsldatasource_messages .properties

domain_designer_messages .properties

Descripción

Las etiquetas y mensajes para el panel Filtros Ad Hoc.

Máscaras (formatos de datos) para los valores que aparecen en el Editor de Ad Hoc. Las etiquetas y los mensajes para el Editor Ad Hoc.

Las etiquetas y los mensajes utilizados por el diálogo del calendario emergente. Bundle para las pruebas.

Las etiquetas y los mensajes para el diálogo Crear dominio.

Las etiquetas y los mensajes de la interfaz de usuario Diseñador de dominio.

261


Por defecto los paquetes de recursos en JasperReports Servidor


HomeBundle.properties

image_descriptions_messages .properties

jasperreports_highcharts_ messages.properties

jasperreports_messages .properties

jasperserver_config.properties

jasperserver_messages.properties

Descripción

Etiquetas para la nueva página de inicio introdujeron en la versión 5.5.

Las etiquetas y los mensajes para el (Amazon Web Services) máquina de AWS imágenes.

Mensajes para los gráficos en el visor de informes.

Las etiquetas y los mensajes para el visor de informes.

Propiedades de configuración para fechas y fecha-veces.

Las etiquetas y los mensajes utilizados en el principal usuario del servidor JasperReports interfaz.

Mensajes utilizados en los errores y excepciones, tanto en la interfaz de usuario y en el registro de mensajes.

Las etiquetas y los mensajes utilizados al validar licencias.

Mensajes de registro internas.

jsexceptions_messages.properties

LicenseMessages.properties

logger_descriptions.properties logger_descriptions_pro.properties

pro_nav_messages.properties

querybuilder_messages.properties

Las etiquetas y los mensajes de la barra de menús y la página de Inicio de edad. Las etiquetas y los mensajes para el diálogo Elegir datos (para la creación de un Tema de dominio antes de usar editor de Ad Hoc).

Las etiquetas y los mensajes para el diálogo de opciones de informe.

report_option_messages .properties

ScalableInputControlsBundle .properties

scheduling_ws.properties

semanticLayer.properties

Etiquetas para listas de valores en los controles de entrada.

Los mensajes de validación para el programador de reportes. Las etiquetas y los mensajes para el diseñador de dominio y datos de Ad Hoc políticas.

Por defecto los paquetes de recursos en Jaspersoft OLAP


ja_mondrian.properties

Descripción

Las etiquetas y los mensajes de la interfaz de usuario de configuración de OLAP.

262


Por defecto los paquetes de recursos en Jaspersoft OLAP


JA-pro_messages.properties

jpivot_messages.properties

mondrian_exception_messages .properties

Descripción

Las etiquetas y los mensajes en la edición comercial OLAP espectador.

Las etiquetas y los mensajes en la edición de la comunidad OLAP espectador. Mensajes de error de validación MDX específicas al motor de análisis 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

jaspersoft_portlet_ message.properties

Ubicación

WEB-INF \ agrupa bajo el lugar donde el portlet se despliega. Por ejemplo:

C: \ liferay \ webapps \ <portlet_context_ Nombre> \ WEB-INF \ manojos (donde <portlet_ nombre_contexto> es el nombre especificado al el portlet JasperReports Server no desplegado).

Descripción

Las etiquetas y los mensajes que aparecerá en el portlet, incluyendo el texto de ayuda.

Tenga en cuenta que esto no incluye texto en informes específicos; 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:

Componente

iReport

iReport plug-in

Archivo

ireport.properties

irplugin.properties

Descripción

Las etiquetas y los mensajes utilizados en Jaspersoft iReport Designer.

Las etiquetas y los mensajes utilizados en iReport Plug-in para JasperReports Server.

B.4.2 Creación 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 versión predeterminada del archivo de propiedades, y

<Locale> es un identificador de configuración regional en Java compatible.

Por ejemplo, considere el paquete de recursos del servidor JasperReports centrales. Para varios locales, podría ser nombrado como de la siguiente manera:

263


Tipo de Archivo

Paquete de recursos predeterminado Inglés

Francés

Francés en Suiza

Nombre del archivo

jasperserver_messages.properties

jasperserver_messages_en.properties

jasperserver_messages_fr.properties

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 específicas de configuración regional. Java archivos de propiedades utilizan el ISO-8859-1 (Latin-1) de codificación que es el mismo para todos ASCII Inglés no caracteres acentuados. Para los personajes internacionales que no están 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 (manteniéndolos en el mismo directorio que los originales) y cambiarles el nombre de acuerdo con su configuración regional. 2. Traducir etiquetas cada uno * de archivos .properties y mensajes en el nuevo idioma.

Algunas de las cadenas en los archivos de propiedades son los formatos de fecha y máscaras de formato que pueden necesitar ser modificado para la nueva configuración regional. Para obtener más información, consulte "Ajuste de la fecha y de fecha y hora formatos" en la página 264. 3.

4.

Guarde los archivos.

Si el nuevo escenario requiere codificación o fuentes de carácter específico, asegúrese de que JasperReports Server y el tercero software de terceros se basa en están configurados para apoyarlos. Para obtener más información, consulte "Configuración de JasperReports Server para Multi-byte Fuentes "en la página 253.

El nuevo local no está disponible en JasperReports Server hasta que siga los pasos descritos en "Especificación de los entornos nacionales adicionales" en la página 266.

B.4.3 Ajuste de la fecha y de fecha y hora Formatos

Cada entorno puede tener sus propias reglas para la visualización 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 Inglés, 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 través de toda la aplicación. 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 patrón. 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 Configuración de formato de datos Máscaras

Cada entorno puede tener sus propias máscaras de formato que determinan cómo los números aparecen en el Editor de Ad Hoc. Para hacer los datos de las máscaras de formato varían de acuerdo al lugar, debe crear un archivo adhoc_masks para la nueva configuración regional. Para ello, copiar los adhoc_masks.properties de archivo a un nuevo nombre que especifica el nuevo local y cambiar las máscaras se define en el nuevo archivo. Por ejemplo, el archivo francés sería nombrado adhoc_masks_fr.properties.

Las máscaras de formato de datos que se describen en esta sección 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 máscaras de formato de datos disponibles para las fechas, los números enteros y decimales editando el enmascaramiento existente entradas o añadiendo otros nuevos. Las entradas por defecto se indican en la siguiente tabla:

Formato de datos de propiedades de la máscara ADH_100_MASK_date_0 ADH_100_MASK_date_1 ADH_100_MASK_date_2 ADH_100_MASK_date_3

ADH_100_MASK_int_0 ADH_100_MASK_int_1 ADH_100_MASK_int_2 ADH_100_MASK_int_3

ADH_100_MASK_dec_0 ADH_100_MASK_dec_1 ADH_100_MASK_dec_2 ADH_100_MASK_dec_3

= = = =

corto, ocultar de largo, ocultar corto, mediano medio, medio

Aparición en en_US Locale

3/31/09 31 de marzo 2009 31 de marzo 2009 31 de marzo 2009 23:59:59

-1234 -1234 (1.234 dólares) (1234)

-1,234.56 -1234 ($ 1,234.56) (1.234 dólares)

= = = =

= = = =

# ## 0 0 $ #, ## 0; ($ #, ## 0) # ## 0; (# ## 0)

# ## 0,00 0 $ #, ## 0.00; ($ #, ## 0.00) $ #, ## 0; ($ #, ## 0)

Las máscaras de formato de datos para cada tipo se cuentan a partir de cero; crear nuevas máscaras añadiendo nueva entradas. Las claves de las nuevas entradas deben seguir la convención establecida en las entradas predeterminadas. Por ejemplo, una nueva máscara de formato de datos decimal podría tener este ID:

ADH_100_MASK_dec_4

Máscaras de formato de fecha se implementan utilizando java.text.SimpleDateFormat y extensiones de JasperReports que proporcionar acceso a máscaras predefinidas de formato de datos localizadas. Nuevas máscaras 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 internacionalización es limitado. •

265


Ambas máscaras enteros y formato de datos decimal se implementan con java.text.DecimalFormat, Que localiza caracteres en la especificación de formato. Por ejemplo, considere el caso del símbolo de agrupación de dígitos (Separador de miles): en francés, es un espacio; en EE.UU. Inglés, es una coma. DecimalFormat maneja tanto casos: si el patrón de número #, se usa ## 0, el número 6000 aparece como 6 000 en el entorno local francés y 6.000 en la localidad EE.UU. Inglés.

Para obtener más información acerca de la manipulación de Java de decimales y de formato de fecha máscaras, 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 están enmascarados como USD (dólares estadounidenses). Dependiendo de sus datos, puede que tenga que soportar una moneda diferente, apoyar más de una moneda, o el apoyo conversión de moneda. Estos son tres casos muy diferentes: • El apoyo a una moneda diferente a USD implica cambiar las máscaras monetarios de utilizar la correcta

símbolo de su moneda (por ejemplo, sustituir el $símbolo en la ADH_100_MASK_dec_2 y ADH_ 100_MASK_dec_3 máscaras). Sin embargo, el cambio de este símbolo en realidad no convertir las monedas en sus informes.

Apoyo a otras monedas además de USD implica añadir nuevas máscaras. Sin embargo, la adición de los datos formatos en realidad no convertir las monedas en sus informes.

Apoyo a la conversión de moneda es más complicado; debe tener en cuenta cuestiones tales como las fluctuaciones en las tasas de conversión. A menudo, un servicio de terceros puede ser utilizado para realizar la conversión de moneda

•

•

B.5 Configuración de JasperReports servidores que ofrece una configuración regional Después de crear un local, debe configurar JasperReports Server para ofrecer a sus usuarios, junto con cualquier nuevo zonas horarias.

Las tareas de esta sección requieren que editar estos archivos:

Nombre del archivo

applicationContext-security.xml

JasperServer-servlet.xml

Ubicación

WEB-INF

WEB-INF


Especificar localizaciones adicionales

Especificación de zonas horarias adicionales

B.5.1 Especificación de los entornos nacionales adicionales

De forma predeterminada, JasperReports Server aparece en la configuración regional seleccionada en el navegador del usuario final. La Página de registro permite los usuarios especificar la configuración 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 configuración 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>

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>

2. Añadir el nuevo escenario al final de la lista. Por ejemplo, añada la siguiente línea de Holandés (nl_NL de Java locale):

<Tipo value = "java.util.Locale"> nl_NL / value>

3.

4.

Guarde el archivo.

Reinicie JasperReports Server, y acceder a la aplicación web para probar su traducción. Revisión 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 Especificación 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 página de Inicio de sesión 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> América / Denver </ value> <Valor> América / Chicago </ value> <Valor> América / Chicago </ value> <Valor> Europe / London </ value> <Valor> Europe / Berlin </ value> <Valor> Europa / Bucarest </ value> </ List> </ Propiedad> </ Bean>

2. Añadir la nueva zona horaria a la parte inferior de la lista. Especifique cada zona horaria que la zona horaria estándar de Java valores para que JasperReports servidor ajusta al horario de verano, cuando proceda. Por ejemplo, añadir el siguiendo la línea de Tokio:

<Valor> Asia / Tokio </ value>

3. Guarde el archivo.

267


4. Reinicie JasperReports Server.

Para obtener más información 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 específica en Java. Se convierte en la zona horaria predeterminada para todos los usuarios, pero aún así puede seleccionar una diferente zona horaria cuando inician sesión. Para establecer una zona horaria predeterminada, establezca la user.timezone propiedad en la JVM, como se muestra en las tablas siguientes. Busque la configuración de la JVM de archivos que contiene para su plataforma y servidor de aplicaciones. El valor de la propiedad debe ser una Zona horaria en Java compatible, por ejemplo, Europe / Bucharest. Debe reiniciar el servidor de aplicaciones para que los cambios surtan efecto. La zona horaria se establece para todas las aplicaciones en el servidor de aplicaciones, incluyendo JasperReports Server.

Valores de JVM para zona horaria predeterminada

Funcionamiento Sistema

Ventanas

App Servidor

Tomcat

JBoss

Linux Tomcat

JBoss

Ambos GlassFish

Archivo Ajuste

<Apache-tomcat> \ bin \ setenv.bat

<Jboss> \ bin \ run.bat

<Apache-tomcat> /bin/setenv.sh

<Jboss> /bin/run.sh

<De vidrio pescado> / - dominios / dominio1 / config / domain.xml

Añadir esta línea de código:

establecer JAVA_OPTS =% JAVA_OPTS% -Duser.timezone = <Zona horaria>

Añadir esta línea de código:

JAVA_OPTS exportación = "$ JAVA_OPTS -Duser.timezone = <Zona horaria> "

Añadir esta línea de código para <jvm-options> sección:

-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 colección predefinida de campos, la Hoc Editor de anuncios le permite arrastrar y soltar campos, dimensiones y medidas a explorar los datos y crear tablas, gráficos 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 podrían ser añadido a cuadros de mando y ser programado, pero cuando editado en iReport, perdido su agrupación y clasificación. En el versión 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 pérdida, y puede ser programado y se añade a cuadros de mando.

Especial Vista

Una vista de los datos que se basa en una conexión de cliente de dominio, Tema, o OLAP. Un punto de vista ad hoc puede ser una tabla, gráfico o tabla de referencias cruzadas y es el punto de entrada para operaciones de análisis, tales como slice and dice, drill down y drill a través. 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. Función de agregación

Una función 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 añadirse 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 cálculo; valores de nivel incluyen Actual (no disponible para percentof), ColumnGroup, ColumnTotal, rowgroup, RowTotal, Total

Vista de Análisis

Ver OLAP Vista.

Auditoría Archiving

Para evitar registros de auditoría se haga demasiado grande para ser de fácil acceso, el instalador configura JasperReports Servidor para mover los registros de auditoría actuales a un archivo después de un cierto número de días, y para eliminar los registros en el archivo después de un cierta edad. El archivo es otra tabla en la base de datos de repositorio del JasperReports Server. Dominios de auditoría

Un dominio que tiene acceso a los datos de auditoría en el repositorio y permite a los administradores crear informes ad hoc de servidor actividad. Hay un dominio de los registros de auditoría actuales y uno para los registros archivados.

269


Registro de auditoría

Cuando está habilitada la auditoría, el registro de auditoría 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 sesión, el nivel de detalle se reunieron, y cuándo archivar los datos. Los registros de auditoría se almacenan en la misma base de datos privada que JasperReports Server utiliza para almacenar el repositorio, pero los datos sólo se puede acceder a través de los dominios de auditoría. Auditoría

Una característica de la edición 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 fórmula definida por el usuario, que puede incluir cualquier número de campos, operadores y constantes. Para Dominios, un campo calculado se convierte en uno de los artículos a que pueden solicitar archivos de seguridad y la configuración regional paquetes del dominio. Hay más funciones disponibles para Ad Hoc Vea los cálculos que para los dominios. CRM

Customer Relationship Management. La práctica de la gestión de todas las facetas de la interacción de la empresa con su clientela. Aplicaciones de CRM ayudan a las empresas a seguir y apoyar a sus clientes.

CrossJoin

Una función MDX que combina dos o más dimensiones en un solo eje (columna o fila).

Cube

La base de la mayoría de las aplicaciones OLAP, un cubo es una estructura de datos que contiene tres o más 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 través de los elementos del menú como una simple función 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 colección de informes, controles de entrada, gráficos, 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 número de datos a un rango de fechas. Contenido web incorporado, como otra web- aplicaciones o mapas base, hacen cuadros de mando más 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 artículos disponible en el dominio. Por ejemplo, con una fuente de datos JDBC, puede escribir una consulta SQL que incluye funciones complejas para la selección de datos. Puede utilizar los elementos de una tabla derivada para otras operaciones sobre el Dominio, como unión de tablas, la definición de un campo calculado, o filtrado. Los elementos de una tabla derivada también puede ser referencia en archivos de seguridad y la configuración regional paquetes del dominio. Política de datos

En JasperReports Server, un entorno que determina cómo los procesos de servidor y guarda en caché los datos usados por Ad Hoc informes. Seleccione sus políticas de datos haciendo clic Administrar> Configuración Ad Hoc.

270

Glosario

Fuente de datos

Define las propiedades de conexión 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 también. Conjunto de datos

Una colección 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 través de un control de entrada. Un tipo de datos debe ser de tipo texto, numérico, de fecha o de fecha y hora. Puede incluir restricciones en el valor de la entrada, por ejemplo valores máximos y mínimos. Como tal, un tipo de datos en JasperReports Server es más estructurada que un tipo de datos en la mayoría de lenguajes de programación.

Desnormalizar

Un proceso para la creación de uniones entre tablas que acelera la recuperación de datos en el coste de tener valores de fila duplicados entre algunas columnas. Dados

Una operación OLAP para seleccionar columnas.

Dimensión

Una categorización 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, región y sector del cliente. Dominio

Una vista virtual de un origen de datos que presenta los datos en términos de negocio, permite la localización, y ofrece La seguridad a nivel de datos. Un dominio no es una vista de la base de datos en términos relacionales, pero se implementa la misma funcionalidad dentro de JasperReports Server. El diseño de un dominio especifica las tablas de la base de datos, se unen cláusulas, campos calculados, nombres de pantalla, y propiedades por defecto, todos los cuales definen los elementos y conjuntos de elementos para la creación de Informes ad hoc. Tema de dominio

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 artículos en un dominio, sino que además permite el filtrado, la entrada del usuario, y la selección de artículos. 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 operación OLAP que expone la información más detallada hasta los niveles de la jerarquía de profundizar en la jerarquía y la actualización de los contenidos de la tabla de navegación. Perforar a través. Una operación 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 navegación; la nueva tabla indica el bajo nivel datos que constituye los datos que se ha hecho clic. Sintetizar. Una operación OLAP para devolver el nivel de jerarquía de elementos primarios para ver la información de resumen.

•

Eclipse

Un código abierto entorno de desarrollo integrado (IDE) para Java y otros lenguajes de programación, 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 tendrán acceso. El producto ETL Jaspersoft permite definir y procesos ETL horario. Realidad

El valor específico o el valor agregado de una medida para un miembro particular de una dimensión. Los hechos son típicamente numérico. 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 visualización 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 parámetros. Grupo

En un informe, un grupo es un conjunto de filas de datos que tienen un valor idéntico 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 gráfico, 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 Jerarquía

En un cubo OLAP, un miembro de una dimensión que contiene un grupo de miembros.

Control de entrada

Cuadro A, el botón de verificación, la lista desplegable, campo de texto o icono de calendario que permite al usuario introducir un valor cuando se ejecuta un informe o la visualización de un panel de control que acepta parámetros de entrada. Para informes JRXML, controles de entrada y su tipos de datos asociados deben ser definidos como objetos del repositorio y se asocian explícitamente 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 informe se utiliza en un tablero de instrumentos, sus controles de entrada están disponibles para ser añadido como contenido especial. iReport Diseñador

Una herramienta de código abierto para diseñar gráficamente informes que aprovechan todas las características de la biblioteca JasperReports. El Jaspersoft iReport Diseñador le permite arrastrar y colocar campos, gráficos y subinformes en un lienzo, y también definir parámetros o expresiones para cada objeto para crear informes de píxel perfecto. Puede generar el JRXML del reportará directamente en iReport, o subirlo a JasperReports Server. iReport se implementa en NetBeans.

Artículo

En el diseño de un dominio o crear un tema basado en un dominio, un elemento es la representación de una base de datos campo o un campo calculado junto con sus nombres de pantalla y formato propiedades definidas en el dominio. Artículos pueden agruparse en conjuntos y están disponibles para su uso en la creación de informes ad hoc.

JasperReport

Una combinación de una plantilla de informe y los datos que produce un documento complejo para ver, imprimir o información de archivo. En el servidor, un JasperReport referencias a otros recursos en el repositorio:

• La plantilla de informe (en forma de un archivo JRXML)

272

Glosario

• •

Información sobre la fuente de datos que suministra los datos para el informe Cualquier recurso adicional, como imágenes, fuentes y paquetes de recursos referenciados por la plantilla del informe.

La colección 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 función de agregado en una vista especial. Valores de nivel son Actual (no disponible para Percentof), ColumnGroup, ColumnTotal, rowgroup, RowTotal, Total.

JasperReports Biblioteca

Una, de código abierto integrable, API Java para la generación de un informe, llenándolo de datos actual, dibujo y gráficos tablas y exportar a cualquier formato estándar (HTML, PDF, Excel, CSV, y otros). Procesos JasperReports informes definidos en JRXML, un formato XML abierto que permite que el informe contiene expresiones y lógica para informe de control de salida en base a los datos de tiempo de ejecución.


Una aplicación de código 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 funciones de creación, y de la empresa, tales como las organizaciones y auditoría. Jaspersoft ETL

Una herramienta gráfica para el diseño y la implementación de su extracción de datos, transformación 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 agregación de datos y la integración en mercados de datos o almacenes de datos que utilizar para la presentación de informes.

Jaspersoft OLAP

Un servidor OLAP relacional integrado en JasperReports Server que realiza análisis de datos con consultas MDX. El producto incluye generadores de consultas y clientes de visualización que ayudan a los usuarios explorar y dar sentido a datos multidimensionales. Jaspersoft OLAP también soporta conexiones XML / A a servidores remotos.

Jaspersoft Studio

Una herramienta de código abierto para diseñar gráficamente informes que aprovechan todas las características de la biblioteca JasperReports. Jaspersoft Studio le permite arrastrar y colocar campos, gráficos y subinformes en un lienzo, y también definir parámetros o expresiones para cada objeto para crear informes de píxel 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 estándar. JDBC

Java Database Connectivity. Una interfaz estándar que las aplicaciones Java utilizan para acceder a bases de datos. JNDI

Java Naming and Directory Interface. Una interfaz estándar que las aplicaciones Java utilizan para acceder a nombrar y servicios de directorio.

273


Únete Árbol

En Dominios, una colección de tablas combinadas de la fuente de datos real. Una unión es la operación relacional que asocia las filas de una tabla con las filas de otra tabla basada en un valor común en determinado campo de cada tabla. Sólo 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 gráfica de usuario de código abierto para operaciones OLAP. Para obtener más información, 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 estándar de definir con precisión toda la estructura y configuración 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 analítico. 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 fórmula 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 gráfico (como las rodajas en una empanada). En una vista OLAP, una fórmula que calcula los hechos que constituyen los datos cuantitativos en un cubo.

Mondrian

Una, la aplicación de base de datos multidimensional de código abierto basado en Java. Conexión Mondrian

Una conexión 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 creación de esquemas OLAP Mondrian.

XML Mondrian / A Fuente

Un XML de servidor / Una definición de origen de un XML en el cliente remoto / Una conexión utiliza para rellenar un OLAP ver usando el XML / A estándar.

MySQL

Un sistema de gestión de base de datos relacional de código abierto. Para obtener más información, visita http://www.mysql.com/. Tabla de navegación

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. Después de configurar la fuente de datos de Jaspersoft ODBO, los analistas de negocios pueden usar las tablas dinámicas de Excel como un front-end para el análisis OLAP.

274

Glosario

OLAP

El procesamiento analítico en línea. Ofrece vistas multidimensionales de datos que ayudan a los usuarios a analizar y pasados rendimiento y modelo escenarios futuros.

OLAP Client Connection

Una definición de recuperación de datos para rellenar una vista OLAP. Una conexión de cliente OLAP es o un Java directa conexión (conexión Mondrian) o una conexión API basada en XML (XML / A la conexión).

OLAP esquema

Una definición 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

También se llama una vista de análisis. Una vista de datos multidimensional que se basa en una conexión 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 análisis avanzados que quieren escribir sus propias consultas. Compare Ad Hoc View.

Organización

Un conjunto de usuarios que comparten carpetas y recursos en el repositorio. Una organización tiene sus propias cuentas de usuario, roles, y la carpeta raíz del repositorio para aislar de forma segura de otras organizaciones que pueden ser alojados en la misma instancia de JasperReports Server. Organización administración

También llamado el administrador de la organización. Un usuario en una organización con los privilegios para administrar el las cuentas de la organización de usuarios y roles, permisos del repositorio, y el contenido del repositorio. Un administrador organización También puede crear suborganizaciones y sarna todas sus cuentas, las funciones y los objetos del repositorio. El valor por defecto organización admin en cada organización 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 número muy elevado de entradas helpdesk. Estos valores atípicos pueden indicar un problema (o un logro importante) en su negocio. Las funciones de análisis de Jaspersoft OLAP sobresalen en los valores extremos que revelan. Parámetro

Valores con nombre que se pasan al motor en tiempo de informe rellenando para controlar los datos devueltos o la aparición y el formato del informe. Un parámetro de informe se define por su nombre y el tipo. En JasperReports Server, parámetros 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 físicas (por ejemplo, X y eje Y) para organizar la información que contiene más de dos dimensiones lógicas (por ejemplo, producto, cliente, hora y lugar), de manera que cada dimensión física es capaz de representar una o más dimensiones lógicas, donde los valores descritos por las dimensiones se agregan utilizando una función como SUM. Las tablas pivote se utilizan en Jaspersoft OLAP.

.

275


Propiedades

Ajustes asociados a un objeto. Los ajustes determinan ciertas características 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 también 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 ejecución de un informe, Ad Hoc vista, o en el salpicadero, o una sesión de visualización o en el salpicadero de diseño, mide y límites de uso de instancias Freemium de JasperReports Server. Las ejecuciones se aplican a los recursos sin importar cuán ser lanzados (ya sea en la interfaz web oa través 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 límite. Para obtener más información, por favor póngase en contacto con [email protected]. 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 través de la interfaz web JasperReports Server o a través de iReport. Las aplicaciones pueden acceder a la repositorio a través de la API de servicios web. Los administradores usan las utilidades de importación y exportación 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 también incluyen la carpetas en el repositorio. Los administradores configuran los usuarios y basados en roles permisos de acceso a los recursos del repositorio de establecer una política de seguridad. Papel

Una característica de seguridad de JasperReports Server. Los administradores crean papeles con nombre, asignarlos a las cuentas de usuario, y a continuación, establecer permisos de acceso a los objetos del repositorio basado en esos roles. Ciertas funciones también determinan lo funciones y opciones de menú se muestran a los usuarios en la interfaz de JasperReports Server. Esquema

Un modelo lógico que determina cómo se almacenan los datos. Por ejemplo, el esquema en una base de datos relacional es una descripción de las relaciones entre las tablas, vistas e índices. En Jaspersoft OLAP, un esquema OLAP es el modelo lógico de los datos que aparecen en una vista OLAP; que se cargan en el repositorio como recursos. Para Dominios, esquemas están representados en los archivos de diseño XML.

Workbench de esquema

Una herramienta gráfica para diseñar fácilmente 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 análisis simple pero potente de grandes cantidades de datos multidimensionales almacenados en sistemas RDBMS estándar.

276

Glosario

Set

En dominios y dominio Temas, una colección 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 operación OLAP para el filtrado de filas de datos.

SQL

Lenguaje de consulta estructurado. Un lenguaje estándar que se utiliza para acceder y manipular datos y esquemas en un base de datos relacional. System Admin

También 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 administración puede crear organizaciones de nivel raíz y gestionar todos los ajustes del servidor. El sistema por defecto admin es la superusuario cuenta. Tema

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 transacción 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 interactúa con JasperReports Server a través de la interfaz web. En general, existen tres categorías 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 contraseña para hacer cumplir la autenticación. Tanto las personas como llamadas a la API con el acceso el servidor debe proporcionar el ID y la contraseña de una cuenta de usuario válida. 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 múltiples 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 través 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 más información, consulte http://jpivot.sourceforge.net/wcf/index.html. Servicios Web

Un jabón (Simple Object Access Protocol) API que permite a las aplicaciones acceder a ciertas funciones de JasperReports Server. Las características incluyen tareas de depósito, programación y administración de usuarios.

XML

Extensible Markup Language. Un estándar para la definición, la transferencia y la interpretación de los datos para su uso a través de cualquier número de aplicaciones habilitadas para XML. XML / A

XML for Analysis. Un estándar XML que utiliza el protocolo de acceso a objetos simple (SOAP) para tener acceso a datos remotos fuentes. Para obtener más información, consulte http://www.xmla.org/ XML / A Conexión

Un tipo de conexión 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 parámetro tema 129

A

Sobre ventana JasperReports servidor 23 control de acceso administrar 57 autenticación 19 autorización 20 permisos a nivel de objeto 60 Permisos 57 repositorio 15 Ad hoc caching 184 comparación con Jaspersoft OLAP caching 188 formatos de datos 265 políticas 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 añadiendo fuentes de datos de frijol 88 tipos de datos 94 carpetas 49 Fuentes de datos JDBC 66 Fuentes de datos JNDI 71

enumera 96

consultas de 92 recursos 50 fuentes de datos virtuales 82 administración de servidor JasperReports Especial 178, 184 Amazon Web Services 197 auditoría 221 fuentes de datos de frijol 88 temas gráfico 207 archivos de configuración 171 tabla de referencias cruzadas limitar 207 políticas de datos 178-179 fuentes de datos 65 tipos de datos 94 Validación de dominio 200 carpetas 49 111 fuentes tareas generales 13 latido del corazón 218 Exportador HTML 208 HTML5 para Pro Listas 209 Los controles de entrada 96 Archivos JAR 111 JasperReports Library 206 Configuración del servidor JasperReports 183 Fuentes de datos JDBC 66 Fuentes de datos JNDI 71 niveles de la administración 13 enumera 95 localización 256, 261, 266 iniciar sesión como un usuario 62

279


varios administradores 15, 25 permisos a nivel de objeto 60 ayuda en línea 219 organizaciones de 12, 25, 55 contraseñas 151 consultas de 91, 178 informe Intervalos 216 repositorio de 14, 43, 55 recurso agrupa 111 recursos 50 funciones 17, 36 configuración de seguridad 145 Ver también el control de acceso. [Administrar JasperReports Servidor aaa] 15 Resumen de las tareas 25 Suite de Integración Talend 37 los usuarios 17, 19, 25, 29 fuentes de datos virtuales 82 XHTML exportador 208 administradores tareas generales 13 niveles de la administración 13 administrador de la organización 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 asiáticas 253-254 atributos, perfil. Ver atributos de perfil. 104 auditoría administrar 221 eventos de auditoría archivado 221, 224 informes de auditoría 229 eventos auditados 222 configuración 223 importación y exportación de datos de auditoría 232 de autenticación. Ver control de acceso. 19 autorización. Ver control de acceso. 20

C

el almacenamiento en caché. Ver Ad Hoc. 184 Los controles de entrada en cascada 105 codificación de caracteres codificación de forma 259 JBoss 257-259 Conexiones JDBC 260 Fuentes de datos JDBC 258 Controladores JDBC 258 Fuentes de datos JNDI 258 MySQL 258 no UTF-8 codificación de caracteres 259 Fuentes de datos OLAP 260 OLAP ve 260 Bases de datos Oracle 258 PostgreSQL 257 Ver también fuentes, locales, y la localización. [Personaje codificación aaa] 253 Tomcat 256, 259-260 Bases de datos Unicode 260 UTF-8 256 gráficos generación 210 informes y temas para 207 CLOB 203 Cloudera Impala 65 configurar JasperReports Server. Ver administrar Jas- perReports Server. 15 copia carpetas 52 recursos 16, 52 la creación 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 volúmenes de datos 78, 181 la navegación de repositorios 16

D

formatos de datos 265 políticas de datos 178-179

280

Índice

fuentes de datos administrar 65 Amazon Web Services 73 frijol 88 la combinación. 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 creación de 94 Para los controles de entrada 94 tipos 94 formatos de fecha 264-265 incumplimientos cambiar 171 temas gráfico 207 Validación de dominio 200 instalación 12 locale 261 Carácter Oracle establece 258 Sinónimos de Oracle 202 Fuentes PDF 256 reportar opción de programación intervalo de 216 papeles 36 zona horaria 268 29 usuarios borrado carpetas 54 recursos 16, 54 demostración. Ver Supermart. 37 diagnóstico 233 Dominios adaptar los informes a los públicos 92 Tipos de columna JDBC 204 validación 200

exportar datos de auditoría 232 desde la interfaz de usuario 133-134 visión general 131 recursos 137

F

favicon.ico presentar 119 Plug-in de 128 Firebug Flash 209 Plantilla Carpeta 28, 127 carpetas la creación de 49 borrar 54 edición 51 Plantilla Carpeta 28 móvil 52 Pública 16 fuentes administrar 111 Asia Oriental 253-254 en el depósito de 111 Jaspersoft OLAP 255 localización 253 multi-byte 253 fuentes no UTF-8 259 OLAP ve 255 Archivos PDF 256 Ver también la codificación de caracteres, locales, y la localización. [fuentes aaa] 253 solución de problemas en los archivos exportados 111 máscaras de formato 265 Gráficos de fusión 209-210

T

cartas que generan 210 GlobalPropertiesList 174

H

Fuentes de datos Hadoop Hive-78 latido del corazón 21, 218 configuración ayuda 219 Generación Highcharts 210 Idioma Hive Consulta 65 HiveQL 94

E

carpetas de edición y recursos 51 eventos. Ver registro. 221

281


Exportador HTML 208 HTML5 209

I

Impala 65 importación datos de auditoría 232 desde la interfaz de usuario 135 visión general 131 recursos 139 controles de entrada añadiendo 97 administrar 96 y tipos de datos 94, 97, 99 cascada 105 la creación de 97 lista de valores para 95 lista Tipo 95 parámetros para la entrada en cascada controla 106-107 parámetros de entrada basado en consultas controla 106 99 basado en consultas ahorro de 95-96, 99 tipos 97 internacionalización. Ver localización. 253 iReport. Ver Jaspersoft iReport Designer. 11

JBoss y la configuración UTF-8 257 JBoss Portal 171 Fuentes de datos JDBC 66 JMX 233 Fuentes de datos JNDI 71 Archivos JRXML sintaxis de referencia. Ver repositorio. 46 recurso agrupa 111 comando js-exportación 137 comando js-importación 139

L

idiomas. Ver localización. 253 caducidad de la licencia 23 Liferay Portal 171 listas administrar 95 la creación de 96 controla tipo de lista de entrada 95 locales administrar 266 codificación de caracteres 259 la creación de 261 formatos de datos 265 formatos de fecha 264-265 máscaras de formato 265 no UTF-8 codificación de caracteres 260 261 propiedades Ver también la codificación de caracteres, las fuentes, y la localización. [locales aaa] 261 zonas de tiempo 267 localización 253 fuentes JasperReports servidor 261 Jaspersoft iReport Diseñador 263 OLAP ve 255, 260 Ver también codificación de caracteres, fuentes y lugares. [Local- ización aaa] 253 UTF-8 256 tala eventos de auditoría. Ver la auditoría. 221 los eventos del sistema 192

iniciar sesión como un usuario 62

J

Archivos JAR, la administración de 111 JasperAnalysis. Ver Jaspersoft OLAP. 11 JasperETL 37 JasperReports Biblioteca configuración 206 la creación de informes 11 se extiende 206 estructura de un JasperReport 45 JasperReports Servidor configuración 183 plug-in para iReport 108 JasperServer. Ver la administración de JasperReports Server. 11 Jaspersoft iReport Diseñador temas gráfico 207 la creación de informes con 11 recurso agrupa 263 Jaspersoft OLAP 37, 188, 255 Java Management Extensions (JMX) 233 Motor de JavaScript 210

282

Índice

M

maxFilterValues 190 maxHttpHeaderSize 245 MaxPostSize 244 Consulta MDX en vista Especial 178 mdxDataStrategy 190 Fuentes de datos MongoDB 66 monitoreo configuración 223 muestra de 231 informes movimiento carpetas 52 recursos 16, 52 fuentes multi-byte 253 múltiples organizaciones. Vea las organizaciones. 55 MySQL 180, 258

N

NVARCHAR2 204

O

OLAP ve 21, 255, 260 ayuda en línea 219 Oracle juegos de caracteres 258 CLOB 203 NVARCHAR2 204 sinónimos 202 TIMESTAMP WITH LOCAL TIME ZONE 205 TIMESTAMP WITH TIME ZONE 205 organizaciones roles de administración 36 administrar 25 predeterminado 12 estructura de carpetas 28 múltiples 12, 25, 55 Organizaciones carpeta 28 la búsqueda de 27 solo 12, 25 suborganizaciones 13 Organizaciones carpeta 28 Errores de falta de memoria 207 archivo overrides_custom.css 120

contraseñas auditoría 227 expiración 151 usuarios cambiar 152 PDF la incrustación de fuentes 256 Resolución 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 generación Charts 210 Atributos de perfil 34 y la auditoría 223 y controles de entrada basado en consultas 104 definido 21 '31 usuarios que ven archivos de propiedades la creación de 261 recurso agrupa 263 Carpeta pública 16

Q

consultas administrar 91 y considera Especial 178, 184 la creación de 92 múltiples lenguajes de consulta 94 parámetros para la entrada en cascada 106 controla parámetros de entrada basado en consultas controla 106 ejecutores de consulta 94 utilizando 91 Los controles de entrada basado en consultas 99

R

sintaxis repo 46 informes y controla la entrada en cascada 110 la creación de 11 JasperReport 46 Biblioteca JasperReports 11

P

consultas con parámetros. Ver consultas. 96

283


Jaspersoft iReport Diseñador 11 informe Intervalos 216 programación 216 solución de problemas de fuentes en los informes exportados 111 repositorio control de acceso 15 la administración de 14, 43 navegación 16 configuración 55 diseño emite 55 eventos 227 carpetas 14 importación y exportación de 131 Organizaciones carpeta 28 Carpeta pública 16 sintaxis de referencia 46 recursos que hacen referencia a 56 recursos 14, 46 datos de la muestra 15 buscar 16, 38 Ver también los recursos. [Repositorio aaa] 16 estructura 14 Codificación UTF-8 257-258 paquetes de recursos en el depósito de 111 Ver también la localización. 263 recursos agregando 16, 50 navegación 16 copia 16 corte de 16 eliminación de 16, 54 edición 51 111 fuentes importación y exportación de 131 en el repositorio 46 Archivos JAR 111 móvil 52 pegar 16 consultas de 91 recurso agrupa 111 referencias de recursos en archivos JRXML. Ver repositorio. 46 buscar 16 conjuntos de resultados 184

Rhino 210 papeles administración de 17, 36 administrativa 25 y usuarios 36 roles predeterminados 36 permisos a nivel de objeto 60 la búsqueda 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 sesión 153 snapshotPersistenceEnabled 191 snapshotRecordingEnabled 191 Consulta SQL en la vista Especial 178 suborganizaciones. Vea las organizaciones. 13 Demostración Supermart y funciones 37 apoyo, la búsqueda de la versión 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 parámetro 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 Jaspersoft iReport Diseñador 207 permisos 123 recuperando de 129 inadvertida cambia galerías de muestra 129 Ver también trazar temas. [temas &&] 115 tema del sistema 117 Carpeta Themes 117

284

Índice

subir 126 Parámetro 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 transformación Unicode (UTF-8). Ver personaje codificación. 256 Recursos Identificadores universal (URI) 56 muestras de interfaz de usuario 129 usuarios la administración de 17, 19, 29 autenticar 19-20, 57 el cambio de contraseñas 152 usuarios por defecto 29 ingresar como 62 permisos a nivel de objeto 60 papeles 36 la búsqueda de 31 tiempo de espera de la sesión 153

V

versión del software 23 21 visitas fuentes de datos virtuales 82

W

servicios web 225

X

XHTML exportador 208

285


286

JasperReports Server Admin Guide Release 5.6.es.pdf

Documents

Transcript of JasperReports Server Admin Guide Release 5.6.es.pdf