API ตัวกรองข้อมูลประจําตัว

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

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

API นี้จะมีประโยชน์ในสถานการณ์ต่อไปนี้:

• สําหรับวิชวลแบบกําหนดเองที่ใช้แบบจําลองความหมายที่มีกลุ่มบนคีย์
• การโยกย้ายวิชวลที่ใช้ API ที่เก่ากว่า (ก่อนหน้า 2.2) ไปยัง API ที่ใหม่กว่า
• อนุญาตให้เลือกโดยใช้การระบุอาร์เรย์ดัชนี

หมายเหตุ

API ตัวกรองข้อมูลประจําตัวพร้อมใช้งานจาก API เวอร์ชัน 5.1 เพื่อค้นหาเวอร์ชันที่คุณกําลังใช้ ตรวจสอบapiVersionในไฟล์ pbiviz.json

แบบจําลองตัวกรองข้อมูลประจําตัวจะขึ้นอยู่กับอินเทอร์เฟซ IIdentityFilter

    private filter: IIdentityFilter = {
        $schema: “”,
        filterType: FilterType.Identity,
        operator: "In",
        target: []
    }

ตัวอย่างเช่น ถ้าวิชวลได้รับการอัปเดตมุมมองข้อมูลต่อไปนี้:

อาร์เรย์ คือชนิด number[] และประกอบด้วยเขตข้อมูลข้อมูลประจําตัวของรายการที่ผู้ใช้เลือก

identityIndex สอดคล้องกับดัชนีของค่าในอาร์เรย์ค่าของแบบจําลองความหมาย (ดูตัวอย่างต่อไปนี้)

ในตัวอย่างข้างต้น: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" เป็นต้น

วิธีการใช้ API ตัวกรองข้อมูลประจําตัว

หากต้องการใช้ API ตัวกรองข้อมูลประจําตัว เวอร์ชันของ powerbi-models ของคุณต้องเป็น 1.9.1 หรือสูงกว่า

• เพิ่มคุณสมบัติต่อไปนี้เป็นสมาชิกของคลาส visual.ts:

      private filter: IIdentityFilter = {
          $schema: “”,
          filterType: FilterType.Identity,
          operator: "In",
          target: []
      }
  

• หากต้องการจัดการการอัปเดต Power BI ให้ อ่านอาร์เรย์เป้าหมาย จาก 'jsonFilters' ใน 'VisualUpdateOptions' และแปลเป็นค่าที่สอดคล้องกัน ค่าเหล่านี้คือค่าที่ถูกเลือก ในตัวอย่างก่อนหน้านี้ อาร์เรย์เป้าหมายของ [0,10] สอดคล้องกับค่าของ Aliyah และ Abigail

• หากต้องการจัดการการเลือกผู้ใช้ในตัวอย่างก่อนหน้านี้ คลิกที่ Abigail แรกเพื่อเพิ่มค่า 8 ไปยังอาร์เรย์เป้าหมายตัวกรองและส่งโดยใช้คําสั่งต่อไปนี้:

this.visualHost.applyJsonFilter(this.filter, "general", "filter", powerbi.FilterAction.merge);

การโยกย้ายวิชวลด้วย API เก่า

เริ่มต้นจาก API 5.1.0 เพื่อสนับสนุนตัวกรองข้อมูลประจําตัวบนวิชวลที่สร้างขึ้นโดยใช้เวอร์ชันก่อนหน้า 2.2 ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ capabilities.json ของคุณ:

    "migration": {
        "filter": {
            "shouldUseIdentityFilter": true
        }
    }

บรรทัดเหล่านี้แปลงการเลือกเป็นตัวกรองข้อมูลประจําตัว

หมายเหตุ

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

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

ใช้การเลือกวิชวล Power BI เพื่อเพิ่มการโต้ตอบไปยังวิชวล

มีคำถามเพิ่มเติมหรือไม่? ลองใช้ชุมชน Power BI