API filter identitas

API filter Identitas memungkinkan Anda membuat visual yang dapat memfilter data kategoris menggunakan kueri semantik.
Ini memfilter data menurut titik data daripada ekspresi matematika.

API melacak pilihan pengguna dan titik data mana yang akan ditampilkan. Titik data disimpan dalam array dan dirujuk oleh posisinya dalam array.

API ini berguna dalam skenario berikut:

• Untuk visual kustom yang menggunakan model semantik dengan grup pada kunci
• Memigrasikan visual yang menggunakan API yang lebih lama (lebih awal dari 2.2) ke API yang lebih baru
• Perbolehkan pilihan menggunakan identifikasi array indeks

Catatan

API filter Identitas tersedia dari API versi 5.1 Untuk mengetahui versi mana yang Anda gunakan, periksa apiVersion di file pbiviz.json.

Model filter Identitas didasarkan pada antarmuka IIdentityFilter .

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

Misalnya, jika visual menerima pembaruan tampilan data berikut:

Array berjenis number[] dan berisi bidang identitas item yang dipilih pengguna.

IdentityIndex sesuai dengan indeks nilai dalam array nilai model semantik (lihat contoh berikut).

Dalam contoh di atas: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" dll.

Cara menggunakan API filter Identitas

Untuk menggunakan API filter Identitas, versi powerbi-models Anda harus 1.9.1 atau lebih tinggi.

• Tambahkan properti berikut sebagai anggota kelas visual.ts:

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

• Untuk menangani pembaruan Power BI, baca array target dari 'jsonFilters' di 'VisualUpdateOptions' dan terjemahkan ke nilai yang sesuai. Nilai-nilai ini adalah nilai yang dipilih. Dalam contoh sebelumnya, array target [0,10] sesuai dengan nilai Aliyah dan Abigail.

• Untuk menangani pilihan pengguna dalam contoh sebelumnya, klik Abigail pertama untuk menambahkan nilai 8 ke array target filter dan mengirimkannya menggunakan perintah berikut:

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

Memigrasikan visual dengan API lama

Mulai dari API 5.1.0, untuk mendukung filter identitas pada visual yang dibuat menggunakan versi yang lebih lama dari 2.2, tambahkan baris berikut ke file capabilities.json Anda:

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

Baris ini mengonversi pilihan ke filter identitas.

Catatan

Langkah ini hanya diperlukan untuk visual yang ada yang dibuat dengan API yang lebih lama. Visual yang lebih baru tidak perlu menambahkan ini.

Konten terkait

Menggunakan pilihan visual Power BI untuk menambahkan interaktivitas ke visual

Ada pertanyaan lagi? Coba Komunitas Power BI.