Ir al contenido

AL と環境の概要

Application Language (AL) の深い基礎知識、下位アーキテクチャ、および VS Code とテナントの高度な設定

0閲覧数

DevSecOpsおよびデータエンジニアリング文化において、Dynamics 365 Business CentralなどのERPシステムを「ブラックボックス」や単なるWebインターフェースとして扱うのをやめることが不可欠です。コアレベルで最大のパフォーマンスを引き出し、カスタマイズするには、ソースコードレベルにまで下がり、その下位アーキテクチャを理解する必要があります。

1. AL (Application Language)とは何ですか?

Sección titulada «1. ¿Qué es AL (Application Language)?»

ALは構造的で宣言的で強力に型付けされたプログラミング言語です。これはマイクロソフトがビジネス中央のビジネスロジックとデータモデルを拡張するために独自に設計した言語です(古いC/ALに置き換えます)。

ALで作業することは、インフラとしてのコード(IaC)(TerraformやAnsibleなど)で作業することと非常に似ています。私たちはデータベースをインターフェースでクリックして変更しません。私たちはテキストファイル(.al)に、データベース(テーブル)、ロジック(コードユニット)、インターフェース(ページ)、およびAPI(クエリ)がどのようにあるべきかを定義します。

その後、このコードはパッケージまたは拡張機能(.app)にコンパイルされ、サーバーにデプロイされます。マイクロソフトは標準コードベースを変更することを許可していません。私たちのすべてのプログラミングは、ERPに「追加レイヤー」(拡張機能)として接続される「追加レイヤー」として機能します。

2. カスタムアーキテクチャ(NSTとSQL Server)

Sección titulada «2. Arquitectura Subyacente (El NST y SQL Server)»

効率的にプログラミングするには、ビジネス中央が私たちの指示をどのように処理するかを理解する必要があります:

  • データ層: すべては、マイクロソフトSQL Server(クラウド環境ではAzure SQL)のエンジンにあります。
  • アプリケーション層(NST): Navision Server Tierは「脳」です。私たちのALコードをSQLクエリに変換し、ユーザーが見るHTML/JSONやAPIが消費するデータをレンダリングします。これの理解は、NSTのメモリをオーバーロードしないために非常に重要です。

私たちはローカルで開発しますが、クラウドのSandboxに対してコンパイルします。これは私たちの基本構成です:

  1. Visual Studio Code (VS Code): 私たちの統合開発環境(IDE)です。
  2. 「AL Language」拡張機能(マイクロソフト): コンパイラ、オートコンプリート(IntelliSense)、デバッグツール、およびテナントへの接続を提供します。
  3. (推奨されるオプション) 「AL Object Designer」拡張機能: マイクロソフトのベーステーブルをナビゲートし、標準フィールドの名前を発見するための非常に便利なビジュアルエクスプローラーです。

3.2. プロジェクト初期化(「スカッフォールディング」)

Sección titulada «3.2. Inicialización del Proyecto (El “Scaffolding”)»

新しいプロジェクトを作成するには、VS Codeのコマンドパレット(Ctrl + Shift + P)を開き、AL: Go!を実行します。アシスタントは次のように尋ねます:

  • プロジェクトを保存するローカルパス。
  • デプロイ先の場所:常に< strong >「Microsoftクラウドサンドボックス」を選択します(開発フェーズでは「Production」は選ばないでください)。

これにより、.vscodeフォルダーとその中のlaunch.jsonファイル、およびルートのapp.jsonファイルを含むベース構造が生成されます。

4. ルーティングと接続(launch.json)

Sección titulada «4. Enrutamiento y Conexión (launch.json)»

.vscode/launch.jsonファイルは、マイクロソフトサーバーとの私たちの命綱です。ここでの設定が緩いと、接続やデプロイのエラーの主な原因になります。

正確な設定が必要で、defaultなどの汎用的な値を避ける必要があります。

{
"version": "0.2.0",
"configurations": [
{
"name": "Conexión a Sandbox PORTELCORE",
"request": "launch",
"type": "al",
"environmentType": "Sandbox",
// 1. Nombre EXACTO del entorno (Sensible a mayúsculas y minúsculas)
// Esto se obtiene del Admin Center de Business Central.
"environmentName": "Sandbox-Dev",
// 2. Tenant ID: Usar el GUID alfanumérico garantiza que evitamos fallos de DNS o redirección.
"tenant": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
// 3. Objeto de inicio: 22 es la lista de clientes. Cuando pulsemos F5, se abrirá esta pantalla.
"startupObjectId": 22,
"startupObjectType": "Page",
"breakOnError": "Default",
"launchBrowser": true,
// 4. Parámetros de Telemetría y Debugging avanzados
"enableLongRunningSqlStatements": true,
"enableSqlInformationDebugger": true
}
]
}

5. メタデータと依存関係の管理(app.json)

Sección titulada «5. Gestión de Metadata y Dependencias (app.json)»

app.jsonファイルは、私たちの拡張機能のマニフェストです。私たちは誰であるか、どのバージョンを公開しているかを定義し、最も重要なのは、どの依存関係があるかを定義します。

ALエコシステムでは、ERPの「シンボル」(事前にコンパイルされたライブラリ)を事前にダウンロードしないとコンパイルできません。app.jsonは、VS Codeにどのバージョンのシンボルをサーバーから取得するかを伝えます。

{
"id": "56a4f575-efca-45f3-8a35-43c3ab4c9adf",
"name": "Entradas_Salidas_AL",
"publisher": "Portelcore DevSecOps",
"version": "1.0.0.0",
"brief": "Gestión optimizada de datos y extensiones.",
// Dependencias de otras apps. Si no usamos módulos raros, dejar vacío o con lo básico.
"dependencies": [],
// EL PUNTO DE RUPTURA: La versión de "application" debe coincidir con la de nuestro Sandbox.
// Si pedimos la 27.0 y el server tiene la 25.0, todo el proyecto fallará.
"application": "25.0.0.0",
"platform": "25.0.0.0",
"runtime": "15.0", // Versión del motor de ejecución (NST).
"idRanges": [
{
"from": 50100,
"to": 50149 // Nuestro bloque de IDs reservados.
}
]
}

6. エンバイロメントの同期(シンボルの「プル」)

Sección titulada «6. Sincronización del Entorno (El “Pull” de Símbolos)»

最初のコードラインを書く前の最終ステップは、VS Codeをクラウドと同期することです。

  1. 私たちの隠しフォルダー.alpackagesが空(または作成済み)であることを確認します。
  2. コマンドを実行します:Ctrl + Shift + P -> AL: Download Code(またはAL: Download Symbols)。
  3. システムはブラウザ内のコードを通じて認証(デバイスログイン)を求めるでしょう。私たちは管理者資格情報を使用します。
  4. もしlaunch.jsonとapp.jsonが正しい場合、コンソールでMicrosoft_Application.appなどのパッケージがダウンロードされているのが見えます。

現在、ローカルマシンはERPの全体的なデータベース構造を把握しています。プログラミングを開始する準備ができました。

  • ✓ 接続性: VS Codeコンソールでのシンボルの正常なダウンロード(出力コード 0)。
  • ✓ バージョン: app.json内のruntimeおよびapplicationポリシーの整合性と、現在のNSTバージョンの一致。
  • ✓ 認証: OAuth 2.0によるデバイスログインによるサインインフローの完了。