Очистка кэша (Excel & Power BI)
Оперативный протокол для решения конфликтов метаданных и кэшированных схем после развертывания новых API в Business Central.
В нашей операции непрерывной интеграции (CI/CD) часто мы модифицируем API на языке AL, чтобы добавить новые столбцы или переименовать существующие (например, изменить с numDocumento на Num_Documento).
Хотя развертывание в Business Central может быть успешным, клиентские инструменты Microsoft (Excel и Power BI Desktop) используют систему кэширования метаданных, которая очень агрессивна для экономии полосы пропускания. Это вызывает попытки читать API на основе «старой фотографии» схемы, что приводит к полному сбою приема данных.
1. Классическая ошибка: «Свойство не существует»
Sección titulada «1. El Error Clásico: “Property does not exist”»Несомненным симптомом этого конфликта является следующая ошибка в 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."Диагностика DevSecOps: Исходная база данных изменилась, но локальный клиент (Excel/Power BI) отказывается загружать новый документ $metadata OData. Он продолжает запрашивать старый столбец, и сервер отклоняет запрос.
2. Протокол очистки в Microsoft Excel
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Когда мы потребляем наши аналитические API напрямую из Excel (через Power Query), нам необходимо очистить два разных кэша, чтобы принудительно обновить схему:
Шаг А: Очистка разрешений
Sección titulada «Paso A: Limpieza de Permisos»- В ленте меню переходим на вкладку Данные.
- Нажимаем на Получить данные -> Настройка источника данных (Data Source Settings).
- Ищем путь к нашему API Business Central в списке глобальных источников или текущего файла.
- Нажимаем на Очистить разрешения (Clear Permissions).
Шаг B: Очистка кэша данных
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Открываем редактор Power Query (двойным щелчком на нашем запросе в правой панели).
- Переходим в Файл -> Параметры и настройка -> Параметры запроса.
- В левой панели, в разделе «ГЛОБАЛЬНО», выбираем Загрузка данных.
- Нажимаем на кнопку Очистить кэш (Clear Cache).
- Наконец, в самом редакторе Power Query, нажимаем на кнопку Обновить предварительный просмотр. Система снова авторизуется и правильно прочитает новые столбцы.
3. Протокол очистки в Power BI Desktop
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Поведение в Power BI идентично Excel, но параметры расположены немного по-другому.
Полная очистка локальной модели
Sección titulada «Purga Completa del Modelo Local»- Переходим в Файл -> Параметры и настройка -> Параметры.
- В левом боковом меню, в разделе «ГЛОБАЛЬНО», выбираем Загрузка данных (Data Load).
- В разделе «Параметры кэша данных» нажимаем на Очистить кэш.
- (Необязательно) Если мы используем Q&A, мы также нажимаем «Очистить кеш Q&A».
- Закрываем окно параметров.
- В основном представлении (или в Power Query) мы нажимаем на Обновить. Поскольку нет локального кэша, Power BI выполнит чистый HTTP-запрос для загрузки нового схемы JSON из нашей API, мгновенно решив проблему.
4. Контрольный список обслуживания кэша
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ Отладка разрешений: Удаление поврежденных глобальных учетных данных после реорганизации или изменения UPN Entra ID.
- ✓ Обновление схемы: Очистка локального кэша данных в Power Query для перезагрузки документа
$metadataERP. - ✓ Окончательная проверка: Проверка импортированных столбцов в представлении Power Query, чтобы убедиться, что они соответствуют текущему определению AL.

