ONEWEB สามารถรวมเข้ากับระบบภายนอกอื่น ๆ ได้อย่างง่ายดายโดยใช้ visual UI นักพัฒนาสามารถรวมบริการ SOAP และ REST เข้ากับฐานข้อมูลภายนอกหรือไฟล์โดยไม่ต้องเขียนโค้ดใดๆ ใช้ฟังก์ชันการลากและวางอย่างง่าย สําหรับการกําหนดค่า UI screens ดังนั้นจากมุมมองของผู้ใช้แทบไม่มีความแตกต่างระหว่างการผสานรวมกับ REST API หรือ SOAP API แพลตฟอร์ม

ONEWEB มีเครื่องมือสองอย่างสําหรับการรวม Microflow Designer และ Process Designer คุณต้องตัดสินใจว่าส่วนประกอบใดเหมาะสมกับความต้องการใช้งานของคุณมากที่สุด เครื่องมือทั้งสองมีความคล้ายคลึงกันในการกําหนดค่า แต่แตกต่างกันในความตั้งใจในการใช้งาน

ตัวออกแบบกระบวนการ (Process Designer) ใช้ในการสร้างกระบวนการทางธุรกิจซึ่งเป็นกระบวนการที่ทํางานมานานเพื่อเป็นแนวทางเวิร์กโฟลว์ของระบบ

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

การรวมเข้ากับระบบภายนอกและฐานข้อมูลอาจใช้เวลานานและการใช้งานมีแนวโน้มที่จะเกิดข้อผิดพลาด มีเครื่องมือบูรณาการหลายอย่างในตลาด แต่ข้อดีของการใช้ ONEWEB คือ

Visual Configuration - ONEWEB มีเครื่องมือ Visual UI เพื่อกําหนดค่า ดังนั้นทุกคนสามารถจัดการการกําหนดค่าการรวมโดยไม่ต้องเขียนโค้ดใด ๆ ลดเวลาและความพยายามและกําจัดข้อผิดพลาดได้อย่างมาก Shared Integration units - ตัวอย่างเช่นหากระบบของคุณต้องการเชื่อมต่อกับบริการสําหรับการแปลงสกุลเงินเมื่อคุณสร้างหน่วยรวมไปยังบริการนี้คุณสามารถเรียกได้จากส่วนใดก็ได้ของแอพพลิเคชันของคุณ Quick Deployment - เมื่อคุณทําการเปลี่ยนแปลงกระบวนการและคลิกที่ deploy ระบบจะปรับใช้กับสภาพแวดล้อมรันไทม์ของคุณและคุณสามารถเริ่มใช้งานได้

Built-in Monitor & Logging - ONEWEB ให้ความสามารถในการตรวจสอบและการบันทึกในตัว

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

การรวมกับ SOAP web services และ REST APIs

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

การรวมกับฐานข้อมูลที่มีอยู่

ONEWEB รองรับการผสานรวมกับ SQL Server, Oracle, MySQL, PostgreSQL, DB2 เป็นต้น Microflow Designer ให้ Database Task เพื่อรวมเข้ากับฐานข้อมูล พวกเขาให้การรวมสองประเภท - ใช้ JNDI หรือใช้ JDBC

การรวมกับไฟล์ Excel, CSV, XML หรือ Fixed width

Microflow รองรับการอ่าน Microsoft Excel, ไฟล์ที่คั่น, ไฟล์ XML หรือไฟล์ความกว้างคงที่ File Read Task สามารถใช้สําหรับการสร้างแบบจําลองข้อมูลและเติมข้อมูลจากไฟล์ ONEWEB สามารถอ่านไฟล์จาก Files System แต่ยังรองรับการอ่านผ่าน FTP, SFTP และ FTPS

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

นอกจากนี้ App Designer ยังมีวิธีการผสานรวมกับ with business processes ผ่านปุ่ม Process ผู้ใช้จะต้องลากปุ่ม Process และเลือกกระบวนการที่จะเรียกใช้และ ONEWEB จะดูแลการรวมที่แท้จริง ผู้ใช้ยังสามารถแมปพารามิเตอร์ที่จะส่งผ่านในขณะที่เรียกใช้กระบวนการโดยเพียงแค่แมปฟิลด์ใน App Designer กับพารามิเตอร์ของกระบวนการ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Smart Form Integration with Process โปรดดูที่ การรวม Smart Form เข้ากับ Process

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

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

