Microflow เป็นหนึ่งในองค์ประกอบของ ONEWEB ที่พัฒนาขึ้นเพื่อวัตถุประสงค์ในการอํานวยความสะดวกในการเชื่อมต่อโครงข่ายกับระบบอื่น ๆ อาจเป็นการเชื่อมต่อภายในระหว่างส่วนประกอบ ONEWEB ที่แตกต่างกันหรือการเชื่อมต่อภายนอกกับระบบภายนอก สามารถเชื่อมต่อกับระบบภายนอกผ่าน REST หรือ SOAP API

Microflow สามารถใช้ได้ 2 วิธี

ไมโครโฟลว์แบบฝังตัว (Embedded Microflow) ผู้ใช้สามารถออกแบบไมโครเซอร์วิสโดยใช้ Microflow แล้วส่งออกเป็นไฟล์ jar เพื่อใช้ในระบบอื่น ผู้ใช้สามารถนําเข้าไฟล์ jar ไปยังโครงการ java ที่มีอยู่และใช้ Microflow Java APIs เพื่อเรียกใช้และดําเนินการ microservice

Runtime Microflow Server ผู้ใช้ยังสามารถใช้ Microflow เป็นโหมดเซิร์ฟเวอร์แบบสแตนด์อโลนโดยการติดตั้งรันไทม์ของเซิร์ฟเวอร์และเรียกใช้ Microflow ผ่านบริการเว็บ ในกรณีนี้ Microflow พร้อมใช้งานเป็นบริการและผู้ใช้สามารถเรียกและดําเนินการ microservice โดยใช้ REST APIs

Microflow มีโหนดจํานวนมากที่ได้รับการพัฒนาเพื่อรองรับการรวมเช่น

โหนดฐานข้อมูล (Database Node) Microflow สามารถสื่อสารกับฐานข้อมูล ซึ่งอาจเป็นประโยชน์ถ้าคุณต้องการดึงค่าบางอย่างจากฐานข้อมูล นอกจากนี้ยังสามารถใช้เพื่อแทรกอัปเดตหรือลบข้อมูลจากฐานข้อมูล การรวมนี้สามารถทําได้ผ่านโหนดฐานข้อมูลซึ่งรองรับการเชื่อมต่อสองประเภท JNDI และ JDBC นอกจากนี้ยังรองรับคําสั่ง 4 ประเภท

• เลือก (Select) - เพื่อดึงข้อมูลที่ต้องการจากฐานข้อมูล

• แทรก (Insert) - เพื่อแทรกข้อมูลที่ต้องการลงในฐานข้อมูล

• อัปเดต (Update) - เพื่ออัปเดตค่าในฐานข้อมูล

• ลบ (Delete) - เพื่อลบข้อมูลออกจากฐานข้อมูล คุณสามารถกําหนดฟิลด์และตารางผ่านคําสั่ง SQL

โหนดกระบวนการย่อย (Sub Process Node) ในกระบวนการขนาดใหญ่ กระบวนการหนึ่งสามารถมีรูทีนย่อยหรือกระบวนการอื่นอยู่ภายในได้ แน่นอนว่าต้องมีงานที่ซับซ้อนและในบางกรณีอาจมีฟังก์ชั่นที่ซ้ํากัน แทนที่จะวาดโฟลว์เดียวกันในหลายจุดผู้ใช้สามารถยุบโฟลว์ลงในโฟลว์ที่ง่ายกว่าโดยใช้โหนดกระบวนการย่อย

Web Service Node Web Services เป็นระบบซอฟต์แวร์ที่ออกแบบมาเพื่อรองรับการแลกเปลี่ยนข้อมูล Microflow Designer ให้บริการโหนดบริการเว็บสําหรับการบริโภคบริการ SOAP และ REST นักพัฒนาเพียงแค่ต้องกําหนดค่าข้อกําหนดของบริการและ ONEWEB จะสร้างวิธีการและโครงสร้างข้อมูลเพื่อเรียกบริการ

SOAP

REST

File Read Node Microflow สามารถอ่านข้อมูลบนระบบไฟล์โดยใช้ File Read Node รองรับไฟล์เช่น excel, XML, Delimited และไฟล์ความกว้างคงที่ ใน FileRead Node ผู้ใช้ยังสามารถกําหนดค่าการดําเนินการเกี่ยวกับความสําเร็จและความล้มเหลว

Microflow ได้รับการออกแบบให้เป็นสื่อกลางสําหรับการรวมหลายระบบ เครื่องมือในตัวมีโหนดผู้ช่วยจํานวนมาก นอกจากนี้ยังมีโหนด Java เพื่อรันตรรกะที่กําหนดเองที่จําเป็นสําหรับแอพพลิเคชัน เพิ่มตรรกะที่กําหนดเองให้กับ Microflow เพื่อเพิ่มตรรกะที่กําหนดเองเพียงแค่สร้าง microflow และเพิ่มโหนด java ลงไป นักพัฒนาสามารถใช้ตรรกะที่กําหนดเองใน java และส่งออกเป็นไฟล์ jar เมื่อคุณมีไฟล์ jar แล้วคุณสามารถอัปโหลดไปยังโหนด java microflow และระบุคลาสและวิธีการที่จะเรียกใช้จาก microflow ผู้ใช้ยังสามารถแมปข้อมูลจาก microflow ไปยังคลาส java และย้อนกลับ โปรดอย่าลืมอัปโหลดไฟล์ jar ที่ขึ้นอยู่กับโฟลว์อย่างอิสระโดยใช้ยูทิลิตี้ไฟล์ jar อัปโหลด

ส่วนด้านล่างอธิบายขั้นตอนในการกําหนดค่าโหนด Java

