Documenta tu Código M en PowerQuery con Excel y chatGPT

Documentar Power Query es la parte que no le gusta a nadie

Montar la consulta es lo divertido: integrar los ficheros, resolver el problema, ver que por fin encaja todo. Lo que viene después —dejar por escrito qué hace cada paso— se parece bastante a recoger la casa después de la fiesta. Hay que hacerlo, pero no le gusta a nadie.

Y hay que hacerlo por dos motivos concretos. Uno, porque el usuario final necesita una documentación que le explique cómo usar lo que has montado. Y dos, porque cuando tengas que volver a tocar esa consulta dentro de unos meses, agradecerás que cada paso diga qué hace.

En este tutorial los dos problemas se resuelven con la plantilla de ChatGPT para Excel: le pasas el código M y te devuelve la documentación hecha.

Qué necesitas antes de empezar

La plantilla trabaja contra la API de ChatGPT, así que necesitas tu propia clave. Te das de alta, te facturan por consumo y te dan un código largo que se pega en la hoja Setup de la plantilla. En cuanto está puesta, la plantilla la reconoce y ya puedes lanzar peticiones.

Sobre el coste, que es la duda más repetida: en uso diario para varias tareas el consumo ronda los 5-7 al mes, y generar la documentación completa del ejemplo del vídeo costó 6 céntimos.

Dentro de la plantilla eliges un perfil según lo que quieras hacer. Hay uno general (el ingeniero de prompts) y dos creados para este ejercicio: documentador de Power Query, que hace el análisis global del proyecto, y comentarios de Power Query, que trabaja consulta a consulta.

Parte 1: la documentación global del proyecto

El primer perfil genera el documento de entrega. El proceso es corto:

1. Abre el editor de Power Query, ya sea desde Excel o desde Power BI.
2. Selecciona todas las consultas: clic en la primera y clic en la última manteniendo pulsada la tecla Mayúsculas.
3. Botón derecho y copiar. Eso te lleva al portapapeles el código M de todas las consultas como texto.
4. Pega ese texto en la plantilla, con el perfil documentador de Power Query seleccionado, y ejecuta.

El resultado no es un texto plano: es código HTML. La elección tiene su motivo. El HTML permite colgar la documentación directamente en la web, y además es un formato que se exporta con facilidad a PDF, Word o Google Docs. Copias el código, lo pegas en un documento de texto y lo guardas indicando la extensión .html en el nombre del fichero, para que el sistema lo reconozca como tal.

Al abrirlo tienes la documentación completa: desde el objeto global de todo el proyecto hasta el detalle consulta por consulta. De cada una explica de dónde coge la información, con qué otras consultas está relacionada, cuáles son sus pasos principales y —esto es lo interesante— instrucciones de uso. En el ejemplo, sobre una consulta que agrupa plantillas de una carpeta, la documentación indica que para añadir o eliminar archivos basta con modificar el contenido de esa carpeta.

Parte 2: comentarios dentro del propio código M

La segunda parte no genera un documento aparte: modifica el código para que los comentarios queden grabados en el propio fichero de Power Query.

Conviene recordar antes que Power Query ya permite describir cada paso a mano. Vas a las propiedades del paso, escribes ahí lo que hace (por ejemplo, filtramos las filas que nos interesan para acumular) y ese texto aparece al pasar por encima. Es muy útil cuando tienes que revisar algo que hiciste hace tiempo y no recuerdas exactamente cómo lo montaste.

Con el perfil comentarios de Power Query el trabajo va consulta a consulta, porque después hay que devolver el código también consulta a consulta:

1. En el editor, botón derecho sobre la consulta y copiar.
2. Pega el código en la plantilla con el perfil de comentarios y actualiza.
3. La plantilla devuelve el mismo código con líneas de comentario añadidas describiendo cada paso: seleccionamos columnas, expandimos, filtramos según condiciones...
4. Copia todo el resultado, vuelve a Power Query, abre el Editor avanzado y sustituye el código anterior.

El resultado sigue funcionando exactamente igual, pero ahora cada paso lleva su explicación incorporada.

Por qué merece la pena

El valor no está solo en la entrega. Tener la documentación formateada hace que el trabajo final tenga una presencia mucho más consistente, y puedes acompañarla al proyecto. Pero donde de verdad se nota es al revisar: cuando vuelves meses después a una consulta y necesitas saber dónde tocar, tener cada paso comentado te lleva al sitio en segundos en lugar de reconstruir la lógica desde cero.

Conclusión

Documentar deja de ser el peaje aburrido del final cuando el trabajo pesado lo hace la plantilla. Con dos perfiles y unos minutos tienes el documento HTML para el usuario y el código M comentado para ti. La plantilla del ejercicio se puede descargar desde la descripción del vídeo; recuerda incluir tu clave de API para que funcione.

Y si quieres más ideas como esta, en la comunidad de InflueXcel salen a diario problemas reales de Power Query con las soluciones de sus más de 1.500 miembros.

Más contenido de Excel en InflueXcel

• Tabla de clasificación de una liga que se ordena sola: tres formas de montarla Caso
  De madrugada, Hector lanzó al grupo una petición que suena sencilla y que acabó generando tres enfoques radicalmente distintos. Tiene un lib
• Conciliación contable: una sola fórmula por hoja que cuadra, descuadra y avisa Caso
  Esta semana alguien preguntó en el grupo si tenía sentido montarse un fichero para conciliaciones bancarias. La respuesta llegó en forma de
• Una función M que asigna los tipos de columna sola (y se documenta a sí misma) Caso
  Cualquiera que use Power Query a diario conoce el paso "Tipo cambiado". Es el que Excel añade solo al final de una consulta, y también el qu
• Crear el árbol de carpetas del año desde Excel con una macro parametrizable Caso
  Esta vez no hay una pregunta que resolver: Hector pasó por el grupo y dejó directamente la herramienta, una macro que crea en Windows la car
• Saber en qué rango cayó el valor encontrado, no solo su valor Caso
  Esta semana surgió una duda que parece sencilla hasta que te pones: Juan tiene una base de datos larga y, tras localizar un valor con ÍNDICE
• Partir un texto con separadores sobre todo un rango sin ir celda a celda Caso
  Interesante problema planteado por Juan: tiene una columna de textos donde cada celda guarda varios valores unidos por el carácter |, y quie
• MMULT no es conmutativa: la misma agregación funciona en horizontal y falla en vertical Caso
  Esta vez la duda llegó con prisa y todo: Juan quería dejarla resuelta "antes de que Francia nos mande para casa". Tenía dos bases de datos c
• Reorganizar tablas mensuales: cruzar por persona buscando en vertical y en horizontal Caso
  Nuevo caso interesante de la comunidad. Juan tenía varias tablas mensuales (a veces más de una en el mismo mes) y quería reorganizarlas por
• Acumular saldo con registros duplicados usando AGRUPARPOR y SCAN Caso
  Juan intenta acumular saldos cuando hay registros con la misma clave, pero ni BYROW, ni SCAN, ni AGRUPARPOR por separado le dan el resultado
• Ordenar meses cronológicamente en PIVOTARPOR Caso
  Problema clásico con PIVOTARPOR: cuando los meses vienen como texto ("enero", "febrero"...), las columnas se ordenan alfabéticamente en luga