Veamos hoy una herramienta creada por la fabulosa comunidad de usuarios de Power BI que se llama Power BI Documenter.

Autor o creador:

La herramienta ha sido creada por Data Vizioner

El objetivo es documentar, revisar y mejorar la calidad y eficiencia del modelo de datos a partir de los elementos que se utilizan en el informe. Se liberó su primera versión en Julio de 2018, aunque comenzamos a jugar con versiones beta desde unos cuantos meses antes. Su equipo ha trabajado en mejoraras contantes. De los avances y de muchas buenas sugerencias para nuestro trabajo con Power BI podemos leer en su blog.

Para trabajar con Power BI Documenter tienes la opción de hacerlo con tres posibles licencias: Gratis, Profesional o Empresarial, sus características se ven en la siguiente imagen.

Ha tenido una gran acogida por parte de la comunidad y los profesionales. Se está utilizando de forma profesional en más de 20 países, a día de hoy. Las características que voy a describir se corresponden con la licencia gratuita.

Para ver sus novedades y estar actualizados les podemos seguir en Twitter -@pbidocumenter o en LinkedIn

Os presento a quienes están detrás de esta herramienta en Data Vizioner: Nima Shahri – @NRShahri, Soheil Bakhshi – @biinsightnz y Timothy Roberts – @tjrobertsnz.

Requisitos previos

1.- Crear plantilla

Antes de poder trabajar con Power BI Documenter, es necesario crear una plantilla, PBIT del informe creado con Power BI Desktop que tiene extensión PBIX y que queremos analizar.

En mi caso voy a utilizar el archivo que presenté como Demo en mi sesión #HappyDAXing en el evento Data Grillen, el pasado junio. Este archivo tiene muchos elementos, muchas páginas, tablas, medidas y diferentes tipos de gráficos y objetos de informe.

Para crear una plantilla basta con ir al menú Archivo, opción Exportar y luego Plantilla de Power BI.

Puedes dejar un comentario a la hora de crear tu plantilla.

Tenemos que asegurarnos de tener el archivo original PBIX y el archivo plantilla PBIT, no es necesario que estén en la misma carpeta.

Ahora ya estamos listos y nos vamos al sitio de Data Vizioner

2.- Darse de alta en el sitio de Data Vizioner

Hay que darse de alta, o acceder si ya tenemos cuenta. Esta la imagen de la página para cumplimentar este paso.

3.- Cargar la plantilla

Una vez autenticado se presenta la página: https://app.datavizioner.com/file.

Basta con seleccionar el botón UPLOAD y nos presenta la siguiente ventana donde sólo es necesario que “dejar caer” una plantilla. Es posible traer más de una o la misma más de una vez.

Una vez cargada la plantilla se presenta, brevemente esta información que refleja que se ha cargado correctamente.

Sin que medie ninguna acción por nuestra parte, estamos listos para recorrer el informe que se ha creado el equipo de Data Vizioner con la herramienta Power BI Documenter.

Explorar el documento

Para explorar el informe basta con un clic sobre la imagen.

El informe creado por Power BI Documenter, se divide en varias pestañas.

Vamos a verlas una a una y lo vamos a hacer en tres partes. En la primera parte voy a cubrir las fichas Report, Custom Visuals e Info. En la segunda parte veremos M Scripts y Model. El resto de fichas las veremos en la tercera parte y final.

Report

Es la ficha que aparece como página de presentación y sirve como resumen inicial de los elementos contenidos en el informe, tanto en diseño como en modelo. Este resumen muestra las páginas que existen en el informe, los tipos de objetos utilizados y los elementos que integran el modelo de datos.

Como hay tanta información, la voy a ir contando paso a paso.

Cuadro resumen

Lo primero que vemos es un resumen, las cifras de los elementos que integran nuestro informe.

En mi ejemplo, se trata de un informe de 18 páginas en el que aparecen 65 objetos visuales de 6 tipos distintos. El modelo consta de 10 tablas con 27 medidas y 10 columnas calculadas. (Para los que me conocéis o seguís, en este caso se crearon columnas calculadas a propósito para demostrar su ineficiencia, no me estoy descuidando 😊)

Gráfico de barras

A continuación, y a la izquierda encontramos un gráfico de Barras que refleja la cantidad de elementos visuales de cada página de informe. El orden en el que aparecen las barras se corresponde con el orden en que aparecen las páginas de informe. No se utiliza orden alfabético ni es posible ordenar según la cantidad de elementos que contiene cada página.

Si pasamos el ratón por encima de las barras se puede identificar bien el nombre de la página, se resalta la barra que se extiende hasta el final y se indica con mayor claridad el nombre de la página y la cantidad de elementos que contiene.

