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.

0lecturas

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.

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:

  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. Buscamos la ruta de nuestra API de Business Central en la lista de orígenes globales o del libro actual.
  4. Hacemos clic en Borrar permisos (Clear Permissions).
  1. Abrimos el editor de Power Query (haciendo doble clic en nuestra consulta en el panel derecho).
  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.

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.

  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 usamos Q&A, también hacemos clic en “Borrar caché de Q&A”.
  5. Cerramos la ventana de opciones.
  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ón Final: Verificación de columnas importadas en la vista de Power Query para garantizar que coinciden con la definición actual de AL.