Como acceder directamente a reportes creados con PRD usando el API de REST de Pentaho Server

En ésta publicación explico el procedimiento para invocar a Pentaho Report Viewer a través del API de REST. Esto es muy útil cuando se desea acceder directamente a reportes creados con Pentaho Report Designer (PRD) y publicados en Pentaho Server sin necesidad de navegar por la perspectiva Browse Files.

Suponiendo que se tiene la siguiente organización de la solución y se desea visualizar el ReportePentaho.prpt:

├── home
│   └── cursobi
│       └── reportes
│           └── ReportePentaho.prpt


El API de REST para invocar a ReportViewer provee el siguiente URL:

http://localhost:8080/pentaho/api/repos/<path>/viewer

En dónde <path> hace referencia a la ubicación del reporte usando :

:home:cursobi:reportes:ReportePentaho.prpt

URL simple para visualizar un reporte

http://localhost:8080/pentaho/api/repos/:home:cursobi:reportes:ReportePentaho.prpt/viewer

URL para visualizar un reporte enviando los valores de los parámetros

http://localhost:8080/pentaho/api/repos/:home:cursobi:reportes:ReportePentaho.prpt/viewer?param1=A&param2=X&param2=Y&param2=N

NOTA: para parámetros de selección múltiple se envía N veces el parámetro con los valores. Ej. param2=X&param2=Y&param2=N

URL para visualizar un reporte en formato PDF y ocultar la selección de parámetros

http://localhost:8080/pentaho/api/repos/:home:cursobi:reportes:ReportePentaho.prpt/viewer?param1=A&param2=X&param2=Y&paramN=N&output-target=pageable/pdf&showParameters=false

Arquitectura de Flujo de Datos con Pentaho Community Edition

En el siguiente diagrama que he creado muestro una Arquitectura de Flujo de Datos para cargar un Data Warehouse (DWH) apoyada por las herramientas de la plataforma Pentaho CE

Las actividades de Data Warehousing se realizan usando las herramientas de Pentaho Data Integration (PDI), Spoon es la herramienta gráfica para construir los procesos ETL,  Kitchen/Pan son las herramienta que permiten calendarizar la ejecución de los procesos ETL.

Las construcción de soluciones para actividades de Inteligencia de Negocios son apoyadas por las siguientes herramientas:

• Pentaho Metadata Editor (PME) permite crear una capa de metadatos sobre el DWH con términos del negocio; ésta capa es la fuente para crear reportes a demanda usando herramientas como WAQR (Web-based Ad Hoc Query and Reporting)
• Pentaho Report Designer (PRD) permite crear reportes avanzados que contienen fórmulas, agrupaciones, hipervínculos, parámetros, gráficos
• Pentaho Schema Workbench (PSW) permite crear cubos de análisis OLAP
• Community Tools (CTools) conjunto de herramientas Open Source que permiten construir tableros de mando (Dashboards) con indicadores claves de rendimiento (KPIs)

El servidor central Pentaho Server posee un cliente web conocido como Pentaho User Console (PUC) a través del cual se accede al contenido publicado por las herramientas PME, PRD, PSW y CTools. Además, requiere de 3 repositorios para su operación normal:  hibernate, quartz y jackrabbit.

Requerimientos de Software y Hardware

• Pentaho v8.2
• Pentaho v9.0

Nuevas Funcionalidades

• Pentaho v8.2
• Pentaho v9.0

Cómo configurar una conexión JNDI en Pentaho Report Designer

En ésta publicación explico el procedimiento para configurar una conexión JNDI a PostgreSQL en Pentaho Report Designer (PRD)

1. Ir al directorio home del usuario.

En Mac OS X: /Users/nombre_usuario/.pentaho

En Windows: C:\Users\nombre_usuario\.pentaho 

2. Crear el directorio simple-jndi

3. Dentro del directorio crear un archivo de nombre default.properties

