Ir al contenido

キャッシュクリーン(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つのキャッシュをクリアする必要があります:

  1. オプションタブからデータタブに移動します。
  2. データの取得 -> データソース設定(Data Source Settings)をクリックします。
  3. グローバルまたは現在のワークブックのデータソース一覧から、ビジネス中央APIのパスを探します。
  4. 権限のクリア(Clear Permissions)をクリックします。

ステップB: データキャッシュのクリア

Sección titulada «Paso B: Limpieza de la Caché de Datos»
  1. 右ペインのクエリをダブルクリックしてPower Queryエディタを開きます。
  2. ファイル -> オプションと設定 -> クエリオプションに移動します。
  3. 左パネルの「グローバル」セクションで、データの読み込みを選択します。
  4. キャッシュのクリア(Clear Cache)ボタンをクリックします。
  5. 最後に、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»
  1. <strong>ファイル</strong> -> <strong>オプションと設定</strong> -> <strong>オプション</strong>に移動します。
  2. 左側のメニューで「GLOBAL」の下にある<strong>データの読み込み</strong>(Data Load)を選択します。
  3. 「データキャッシュオプション」セクションで<strong>キャッシュを削除</strong>をクリックします。
  4. (オプション) Q&Aを使用する場合は、「Q&Aのキャッシュを消去」もクリックします。
  5. オプションウィンドウを閉じます。
  6. メインビュー(または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の現在の定義と一致することを確認します。