Kimlik filtresi API'si

Kimlik filtresi API'si, anlamsal sorgu kullanarak kategorik verileri filtreleyebilecek bir görsel oluşturmanıza olanak tanır.
Verileri matematiksel ifadeler yerine veri noktalarına göre filtreler.

API, kullanıcı seçimlerini ve hangi veri noktalarının görüntüleneceğini izler. Veri noktaları bir diziye kaydedilir ve dizideki konumlarına göre başvurulur.

Bu API aşağıdaki senaryolarda kullanışlıdır:

• Anahtarlar üzerinde grup içeren anlamsal modeller kullanan özel görseller için
• Daha eski bir API (2.2'den önceki) kullanan görselleri daha yeni bir API'ye geçirme
• Dizin dizilerini tanımlamayı kullanarak seçimlere izin ver

Dekont

Kimlik filtresi API'si 5.1 API sürümünden edinilebilir Hangi sürümü kullandığınızı öğrenmek için pbiviz.json dosyasındaki öğesini denetleyinapiVersion.

Kimlik filtresi modeli, IIdentityFilter arabirimini temel alır.

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

Örneğin, görsel aşağıdaki veri görünümü güncelleştirmesini aldıysa:

Dizi number[] türündedir ve kullanıcının seçtiği öğelerin kimlik alanlarını içerir.

identityIndex, semantik modelin değer dizisindeki değerin dizinine karşılık gelir (aşağıdaki örne bakın).

Yukarıdaki örnekte: {identityIndex: 0} = "Aaliyah" {identityIndex: 1} = "Aaliyah" {identityIndex: 02 = "Aaliyah" vb.

Kimlik filtresi API'sini kullanma

Kimlik filtresi API'sini kullanmak için powerbi-models sürümünüzün 1.9.1 veya üzeri olması gerekir.

• Aşağıdaki özelliği visual.ts sınıfının bir üyesi olarak ekleyin:

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

• Power BI güncelleştirmelerini işlemek için , 'VisualUpdateOptions' içindeki 'jsonFilters' içindeki hedef diziyi okuyun ve karşılık gelen değerlere çevirin. Bu değerler seçilen değerlerdir. Önceki örnekte [0,10] hedef dizisi Aliyah ve Abigail değerlerine karşılık gelir.

• Önceki örnekteki kullanıcı seçimlerini işlemek için ilk Abigail'e tıklayarak filtre hedef dizisine 8 değerini ekleyin ve aşağıdaki komutu kullanarak gönderin:

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

Eski API ile görselleri geçirme

API 5.1.0'dan başlayarak, 2.2'den önceki bir sürüm kullanılarak oluşturulan görsellerde kimlik filtresini desteklemek için capabilities.json dosyanıza aşağıdaki satırları ekleyin:

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

Bu satırlar seçimleri kimlik filtrelerine dönüştürür.

Dekont

Bu adım yalnızca eski API'lerle oluşturulan mevcut görseller için gereklidir. Daha yeni görsellerin bunu eklemesi gerekmez.

İlgili içerik

Görsele etkileşim eklemek için Power BI görsel seçimlerini kullanma

Başka sorunuz var mı? Power BI Topluluğu deneyin.