ลากและวางกิจกรรมโหนด Java ไปที่แผงไดอะแกรม เลือกไฟล์ Jar ที่คุณต้องการดําเนินการใน 'Jar Name' หรือเลือกจากรายการที่อัปโหลดที่มีอยู่ คลิกที่ Get Class Name และเลือก java class name ที่กำหนดเองใน field 'Class Name' เลือกวิธีการที่ต้องการเรียกใน 'Method Name' คลิกเปิด Mapping Parameter เพื่อแมปพารามิเตอร์กับเมธอด java และข้อมูลที่ส่งกลับ จาก java ไปยัง process parameter คลิก 'Done' เพื่อบันทึกการตั้งค่า java node ของคุณ

การดําเนินการแบบซิงโครนัสเป็นการปิดกั้น เนื่องจากกระบวนการจะรอจนกว่าการดําเนินการจะเสร็จสมบูรณ์ แต่การดําเนินการแบบอะซิงโครนัสนั้นไม่ปิดกั้น เนื่องจากเป็นเพียงการเริ่มต้นดําเนินการเท่านั้น การทํางานแบบอะซิงโครนัสช่วยให้มีความขนานกันมากขึ้น เนื่องจากการดําเนินการไม่ได้ปิดกั้นกระบวนการจึงสามารถทําการคํานวณอื่น ๆ ได้ในขณะที่การดําเนินการอยู่ระหว่างดําเนินการ

process flow ได้รับการออกแบบให้เป็นกระบวนการแบบอะซิงโครนัสมากขึ้นและ 'submit' จากปุ่ม process จะเริ่มต้น business process แต่แบบฟอร์มไม่จําเป็นต้องรอให้ business process เสร็จสมบูรณ์ นอกจากนี้กระบวนการส่วนใหญ่ใช้เวลาหลายวันจึงจะเสร็จสมบูรณ์ดังนั้นจึงไม่มีประโยชน์ที่จะรอให้กระบวนการเสร็จสมบูรณ์

Microflow สามารถออกแบบเป็นกระบวนการซิงโครนัสซึ่งระบบจะรอให้ข้อมูลถูกส่งกลับจาก Microflow หรือเป็นกระบวนการแบบอะซิงโครนัสที่ผู้ใช้สามารถทํางานบนหน้าจอต่อไปได้ในขณะที่ระบบจะคํานวณในพื้นหลังและอัปเดตหน้าจอด้วยผลลัพธ์ เมื่อใช้ microflow ผู้ใช้สามารถใช้คุณสมบัติการบล็อกหน้าจอเพื่อให้การโทรเป็นการทํางานแบบซิงโครนัสหรือแบบอะซิงโครนัส

ในส่วนนี้เราจะเรียนรู้วิธีสร้าง Microflow ตั้งแต่เริ่มต้น จากเวอร์ชัน 4.0.19.10 ขึ้นไปผู้ใช้สามารถสร้างแอพพลิเคชันจาก AppSpace เท่านั้น จากนั้นผู้ใช้สามารถสร้างเพจภายในแอพพลิเคชันได้ เมื่อสร้าง Microflow แล้ว AppSpace จะนําคุณไปยัง Microflow Designer เพื่อออกแบบโฟลว์

ในส่วนนี้เราจะแสดงวิธีสร้างแอพพลิเคชันและสร้างโฟลว์ในแอพพลิเคชันและวิธีการจําลองและปรับใช้ไมโครโฟลว์นี้กับสภาพแวดล้อมจริง

การแมปข้อมูลเป็นส่วนสําคัญของการรวมระบบเนื่องจากคุณต้องแมปพารามิเตอร์อินพุตและเอาต์พุตเพื่อถ่ายโอนข้อมูลจากองค์ประกอบหนึ่งไปยังอีกองค์ประกอบหนึ่ง ONEWEB มี UI อย่างง่ายสําหรับการแมปพารามิเตอร์ระหว่างส่วนประกอบ

การแมปข้อมูลจาก Smart Form ไปยัง Microflow ONEWEB มี UI แบบลากและวางอย่างง่ายเพื่อแมปพารามิเตอร์จากฟิลด์ Smart Form ไปยัง process parameters ของ Microflow ผู้ใช้สามารถคลิกที่พารามิเตอร์ App Designer จากนั้นลากและวางไปที่ process parameters เพื่อแมปค่าในขณะที่เรียกไมโครโฟลว์ ในทํานองเดียวกันผู้ใช้สามารถคลิกที่แท็บการตอบสนองและแมปพารามิเตอร์กระบวนการส่งออกที่ส่งกลับจาก Microflow ไปยังฟิลด์ UI บน Smart Form

การแมปข้อมูลภายในโหนดต่างๆ ใน Microflow ONEWEB มีหน้าจอพารามิเตอร์การแมปอย่างง่ายเพื่อแมปพารามิเตอร์จากกระบวนการไปยัง Activities ภายในแต่ละโหนด

เมื่อผู้ใช้ต้องการสร้าง microflow ผู้ใช้สามารถสร้างโฟลว์และข้อมูลที่จะใช้ในโฟลว์เป็นแอพพลิเคชันเดียว

สร้างแอพพลิเคชันบน AppSpace ในการสร้างแอพพลิเคชันบน AppSpace ก่อนอื่นให้เข้าสู่ระบบ AppSpace และคลิกที่ปุ่ม Create new app

เมื่อสร้างแอพพลิเคชันผู้ใช้สามารถสร้างเป็นเว็บแอพพลิเคชัน (Web) หรือแอพมือถือ (Mobile) เลือกแพลตฟอร์มที่เหมาะสมสําหรับแอพพลิเคชันของคุณและป้อนรายละเอียด

คลิกที่ Create แอพพลิเคชันใหม่ถูกสร้างขึ้นสําหรับคุณในขณะนี้ คลิกที่ไอคอนแอพพลิเคชันเพื่อเปิดแอพของคุณ ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้า components

คลิกที่ไอคอน Create Flows

