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. O Erro Clássico: “Property does not exist”

Sección titulada «1. El Error Clásico: “Property does not exist”»

O sintoma inequívoco deste conflito é o seguinte erro no 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.

Quando consumimos as nossas APIs analíticas diretamente do Excel (via Power Query), devemos purgar duas caches diferentes para forçar a atualização do esquema:

  1. Em a cinta de opções, vamos para a pestaña Dados.
  2. Hacemos clic em Obter dados -> Configuração de origem de dados (Data Source Settings).
  3. Procuramos o caminho da nossa API do Business Central na lista de fontes globais ou da pasta de trabalho atual.
  4. Hacemos clic em Borrar permisos (Clear Permissions).
  1. Abrimos o editor do Power Query (fazendo duplo clique na nossa consulta no painel direito).
  2. Vamos a Arquivo -> Opciones y configuración -> Opciones de consulta.
  3. Em o painel esquerdo, sob a seção “GLOBAL”, selecionamos Carga de dados.
  4. Hacemos clic no botão Borrar caché (Clear Cache).
  5. Finalmente, em o próprio editor de Power Query, hacemos clic no botão Atualizar vista previa. O sistema volverá a autenticarse e lerá as novas colunas corretamente.

O comportamento no Power BI é idêntico ao do Excel, mas as opções encontram-se distribuídas de forma ligeiramente diferente.

  1. Vamos a Arquivo -> Opciones y configuración -> Opciones.
  2. Em o menu lateral esquerdo, sob o epígrafe “GLOBAL”, selecionamos Carga de dados (Data Load).
  3. Em a seção “Opciones de caché de datos”, hacemos clic em Borrar caché.
  4. (Opcional) Se usarmos Q&A, também clicamos em “Limpar cache de Q&A”.
  5. Fechamos a janela de opções.
  6. Em a vista principal (ou em Power Query), le damos a Atualizar. Não encontrando caché local, Power BI realizará uma chamada HTTP limpa para baixar o novo esquema JSON da nossa API, resolvendo o erro imediatamente.
  • ✓ Depuración de Permisos: Borrado de credenciais globais corruptas após reorganizações ou mudanças de UPN de Entra ID.
  • ✓ Atualização de Esquema: Purga do armazenamento em caché de dados locais em Power Query para recarregar o documento $metadata do ERP.
  • ✓ Validação Final: Verificação de colunas importadas na vista de Power Query para garantir que coincidam com a definição atual de AL.