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. L'Error Clàssic: “Property does not exist”
Sección titulada «1. El Error Clásico: “Property does not exist”»El símptoma inequívoc d'aquest conflicte és el següent error a 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. Protocol de Neteja a Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Quan consumim les nostres APIs analítiques directament des d'Excel (via Power Query), hem de purgar dues cachés diferents per forçar l'actualització de l'esquema:
Pas A: Neteja 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).
- Busquem la ruta de la nostra API de Business Central a la llista d'orígens globals o del llibre actual.
- Hacemos clic en Borrar permisos (Clear Permissions).
Pas B: Neteja de la Caché de Dades
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Obrim l'editor de Power Query (fent doble clic a la nostra consulta al panell dret).
- 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. Protocol de Neteja a Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»El comportament a Power BI és idèntic al d'Excel, però les opcions es troben distribuïdes de manera lleugerament diferent.
Purga Completa del Model 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 usem Q&A, també fem clic a “Borrar caché de Q&A”.
- Tanquem la finestra d'opcions.
- 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 Manteniment 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 $metadata
del ERP. - ✓ Validació Final: Verificació de columnes importades a la vista de Power Query per garantir que coincideixen amb la definició actual d'AL.

