APIおよびデータのトラブルシューティング
ビジネスセンターにおける大規模抽出エラー、ODataネットワーク遅延、およびアーキテクチャ制限に対する対応プロトコル。
データパイプラインの整合性を確保するDevSecOps作業において、Business Centralとビジネスインテリジェンスプラットフォームの統合はボトルネックやネットワークの障害となることがあります。
このドキュメントでは、実装されたアーキテクチャに基づいて、遭遇した最も深刻な障害の根本原因とその確定的な解決策について説明します。
インシデント1: 「リモートホストが接続を強制終了しました」(ODataタイムアウト)
Sección titulada «Incidente 1: “Host remoto forzó la interrupción” (Timeout OData)»Power Query、Power BI Desktop、またはPythonスクリプトを通じて、歴史的データセット(例: 200,000行以上)を更新しようとすると、接続が数分間ロードされ、突然エラーが発生し、接続が閉じられました: リモートホストが接続を強制終了しました。(ODataタイムアウト)が表示されます。
これはNST(Navision Server Tier)でのリソース枯渇による障害です。 対象のエンドポイントが最適化されたAPI(Query)ではなく、Webサービスとして公開された標準ページ(例:ページ38)である場合に発生します。Webページに数千行を要求すると、Business Centralサーバーは各行についてビジュアルコンポーネントのレンダリング、トリガーの実行、複雑なサブクエリ(FlowFields)の算出をRAM上で行おうとします。処理が時間制限(通常10分または15分)を超えると、AzureのロードバランサーはERPの停止を防ぐため、HTTP接続を安全のために切断します。
DevSecOpsソリューション(実装済み)
Sección titulada «Solución DevSecOps (Implementada)»- ページベースのWebサービスを放棄する:Webサービスタイプのデータ取得をアーキテクチャから削除する。
- ネイティブAPI(Query)を開発する:要求をALの
queryオブジェクトに移行する。これにより、インターフェース層をスキップして純粋なSQL文に変換され、応答時間が15分から30秒未満に短縮される。 - ページング(外部スクリプト):PythonなどのETL言語を使用する場合、サーバーが返す
@odata.nextLinkトークンの追跡とプログラムを確実に実施する必要がある。Business Centralは返されるJSONページの最大行数に制限を設けているためである。
インシデント2: APIルートにサブフォルダを作成できない
Sección titulada «Incidente 2: Imposibilidad de Crear Subcarpetas en Rutas API»ALで新しいAPIを開発中に、APIのプロパティにスラッシュ(/)を追加して論理的な部署階層を作成しようとすると、Visual Studio Codeのコンパイラが致命的なエラーを発生させ、.appファイルの生成をブロックする。
不具合コードの例:
// ERROR FATAL DE COMPILACIÓN: Microsoft prohíbe las barras en metadatos de enrutamientoAPIGroup = 'portelcore/departamentos/finanzas';Microsoft Business CentralのOData V4ジェネレーターエンジンには、工場で厳密にハードコードされた構造的ルートが存在する。
サーバーが常に、そして唯一受け入れるのは、変更不可能な3層モデルです:
{APIPublisher} / {APIGroup} / {APIVersion}
カスタムAPIのURLに「サブフォルダ」を追加するには、技術的な能力やコンテナレベルの権限が存在しない。
アーキテクチャソリューション / ワークアラウンド
Sección titulada «Solución / Workaround Arquitectónico»厳格なネーミング規則 (ネーミング規則) を採用する。
物理的なルートを / で分離できないため、APIGroup または APIPublisher 内でスネークケース (Snake_case) を使用して階層をシミュレートします。
-
正しい実装 (ロジカルグループ):
APIPublisher = 'portelcore';APIGroup = 'api_portelcore_finanzas_1';APIVersion = 'v1.0';ODataの結果:
.../api/portelcore/api_portelcore_finanzas_1/v1.0/ -
代替実装 (ロジカルパブリッシャー):
APIPublisher = 'portelcore_finanzas';APIGroup = 'analitica';APIVersion = 'v1.0';ODataの結果:
.../api/portelcore_finanzas/analitica/v1.0/
3. APIおよびデータ診断チェックリスト
Sección titulada «3. Checklist de Diagnóstico de API y Datos»- ✓ パフォーマンス: NSTでのRAMオーバーフローによるタイムアウトを回避するために、ページ型サービスをすべて
Query APIオブジェクトに置き換えます。 - ✓ ルーティング形式: ALコンパイラが要求する3レベルのスキーマを厳密に遵守し、ロジカル階層にスネークケースを使用します。
- ✓ 同期: 再構成後のスキーマの再発見を強制するために、クライアントのローカルキャッシュを事前にクリーンアップします。