ในกล่องโต้ตอบ Create Microflow ให้ป้อนรายละเอียดโฟลว์ ผู้ใช้สามารถคลิกที่ปุ่ม Create เพื่อสร้างไมโครโฟลว์ที่ว่างเปล่าและสามารถเลือกเริ่มออกแบบได้ในภายหลัง อีกวิธีหนึ่งผู้ใช้สามารถคลิกที่ปุ่ม Start Design เพื่อสร้างโฟลว์และเริ่มออกแบบทันที

หากผู้ใช้เลือกที่จะคลิกที่ Create ระบบจะสร้างไมโครโฟลว์และแสดงรายการส่วนประกอบให้กับผู้ใช้ ผู้ใช้สามารถคลิกที่ไอคอนแก้ไขเพื่อเริ่มทํางานกับไมโครโฟลว์ได้ในภายหลัง

หากผู้ใช้คลิกที่ปุ่ม Start Design ระบบจะสร้าง microflow และเปลี่ยนเส้นทางผู้ใช้ไปยัง Microflow Designer ตอนนี้ระบบจะแสดงหน้า Create Flow สําหรับการสร้าง Flow Diagram

หากผู้ใช้กําลังสร้าง microflow เป็นครั้งแรกระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้า BO ที่กําหนดไว้

ขั้นตอน Define the Business Object ผู้ใช้สามารถสร้างพารามิเตอร์อินพุตและเอาต์พุตของ process

ผู้ใช้สามารถเพิ่มรายละเอียดเพิ่มเติมให้กับ BO ได้โดยคลิกที่ไอคอน Add Parameter บน BO และเพิ่มพารามิเตอร์ภายใน BO

ตอนนี้ระบบจะแสดงหน้า Create Flow สําหรับการสร้าง Flow Diagram ผู้ใช้สามารถเริ่มออกแบบ flow diagram ได้ที่นี่

การแมปข้อมูลที่กล่าวถึงในส่วนของ เป็นการแมป data-level ระหว่างพารามิเตอร์ขาเข้าและขาออก แต่ส่วนนี้หมายถึงการแปลงข้อมูลขณะ mapping ดับเบิลคลิกที่เส้นสีน้ําเงินที่เชื่อมต่อพารามิเตอร์เพื่อเปิดแผงตัวแก้ไขสูตรเพื่อสร้างตรรกะการแปลงข้อมูล

บนพาเนล Formula Editor ผู้ใช้สามารถลาก process parameters และตัวดําเนินการทางคณิตศาสตร์ต่างๆ และฟังก์ชันสตริงเพื่อสร้างเงื่อนไขได้ ฟังก์ชันสตริงเหล่านี้จะพร้อมใช้งานในตัวแก้ไขสูตรบนหน้าจอการแมปเท่านั้น

เมื่อคุณออกแบบ Microflow เสร็จแล้วคุณสามารถปรับใช้กับสภาพแวดล้อมเป้าหมายเพื่อเริ่มใช้งานได้ มี 2 วิธีในการปรับใช้ Microflow กับสภาพแวดล้อมของคุณสําหรับการใช้งาน

โหมดฝังตัว (Embedded mode) โหมดเซิร์ฟเวอร์แบบสแตนด์อโลน (Standalone Server mode)

กระบวนการปรับใช้จะแตกต่างกันสําหรับสองโหมด ให้เราดูวิธีปรับใช้ Microflow ของคุณสําหรับทั้งสองประเภท

สําหรับโหมดเซิร์ฟเวอร์แบบสแตนด์อโลนจะไม่มีการปรับใช้แยกต่างหากเนื่องจาก Microflow เปิดใช้งานบนเซิร์ฟเวอร์แล้วและคุณสามารถเข้าถึงได้โดยตรงผ่าน REST APIs

ขั้นตอนที่ 1: คลิก"Export Embedded Microflow" ใต้ "Choose Export" ที่ด้านบนขวาของหน้าจอ

ขั้นตอนที่ 2: ป้อนชื่อไฟล์ที่จะบันทึกใน "File name" และคลิก "Export"

Microflow ของคุณจะถูกดาวน์โหลดเป็นไฟล์ Jar และคุณสามารถคัดลอก Microflow ของคุณไปยังโปรเจค Java อื่นและใช้ในโหมดฝังตัว

เมื่อ microflow เสร็จสมบูรณ์และตรวจสอบเรียบร้อยแล้วผู้ใช้อาจต้องการทดสอบเพื่อดูว่าโฟลว์ทํางานตามที่คาดไว้หรือไม่ สําหรับ ONEWEB นี้มี Simulator Utility เพื่อจําลองโฟลว์

เมื่อต้องการจําลองโฟลว์ ให้ไปที่แท็บ Simulation Test ยูทิลิตี้จัดเตรียม flow diagram สําหรับการตรวจสอบและกล่องอินพุตที่มีพารามิเตอร์ BO อินพุตในรูปแบบ JSON เพื่อเริ่มโฟลว์

1. อัปเดตพารามิเตอร์ Input BO ด้วยค่าจริงที่คุณต้องส่งเพื่อทดสอบโฟลว์

2. คลิกที่ปุ่ม Start

ระบบจะทริกเกอร์โฟลว์ด้วยค่าตัวอย่างและแสดงค่าที่ส่งกลับจาก microflow ในกล่องเอาต์พุต

หากผู้ใช้อัปเดตโฟลว์หรือ business object บนโฟลว์ ผู้ใช้ต้องคลิกที่ปุ่ม Refresh Cache เพื่อโหลดไมโครโฟลว์ใหม่สําหรับการ simulation ผู้ใช้สามารถคลิกที่ปุ่ม Retest เพื่อทดสอบโฟลว์ด้วยค่าใหม่

ตอนนี้ให้เราสร้างตรรกะไมโครโฟลว์จริงใน Flow Diagram

1. ลากโหนดเริ่มต้นภายใต้แท็บ EVENT และวางใน diagram panel

