建立一個Hello World 範例程式，並佈署到 D365 Business Central 指定的測試環境

內容目錄

整個開發與測試的完整步驟，包含：

安裝 Visual Studio Code
Visual Studio Code 安裝延伸套件 AL Language 擴充套件
建立 Hello World 的 AL 專案
撰寫 AL 程式碼
設定 launch.json 指定要佈署的測試環境
在 VS Code 部署到 Microsoft Dynamics 365 Business Central 測試環境

安裝與準備

安裝 Visual Studio Code。
在 VS Code 安裝 AL Language 擴充套件（由 Microsoft 提供）。
取得你的 Business Central Sandbox (測試環境) 的 URL 與登入帳號。
通常 URL 格式是：

Perl

https://businesscentral.dynamics.com/<tenant>/<environment>/

https://businesscentral.dynamics.com/<tenant>/<environment>/

建立 AL 專案

在命令列或 VS Code 命令面板 (Ctrl+Shift+P) 輸入：

Makefile

AL: Go!

AL: Go!

選擇一個資料夾來建立專案。
這會自動產生一個專案結構，包含 app.json、launch.json。

撰寫 Hello World 程式

在專案資料夾下建立新檔案 HelloWorld.al

C++

pageextension 50110 CustomerListExt extends "Customer List"
{
    actions
    {
        addlast(Processing)
        {
            action(HelloWorld)
            {
                ApplicationArea = All;
                Caption = 'Hello World';
                Image = Smile;

                trigger OnAction()
                begin
                    Message('Hello World from AL Extension!');
                end;
            }
        }
    }
}

pageextension 50110 CustomerListExt extends "Customer List"
{
    actions
    {
        addlast(Processing)
        {
            action(HelloWorld)
            {
                ApplicationArea = All;
                Caption = 'Hello World';
                Image = Smile;

                trigger OnAction()
                begin
                    Message('Hello World from AL Extension!');
                end;
            }
        }
    }
}

說明：

這支程式的 Id 編號為 50110 ，要在 app.json 範圍內，且不能在D365 Business Central上有重覆註冊
這個程式會在 Customer List 頁面的動作下拉頁面中加一個 Hello World 按鈕。
點擊按鈕時會跳出訊息 Hello World from AL Extension!。

設定 `launch.json`

打開 .vscode/launch.json，確認內容大致如下（修改成你的環境資訊）：

JSON

{
    "configurations": [        
        {
            "name": "Microsoft cloud sandbox",
            "request": "launch",
            "type": "al",
            "environmentType": "Sandbox",
            "environmentName": "Your Environment Name",
            "startupObjectId": 22,
            "startupObjectType": "Page",
            "breakOnError": "All",
            "launchBrowser": true,
            "enableLongRunningSqlStatements": true,
            "enableSqlInformationDebugger": true,
            "tenant": "Your tenant Code"
        }
    ]
}

{
    "configurations": [        
        {
            "name": "Microsoft cloud sandbox",
            "request": "launch",
            "type": "al",
            "environmentType": "Sandbox",
            "environmentName": "Your Environment Name",
            "startupObjectId": 22,
            "startupObjectType": "Page",
            "breakOnError": "All",
            "launchBrowser": true,
            "enableLongRunningSqlStatements": true,
            "enableSqlInformationDebugger": true,
            "tenant": "Your tenant Code"
        }
    ]
}

說明：

startupObjectId: 22 代表 Customer List（系統內建頁面）

設定 app.json

打開根目錄下的 app.json，確認內容大致如下（修改成你的環境資訊）：

JSON

{
  "id": "9f1d30b1-3f1e-4be7-86e6-6f29091d3120",
  "name": "Hello World",
  "publisher": "Default Publisher",
  "version": "1.0.0.0",
  "brief": "",
  "description": "",
  "privacyStatement": "",
  "EULA": "",
  "help": "",
  "url": "",
  "logo": "",
  "dependencies": [],
  "screenshots": [],
  "platform": "1.0.0.0",
  "application": "26.0.0.0",
  "idRanges": [
    {
      "from": 50100,
      "to": 50149
    }
  ],
  "resourceExposurePolicy": {
    "allowDebugging": true,
    "allowDownloadingSource": true,
    "includeSourceInSymbolFile": true
  },
  "runtime": "15.0",
  "features": [
    "NoImplicitWith"
  ]
}

{
  "id": "9f1d30b1-3f1e-4be7-86e6-6f29091d3120",
  "name": "Hello World",
  "publisher": "Default Publisher",
  "version": "1.0.0.0",
  "brief": "",
  "description": "",
  "privacyStatement": "",
  "EULA": "",
  "help": "",
  "url": "",
  "logo": "",
  "dependencies": [],
  "screenshots": [],
  "platform": "1.0.0.0",
  "application": "26.0.0.0",
  "idRanges": [
    {
      "from": 50100,
      "to": 50149
    }
  ],
  "resourceExposurePolicy": {
    "allowDebugging": true,
    "allowDownloadingSource": true,
    "includeSourceInSymbolFile": true
  },
  "runtime": "15.0",
  "features": [
    "NoImplicitWith"
  ]
}