แชร์ผ่าน

เพิ่มไอคอนคําเตือนการแสดงผลไปยังวิชวลของคุณ

  • บทความ

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

  • วิชวลแผนที่สามารถแสดงไอคอนคําเตือนเมื่อค่าอยู่นอกช่วงที่ถูกต้องของละติจูดหรือลองจิจูด

  • วิชวลแผนภูมิวงกลมสามารถแสดงไอคอนคําเตือนเมื่อแสดงค่าลบที่ผสมกับค่าบวก

  • แผนภูมิคาร์ทีเซียนสามารถแสดงไอคอนคําเตือนเมื่อมีการคํานวณค่าอนันต์ ตัวอย่างเช่น ถ้า Y เป็นศูนย์ เมื่อหาร X ด้วย Y ผลลัพธ์จะเป็นค่าอนันต์

เมื่อไอคอนปรากฏขึ้น ผู้ใช้สามารถโฮเวอร์เหนือไอคอนเพื่อดูชื่อเรื่องของข้อความเตือน

A screenshot showing a warning icon in a Power BI visual.

เมื่อผู้ใช้เลือกไอคอนคําเตือน ข้อความที่อธิบายปัญหาจะปรากฏขึ้นในหน้าต่างป็อปอัพ

A screenshot showing a warning message triggered by selecting a warning icon in a Power BI visual.

สร้างไอคอนคําเตือน

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

เพิ่มการเรียกไปยังวิธีการอัปเดต

หากต้องการเพิ่มไอคอนคําเตือนการแสดงผลไปยังวิชวลของคุณ ให้ displayWarningIcon เรียกใช้วิธีการ วิธีการ เป็นส่วนหนึ่งของ IVisualHost และ จะแสดงโดยใช้powerbi-visuals-api

เพิ่มการนําเข้าต่อไปนี้ไปยังไฟล์ของคุณ:

import powerbiVisualsApi from "powerbi-visuals-api";

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

ตัวอย่างที่ 1: ตรวจสอบความเข้ากันได้ของภาษา

การแปลเป็นภาษาท้องถิ่นใช้เพื่อแสดงวิชวลในภาษาแม่ของลูกค้า ซึ่งจะขัดต่อการตั้งค่าของระบบปฏิบัติการ

ในตัวอย่างนี้ วิชวลเปรียบเทียบภาษาของวิชวล ซึ่งตั้งค่าเป็นภาษาอังกฤษแบบ US เป็นภาษาของระบบปฏิบัติการ ถ้าภาษาไม่ตรงกัน ไอคอนคําเตือนจะแสดงขึ้นมา

if (this.locale != 'en-US') { 

            this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.'); 
        }

A screenshot showing the language mismatch warning message.

ตัวอย่างที่ 2: เปรียบเทียบสีในคอลัมน์ติดกัน

ในตัวอย่างนี้ ไอคอนคําเตือนการแสดงผลจะปรากฏขึ้นเมื่อสองคอลัมน์ที่อยู่ติดกันมีสีเดียวกัน

เม getColumnColorByIndex ธอดจะวนผ่านคอลัมน์ทั้งหมด ถ้าสองคอลัมน์ที่อยู่ติดกันมีสีเดียวกัน ไอคอนคําเตือนจะปรากฏขึ้น

let category = options.dataViews[0].categorical.categories[0]; 

let dataValue = options.dataViews[0].categorical.values[0]; 

let colorPalette = this.host.colorPalette; 

for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) { 

    const color1: string = getColumnColorByIndex(category, i, colorPalette); 

    const color2: string = getColumnColorByIndex(category, i+1, colorPalette); 

    if (color1 == color2) { 

        this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.'); 
    } 

}

ข้อควรพิจารณาและข้อจำกัด

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

  • คําเตือนการแสดงผลจะถูกล้างในระหว่างการแสดงภาพแต่ละครั้ง ตัวอย่างเช่น เมื่อลากข้อมูลใหม่ลงในวิชวล วิธีการของ update() วิชวลจะถูกเรียกใช้หลังจากที่มีการแสดงผลวิชวล หากคําเตือนของวิชวลเกิดขึ้นตามเงื่อนไขที่ตรวจสอบในวิธีอัปเดต แต่ละครั้งที่มีการแสดงผลวิชวล หากเป็นไปตามเงื่อนไข วิชวลจะแสดงคําเตือนอีกครั้ง

  • การปรับขนาดวิชวลจะไม่ส่งผลกระทบต่อไอคอนคําเตือน

ข้อจํากัดต่อไปนี้อ้างอิงถึงข้อความไอคอนการแสดงผล:

  • ความยาวสูงสุดของชื่อเรื่องคือ 70 อักขระ

  • ความยาวสูงสุดของข้อความคือ 2,000 อักขระ

  • ข้อความจะแสดงเป็นข้อความธรรมดาเท่านั้น

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

DataViewUtils