1. ลาก Database node ภายใต้แท็บ ACTIVITY และวางในช่องว่างถัดจาก start node

1. ดับเบิลคลิกที่ Database node และแผงการกําหนดค่าจะปรากฏที่ด้านล่างของหน้าจอ

• ในแท็บ General ป้อน ''RetrieveUserBenefits"

• ในแท็บ Business Object คลิกที่ปุ่ม "Add Row" สําหรับ

• อินพุตตรวจสอบ BenefitBO และสําหรับเอาต์พุตตรวจสอบ BenefitBOout_Avalant

• คลิก "Open Mapping Parameter"

• คลิกที่บรรทัดระหว่าง Input และ Mapping

• เชื่อมโยงพารามิเตอร์สําหรับการป้อนข้อมูล

• คลิกที่ line ระหว่างการทํา Mapping และเอาต์พุต

• เชื่อมโยงพารามิเตอร์สําหรับเอาต์พุต

• ตอนนี้คลิกที่ Done เพื่อปิดหน้าจอการทํา mapping

• เปิดแท็บ Database Parameter

• เลือกประเภทการเชื่อมต่อเป็น JNDI

• ป้อน "jdbc/application" ใน JNDI Name

• เลือก "Select" สําหรับประเภทคําสั่ง

• ป้อน "SELECT id, travel_date, project_name, description, amount, status, benefit_type, username FROM oneweb_benefit WHERE benefit_type = ? และชื่อผู้ใช้ = ?" ใน Command

• คลิก "Open Mapping Parameter"

• คลิกที่ line ระหว่าง Input และ Mapping

• คลิกที่ DatabaseDummyObject และเลือกไอคอน Add Parameter

• เพิ่มพารามิเตอร์ "benefit_type" & "username" แล้วคลิก Submit

• เชื่อมโยง activity parameters สําหรับการป้อนข้อมูล

• คลิกที่ line ระหว่างการทํา Mapping และ Output

• คลิกที่ DatabaseDummyObject และเลือกไอคอน Add Parameter

• เพิ่มพารามิเตอร์สําหรับผลลัพธ์แล้วคลิก Submit

• เชื่อมโยง activity parameters สําหรับเอาต์พุต

• ตอนนี้คลิกที่ Done เพื่อปิดหน้าจอ mapping

• คลิก Done บนแผงการกําหนดค่า database node เพื่อปิดแผง

1. ลากโหนด END ภายใต้แท็บ EVENT และพื้นที่ drop-in ถัดจาก database node

1. ลากเส้นและเชื่อมต่อโหนด

2. คลิก "Save"

ตอนนี้คุณมีบริการ Microflow แรกของคุณพร้อมสําหรับการดําเนินการแล้ว

ผู้ใช้สามารถใช้ตัวเลือกการตรวจสอบเพื่อดูว่าการกําหนดค่าทั้งหมดเสร็จสมบูรณ์หรือไม่

สมมติว่าคุณต้องอัปเดตข้อมูลบางอย่างไปยังฐานข้อมูลจากหน้าเว็บหรือแสดงข้อมูลบางส่วนจากระบบอื่นคุณต้องรวม Page เข้ากับ Microflow สมมติว่าเราจําเป็นต้องแสดงข้อมูลเช่นอัตราแลกเปลี่ยนจากเว็บไซต์ Fixer.io เพื่อแสดงแบบไดนามิกบนเพจ สําหรับสิ่งนี้เราสามารถใช้โหนดบริการเว็บใน Microflow (REST หรือ SOAP) เพื่อรับข้อมูลจากเว็บไซต์และรวมเข้ากับ Page Designer

ในโฟลว์กระบวนการ ผู้ใช้อาจต้องอัปโหลดไฟล์ jar สําหรับโหนด Java หรือไฟล์ WSDL สําหรับโหนด Webservice แทนที่จะอัปโหลดไฟล์ที่โหนดผู้ใช้สามารถอัปโหลดไปยังแอพพลิเคชันโดยใช้สิ่งอํานวยความสะดวกการอัปโหลดไฟล์จากนั้นเลือกไฟล์ที่ต้องการที่โหนด สิ่งนี้ทําให้ง่ายต่อการจัดการไฟล์หรืออัปเดตโดยไม่ส่งผลกระทบต่อโหนด

หากต้องการอัปโหลดไฟล์ไปยังแอพพลิเคชัน ให้ไปที่เมนูอัปโหลดไฟล์และอัปโหลดไฟล์ที่ต้องการ

เมื่ออัปโหลดไฟล์แล้วผู้ใช้สามารถเลือกไฟล์เหล่านี้จาก Java node task หรือ Web services node task และใช้ในโฟลว์กระบวนการ

เพจสามารถรวมเข้ากับระบบภายในและภายนอกอื่น ๆ เช่น databases หรือ web services โดยใช้ Microflow เพื่อสร้างหน้าเว็บแบบไดนามิกบน ONEWEB ส่วนนี้จะแสดงวิธีเรียกใช้บริการ Microflow จากเพจ และแสดงข้อมูลที่ส่งคืนโดยบริการบนเพจ

Page ที่จะเรียก Microflow ไปที่ Page Designer และเปิดเพจที่คุณต้องการทําให้เป็นแบบไดนามิก

1. คลิกที่ช่องป้อนข้อมูลเพื่อส่งผ่านไปยัง Microflow ขณะเรียก

2. คลิกที่แท็บ State และคลิกที่ปุ่ม Connect to State

1. เลือก State parameter เพื่อเชื่อมต่อ (การทํา Microflow mapping อนุญาตให้แมปเฉพาะ State parameter กับ microflow input parameter ดังนั้นการส่งผ่านพารามิเตอร์ไปยังผู้ใช้ microflow จําเป็นต้องแมปฟิลด์ input ไปยัง State)

