Limpieza de Caché (Excel & Power BI)
Protocolo operativo para resolver conflictos de metadatos y esquemas cacheados tras el despliegue de nuevas APIs en Business Central.
En nuestra operativa de integración continua (CI/CD), es habitual que nosotros modifiquemos las APIs en lenguaje AL para añadir nuevas columnas o renombrar las existentes (ej. pasar de numDocumento a Num_Documento).
Aunque el despliegue en Business Central sea exitoso, las herramientas cliente de Microsoft (Excel y Power BI Desktop) utilizan un sistema de caché de metadatos extremadamente agresivo para ahorrar ancho de banda. Esto provoca que intenten leer la API basándose en una “foto” antigua del esquema, resultando en caídas totales de la ingesta de datos.
1. El Error Clásico: “Property does not exist”
Sección titulada «1. El Error Clásico: “Property does not exist”»El síntoma inequívoco de este conflicto es el siguiente error en Power Query:
Detalles: "OData: The property 'numDocumento' does not exist on type 'Microsoft.NAV.comercialAlbaranCompra'. Make sure to only use property names that are defined by the type or mark the type as open type."Diagnóstico DevSecOps: La base de datos origen ha cambiado, pero el cliente local (Excel/Power BI) se niega a descargar el nuevo documento $metadata de OData. Sigue solicitando la columna antigua y el servidor rechaza la petición.
2. Protocolo de Limpieza en Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Cuando consumimos nuestras APIs analíticas directamente desde Excel (vía Power Query), debemos purgar dos cachés diferentes para forzar la actualización del esquema:
Paso A: Limpieza de Permisos
Sección titulada «Paso A: Limpieza de Permisos»- En la cinta de opciones, vamos a la pestaña Datos.
- Hacemos clic en Obtener datos -> Configuración de origen de datos (Data Source Settings).
- Buscamos la ruta de nuestra API de Business Central en la lista de orígenes globales o del libro actual.
- Hacemos clic en Borrar permisos (Clear Permissions).
Paso B: Limpieza de la Caché de Datos
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Abrimos el editor de Power Query (haciendo doble clic en nuestra consulta en el panel derecho).
- Vamos a Archivo -> Opciones y configuración -> Opciones de consulta.
- En el panel izquierdo, bajo la sección “GLOBAL”, seleccionamos Carga de datos.
- Hacemos clic en el botón Borrar caché (Clear Cache).
- Finalmente, en el propio editor de Power Query, hacemos clic en el botón Actualizar vista previa. El sistema volverá a autenticarse y leerá las nuevas columnas correctamente.
3. Protocolo de Limpieza en Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»El comportamiento en Power BI es idéntico al de Excel, pero las opciones se encuentran distribuidas de manera ligeramente distinta.
Purga Completa del Modelo Local
Sección titulada «Purga Completa del Modelo Local»- Vamos a Archivo -> Opciones y configuración -> Opciones.
- En el menú lateral izquierdo, bajo el epígrafe “GLOBAL”, seleccionamos Carga de datos (Data Load).
- En la sección “Opciones de caché de datos”, hacemos clic en Borrar caché.
- (Opcional) Si usamos Q&A, también hacemos clic en “Borrar caché de Q&A”.
- Cerramos la ventana de opciones.
- En la vista principal (o en Power Query), le damos a Actualizar. Al no encontrar caché local, Power BI realizará una llamada HTTP limpia para descargar el nuevo esquema JSON de nuestra API, resolviendo el error al instante.
4. Checklist de Mantenimiento de Caché
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Depuración de Permisos: Borrado de credenciales globales corruptas tras reorganizaciones o cambios de UPN de Entra ID.
- ✓ Actualización de Esquema: Purga del almacenamiento en caché de datos locales en Power Query para recargar el documento
$metadatadel ERP. - ✓ Validación Final: Verificación de columnas importadas en la vista de Power Query para garantizar que coinciden con la definición actual de AL.