4. Suponiendo que la conexión JNDI en BI Server se la configuró como jdbc/dwh colocar en el archivo lo siguiente:

dwh/type=javax.sql.DataSource
dwh/driver=org.postgresql.Driver
dwh/url=jdbc:postgresql://127.0.0.1:5432/dwh
dwh/user=postgres
dwh/password=postgres

5. Guardar el archivo y ejecutar report-designer. Cuando se cree la conexión, hacer referencia al JNDI Name: dwh

Cómo corregir la visualización en PDF de reportes publicados desde PRD en BI Server

En ésta publicación explico el procedimiento para corregir la visualización de reportes en PDF desde Pentaho User Console (PUC) de caracteres especiales como ñ,á,é,í, etc. cuando se trata de visualizar un reporte publicado desde Pentaho Report Designer (PRD) en formato PDF.

1. En PRD ir a File > Configuration > output-pageable-pdf

2. Seleccionar la opción ~.Encoding y colocar el valor ISO-8859-1

3. Guardar el reporte y publicar a Pentaho Server

Cómo colocar la fecha del sistema en un reporte de PRD

En ésta publicación explico cómo colocar la fecha del sistema en un reporte de Pentaho Report Designer sin usar la función Deprecated > Date.

Para colocar la fecha del sistema en cualquier banda del reporte, se tiene que arrastrar un message-field y colocar lo siguiente:

$(report.date,date,dd/MM/yyyy hh:mm:ss)

En dónde en el último argumento se coloca el formato de fecha que queremos mostrar basado en el formato del API Java Date Format

Cómo mostrar texto rico definido en HTML en Pentaho Report Designer

Supongamos que se tiene un campo en la base de datos de tipo VARCHAR con datos definidos como texto rico (RTF) en HTML y se desea renderizar ese HTML cuando se visualice el reporte.

Para poder realizar esto en PRD vamos a suponer que tenemos los siguientes datos:

<b>Probando</b><br/>RTF desde <i>PRD</i>

Una vez que se arrastre el campo a la banda de detalles de PRD, se tiene que definir el atributo rich-text-type:

common/rich-text-type = text/html

Con esta propiedad el HTML plano del campo VARCHAR será interpretado y visualizado como HTML en PRD como se muestra a continuación:

Error al publicar un reporte con gráficos desde Pentaho Report Designer

El día de hoy en clase nos encontramos con el error de que no pudimos ejecutar en la consola de usuario de Pentaho (PUC) un reporte publicado desde Pentaho Report Designer (PRD) v3.8.2 que contenía gráficos.

Éste error se da por una incompatibilidad entre la versión del servidor de BI biserver-ce v3.8.0 y PRD v3.8.2

Para solucionar este error se tiene que proceder la siguiente forma:

1. Revisar el log de Pentaho ubicado en: C:\pentaho\biserver-ce-3.8.0\biserver-ce\tomcat\bin\pentaho.log

2. Revisando el log se puede observar lo siguiente:

org.pentaho.reporting.libraries.resourceloader.ResourceCreationException: Unable to parse the document: ResourceKey{schema=org.pentaho.reporting.libraries.docbundle.bundleloader.ZipResourceBundleLoader, identifier=layout.xml, factoryParameters={org.pentaho.reporting.libraries.resourceloader.FactoryParameterKey{name=repository}=org.pentaho.reporting.libraries.repository.zipreader.ZipReadRepository@1c1d051, org.pentaho.reporting.libraries.resourceloader.FactoryParameterKey{name=::Include-parser}=true, org.pentaho.reporting.libraries.resourceloader.FactoryParameterKey{name=::Report}=org.pentaho.reporting.engine.classic.core.MasterReport={name="Graficos", type="master-report"}, org.pentaho.reporting.libraries.resourceloader.FactoryParameterKey{name=repository-loader}=org.pentaho.reporting.libraries.docbundle.bundleloader.ZipResourceBundleLoader@1f864b, org.pentaho.reporting.libraries.resourceloader.FactoryParameterKey{name=property-expansion}=false}, parent=ResourceKey{schema=pentaho, identifier=curso-bi-pentaho/ReporteGraficos.prpt, factoryParameters={}, parent=null}}

