รอบการขายของสินค้า
โฟลว์ที่แนะนําสําหรับการสร้างรายการใน Fabric UI คือ
- แจ้งผู้ใช้สําหรับชื่อรายการ
- สร้างรายการ "ว่าง"
- แก้ไขและบันทึกรายการใหม่
กระบวนการนี้สามารถแบ่งออกเป็นระยะต่อไปนี้:
เมื่อผู้ใช้เลือกปุ่มเพื่อสร้างรายการของชนิดใดก็ตาม โค้ด Fabric FE (พอร์ทัล) จําเป็นต้องโหลดตัวแก้ไขรายการที่สอดคล้องกัน Fabric FE ทําการเรียกใช้ API ไปยัง Fabric BE เพื่อดึงข้อมูลที่จําเป็น รวมถึง URL ต้นทาง รายละเอียดแอปพลิเคชัน Microsoft Entra ID และ URL ของปริมาณงานทั้งหมดที่สอดคล้องกับบริบทปัจจุบัน เมื่อข้อมูลนี้พร้อมใช้งาน รายการจะถูกสร้างขึ้น โดยทั่วไปรายการจะโหลดทรัพยากรแบบคงที่ เช่น HTML, JavaScript, CSS และรูปภาพจาก CDN เราขอแนะนําให้ใช้การปรับใช้ CDN แบบหลายภูมิภาคและกําหนดค่าความละเอียดของชื่อเพื่อให้ URL ต้นทางจะแก้ไขไปยังเซิร์ฟเวอร์ CDN ที่อยู่ใกล้กับตําแหน่งที่ตั้งปัจจุบันของเบราว์เซอร์มากที่สุด
หมายเหตุ
โดยทั่วไปแล้ว ตัวแก้ไขรายการจําเป็นต้องเรียกใช้ปริมาณงาน BE ซึ่งอาจในระหว่างขั้นตอนการแก้ไข ซึ่งจําเป็นต้องมีการแก้ไข URL ของปริมาณงานตามบริบทปัจจุบัน ในปัจจุบัน รหัสสามารถใช้ URL แบบกําหนดค่าตายตัวได้
สร้างรายการที่ว่างเปล่า
ซึ่งเป็นแนวทางปฏิบัติทั่วไปใน Fabric เพื่อให้สามารถสร้างรายการโดยไม่มีการป้อนข้อมูลของผู้ใช้ ยกเว้นชื่อรายการ ซึ่งไม่ได้คาดหวังว่ารายการดังกล่าวจะมีความหมาย (ดังนั้น "ว่าง") แต่จะปรากฏในพื้นที่ทํางานและสามารถเข้าร่วมในโฟลว์และการดําเนินการพื้นฐานได้ ยิ่งไปกว่านั้นในบางกรณีพวกเขาสามารถทํางานได้ตามค่าเริ่มต้นที่สมเหตุสมผลตามปริมาณงาน
โฟลว์นี้เริ่มต้นด้วยการแจ้งให้ผู้ใช้ใส่ชื่อสําหรับรายการใหม่ การมีชื่อ iframe ทําการเรียกไปยังโฮสต์ JS API เพื่อเริ่มต้นโฟลว์การสร้างรายการ ผ่านวัตถุ JSON ที่เลือกได้เป็น "สร้างส่วนข้อมูล" และโฮสต์จะเรียกใช้ไปยัง Fabric BE การรับรองความถูกต้องถูกจัดการโดยโฮสต์ Fabric BE ช่วยแก้ไข URL ของปริมาณงาน BE ตามบริบทและเรียกใช้ CreateItem API ปริมาณงาน ที่ส่งผ่าน "สร้างส่วนข้อมูล" ที่ส่งโดย iframe คาดว่าจะมีการจัดเก็บเมตาดาต้ารายการใหม่ อาจจัดสรรทรัพยากรบางอย่าง (แม้ว่าขั้นตอนนี้สามารถเลื่อนออกไปได้ในภายหลัง) และทํางานอื่น ๆ ที่เกี่ยวข้อง เมื่อการสร้างรายการเสร็จสมบูรณ์จากมุมมองของปริมาณงาน BE จําเป็นต้องแจ้งให้ Fabric BE ทราบเกี่ยวกับการเปลี่ยนแปลงเมตาดาต้าของรายการ กระบวนการเดียวกันนี้จําเป็นต้องเกิดขึ้นในการอัปเดตเมตาดาต้าของรายการ ดังนั้นโทเค็นของชื่อเรื่องจึงต้องเปลี่ยนสําหรับผู้ชม Fabric BE
หมายเหตุ
API สําหรับการแจ้งการอัปเดตเมตาดาต้ารายการไม่พร้อมใช้งานในขณะนี้
โหลดสินค้า
หากต้องการแก้ไขรายการ iframe จําเป็นต้องโหลดเมตาดาต้า กระบวนการนี้จะเหมือนกับการโหลดรายการ "ว่าง" และ "เตรียมใช้งาน" iframe ทําการเรียกไปยังโฮสต์ JS API ซึ่งเรียกใช้ Fabric BE ซึ่งจะเรียกใช้ API ปริมาณงาน GetItemPayload ตามลําดับ ปริมาณงานสามารถส่งกลับออบเจ็กต์ JSON ซึ่งจากนั้นจะถูกส่งผ่านกลับไปยัง iframe การรับรองความถูกต้องถูกจัดการโดยโฮสต์
แก้ไขรายการ
เมื่อโหลดเมตาดาต้าของรายการ เซสชันการแก้ไขสามารถเริ่มต้นได้ ไม่ว่าจะในช่วงเริ่มต้นหรือในระหว่างเซสชันนี้ iframe อาจจําเป็นต้องเรียกใช้ไปยังปริมาณงาน BE (ตัวอย่างเช่น การดึงข้อมูลการกําหนดค่า เติมตัวควบคุม UI ทําการตรวจสอบความถูกต้อง และอื่น ๆ) สําหรับวัตถุประสงค์นี้ จําเป็นต้องร้องขอโทเค็นจากโฮสต์ JS API