1. คลิกที่องค์ประกอบหรือ container ที่เริ่มต้นการเรียกไปยัง microflow ของคุณ (1) ในตัวอย่างนี้เราเรียกไมโครโฟลว์ด้วยการคลิกปุ่ม

• คลิกที่ Add icon ด้านล่าง Action

• เลือก "click" ใน Event

• เลือกแท็บ "Microflow"

• คลิก Refresh เพื่อโหลด services ที่มีอยู่อีกครั้ง

• เลือก "Your Project Name" ใน Microflow project name

• เลือก "Your process Name" ใน Microflow process name

2. แมป Page Designer parameter ไปยัง Microflow Parameter อย่าลืมบันทึก mapping โดยคลิกที่ไอคอน Save บนหน้าจอ mapping

1. ผู้ใช้สามารถใช้ hook และเพิ่ม functions JavaScript ก่อนและหลังเรียก microflow

2. ผู้ใช้สามารถเปลี่ยนเส้นทางไปยังหน้าอื่นเมื่อเรียกเสร็จ

อัปเดตข้อมูลบน Page จาก Microflow

1. เลือก object บน page ที่แสดงข้อมูลที่มาจาก service

2. คลิกแท็บ Microflow และเลือกค่าจาก Microflow คลิกปุ่ม 'Connect to Data'

1. เลือก field name และคลิก Connect

1. คลิก Done บนกล่องโต้ตอบ Connect to Data

ตอนนี้ Page ถูกรวมเข้ากับ Microflow เรียบร้อยแล้วและสามารถแสดงข้อมูลที่ดึงมาบนหน้าจอ

ในแอพพลิเคชันระดับองค์กรส่วนใหญ่เพื่อสร้าง UI แบบไดนามิกจําเป็นต้องรวมเข้ากับเซิร์ฟเวอร์ส่วนหลังเพื่อให้ข้อมูลที่อัปเดตตามการโต้ตอบของผู้ใช้ ตัวอย่างเช่นเมื่อผู้ใช้ป้อนรหัสไปรษณีย์ระบบสามารถส่งคืนชื่อของจังหวัดอําเภอและตําบลจากฐานข้อมูล ใน ONEWEB Microflow มีอินเทอร์เฟซสําหรับการรวม

ในส่วนนี้เราจะดูวิธีการรวม Smart Form เข้ากับฐานข้อมูลเพื่อใช้ไดนามิกบน UI โดยใช้ Microflow

การรวม Smart Form โดยใช้ Microflow

1. ไปที่ App Designer

2. เปิด Entity ของคุณ

3. เลือกองค์ประกอบที่ควรทริกเกอร์การกระทําและคลิกที่ไอคอน integrate (ไอคอนนี้มีอยู่ในทุกช่องและปุ่มทั้งหมด)

1. ON หน้าต่าง Microflow Configuration เลือก "change()" ใน Event และคลิกปุ่ม on Microflow เลือก "Your Project Name" ใน Project เลือก "Your Flow Name" ใน Microflow เลือก "Y" ใน Async ('Y' สำหรับเรียก asynchronous และ 'N' สำหรับ synchronous)

1. แมป Entity Parameters ไปยัง Flow Parameters

1. คลิกที่แท็บ Response และแมป output parameters จาก Microflow ไปยัง Entity parameters

1. คลิก OK และบันทึก Entity คุณได้รวม Smart Form ไปยัง Microflow เรียบร้อยแล้ว

ตอนนี้เมื่อคุณเปิด form ใน Runtime และคลิกที่ปุ่ม มันจะเรียก microflow

Microflow Designer (MFD) อนุญาตให้ส่งออกไมโครโฟลว์จากแอพพลิเคชันหนึ่งและนําเข้าไปยังแอพพลิเคชันอื่นเพื่อทําซ้ําหรือนําไมโครโฟลว์กลับมาใช้ใหม่ ไมโครโฟลว์ยังสามารถนําเข้าไปยังสภาพแวดล้อมที่แตกต่างอย่างสิ้นเชิงได้เช่นกัน

ส่งออก (Export) ในการส่งออก microflow ใดๆ มีตัวเลือก "Export" ภายใต้หน้าจอ Project Overview ดังที่แสดงในรูปด้านล่าง

ผู้ใช้จะมี 3 ตัวเลือก Config, Embedded, MicroService

• Config - ส่งออกการกําหนดค่า microflow เพื่อให้สามารถนําเข้าไปยังแอพพลิเคชันอื่นได้

• Embedded - ไฟล์ microflow jar ถูกใช้โดยรันไทม์ Microflow เพื่อคัดลอกไปยัง sit หรือ production environment

• Microservice - เพื่อส่งออกเป็นบริการที่จะโฮสต์ในสภาพแวดล้อมนั้น

ผู้ใช้ยังมีตัวเลือกในการเลือกไมโครโฟลว์ที่ต้องส่งออก ผู้ใช้สามารถเลือกไมโครโฟลว์อย่างน้อยหนึ่งรายการที่จะส่งออก

ถ้าผู้ใช้เลือกตัวเลือก Config การดําเนินการส่งออกมี 2 ชนิดที่พร้อมใช้งานภายใต้ Export Config

• ส่งออกเฉพาะการกําหนดค่า

• ส่งออกการกําหนดค่าพร้อมกับ artifacts ที่แนบมาเช่นไฟล์ jar (สําหรับโหนด Java) หรือไฟล์ wsdl (โหนด Web Service)

ผู้ใช้มีตัวเลือกในการเลือกสิ่งที่จะส่งออก ผู้ใช้สามารถเลือก Only Config option เพื่อส่งออกเฉพาะการกําหนดค่า microflow หรือ With File ตัวเลือกเพื่อส่งออกไฟล์ jar ที่แนบมาและ artifacts อื่น ๆ

