หลังจากได้ที่ได้ 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 นี้จะประกอบไปด้วย
- Download และ ติดตั้ง Visual Studio Code
- ติดตั้ง AL Language
- New project + Setup launch.json และ app.json
- Say Hello World
Step 1: Download และ ติดตั้ง Visual Studio Code
ก่อนอื่นคุณสามารถดาวน์โหลดโปรแกรม Visual Studio Code มาก่อน
เมื่อทำการ install เสร็จเรียบร้อยแล้วจะได้โปรแกรมหน้าตาแบบนี้
Step 2: ติดตั้ง AL Language
ภายในโปรแกรม Visual Stodio Code ให้ไปที่ Extensions จากนั้นให้คุณเลือก Install from VSIX ตามรูปภาพด้านล่างได้เลย
จะมีหน้าต่างสำหรับ 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
หากการติดตั้งสำเร็จ คุณก็ได้จะ AL Language Extension มา
คุณสามารถดาวน์โหลด 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!
โปรแกรมจะทำการเลือก default project directory ให้กับคุณ ซึ่งสามารถเปลี่ยนได้ ถ้าไม่อยากเปลี่ยนก็กด Enter ได้เลย
จากนั้นจะมี option ขึ้นมาให้เลือก ให้คุณเลือก Your own server
ให้คุณไปที่ launch.json เพื่อทำการแก้ไขข้อมูลสำหรับ server setting ให้ตรงกับ service tire , server name ของคุณ (localhost) และ developement service port ในรูปด้านล่างจะเป็นไฟล์ launch.json ที่โปรแกรม default มาให้
เมื่อทำการแก้ไข setting ให้ match กับโปรแกรม Microsoft Dynamics 365 BC ที่ติดตั้งในเครื่องแล้วจะได้รูปตามด้านล่าง
ในส่วนของ “authentication” หากคุณใช้การ login เข้าสู่ระบบแบบ username และ password ก็ให้ใช้เป็น “UserPassword” แต่ผมจะเลือกใช้การ login ด้วย Windows authentication แทน ผมเลยใช้เป็น “Windows” ที่ “authentication”
ส่วน port คุณสามารถดูได้จาก Developement ใน Service tire ที่คุณได้สร้างไว้
และนี่คือไฟล์ app.json ของผม
หากคุณต้องการอ่านรายละเอียดเพิ่มเติมเกี่ยวไฟล์ 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
ถ้าสามารถทำการ download symbols ได้ ที่ output จะแสดงข้อความแบบนี้
แต่ถ้าหากคุณไม่สามารถทำการ download symbols ได้ ให้ลองไปตรวจสอบว่าได้ติ๊กถูกที่ช่อง Enable Developer Service Endpoint ที่ Service Tire หรือเปล่า ให้ติ๊กถูกแล้ว restart service หนึ่งครั้ง แล้วลองทำการ download symbols ดูอีกครั้ง
เมื่อคุณ download symbols เสร็จแล้วจะสังเกตุได้ว่าไม่มี error แจ้งเตือนแล้ว
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 หรือไม่
หากขึ้นมาแบบนี้ก็แสดงว่าเป็นอันเรียบร้อย
บางคิดอาจคิดในใจว่ายังไม่ได้เขียนโค้ดเลยซักตัว ไม่เป็นไรครับ เดี๋ยว blog ต่อไปผมจะพาเขียนโค้ดพื้นฐานในการสร้าง Extension บน Microsoft Dynamics 365 Business Central อย่างแน่นอน ขอบคุณทุกท่านที่สละเวลาอ่านมาถึงตรงนี้ แล้วเจอกันใหม่ใน blog ถัดไปครับ สวัสดีครับ
บทความที่คุณอาจสนใจ
• เริ่มต้นสร้าง Extension แรกบน MS Dynamics 365 BC ตอนที่ 1 – New Table
• คู่มือใช้งาน Dynamics 365 Business Central – Sales Module: ตอนที่ 1 สร้าง Customer