ขั้นตอนการติดตั้ง AL Language บน Visual Studio Code สำหรับ Microsoft Dynamics 365 Business Central

Spread the love

หลังจากได้ที่ได้ Download และติดตั้งตัวโปรแกรม Microsoft Dynamics 365 Business Central กันไปแล้ว สำหรับใครที่ยังไม่มีโปรแกรมก็สามารถคลิกที่ link นี้ได้เลยครับ คู่มือการดาวน์โหลดและติดตั้งโปรแกรม Microsoft Dynamics 365 Business Central และหากคุณเป็นมือใหม่แนะนำให้อ่าน blog นี้เพื่อเพิ่มความเข้าใจในตัวโปรแกรมครับ ส่วนประกอบต่าง ๆ ของโปรแกรม Microsoft Dynamics 365 Business Central

เอาละ เมื่อคุณมีโปรแกรมพร้อมแล้ว แน่นอนว่าคุณคงเป็น developement ที่อยากจะสร้าง Extension บน Microsoft Dynamics 365 BC และสิ่งที่สำคัญในการสร้าง Extension ก็คือเจ้าตัว AL Language บน Visual Studio Code นั่นเอง

ภายใน blog นี้จะประกอบไปด้วย

  1. Download และ ติดตั้ง Visual Studio Code
  2. ติดตั้ง AL Language
  3. New project + Setup launch.json และ app.json
  4. Say Hello World

Step 1: Download และ ติดตั้ง Visual Studio Code

ก่อนอื่นคุณสามารถดาวน์โหลดโปรแกรม Visual Studio Code มาก่อน

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

เมื่อทำการ install เสร็จเรียบร้อยแล้วจะได้โปรแกรมหน้าตาแบบนี้

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

Step 2: ติดตั้ง AL Language

ภายในโปรแกรม Visual Stodio Code ให้ไปที่ Extensions จากนั้นให้คุณเลือก Install from VSIX ตามรูปภาพด้านล่างได้เลย

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

จะมีหน้าต่างสำหรับ browse file ขึ้นมาให้คุณทำการติดตั้งตัว AL Language ซึ่งโดยทั่วไปจะอยู่ในไฟล์ในโฟลเดอร์คุณดาวน์โปรแกรม Microsoft Dynamics 365 Business Central มา โดย default แล้วจะอยู่ที่ ..\ModernDev\program files\Microsoft Dynamics NAV\140\AL Development Environment\ ALLanguage.vsix

แต่ถ้าหากคุณไม่มีไฟล์ติดตั้งแล้วละก็ คุณยังสามารถหาเจ้าไฟล์ AL Language ได้จาก C:\Program Files (x86)\Microsoft Dynamics 365 Business Central\140\AL Development Environment\ ALLanguage.vsix

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

หากการติดตั้งสำเร็จ คุณก็ได้จะ AL Language Extension มา

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

คุณสามารถดาวน์โหลด AL Language Extension จาก Visual Studio Code ได้ แต่จะดีกว่าถ้าคุณติดตั้งโดยใช้ VSIX file จาก Microsoft Dynamics 365 BC OnPrem ซึ่งคุณสามารถมั่นใจได้ว่า Extension ที่คุณติดตั้งนั้น มี version ตรงกันกับตัวโปรแกรม Microsoft Dynamics 365 BC

Step 3: New Project + Setup launch.json และ app.json

โอเค เมื่อคุณติดตั้ง AL Language Extension เรียบร้อยแล้ว เราก็จะมาเริ่มสร้าง project กันเลย โดยการกด Ctrl+Shift+P จากนั้นเลือก AL Go!

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

โปรแกรมจะทำการเลือก default project directory ให้กับคุณ ซึ่งสามารถเปลี่ยนได้ ถ้าไม่อยากเปลี่ยนก็กด Enter ได้เลย

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

จากนั้นจะมี option ขึ้นมาให้เลือก ให้คุณเลือก Your own server

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

ให้คุณไปที่ launch.json เพื่อทำการแก้ไขข้อมูลสำหรับ server setting ให้ตรงกับ service tire , server name ของคุณ (localhost) และ developement service port ในรูปด้านล่างจะเป็นไฟล์ launch.json ที่โปรแกรม default มาให้

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