ONEWEB มีเครื่องมือ Process Designer เพื่อพัฒนาและดําเนินการ business processes ในแอพพลิเคชัน เครื่องมือตัวออกแบบกระบวนการยังมีโหนดบางตัวเพื่อรวมเข้ากับระบบอื่นในระหว่าง business process flow ฟังก์ชันการทํางานของ node tasks คล้ายกับ node tasks ในเครื่องมือ Microflow Designer

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

คําสั่งมี 4 ประเภท เลือก (Select): คิวรีเพื่อดึงค่าที่ต้องการจากฐานข้อมูล คุณสามารถกําหนดฟิลด์และตารางผ่านคําสั่ง SQL แทรก (Insert): แทรกค่าที่ต้องการลงในฐานข้อมูล อัปเดต (Update): อัปเดตค่าในฐานข้อมูลผ่านคําสั่ง SQL ลบ (Delete): ลบค่าออกจากฐานข้อมูลผ่านคําสั่ง SQL

โหนดกระบวนการย่อย (Sub Process Node) ในกระบวนการขนาดใหญ่กระบวนการหนึ่งสามารถมีรูทีนย่อยหรือกระบวนการอื่นอยู่ภายใน เราสามารถยุบโฟลว์เป็นโฟลว์เดียวโดยใช้โหนดกระบวนการย่อย

โหนดบริการเว็บ (Web Service Node) บริการเว็บอนุญาตให้เข้าถึงข้อมูลจากแอพพลิเคชันต่างๆ Process Designer ให้บริการ Web Service Task สําหรับการใช้บริการ SOAP และ REST นักพัฒนาเพียงแค่ต้องกําหนดค่าข้อกําหนดของบริการและ ONEWEB จะสร้างวิธีการและโครงสร้างข้อมูลเพื่อเรียกบริการ

SOAP

REST

โหนดอ่านไฟล์ (File Read Node) Process Designer สนับสนุนการอ่าน Microsoft Excel, ไฟล์ที่ถูกคั่น, ไฟล์ XML หรือไฟล์ความกว้างคงที่ File Read Task สามารถใช้สําหรับการสร้างแบบจําลองข้อมูลและเติมข้อมูลจากไฟล์ Process Designer สามารถอ่านไฟล์จาก Files System แต่ยังรองรับการอ่านผ่าน FTP, SFTP และ FTPS นอกเหนือจากการอ่านไฟล์ในระหว่างกระบวนการแล้ว Process Designer ยังสามารถทริกเกอร์กระบวนการเพื่อเริ่มต้นตามความพร้อมใช้งานของไฟล์โดยใช้ File Input Node

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

Process Designer และ Microflow Designer เป็นเครื่องมือใน ONEWEB เพื่อรวมเข้ากับโมดูลหรือระบบอื่น ๆ Process Designer ใช้ในการออกแบบและสร้าง business process และ Microflow Designer เพื่อออกแบบ Microflow การไหลของกระบวนการและ Microflow ค่อนข้างคล้ายกัน ความแตกต่างอยู่ที่การใช้งานที่ตั้งใจไว้

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

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

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

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

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

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

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 ของคุณ

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

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

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

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

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

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

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

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

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

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

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

การผสานรวมเป็นส่วนสําคัญในการสร้างแอพพลิเคชันระดับองค์กรขนาดใหญ่ ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดที่กําหนดในขณะที่รวมแอพพลิเคชันของคุณโดยใช้ ONEWEB

• เลือกเครื่องมือที่ดีที่สุดตามความต้องการของแอพพลิเคชันของคุณ ใช้ Process Designer สําหรับการรวมเข้ากับเวิร์กโฟลว์เท่านั้น

• ใช้ Microflow เพื่อรวมเข้ากับส่วนประกอบหรือบริการอื่น ๆ

• ออกแบบไมโครโฟลว์แต่ละแบบโดยใช้โมเดลความรับผิดชอบเดียว ช่วยให้บํารุงรักษาง่าย

• ใช้โฟลว์ย่อยเพื่อนําไมโครโฟลว์กลับมาใช้ใหม่

• กําหนด microflow name และ business objects ล่วงหน้าในระหว่างขั้นตอนการออกแบบเอง