Este error aparece al querer ejecutar el reporte desde la consola de usuario (PUC) y es ocasionado por lo siguiente:

org.pentaho.reporting.libraries.xmlns.parser.ParseException: Unable to assign property 'categoricalAxisMessageFormat' to expression 'null' [Location: Line=56 Column=73]

Es decir, PRD v3.8.0 genera esa propiedad con valor nulo pero biserver-ce v3.8.0 no la soporta, es por eso que se genera el error de incompatibilidad. La solución a éste inconveniente es comentar esa propiedad en el archivo layout.xml del reporte que contiene gráficos, como se indica a continuación.

3. Abrir WinRAR o WinZIP e ir al directorio de la solución en dónde se publico el reporte. Por ejemplo: C:\pentaho\biserver-ce-3.8.0\biserver-ce\pentaho-solutions\curso-bi-pentaho\reportes

4. Abrir el reporte que contiene gráficos y ubicar el archivo layout.xml. Dar doble clic para editar el archivo, y ubicar la propiedad categoricalAxisMessageFormat

5. Comentar esa propiedad como se muestra a continuación:

<!-- ... -->
<property name="chartWidth">0</property>
<!--property name="categoricalAxisMessageFormat">{0}</property-->
<property name="rangeMaximum">1.0</property>
<!-- ... -->

6. Guardar el cambio y actualizar el cambio en WinRAR

7. Finalmente, el reporte ya podrá ser visualizado en PUC.

Configuración de la contraseña de publicación en Pentaho BI Server

Para poder publicar contenido de BI (metadatos, reportes, cubos OLAP) de las herramientas PME, PRD y PSW al servidor central de BI de Pentaho (biserver-ce) es obligatorio configurar la contraseña de publicación, en ésta publicación explico el procedimiento para hacerlo:

1. Ir al directorio C:\pentaho\biserver-ce-X.X.X\biserver-ce\pentaho-solutions\system

2. Editar el archivo publisher_config.xml y asignar un valor a la etiqueta <publisher-password> como se muestra a continuación:

<?xml version="1.0"?>
<publisher-config>
 <publisher-password>password</publisher-password>
</publisher-config>

Arquitectura de Flujo de Datos con Pentaho Community

En el siguiente diagrama que he creado muestro una Arquitectura de Flujo de Datos para cargar un Data Warehouse (DWH) apoyada por las herramientas de la plataforma Pentaho CE

Las actividades de Data Warehousing se realizan usando las herramientas de Pentaho Data Integration (PDI), Spoon es la herramienta gráfica para construir los procesos ETL y Kitchen es la herramienta que permite calendarizar la ejecución de los procesos ETL.

Las actividades de Inteligencia de Negocios son apoyadas por las siguientes herramientas:

•  Pentaho Metadata Editor (PME) permite crear una capa de metadatos sobre el DWH con términos del negocio; ésta capa es la fuente para crear reportes a demanda usando la herramienta WAQR (Web-based Ad Hoc Query and Reporting)
• Pentaho Report Designer (PRD) permite crear reportes avanzados que contienen fórmulas, agrupaciones, hipervínculos, parámetros, gráficos.
• Pentaho Schema Workbench (PSW) permite crear cubos de análisis OLAP
• Community Dashboard Framework (CDF) es una herramienta de la comunidad, no mantenida por Pentaho, que permite construir tableros de mando (Dashboards) con indicadores claves de rendimiento (KPIs)

El servidor central Pentaho BI Server tiene organizado en una solución los reportes, tableros y cubos OLAP publicados por las herramientas PME, PRD, PSW y CDF