Ir al contenido

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.

0lectures

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.

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:

  1. En la cinta de opciones, vamos a la pestaña Datos.
  2. Hacemos clic en Obtener datos -> Configuración de origen de datos (Data Source Settings).
  3. Busquem la ruta de la nostra API de Business Central a la llista d'orígens globals o del llibre actual.
  4. Hacemos clic en Borrar permisos (Clear Permissions).
  1. Obrim l'editor de Power Query (fent doble clic a la nostra consulta al panell dret).
  2. Vamos a Archivo -> Opciones y configuración -> Opciones de consulta.
  3. En el panel izquierdo, bajo la sección “GLOBAL”, seleccionamos Carga de datos.
  4. Hacemos clic en el botón Borrar caché (Clear Cache).
  5. 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.

El comportament a Power BI és idèntic al d'Excel, però les opcions es troben distribuïdes de manera lleugerament diferent.

  1. Vamos a Archivo -> Opciones y configuración -> Opciones.
  2. En el menú lateral izquierdo, bajo el epígrafe “GLOBAL”, seleccionamos Carga de datos (Data Load).
  3. En la sección “Opciones de caché de datos”, hacemos clic en Borrar caché.
  4. (Opcional) Si usem Q&A, també fem clic a “Borrar caché de Q&A”.
  5. Tanquem la finestra d'opcions.
  6. 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.
  • ✓ 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.