• ใช้ environment variables เพื่อกําหนดค่ากิจกรรมสําหรับสภาพแวดล้อมที่แตกต่างกัน สิ่งนี้จะป้องกันการเปลี่ยนแปลงการกําหนดค่าในภายหลังเมื่อปรับใช้กับสภาพแวดล้อมการทดสอบหรือการผลิต

• แยกไฟล์ Jar อ้างอิงออกจากไฟล์ Jar ที่สร้างขึ้นสําหรับโหนด Java และอัปโหลดไปยังเซิร์ฟเวอร์โดยใช้เมนู upload file สิ่งนี้ช่วยให้ผู้ดูแลระบบสามารถควบคุมเวอร์ชันของไฟล์ jar ยูทิลิตี้แต่ละไฟล์โดยเฉพาะอย่างยิ่งเมื่อมียูทิลิตี้ทั่วไปที่เกี่ยวข้อง

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

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

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

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

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

เมื่อผู้ใช้ต้องการสร้าง 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 ได้ที่นี่

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

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

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

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

ตอนนี้ให้เราสร้างตรรกะไมโครโฟลว์จริงใน 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 แรกของคุณพร้อมสําหรับการดําเนินการแล้ว

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

เพจสามารถรวมเข้ากับระบบภายในและภายนอกอื่น ๆ เช่น 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

