將 AL 程式部署到 Dynamics 365 Business Central 的正式環境(Production)

將 AL 程式部署到 Microsoft Dynamics 365 Business Central 的生產環境(Production)涉及幾個步驟,這些步驟包括建立和測試擴展、建立 .app 檔案、以及透過 Visual Studio Code 或 Business Central 管理界面來進行部署。以下是詳細的步驟:

步驟 1:準備環境

  1. 確認開發環境
    • 確保你已經在本地安裝了 Visual Studio Code,並安裝了 AL 擴展。
    • 你需要安裝並配置 Business Central Docker 容器或使用 Cloud Sandbox 進行開發和測試。
    • 確保你有正確的 Business Central 供應商或客戶的生產環境的 API 訪問權限。
  2. 開發並測試你的擴展
    • 確保你在 sandbox 或開發環境中已經測試完畢,並且沒有錯誤。
    • 建立Business Central extension 權限設定檔
    • 使用 Ctrl + Shift + B 或在命令面板(Ctrl + Shift + P )中選擇 AL: Package 來產生 .app 檔案。

Business Central extension 權限設定說明:

命令面板(Ctrl + Shift + P )中選擇 “AL: Generate permission set as AL object containing current extension objects” 來產生 Extension 的權限檔

根據 Business Central 權限的語法,權限應該使用正確的格式來指定每一個物件的權限。每個物件都應該跟隨相應的權限級別,如 R(讀取)、M(修改)、I(插入)、D(刪除)、X(執行)。

JSON
permissionset 60200 GeneratedPermission
{
    Assignable = true;
    Permissions =
        tabledata "WIP Inventory" = RIMD,  // 讀取、修改、插入、刪除
        table "WIP Inventory" = X,         // 執行
        codeunit "WIP Tool" = X,           // 執行
        page "WIP Inventory" = X;          // 執行
}

說明:

  1. tabledata “WIP Inventory” = RIMD:這裡使用了 RIMD 權限組合,表示讀取(R)、插入(I)、修改(M)和刪除(D)的權限。
  2. table “WIP Inventory” = X:表示對該資料表有執行(X)權限。
  3. codeunit “WIP Tool” = X:表示對該 Codeunit 有執行(X)權限。
  4. page “WIP Inventory” = X:表示對該 Page 有執行(X)權限。

請確保這些物件(table, codeunit, page 等)名稱正確且符合你的 Business Central 系統中實際使用的名稱。如果物件名稱或權限有錯誤,將無法正常工作。

步驟 2:建立 .app 檔案

  1. 在 Visual Studio Code 中,開啟你的 AL 項目。
  2. 使用 AL: Package 命令來將你的程式碼包裝成 .app 檔案。這會根據你的 app.json 檔案中的設定,將所有的 AL 源碼編譯並包裝成一個 .app 檔案。
    • 使用Ctrl + Shift + B 或在命令面板(Ctrl + Shift + P )中選擇 AL: Package 來產生 .app
    • 完成後,你會在 專案名稱 資料夾中找到 .app 檔案。

步驟 3:部署到生產環境

1.登入到你的 Business Central 生產環境。

2. 進入 管理擴展(Extension Management) 頁面(可以在“設置”和“擴展”中找到)。

image 4

3. 點擊 上傳,並選擇你剛剛產生的 .app 檔案。

image 5

步驟 4:確認部署

一旦部署完成,請確認以下幾點:

  1. 管理擴展(Extension Management) 頁面中,確認你的擴展顯示為已安裝。
  2. 驗證擴展的功能是否正常運行。
  3. 如果有必要,進行進一步的配置或資料遷移。

常見問題:

  • 驗證錯誤:如果發生驗證錯誤,請檢查 .app 檔案中的元資料,確保所有的版本號、對應的物件名稱等設定正確。
  • 權限問題:確保擁有足夠的權限來進行擴展的部署。

這些步驟應該可以幫助你順利將 AL 擴展部署到生產環境。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *


內容索引