ไฟล์ที่ส่งออกจะแสดงเพื่อดาวน์โหลดและบันทึกลงในเครื่องของผู้ใช้ ไฟล์นี้มี flow และ business objects ทั้งหมดในรูปแบบ JSON พร้อมกับ artifacts ขึ้นอยู่กับตัวเลือกที่เลือก

นําเข้า (Import) ในการนําเข้า microflow จะมีปุ่ม Import บนหน้าจอข้อมูลโครงการดังที่แสดงในรูปด้านล่าง

ด้วยการคลิกปุ่มนี้กล่องโต้ตอบกระบวนการนําเข้าจะปรากฏขึ้น ผู้ใช้ต้องเลือกไฟล์การกําหนดค่า microflow โดยคลิกที่ปุ่ม "Choose File" จากนั้นระบบจะแสดงรายการ microflows ที่มีอยู่ทั้งหมดในไฟล์นั้น ผู้ใช้สามารถเลือกไมโครโฟลว์ที่จะนําเข้าไปยังแอพได้ โดยค่าเริ่มต้น microflows ทั้งหมดจะถูกเลือก

ผู้ใช้ยังมีตัวเลือกในการนําเข้าเป็น New หรือ เขียนทับ (Overwrite) โฟลว์ที่มีอยู่ หากผู้ใช้เลือกตัวเลือกเขียนทับเขาจะต้องเลือก microflow ที่จะเขียนทับเช่นกัน

คลิกที่ปุ่ม "Import" และ microflow จะถูกนําเข้าไปยังแอพพลิเคชัน เมื่อนําเข้า microflow อย่างสมบูรณ์ผู้ใช้สามารถดู microflows ทั้งหมดที่แสดงอยู่ภายใต้ส่วนชื่อโฟลว์และในเมนู

ONEWEB มีตัวเลือกในการสนับสนุนหลายภาษาในนักออกแบบ ปัจจุบันรองรับภาษาอังกฤษไทยและญี่ปุ่น หากต้องการสลับภาษาบนตัวออกแบบ ให้ไปที่ไอคอนสวิตช์ภาษาที่แผงด้านล่างซ้ายบน Microflow Designer

ด้วยเวอร์ชัน 4.0.19.10 ONEWEB มีคุณสมบัติที่มีประสิทธิภาพมากในการสร้าง activity nodes ที่กําหนดเองและใช้โหนดที่กําหนดเองเหล่านี้ในไมโครโฟลว์ของคุณหรือแชร์กับผู้ใช้รายอื่น โหนดที่กําหนดเองเหล่านี้เรียกว่า ส่วนขยาย (extension) ส่วนขยายเหล่านี้อาจเป็นโหนดง่ายๆในการสืบค้นฐานข้อมูลภายในของคุณหรือโหนดที่เป็นกรรมสิทธิ์ที่ซับซ้อนเพื่อเชื่อมต่อกับเซิร์ฟเวอร์บล็อกเชนเช่นกัน ผู้ใช้สามารถสร้างส่วนขยายได้หนึ่งครั้งจากนั้นใช้ในทุกแอพพลิเคชันโดยการติดตั้งส่วนขยายลงในแอพพลิเคชัน ผู้ใช้ยังสามารถแบ่งปันส่วนขยายของพวกเขากับผู้ใช้ ONEWEB คนอื่นๆ เมื่อ ONEWEB MarketPlace หมดลงผู้ใช้ยังสามารถขายส่วนขยายของพวกเขาใน MarketPlace

เมื่อติดตั้งส่วนขยายที่กําหนดเองบนแอพพลิเคชันใน Microflow ผู้ใช้สามารถใช้ extension node ได้เช่นเดียวกับ activity node อื่นๆ ใน Microflow โดยเพียงแค่ลากและวางโหนดลงใน canvas และกําหนดค่าคุณสมบัติ

กระบวนการทางธุรกิจ (business processes) อาจรวมถึง database nodes หรือ web service nodes เพื่อโต้ตอบกับฐานข้อมูลหรือบริการอื่นๆ แต่การกําหนดค่าฐานข้อมูลและ URL บริการเว็บเหล่านี้อาจแตกต่างกันสําหรับสภาพแวดล้อมที่แตกต่างกัน ตัวอย่างเช่น JDBC URL สําหรับฐานข้อมูลการพัฒนาจะแตกต่างจากค่าสําหรับสภาพแวดล้อมการทดสอบและจะแตกต่างกันอีกครั้งสําหรับฐานข้อมูลการผลิต

ดังนั้นจากเวอร์ชัน 4.0.0.19 ONEWEB มีตัวเลือกในการกําหนดค่าพารามิเตอร์สภาพแวดล้อมเป็นตัวแปรสําหรับสภาพแวดล้อมที่แตกต่างกัน จากนั้นผู้ใช้สามารถใช้ตัวแปรเหล่านี้ในขณะที่กําหนดค่าโฟลว์ สิ่งนี้ทําให้ง่ายต่อการปรับใช้กระบวนการกับสภาพแวดล้อมที่แตกต่างกันโดยไม่ต้องแก้ไขไดอะแกรมกระบวนการทุกครั้ง

วิธีสร้างตัวแปร Environment ใน Process หากต้องการตั้งค่า environment parameters สําหรับแอพพลิเคชัน ให้ไปที่หน้าจอการตั้งค่าสภาพแวดล้อมภายในแอพพลิเคชัน คลิกที่ไอคอน Add Environment

คุณสามารถสร้างสภาแวดล้อมต่างๆสำหรับแอพของคุณได้ที่นี่

ผู้ใช้ยังสามารถสร้างหลายโปรไฟล์สําหรับแต่ละสภาพแวดล้อมบนแท็บ Profile

สุดท้ายผู้ใช้สามารถสร้างตัวแปรสภาพแวดล้อมสําหรับแต่ละพารามิเตอร์

จากนั้นผู้ใช้สามารถสร้างาสําหรับสภาพแวดล้อมอื่น ๆ ได้เช่นกัน

