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. 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.
2. Protocolo de Limpeza no Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»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:
Passo A: Limpeza de Permissões
Sección titulada «Paso A: Limpieza de Permisos»- Em a cinta de opções, vamos para a pestaña Dados.
- Hacemos clic em Obter dados -> Configuração de origem de dados (Data Source Settings).
- Procuramos o caminho da nossa API do Business Central na lista de fontes globais ou da pasta de trabalho atual.
- Hacemos clic em Borrar permisos (Clear Permissions).
Passo B: Limpeza da Cache de Dados
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Abrimos o editor do Power Query (fazendo duplo clique na nossa consulta no painel direito).
- Vamos a Arquivo -> Opciones y configuración -> Opciones de consulta.
- Em o painel esquerdo, sob a seção “GLOBAL”, selecionamos Carga de dados.
- Hacemos clic no botão Borrar caché (Clear Cache).
- 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.
3. Protocolo de Limpeza no Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»O comportamento no Power BI é idêntico ao do Excel, mas as opções encontram-se distribuídas de forma ligeiramente diferente.
Purga Completa do Modelo Local
Sección titulada «Purga Completa del Modelo Local»- Vamos a Arquivo -> Opciones y configuración -> Opciones.
- Em o menu lateral esquerdo, sob o epígrafe “GLOBAL”, selecionamos Carga de dados (Data Load).
- Em a seção “Opciones de caché de datos”, hacemos clic em Borrar caché.
- (Opcional) Se usarmos Q&A, também clicamos em “Limpar cache de Q&A”.
- Fechamos a janela de opções.
- 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.
4. Checklist de Manutenção de Cache
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ 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
$metadatado 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.