กระบวนการทางธุรกิจ (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 สามารถเลือกใช้ค่าจาก การกําหนดค่าสภาพแวดล้อม

ใช้งาน 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 นี้

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

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

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

ส่วนขยาย 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 ดังที่แสดงภายใต้พารามิเตอร์ฟิลด์เฉพาะหรือสามารถอ่านทั้งแถวตามที่กําหนดค่าไว้ภายใต้พารามิเตอร์ระเบียนภายใต้แต่ละแผ่นงาน

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

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

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

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

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

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

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

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

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

Process REST API คือรายการของ REST API ซึ่งใช้เพื่อนําทางโฟลว์กระบวนการตั้งแต่ต้นจนจบ และเพื่อสื่อสารกันโหนดอื่นๆ ผ่านโฟลว์กระบวนการ การถ่ายโอนข้อมูลเกิดขึ้นผ่านเครือข่ายซึ่งสื่อสารผ่านโปรโตคอล HTTP / HTTPS

ตารางด้านล่างแสดงรายการวิธีการ REST API ที่ให้ไว้เพื่อควบคุมการไหลของกระบวนการ สําหรับรายละเอียดเพิ่มเติม โปรดดู คู่มือ API

App Runtime แสดงรายการ REST API เพื่อให้ผู้ใช้จากระบบอื่นสามารถโต้ตอบกับเอนทิตีที่สร้างขึ้นใน App Designer โดยใช้ REST REST API ในรันไทม์ของแอพนี้สามารถใช้เพื่อ แทรก, อัปเดต และลบ การกําหนดค่าเอนทิตีในฐานข้อมูล ส่วนนี้ให้รายละเอียดของวิธีการที่ได้รับจาก API วิธีการสามารถเพิ่มลงในรากบริบทเพื่อเรียกบริการ

ส่วนขยาย 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

REST API แบ่งธุรกรรมเพื่อสร้างชุดโมดูลขนาดเล็ก แต่ละโมดูลจะระบุส่วนพื้นฐานเฉพาะของธุรกรรม โมดูลาร์นี้ช่วยให้นักพัฒนามีความยืดหยุ่นมาก แต่อาจเป็นเรื่องยากสําหรับนักพัฒนาในการออกแบบตั้งแต่เริ่มต้น ปัจจุบัน ตัวอย่างกรณีการใช้งานสําหรับ APP Runtime API คือแอพบนอุปกรณ์เคลื่อนที่และแอพที่กําหนดเอง แอพมือถือ

Mobile App เป็นแอพพลิเคชันที่สื่อสารกับเซิร์ฟเวอร์และมือถือผ่านอินเทอร์เน็ตโดยใช้ REST API

ตัวอย่าง Login Mobile App

คุณสมบัติเช่น Key-in Username & Password, Log on with all case, Forgot Password, Remind me later เป็นการกระทําทั้งหมดจากมือถือไปยังเซิร์ฟเวอร์ที่สื่อสารผ่านอินเทอร์เน็ตโดย REST API

แอพแบบกําหนดเอง (Custom App)

Custom App เป็นแอพพลิเคชันที่สื่อสารกับเซิร์ฟเวอร์และเว็บแอพพลิเคชันโดยใช้ REST API

ตัวอย่าง Work Order

Step-by-step เพื่อรับข้อมูลเอนทิตีโดย REST API

ขั้นตอนที่ 1 กําหนดค่าเอนทิตีเพื่อรับข้อมูลโดย REST API สําหรับตัวอย่างนี้ เราจะเตรียมเอนทิตีที่ชื่อ Work Order เอนทิตีนี้ประกอบด้วย 3 แท็บและ 4 โมดูล ดูภาพด้านล่าง

ขั้นตอนที่ 2 รับข้อมูลสําคัญเพื่อส่งพารามิเตอร์ไปยัง URL ภาพด้านล่างเป็นหน้าจออัปเดตของ Work Order สําหรับตัวอย่างนี้ คีย์คือ sale_order_no และค่าเป็น 0000000010

ขั้นตอนที่ 3 กระบวนการเข้าสู่ระบบใช้วิธีการโพสต์ เรียกใช้ URL http://localhost:9084/eaf-rest/login ด้วยพารามิเตอร์ Content-Type: application/json และ Body ประกอบด้วย 3 ค่าในรูปแบบ JSON

"username" : "administrator", "password" : "P@55w0rd", "clientId" : "123456789"

หลังจากเรียกใช้ URL เข้าสู่ระบบระบบจะส่งคืน id_token เพื่อใช้ในกระบวนการอื่น ดูภาพด้านล่าง

ขั้นตอนที่ 4 เรียก URL เพื่อรับข้อมูลจากเอนทิตี รูปแบบคือ ServerName, Port, Context

ค่า Root และ ค่า Parameter

รูปแบบ: ServerName:Port/Context Root/Parameter Value ตัวอย่าง: http://localhost:9084/eaf-rest/entity/EN_431959963131500/get?handleForm=Y&SALE_ORDER_NO=0000000010&cbMethod=callback

ขั้นตอนที่ 5 ตั้งค่า Header parameters 3 ตัวต่อไปนี้ดังที่แสดงด้านล่าง

• Content-Type: application/json

• Authorization: เริ่มมูลค่า Bearer จากนั้นเว้นวรรคและ token id ที่ได้รับจากกระบวนการเข้าสู่ระบบ

• clientId: ใช้ clientId เช่นเดียวกับในกระบวนการเข้าสู่ระบบ

ขั้นตอนที่ 6 เรียกใช้ขั้นตอนที่ 3 และขั้นตอนที่ 4 เพื่อรับผลลัพธ์ JSON DATA ดังภาพด้านล่าง

ข้อมูล JSON ประกอบด้วยฟิลด์ต่อไปนี้

• ค่า ENTITY_ID ของเอนทิตี ID

• ค่า MODULE_ID ของ moduleID

• UPDATE เป็นโหมดของกระบวนการ

• ALE_ORDER_ITEM คือชื่อตาราง

• PRODUCT_ID, PRODUCT_NAME คือชื่อเขตข้อมูล เป็นต้น

• KEY เป็นคีย์ของโมดูล/บันทึกในข้อมูลนี้จะเห็นค่า ModuleID 4 ซึ่งเหมือนกันกับการกําหนดค่าของเอนทิตีนี้

ทดสอบ API จากแอพที่กําหนดเอง

คุณเห็นวิธีการรับข้อมูลจากเอนทิตีแล้ว ตอนนี้สมมติว่าแอพพลิเคชันอื่นต้องค้นหาผู้ติดต่อลูกค้าจากหมายเลขคําสั่งซื้อ (Order No) คุณสามารถรับข้อมูลได้จาก REST API

ขั้นตอนที่ 1 ในหน้าจอเข้าสู่ระบบให้ป้อนค่า userName และเรียก Login REST

ขั้นตอนที่ 2 ใช้ Ajax เพื่อเรียก Rest Service เพื่อให้ id_token เข้าสู่เซสชันเพื่อใช้โดยกระบวนการอื่นๆ

ขั้นตอนที่ 3 เตรียมหน้าจอเพื่อป้อนหมายเลขคําสั่งซื้อ (Order No)

ขั้นตอนที่ 4 ป้อนค่า Order No จากนั้น คลิก Find Customer contact

ขั้นตอนที่ 5 ใช้ฟังก์ชัน JavaScript เพื่อเรียกใช้ Ajax REST API เพื่อรับ Data Customer contact โดยส่งพารามิเตอร์ Order No ในส่วนหัวตั้งค่า Content-Type, Authorization (ใช้ id_token จากเซสชัน) และ clientId จากกระบวนการเข้าสู่ระบบ

ขั้นตอนที่ 6 เรียกใช้ REST API และรับข้อมูล JSON โมดูลการเน้นมี CUST_CONTACT ที่ต้องการผลลัพธ์ สามารถรับข้อมูลจาก JSONObject ผ่าน MODULE_ID > UPDATE > SALE_ORDER_DELIVERY > CUST_CONTACT

ขั้นตอนที่ 7 ใช้ JQuery หรือ JavaScript เพื่อแสดงข้อมูลผลลัพธ์

Custom App เป็นแอพพลิเคชันภายนอกตามธุรกิจของ บริษัท ซึ่งได้รับการพัฒนานอกแพลตฟอร์ม ONEWEB สามารถเรียก Process Runtime โดยใช้ Process REST API เพื่อควบคุมกระบวนการ

ดังนั้นจากแอพที่กําหนดเองนักพัฒนาสามารถใช้ Ajax เพื่อเรียก Rest Services ตัวอย่างวิธีใช้ API แสดงไว้ด้านล่าง

ตัวอย่าง method control process ภาพด้านล่างนี้เป็นกระบวนการสําหรับ "Booking Room" มันเริ่มต้นขั้นตอนด้วยการเลือกห้องแล้วตรวจสอบสถานะการจอง หากจองห้องพักแล้วให้กลับไปเลือกห้องใหม่ มิฉะนั้นหากไม่ได้จองห้องพักให้เพิ่มรายละเอียดของลูกค้าลงในนั้นแล้วบันทึกลงในฐานข้อมูลและอัปเดตสถานะห้อง

ขั้นตอนที่ 1 เริ่มโฟลว์ ส่ง parameter object เพื่อเริ่มโฟลว์ ในกรณีนี้คือ RoomObject และ CustomerInfo

เมื่อเริ่มต้นโฟลว์แล้ว ระบบจะส่งคืน instance id เพื่อควบคุมขั้นตอนต่อไปของกระบวนการ ในกรณีนี้ instance id คือ "122056879-85735849-0b71-4299-9cd2-165f5b31c12e"

ขั้นตอนที่ 2 รับงานตาม instance id ตอนนี้นักพัฒนาสามารถรับ task name โดยใช้ instance id ตั้งแต่ขั้นตอนแรก

สําหรับขั้นตอนที่ 2 ระบบจะส่งคืน task name, task id และอื่น ๆ โปรดดูภาพด้านบน

ขั้นตอนที่ 3 มอบหมายงาน (ตามผู้ใช้) ตอนนี้นักพัฒนาสามารถมอบหมายงานโดยใช้ task id จากขั้นตอนที่ 2 ด้วย URL นี้ด้านล่าง http://192.168.0.213:8080/BPMREST/service/runtime/tasks/122056910-494baede-088f-46bb-8a24-77b049ef996c/assign?user=origcmr4"

หลังจากมอบหมายงานข้อมูลจะปรากฏในรายการสิ่งที่ต้องทําของผู้ใช้ (Origcmr4) (ดูภาพด้านล่าง)

ขั้นตอนที่ 4 Claim/Unclaim/Complete Task ให้เสร็จสมบูรณ์ในที่สุด Origcmr4 สามารถอ้างสิทธิ์/ยกเลิกการอ้างสิทธิ์หรือทํางานให้เสร็จโดย URL นี้ด้านล่าง

Claim: http://192.168.0.213:8080/BPMREST/service/runtime/tasks/122056910-494baede-088f-46bb-8a24-77b049ef996c/claim?user=origcmr4 Unclaim: http://192.168.0.213:8080/BPMREST/service/runtime/tasks/122056910-494baede-088f-46bb-8a24-77b049ef996c/claim?user= Complete: http://192.168.0.213:8080/BPMREST/service/runtime/tasks/122056910-494baede-088f-46bb-8a24-77b049ef996c/complete?user=origcmr4

หลังจากเสร็จสิ้นภารกิจกระบวนการจะไปที่โหนดถัดไป ดังนั้นมันจะดําเนินการต่อด้วยกระบวนการตามการกําหนดค่าของกิจกรรมกระบวนการถัดไปจนกว่างานสุดท้าย