ใช้ตัวเชื่อมต่อแบบกำหนดเองกับการควบคุม timeline

ตัวเชื่อมต่อแบบกำหนดเองเป็นคุณลักษณะที่ช่วยให้นักพัฒนาสามารถแสดงข้อมูล เช่น แถวของตาราง Dataverse แหล่งข้อมูลภายนอก และอื่นๆ เป็นรายการเรกคอร์ดภายในส่วนประกอบ TimelineWallControl อนุญาตให้มีชุดของสถานการณ์ที่กว้างขึ้นนอกเหนือจากบันทึกย่อ โพสต์ และกิจกรรมแบบสำเร็จรูป

สำหรับข้อมูลเกี่ยวกับการกำหนดค่าและการใช้ไทม์ไลน์ โปรดดูหัวข้อต่อไปนี้:

• ใช้เส้นเวลา
• กำหนดค่าเส้นเวลา
• การกำหนดค่าการ์ดเรกคอร์ดไทม์ไลน์

เรกคอร์ดที่มีการกำหนดค่าภายในตัวเชื่อมต่อแบบกำหนดเอง คือทรัพยากรบนเว็บ JavaScript ที่สอดคล้องกับอินเทอร์เฟซ IRecordSource ชื่อของทรัพยากรบนเว็บ พร้อมกับตัวสร้าง (ชื่อรวมถึงเนมสเปซ) และเส้นทางทรัพยากรบนเว็บ JSON ทางเลือก สามารถเพิ่มเป็นการกำหนดค่าพารามิเตอร์ UClientRecordSourcesJSON ภายใน FormXML

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

TimelineWallControl คาดว่าจะโหลดทรัพยากรบนเว็บ JavaScript แล้วสร้างอินสแตนซ์ของ IRecordSource จากตัวสร้างที่กำหนดค่าไว้

จากนั้น IRecordSource จะเริ่มต้น (init) โดยมีคำขอสำหรับหน้าของเรคคอร์ด (getRecordsData) คำขอสำหรับรายละเอียดตัวกรอง (getFilterDetails) และคำขอสำหรับการแสดง UX ของเรคคอร์ดเดียว (getRecordUX)

การตอบสนองจากการร้องขอเรกคอร์ดยังคงอยู่ เพื่อลดจำนวนการร้องขอเรกคอร์ดที่เกิดขึ้นภายในสถานการณ์จำลองแบบหลายเซสชัน

กำหนดค่าตัวเชื่อมต่อแบบกำหนดเองสำหรับตัวควบคุม timeline

คุณสามารถเพิ่มหรือแก้ไขตัวเชื่อมต่อแบบกำหนดเองสำหรับตัวควบคุม timeline ได้โดยการกำหนดค่าในประสบการณ์ของผู้สร้าง

1. บนตัวควบคุม timeline เลือกฟอร์มที่คุณต้องการเพิ่มหรือแก้ไขตัวเชื่อมต่อแบบกำหนดเอง

2. ทำตามตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้:

   • หากต้องการเพิ่มตัวเชื่อมต่อแบบกำหนดเองใหม่ ในบานหน้าต่าง คุณสมบัติ สำหรับตารางไทม์ไลน์ ใน ตัวเชื่อมต่อแบบกำหนดเอง เลือก เพิ่มตัวเชื่อมต่อ บานหน้าต่าง ตัวเชื่อมต่อแบบกำหนดเองใหม่ จะปรากฏขึ้น

     

   • หากต้องการแก้ไขตัวเชื่อมต่อแบบกำหนดเองที่มีอยู่ซึ่งคุณได้อัปโหลดแล้ว ในบานหน้าต่าง คุณสมบัติ สำหรับเอนทิตีไทม์ไลน์ ให้เลือกตัวเชื่อมต่อแบบกำหนดเอง จากนั้นเลือก แก้ไข บานหน้าต่าง แก้ไขตัวเชื่อมต่อแบบกำหนดเอง จะปรากฏขึ้น

     

3. แก้ไขเพจ และเลือก บันทึก

การสนับสนุนตัวกรอง

การสนับสนุนตัวกรองตัวเชื่อมต่อแบบกำหนดเองมีความสามารถดังต่อไปนี้

• เพิ่มชนิดตัวกรองใหม่ให้กับกลุ่มตัวกรองที่มีอยู่
• เพิ่มกลุ่มตัวกรองใหม่
• อัปเดตจำนวนชนิดตัวกรองที่มีอยู่
• ตัวกรองบนคีย์การค้นหา

ตัวเชื่อมต่อที่กำหนดเองต้องใช้ข้อมูลโซนเวลาของ UserSettings จากบริบทที่ส่งผ่านใน init() เพื่อให้สอดคล้องกับการแสดงไทม์ไลน์

ขอบเขต

คุณลักษณะตัวเชื่อมต่อแบบกำหนดเองได้รับการสนับสนุนภายในฟอร์มตารางเซสชันเดียวและหลายเซสชันในแอปแบบจำลองไคลเอ็นต์ส่วนติดต่อแบบรวม

นอกขอบเขต

ฟังก์ชันต่อไปนี้ไม่พร้อมใช้งานสำหรับคุณลักษณะตัวเชื่อมต่อแบบกำหนดเอง:

• สถานการณ์ออฟไลน์และออฟไลน์โดยค่าเริ่มต้น
• แดชบอร์ด
• ตำแหน่งที่ TimelineWallControl ไม่พร้อมใช้งาน (เช่น แอปที่ผสาน แอปพื้นที่ทำงาน, Power Pages, หน้าแบบกำหนดเอง และอื่นๆ)

ข้อจำกัดที่ทราบ

ทรัพยากรบนเว็บที่กำหนดค่าไว้ไม่ได้รับการประกาศอย่างเป็นทางการเป็นการพึ่งพาแบบฟอร์ม ซึ่งหมายความว่าการส่งออกแบบฟอร์มจะไม่ส่งออกทรัพยากรบนเว็บโดยอัตโนมัติ และจำเป็นต้องเพิ่มลงในการส่งออกนั้นด้วยตนเอง นอกจากนี้ การลบทรัพยากรบนเว็บเหล่านี้โดยไม่ได้ตั้งใจ เกิดขึ้นได้ง่ายด้วย

พัฒนาต้นทางเรกคอร์ด

เมื่อพัฒนาต้นทางเรกคอร์ด ให้ปฏิบัติตามแนวทางปฏิบัติเหล่านี้:

• ตรวจสอบให้แน่ใจว่าคุณกำลังดึงข้อมูลอย่างปลอดภัย แบบจำลองการรักษาความปลอดภัย ส่วนติดต่อแบบรวม ถือว่าทรัพยากรเว็บ JS และ JSON ไม่น่าเชื่อถือ ดังนั้นทรัพยากรดังกล่าวจึงไม่ควรมีโทเค็นหรือความลับอยู่ในนั้น เนื่องจากจะถูกเก็บไว้ในข้อความธรรมดา
• หากข้อมูลอยู่ภายใน Dataverse ให้ใช้อ็อบเจ็กต์บริบทจากลักษณะการทำงาน init เพื่อส่งคำขอเป็น Dataverse การโทรเป็น Dataverse จากบริบทมีการร้องขอพร็อกซีผ่าน iframe ที่ปลอดภัย นี่คือวิธีที่ต้นทางเรกคอร์ดแบบสำเร็จรูปภายใน TimelineWallControl ดึงข้อมูล
• หากข้อมูลอยู่นอก Dataverse ให้ใช้กลไกที่มีอยู่จากแพลตฟอร์มเพื่อดึงข้อมูลภายนอก
• ทดสอบการเปลี่ยนแปลงในเครื่องโดยใช้ Fiddler: ปรับปรุงความคล่องตัวของการพัฒนาและการดีบักของทรัพยากรบนเว็บ JavaScript โดยใช้ Fiddler AutoResponder สำหรับข้อมูลเพิ่มเติม: สคริปต์การพัฒนาทรัพยากรบนเว็บ โดยใช้ Fiddler AutoResponder
• ลดความเสี่ยงของการโจมตี XSS: ความเสี่ยงของการโจมตี XSS เกิดขึ้นเมื่อเพิ่ม/ผูก HTML เข้ากับ DOM ใช้ข้อความธรรมดาทุกครั้งที่ทำได้ เพื่อลดความเสี่ยงนี้ หากจำเป็นต้องใช้ HTML คุณต้องล้างเนื้อหานี้ก่อนที่จะเพิ่มลงในเรกคอร์ด
• ปฏิบัติตามแนวทางปฏิบัติที่ดีที่สุดทั่วไป สำหรับการเขียนสคริปต์ไคลเอ็นต์ ข้อมูลเพิ่มเติม: การเขียนสคริปต์ไคลเอ็นต์ในแอปแบบจำลอง
• รับรองแนวทางการออกแบบที่ครอบคลุม รวมถึงการใช้เครื่องมือทดสอบอัตโนมัติ เช่น Accessibility Insights

ตัวอย่างโซลูชัน

คุณสามารถเริ่มต้นใช้งาน ตัวอย่างโซลูชันตัวเชื่อมต่อแบบกำหนดเอง ที่มีทรัพยากรบนเว็บ "SecondaryRecordSource" ซึ่งมีการตั้งค่าคอนฟิกไว้สำหรับฟอร์ม "บัญชีสำหรับการทำงานแบบเชิงโต้ตอบ" และ "บัญชีสำหรับประสบการณ์หลายเซสชัน"

ดูเพิ่มเติม

ใช้ไทม์ไลน์
ตั้งค่าคอนฟิกไทม์ไลน์

หมายเหตุ

บอกให้เราทราบเกี่ยวกับภาษาที่คุณต้องการในคู่มือ ทำแบบสำรวจสั้นๆ (โปรดทราบว่าแบบสำรวจนี้เป็นภาษาอังกฤษ)

แบบสำรวจนี้ใช้เวลาทำประมาณเจ็ดนาที ไม่มีการเก็บข้อมูลส่วนบุคคล (คำชี้แจงสิทธิ์ส่วนบุคคล)