เมื่อทำการแก้ไข setting ให้ match กับโปรแกรม Microsoft Dynamics 365 BC ที่ติดตั้งในเครื่องแล้วจะได้รูปตามด้านล่าง

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

ในส่วนของ “authentication” หากคุณใช้การ login เข้าสู่ระบบแบบ username และ password ก็ให้ใช้เป็น “UserPassword” แต่ผมจะเลือกใช้การ login ด้วย Windows authentication แทน ผมเลยใช้เป็น “Windows” ที่ “authentication”

ส่วน port คุณสามารถดูได้จาก Developement ใน Service tire ที่คุณได้สร้างไว้

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

และนี่คือไฟล์ app.json ของผม

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

หากคุณต้องการอ่านรายละเอียดเพิ่มเติมเกี่ยวไฟล์ launch.json และ app.json สามารถอ่านที่จาก ที่นี่

เมื่อคุณทำการ setup ไฟล์ launch.json และ app.json เสร็จเรียบร้อยแล้วขั้นตอนต่อไปคือการ Download Symbols จาก Business Central database เพื่อเป็นการให้ AL Project ของคุณรู้จักกับข้อมูล object, function, variable, และทุกอย่างที่กำหนดไว้บน Business Central Database

วิธีการ Download Symbols โดยให้กด Ctrl+Shift+P แล้วเลืิก AL: download symbols

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

ถ้าสามารถทำการ download symbols ได้ ที่ output จะแสดงข้อความแบบนี้

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

แต่ถ้าหากคุณไม่สามารถทำการ download symbols ได้ ให้ลองไปตรวจสอบว่าได้ติ๊กถูกที่ช่อง Enable Developer Service Endpoint ที่ Service Tire หรือเปล่า ให้ติ๊กถูกแล้ว restart service หนึ่งครั้ง แล้วลองทำการ download symbols ดูอีกครั้ง

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

เมื่อคุณ download symbols เสร็จแล้วจะสังเกตุได้ว่าไม่มี error แจ้งเตือนแล้ว

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

Step 4: Say Hello World

ทุกครั้งที่คุณ new project ระบบจะสร้างไฟล์ page extension ซึ่ง extend มาจาก Customer List page โดยใน OnOpenPage trigger จะให้แสดง message ว่า “App published: Hello word’

หากคุณอยากลองเทส extension นี้ก็ให้กด F6 เพื่อ install และ publish extension กันเลย

จากรูปด้านล่างคือ package ได้ถูกติดตั้งบน Server แล้วแต่ยังมี error บอกว่าไม่สามารถ startup page ได้ ซึ่งผมจะเขียนวิธี setup ตัว startup page ใน blog ถัดไป

ตอนนี้ให้คุณลองเทส Extension ของคุณก่อนดีกว่า ว่าสามารถทำงานได้จริงหรือเปล่า โดยให้คุณเปิด web browser ขึ้นมา จะเป็น Chrome หรือ Firefox ก็ได้ แล้วให้พิมพ์ว่า http://localhost:8080/BC140/ บน url เมื่อเปิดหน้า Web Client ขึ้นมาแล้วก็ให้ลองคลิกที่ Customers ดูว่าจะมี Message เด้งขึ้นมา Hello World หรือไม่

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

หากขึ้นมาแบบนี้ก็แสดงว่าเป็นอันเรียบร้อย

Install and Setup al language in VSC for microsoft Dynamics 365 Business Central

บางคิดอาจคิดในใจว่ายังไม่ได้เขียนโค้ดเลยซักตัว ไม่เป็นไรครับ เดี๋ยว blog ต่อไปผมจะพาเขียนโค้ดพื้นฐานในการสร้าง Extension บน Microsoft Dynamics 365 Business Central อย่างแน่นอน ขอบคุณทุกท่านที่สละเวลาอ่านมาถึงตรงนี้ แล้วเจอกันใหม่ใน blog ถัดไปครับ สวัสดีครับ

บทความที่คุณอาจสนใจ

เริ่มต้นสร้าง Extension แรกบน MS Dynamics 365 BC ตอนที่ 1 – New Table
คู่มือใช้งาน Dynamics 365 Business Central – Sales Module: ตอนที่ 1 สร้าง Customer

Leave a Reply

Your email address will not be published. Required fields are marked *