キャッシュクリーン(Excel & Power BI)
Business Centralで新しいAPIをデプロイした後のメタデータとスキーマキャッシュの衝突を解決するオペレーションプロトコル
0閲覧数
継続的インテグレーション(CI/CD)の運用において、私たちはAL言語で記述されたAPIを変更し、新しい列を追加하거나既存の列をリネームすることが一般的です(例: numDocumento を Num_Documento に変更)
ビジネスセンタルでのデプロイが成功しても、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)はODataの新しい$metadataドキュメントをダウンロードを拒否しています。古い列を要求し続け、サーバーがリクエストを拒否します。
2. Microsoft Excelでのクリーンアッププロトコル
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Power Queryを介してExcelから分析用APIを直接利用する場合、スキーマの更新を強制するために2つのキャッシュをクリアする必要があります:
ステップA: 権限のクリア
Sección titulada «Paso A: Limpieza de Permisos»- オプションタブからデータタブに移動します。
- データの取得 -> データソース設定(Data Source Settings)をクリックします。
- グローバルまたは現在のワークブックのデータソース一覧から、ビジネス中央APIのパスを探します。
- 権限のクリア(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»- <strong>ファイル</strong> -> <strong>オプションと設定</strong> -> <strong>オプション</strong>に移動します。
- 左側のメニューで「GLOBAL」の下にある<strong>データの読み込み</strong>(Data Load)を選択します。
- 「データキャッシュオプション」セクションで<strong>キャッシュを削除</strong>をクリックします。
- (オプション) Q&Aを使用する場合は、「Q&Aのキャッシュを消去」もクリックします。
- オプションウィンドウを閉じます。
- メインビュー(またはPower Query)で<strong>更新</strong>をクリックします。ローカルキャッシュが見つからないため、Power BIは新しいJSON APIスキーマをダウンロードするクリーンなHTTP呼び出しを実行し、即座にエラーを解決します。
4. キャッシュメンテナンスチェックリスト
Sección titulada «4. Checklist de Mantenimiento de Caché»- <span style="color: hsl(142, 70%, 45%); font-weight: bold; margin-right: 4px;">✓</span><strong>権限デバッグ:</strong>Entra IDのUPN変更や再編後のグローバルクレデンシャルの削除。
- <span style="color: hsl(142, 70%, 45%); font-weight: bold; margin-right: 4px;">✓</span><strong>スキーマ更新:</strong>Power Queryでのローカルデータキャッシュの削除によりERPの<code dir="auto">$metadata</code>ドキュメントを再読み込みします。
- <span style="color: hsl(142, 70%, 45%); font-weight: bold; margin-right: 4px;">✓</span><strong>最終検証:</strong>Power Queryビューでインポートされたカラムを確認し、ALの現在の定義と一致することを確認します。

