Guía para documentar con comentarios expresiones DAX en Power BI | Xyclos
Actualizado: 22 may
Introducción
Dependiendo del expertise en el uso de DAX, especialmente en los casos en que se usan funciones anidadas, hay personas que ingresan en una o dos líneas una instrucción DAX (Data Analysis eXpressions),
En el mismo caso, los más expertos: mientras ingresan las instrucciones DAX ,paralelamente van documentando y dando un formato estructurado a las instrucciones para que sean legibles y fáciles de mantener para realizar actualizaciones al código.
Esto se conoce como: Establecer las mejores prácticas de ingreso, documentación y formato de código o expresiones DAX.
Comentarios
Este es un proceso fundamental: Documentar siempre las expresiones DAX en el Modelo de datos.
¿Cómo se documenta DAX?
Ingresando comentarios.
¿Dónde se ingresan los comentarios?
Los comentarios se ingresan en la Barra de fórmulas junto con las fórmulas y funciones para crear: Medidas (Measures), Columnas calculadas (Calculated columns) o Tablas calculadas (Calculated tables)
¿Cómo se ingresan comentarios?
Para ingresar comentarios en un código DAX, solo debe ingresar el símbolo: // (doble slash) ya sea como:
Una línea de comentario independiente: // Total ventas netas incluido impuestos Ventas Netas = SUM(Base[Ventas netas])
Como un comentario junto a la instrucción: Ventas Netas = SUM(Base[Ventas netas]) // Total ventas netas incluido impuestos
¿Los comentarios afectan al código?
No, los comentarios no afectan el procesamiento del las instrucciones del código DAX.
Pero eso no es todo.
Para documentar como experto las instrucciones DAX, mientras se ingresa la instrucción se activa Autocompletar, que Power BI nos despliega automáticamente para ayudarnos a ingresar los argumentos de fórmulas o funciones. Entonces el procedimiento es el siguiente;
Ingresa una línea de código
Luego se presiona Ctrl + Enter para crear una nueva línea de código
Continua ingresando los argumentos, fórmulas o funciones, y así sucesivamente:
tabCantProductosVendidos = // Calcula la cantidad de productos vendidos FILTER ( SUMMARIZECOLUMNS ( facVentas[Producto], "CantProd", CALCULATE (COUNTA ( facVentas[Producto] )) ), NOT (ISBLANK ( facVentas[Producto] )))
DAX Formatter
También para mejorar este diseño, usando una herramienta externa gratuita disponible en: www.daxformatter.com de SQLBI.
¿Como se usa?
En el Barra de fórmulas de Power BI, copie el código DAX
Acceda a www.daxformatter.com En la parte superior de la página se despliega el mensaje: Make your DAX code easy to read. Paste your fórmula here and try!
Haga clic sobre el mensaje y pegue el código DAX
Luego haga clic en el botón Format Se despliega el código en un formato estructurado mucho más legible:
Haga clic en el botón Copy
Haga clic en la Barra de fórmulas de Power BI Destop
Pegue el contenido
Haga clic en el icono Visto para aceptar el código y este es el resultado tabCantProductosVendidos =
// Calcula la cantidad de productos vendidos
FILTER (
SUMMARIZECOLUMNS (
facVentas[Producto],
"CantProd", CALCULATE (COUNTA ( facVentas[Producto] ))
),
NOT (ISBLANK ( facVentas[Producto] ))
)
Este es una de las técnicas para documentar el Modelo; en el curso Power BI Gestión Empresarial con KPI's profundizamos todo lo que necesita aprender para aplicar las mejores practicas para documentar sus proyectos en Power BI.