วิธีใช้ตัวแปร Environment เหล่านี้ใน Process คุณสามารถใช้ตัวแปรเหล่านี้ในการกําหนดค่าโหนดของคุณ ตัวอย่างเช่น ในการกําหนดค่าโหนดฐานข้อมูล สําหรับการกําหนดค่าที่อนุญาตตัวแปรสภาพแวดล้อมคุณสามารถดูสภาพแวดล้อมการใช้ check box สามารถเลือกใช้ค่าจาก การกําหนดค่าสภาพแวดล้อม

จาก ONEWEB เวอร์ชัน 4.0.19.12 ผู้ใช้สามารถใช้ไวยากรณ์เส้นทาง JSON เพื่อดึงข้อมูลจากบริการ REST ที่มีโครงสร้าง JSON ที่ซับซ้อน สําหรับข้อมูลเพิ่มเติมเกี่ยวกับไวยากรณ์เส้นทาง JSON โปรดตรวจสอบที่เว็บไซต์ https://support.smartbear.com/alertsite/docs/monitors/api/endpoint/jsonpath.html

ผู้ใช้สามารถใช้ไวยากรณ์นี้บนหน้าจอการแมปเอาต์พุตสําหรับบริการ REST ภายใต้ RestDummyObject

ผู้ใช้สามารถใช้ตัวประเมินเส้นทาง JSON ออนไลน์เพื่อค้นหานิพจน์ JSON ที่จะใช้ในการดึงข้อมูลเฉพาะจากโครงสร้าง JSON มีผู้ประเมินหลายคนทางออนไลน์ สําหรับเช่น https://jsonpath.com/

ส่วนขยาย Excel Writer เป็นส่วนขยายอื่นที่ให้บริการโดย ONEWEB พร้อมกับแพลตฟอร์ม สามารถใช้เขียนข้อมูลลงในไฟล์ Excel เช่นเดียวกับส่วนขยาย Excel Reader ในการเขียนข้อมูลไปยังไฟล์ Excel

ผู้ใช้ต้องติดตั้งส่วนขยายลงในแอพพลิเคชันของตนก่อน โปรดทําตามขั้นตอนตามที่อธิบายไว้ใน ส่วนขยายที่กำหนดเอง เพื่อติดตั้งและเปิดใช้งาน Excel Writer ในแอพพลิเคชันของคุณ เมื่อติดตั้งและเปิดใช้งานส่วนขยายแล้วคุณสามารถใช้มันได้เช่นเดียวกับโหนดอื่น ๆ ใน diagram palette

ผู้ใช้สามารถกําหนดค่าคุณสมบัติสําหรับการเขียนไฟล์ดังที่แสดงด้านล่าง ปลายทางไฟล์อาจเป็นระบบไฟล์หรือเครือข่ายทําให้มีตัวเลือก FTP เช่น FTP, SFTP & FTPS ผู้ใช้สามารถป้อนรายละเอียดไดเรกทอรีและไฟล์ได้โดยตรงหรือแม้แต่รับข้อมูลจากวัตถุธุรกิจดังที่แสดงใน Excel Reader นอกจากนี้ยังมีตัวเลือกในการแปลงข้อมูลเป็นรูปแบบที่กําหนดไว้ล่วงหน้าขณะเขียน

ข้อมูลสามารถเขียนไปยังคอลัมน์เฉพาะบน excel ดังที่แสดงภายใต้พารามิเตอร์ฟิลด์เฉพาะหรือสามารถเขียนเป็นทั้งแถวโดยการกําหนดค่าภายใต้พารามิเตอร์ระเบียน ผู้ใช้สามารถเขียนข้อมูลหลายแผ่นโดยใช้ Excel Writer หนึ่งชุด

ONEWEB จากเวอร์ชัน 4.0.19.11 รองรับส่วนขยายที่กําหนดเองสําหรับ Process และ Microflow มีส่วนขยายที่กําหนดเองบางอย่างที่จัดทําโดย ONEWEB พร้อมกับแพลตฟอร์ม หนึ่งในส่วนขยายที่มีอยู่ที่มาพร้อมกับ ONEWEB คือส่วนขยาย Excel Reader สามารถใช้อ่านข้อมูลจากไฟล์ Excel ในการอ่านข้อมูลโดยใช้ Excel Reader ผู้ใช้ต้องติดตั้งส่วนขยายลงในแอพพลิเคชันของตนก่อน โปรดทําตามขั้นตอนตามที่อธิบายไว้ใน ส่วนขยายที่กำหนดเอง เพื่อติดตั้งและเปิดใช้งาน Excel Reader ในแอพพลิเคชันของคุณ เมื่อติดตั้งและเปิดใช้งานส่วนขยายแล้วคุณสามารถใช้มันได้เช่นเดียวกับโหนดอื่นๆ ใน diagram palette

ผู้ใช้สามารถกําหนดค่าคุณสมบัติสําหรับการอ่านไฟล์ดังที่แสดงด้านล่าง แหล่งที่มาของไฟล์สามารถเป็นระบบไฟล์หรือเครือข่ายทําให้มีตัวเลือก FTP เช่น FTP, SFTP & FTPS ผู้ใช้สามารถป้อนรายละเอียดแหล่งที่มาและไฟล์ได้โดยตรงหรือแม้แต่รับข้อมูลจาก Business Object ดังที่แสดงในตัวอย่างด้านล่าง

ผู้ใช้สามารถอ่านข้อมูลจากแผ่นงานหลายแผ่นโดยการแมปอินพุตข้อมูลที่ส่งผ่านไปยังผู้อ่าน

ข้อมูลสามารถอ่านได้จากคอลัมน์เฉพาะบน excel ดังที่แสดงภายใต้พารามิเตอร์ฟิลด์เฉพาะหรือสามารถอ่านทั้งแถวตามที่กําหนดค่าไว้ภายใต้พารามิเตอร์ระเบียนภายใต้แต่ละแผ่นงาน

ใช้งาน Push Notification เพื่อส่งข้อความไปยังแอพพลิเคชันมือถือ

วัตถุประสงค์

Push Notification ใช้เพื่อเรียก hub Push Notification เพื่อส่งข้อความไปยังแอพพลิเคชันมือถือโดยใช้แพลตฟอร์ม Android หรือ iOS

คุณสมบัติการกําหนดค่า Push Notification Node

แผงการกําหนดค่า Push Notification Node มี 3 แท็บเพื่อกําหนดคุณสมบัติ

General

แท็บ General ประกอบด้วยข้อมูลทั่วไป เช่น title name, task id, description เป็นต้น

BusinessObject

ใช้เพื่อกําหนดค่าและแมป Business Objec สําหรับอินพุตและเอาต์พุตสําหรับโหนด

Push Notification

คุณสามารถใช้ทั้งสองแพลตฟอร์มใน Push Notification Node เดียว

ค่าสําหรับ Settings มีดังนี้

แพลตฟอร์ม Android เมื่อเลือก Android Platform เป็น Platform Type ผู้ใช้จะต้องป้อนข้อมูลเพื่อเรียก push notification สําหรับ Android ใน Android Platform

แพลตฟอร์ม iOS เมื่อเลือก iOS Platform เป็น Platform Type ผู้ใช้จะต้องป้อนข้อมูลเพื่อเรียก push notification สําหรับ iOS ใน iOS Platform

ปุ่ม upload ใช้เพื่ออัปโหลดไฟล์ใบรับรองและคีย์ส่วนตัวสําหรับสภาพแวดล้อมการผลิตหรือการพัฒนา

ทั้งแท็บ Android และ iOS มีปุ่ม "Open Mapping Parameter" การคลิกที่ปุ่ม "Open Mapping parameter" จะเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าจอ Mapping Parameter ซึ่งผู้ใช้สามารถคลิกที่ Mapping Parameter Input line หรือ Mapping Parameter Output line เพื่อแมปพารามิเตอร์สําหรับ Push Notification task นี้

ส่วนขยาย JavaScript Node เป็นส่วนขยายอื่นที่ให้บริการโดย ONEWEB พร้อมกับแพลตฟอร์ม สามารถใช้เพื่อรันโค้ด JavaScript บนข้อมูลภายในออบเจ็กต์ธุรกิจ

เช่นเดียวกับส่วนขยาย Excel Utility ในการใช้ส่วนขยาย JavaScript Node ผู้ใช้ต้องติดตั้งส่วนขยายลงในแอพพลิเคชันของตนก่อน โปรดทําตามขั้นตอนตามที่อธิบายไว้ใน เพื่อติดตั้งและเปิดใช้งาน JavaScript Node ไปยังแอพพลิเคชันของคุณ เมื่อติดตั้งและเปิดใช้งานส่วนขยายแล้วคุณสามารถใช้มันได้เช่นเดียวกับโหนดอื่น ๆ ใน diagram palette

ผู้ใช้สามารถกําหนดค่าโหนดเพื่อรันการเข้าสู่ระบบ Javascript ในคุณสมบัติส่วนขยาย ผู้ใช้ควรทําตามไวยากรณ์ฟังก์ชันเดียวกันเพื่อเพิ่มตรรกะภายในหน้าต่างตัวแก้ไข สําหรับ function excute(input) {}

การแมปข้อมูลสําหรับ JavaScript Node มีดังนี้ ต้องเพิ่ม BO ทั้งหมดที่จะส่งผ่านไปยังฟังก์ชัน JavaScript ภายใต้ตัวแปรอินพุตดังที่แสดงด้านล่าง ผู้ใช้สามารถค้นหา BO โดยใช้ตัวเลือกการค้นหา

ข้อมูลเอาต์พุตจาก JavaScript Node สามารถแมปได้ดังที่แสดงด้านล่าง ข้อมูลเอาต์พุตจะอยู่ภายใต้ variable object เอาต์พุตและชื่อของตัวแปรจะได้รับ answered

ส่วนขยาย Validation Node การตรวจสอบความถูกต้องเป็นส่วนขยายอื่นที่ ONEWEB ให้บริการพร้อมกับแพลตฟอร์ม สามารถใช้เพื่อตรวจสอบความถูกต้องของข้อมูลภายใน Business objects

เช่นเดียวกับส่วนขยาย Excel Utility ในการตรวจสอบ BO ผู้ใช้จําเป็นต้องติดตั้งส่วนขยายลงในแอพพลิเคชันของตนก่อน โปรดทําตามขั้นตอนตามที่อธิบายไว้ใน เพื่อติดตั้งและเปิดใช้งาน Validation Node ไปยังแอพพลิเคชันของคุณ เมื่อติดตั้งและเปิดใช้งานส่วนขยายแล้วคุณสามารถใช้มันได้เช่นเดียวกับโหนดอื่นๆ ในdiagram palette

ผู้ใช้สามารถกําหนดค่าการตรวจสอบความถูกต้องที่จะบังคับใช้ในคุณสมบัติส่วนขยาย ตัวดําเนินการเชิงตรรกะมีสองประเภทที่เป็นไปได้ OR & AND ใช้เกตเวย์ตามเงื่อนไขเอาต์พุตที่ต้องการ มันจะแมปข้อความแสดงข้อผิดพลาดทั้งหมดเพื่อส่งออก

การแมปข้อมูลสําหรับโหนดการตรวจสอบมีดังนี้ ต้องเพิ่ม BO ทั้งหมดที่จะตรวจสอบภายใต้ BO Input ดังที่แสดงด้านล่าง ผู้ใช้สามารถค้นหา BO โดยใช้ตัวเลือกการค้นหา

ข้อความเอาต์พุตจาก Validation node ต้องสามารถแมปได้ดังที่แสดงด้านล่าง