การรวมระบบวิชวล Power BI

  • บทความ

บทความนี้อธิบาย API ของวิชวลและวิธีที่ Power BI จัดการการโต้ตอบระหว่างคุณ วิชวล และโฮสต์

การดําเนินการและการอัปเดตที่ตามมาใน Power BI สามารถเริ่มต้นได้ด้วยตนเองหรือโดยอัตโนมัติ ชนิดการอัปเดต:

รูปภาพต่อไปนี้แสดงวิธีที่การดําเนินการตามวิชวลทั่วไป เช่น การเลือกบุ๊กมาร์ก กระบวนการใน Power BI

Diagram of the Power BI visual process.

โต้ตอบกับวิชวลผ่าน Power BI

คุณสามารถอัปเดตวิชวลด้วย Power BI ดังนี้:

  • เปิดแผงคุณสมบัติของวิชวล

    เมื่อคุณเปิดแผงคุณสมบัติของวิชวล Power BI จะได้รับการสนับสนุนวัตถุและคุณสมบัติจากไฟล์ capabilities.json ของวิชวล ในการรับค่าที่แท้จริงของคุณสมบัติ Power BI เรียกใช้ getFormattingModel เมธอด ของวิชวล (API เวอร์ชันก่อนหน้าที่ 5.0 แทน enumerateObjectInstances ) API ส่งกลับคอมโพเนนต์แบบจําลองของบานหน้าต่างรูปแบบที่ทันสมัย คุณสมบัติ และค่าจริง

    สําหรับข้อมูลเพิ่มเติม โปรดดู ที่ ความสามารถและคุณสมบัติของวิชวล Power BI

  • กําหนดชื่อเรื่องการแสดงภาพ พื้นหลัง ป้ายชื่อ และคําอธิบายแผนภูมิ

    เมื่อคุณเปลี่ยนค่าของคุณสมบัติในแผง รูปแบบ Power BI จะ update เรียกใช้วิธีการ Power BI ส่งผ่านในวัตถุใหม่ options ไปยัง update เมธอด และวัตถุประกอบด้วยค่าใหม่

    สําหรับข้อมูลเพิ่มเติม โปรดดู ที่ ออบเจ็กต์และคุณสมบัติของวิชวล Power BI

  • ปรับขนาดวิชวล

    เมื่อคุณเปลี่ยนขนาดของวิชวล Power BI จะupdateเรียกใช้เมธอด และส่งผ่านในวัตถุใหม่options วัตถุ options มีวัตถุที่ซ้อนกัน viewport ที่ประกอบด้วยความกว้างและความสูงใหม่ของวิชวล

  • ใช้ตัวกรองที่ระดับรายงาน หน้า หรือวิชวล

    ข้อมูลตัวกรอง Power BI ที่ยึดตามเงื่อนไขตัวกรอง Power BI เรียกใช้ update วิธีการ ของวิชวลเพื่ออัปเดตวิชวลด้วยข้อมูลใหม่

    วิชวลได้รับการอัปเดตใหม่ของ options วัตถุเมื่อมีข้อมูลใหม่ในหนึ่งวัตถุที่ซ้อนกัน การอัปเดตเกิดขึ้นขึ้นอยู่กับการกําหนดค่าการแมปมุมมองข้อมูลของวิชวล

    สําหรับข้อมูลเพิ่มเติม โปรดดู ทําความเข้าใจการแมปมุมมองข้อมูลในวิชวล Power BI

  • เลือกจุดข้อมูลในวิชวลอื่นในรายงาน

    เมื่อคุณเลือกจุดข้อมูลในวิชวลอื่นในรายงาน ตัวกรองหรือ Power BI หรือไฮไลต์จุดข้อมูลที่เลือกและเรียกวิธีการ ของ update วิชวล วิชวลได้รับข้อมูลที่ถูกกรองใหม่ หรือได้รับข้อมูลเดียวกันกับอาร์เรย์ของการไฮไลต์

    สําหรับข้อมูลเพิ่มเติม โปรดดู การไฮไลต์จุดข้อมูลในวิชวล Power BI

  • เลือกบุ๊กมาร์กใน แผงบุ๊กมาร์ก ของรายงาน

    เมื่อคุณเลือกบุ๊กมาร์กใน แผงบุ๊กมาร์ก อย่างใดอย่างหนึ่ง:

    • Power BI เรียกใช้ฟังก์ชันที่ส่งผ่านและลงทะเบียนโดย registerOnSelectionCallback วิธีการ ฟังก์ชันการเรียกกลับรับอาร์เรย์ของการเลือกสําหรับบุ๊กมาร์กที่สอดคล้องกัน

    • Power BI เรียกใช้ update วิธีการ ที่มีวัตถุที่สอดคล้องกัน filter ภายใน options วัตถุ

      ในทั้งสองกรณี วิชวลจะเปลี่ยนสถานะตามการเลือกที่ได้รับหรือ filter วัตถุ

      สําหรับข้อมูลเพิ่มเติมเกี่ยวกับบุ๊กมาร์กและตัวกรอง ดู Visual Filter API ในวิชวล Power BI