Veamos la página del informe original, de mi PBIX, que se llama Interaction between contexts IIIl donde pone que hay 9 elementos.

Es cierto que hay muchos objetos. Hay un panel en Power BI Desktop donde es muy cómodo ver los elementos que componen la página. Es el panel Selección, que encontramos en la ficha Vista. Al activar este panel se puede comprobar que existen, cómo no, 9 elementos.

Desde este gráfico se puede realizar acción de filtrado que afecta al gráfico de columnas de la derecha. Si selecciono la misma página con la que estuve trabajando antes vemos la distribución de los 9 objetos existentes según su tipo. Hay 3 segmentadores, 3 tarjetas, un texto, una tabla y una imagen. Es muy cómodo trabajar con estos gráficos.

Gráfico de columnas

El gráfico de columnas, a la derecha, muestra la cantidad de veces que se han utilizado en el informe los distintos tipos de visualizaciones. En mi caso se han empleado los siguientes tipos:  tabla, texto, tarjeta, matriz (que se identifica como Pivot table), segmentador e imagen.

No tengo idea de cuál es el criterio para mostrar los elementos en el gráfico, no es alfabético ni depende de la cantidad.

Para comprobar que el informe es correcto. Selecciono la matriz o Pivot Table. Desde el Power BI Documenter ocurre una acción de filtrado, por lo que el gráfico de barras sólo muestra las 6 páginas donde el diseño del informe contiene una matriz.

Sería muy aburrido ir a cada página, copiar y pegar la imagen con cada matriz. Creerme si os digo que hay 6 objetos tipo matriz utilizados en el informe y han sido perfectamente bien identificados por Power BI Documenter. Como dije antes, es muy cómodo encontrar e identificar los elementos que necesitemos.

Segmentador o Filtro

El informe incluye la posibilidad de analizar, por partes, las medidas, columnas y jerarquías, según se trabaje con estos botones de filtrado.

El efecto de esta acción lo recibe la tabla que se muestra debajo, que recibe la acción de filtrado que provocan además los gráficos. Pero los segmentadores no provocan acción alguna sobre los gráficos que vimos antes.

Así es que si existe un filtro en el gráfico de barras por la misma página de antes que se llama Interaction between contexts IIIl y filtramos, además, por Medidas tenemos este resultado.

Botón para descarga

El informe ofrece, en muchos de los apartados, la opción de realizar una descarga en CSV.   

Al seleccionar este botón tenemos la descarga

El nombre que genera Power BI Documenter combina el nombre de la plantilla que estamos analizando y un sufijo -Visuals.

La estructura que se ha generado al descargar a CSV es la siguiente:

Al convertir el texto en columnas y luego en tabla tenemos lo siguiente.

Con la tabla en Excel podemos seguir analizando si es que fuese necesario.

Tabla con modelo de datos

Y por último en esta primera página del informe de Power BI Documenter, la tabla que muestra el contenido del modelo de datos que se ha utilizado en el informe, muestra la página del informe, del PBIT, el nombre del objeto visual con un identificador, ya que yo no lo he nombrado, el tipo de visualización y el elemento concreto que se utiliza, ya sea columna, medida o nivel de jerarquía.

Custom Visuals

En este informe solo se utilizan componentes nativos, por lo que en la página aparece un mensaje que ofrece esta información.

Las visualizaciones de usuario o custom visuals son opciones adicionales, no integradas en Power BI que han sido creadas por Microsoft o por la comunidad Power BI. las opciones que existen, sus características y enlaces para descarga se encuentran en Microsoft AppSource.

Para ilustrar el informe que crea Power BI Documenter relativo a Custom Visuals abro otra plantilla que había subido antes a Data Vizioner y que contiene custom visuals y esto es lo que podemos ver, un resumen de los custom visuals que se han utilizado, con la opción de desplegar más información sobre cada uno.

En este caso no tenemos información sobre en qué sitio se integran en el informe ni qué elementos del modelo de datos se utilizan, lo que tenemos es información sobre el objeto como tal. Veamos un ejemplo:

Info

Esta es una ficha que muestra información del fichero y de la versión de Power BI Desktop, lo que es muy interesante y puede ser relevante según sea el escenario.

Hasta aquí la primera parte de la descripción del informe que genera Power BI Documenter de Data Vizioner. En la segunda parte veremos las fichas: M Script y Model.

Power BI documenter es una gran herramienta creada para el beneficio de la comunidad de usuarios de Power BI. En este post hemos visto una buena parte de la información que ofrece y las acciones que nos permite realizar y aun queda bastante más. Yo la utilizo con mucha frecuencia.

Espero que también te resulte de utilidad, nos vemos en la segunda parte.