โต้ตอบกับวิชวลโดยตรง

คุณยังสามารถโต้ตอบกับวิชวลโดยตรงเพื่ออัปเดต:

  • วางเมาส์เหนือองค์ประกอบข้อมูล

    วิชวลสามารถแสดงข้อมูลเพิ่มเติมเกี่ยวกับจุดข้อมูลผ่าน Power BI Tooltips API เมื่อคุณโฮเวอร์เหนือองค์ประกอบวิชวล วิชวลสามารถจัดการเหตุการณ์และแสดงข้อมูลเกี่ยวกับองค์ประกอบคําแนะนําเครื่องมือที่เกี่ยวข้อง วิชวลสามารถแสดงคําแนะนําเครื่องมือมาตรฐานหรือคําแนะนําเครื่องมือของหน้ารายงานได้

    สําหรับข้อมูลเพิ่มเติม ดู เพิ่มคําแนะนําเครื่องมือไปยังวิชวล Power BI ของคุณ

  • เปลี่ยนคุณสมบัติวิชวล (ตัวอย่างเช่น โดยการขยายแผนผังต้นไม้) และวิชวลจะบันทึกสถานะใหม่ในคุณสมบัติวิชวล

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

  • เลือก URL

    ตามค่าเริ่มต้น วิชวลไม่สามารถเปิด URL ได้โดยตรง หากต้องการเปิด URL ในแท็บใหม่ วิชวลสามารถเรียกใช้ launchUrl เมธอด และส่งผ่าน URL เป็นพารามิเตอร์ได้

    สําหรับข้อมูลเพิ่มเติม ดูสร้างการเปิดใช้ URL

  • ใช้ตัวกรองผ่านวิชวล

    วิชวลสามารถเรียกใช้ applyJsonFilter เมธอด และส่งผ่านเงื่อนไขเพื่อกรองข้อมูลในวิชวลอื่น ๆ มีตัวกรองหลายประเภทที่พร้อมใช้งาน รวมถึงตัวกรองพื้นฐาน ขั้นสูง และ Tuple

    สําหรับข้อมูลเพิ่มเติม ดู API ตัวกรองวิชวลในวิชวล Power BI

  • เลือกองค์ประกอบในวิชวล

    สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการเลือกในวิชวล Power BI โปรดดู เพิ่มการโต้ตอบลงในวิชวลด้วยการเลือกวิชวลของ Power BI

วิชวลโต้ตอบกับ Power BI

บางครั้งวิชวลเริ่มต้นการสื่อสารกับโฮสต์ Power BI โดยไม่มีการป้อนข้อมูลใด ๆ จากคุณ:

  • วิชวลร้องขอข้อมูลเพิ่มเติมจาก Power BI

    วิชวลประมวลผลส่วนข้อมูลตามส่วน วิธีการ fetchMoreData API ร้องขอส่วนย่อยถัดไปของข้อมูลในแบบจําลองความหมาย

    สําหรับข้อมูลเพิ่มเติม ดู รับข้อมูลเพิ่มเติมจาก Power BI

  • ทริกเกอร์บริการเหตุการณ์

    Power BI สามารถส่งออกรายงานเป็น PDF หรือส่งรายงานทางอีเมล (ใช้กับวิชวลที่ได้รับการรับรองเท่านั้น) หากต้องการแจ้ง Power BI ที่แสดงได้เสร็จสิ้นและวิชวลพร้อมที่จะจับภาพเป็น PDF หรืออีเมล วิชวลควรเรียกใช้ การแสดงเหตุการณ์ API

    สําหรับข้อมูลเพิ่มเติม ดูส่งออกรายงานจาก Power BI เป็น PDF

    เมื่อต้องการเรียนรู้เกี่ยวกับบริการเหตุการณ์ ดู เหตุการณ์ "การแสดงผล" ในวิชวล Power BI

เนื้อหาที่เกี่ยวข้อง

สนใจในการสร้างการแสดงภาพและเพิ่มไปยัง Microsoft AppSource หรือไม่ ดูบทความเหล่านี้: