Power Apps'te Power BI kutucuğu denetimi

Bir uygulamada Power BI kutucuğunu gösteren denetimdir.

Power BI'ınız yok mu? Kaydolun.

Açıklama

Power BI kutucuklarınızı uygulamalarınızda görüntüleyerek mevcut veri çözümlemesi ve raporlama avantajından yararlanın. Seçenekler bölmesinin Veri sekmesindeki Dashboard, Tile ve Workspace özelliklerini ayarlayarak, göstermek istediğiniz kutucuğu belirtin.

Not

  • Power BI kutucuğu denetimi GCC High ve DoD ortamlarında kullanılamaz.
  • Power BI kutucuğu denetimi Çin'de kullanılamaz.
  • Power BI kutucuğu katıştırırken lisans gereksinimleri için bkz. Lisanslama.

Paylaşım ve güvenlik

Power BI içeriği bulunan bir uygulamayı paylaştığınızda, uygulamanın kendisine ek olarak kutucuğun bulunduğu panoyu da paylaşmanız gerekir. Aksi takdirde Power BI içeriği, uygulamayı açan kullanıcılar tarafından bile görüntülenemez. Power BI içeriği olan uygulamalar, o içeriğin izinlerini uygular.

Performans

Uygulamada aynı anda üçten fazla Power BI kutucuğunun yüklenmesi önerilmez. LoadPowerBIContent özelliğini ayarlayarak kutucukların yüklenmelerini veya kaldırılmalarını denetleyebilirsiniz.

Katıştırma Seçenekleri

Power BI API'nin sürümleri arasında katıştırma farklıdır. Yeni Power BI API kimlik doğrulama düzeni nedeniyle, kutucuğunuzun mobil veya diğer katıştırılmış senaryolarda (Teams veya SharePoint) erişilebilir olmayabilir.

AllowNewAPI özelliğini kullanarak API sürümünün kullanımını kontrol edebilirsiniz. Daha fazla bilgi için bkz. Temel özellikler.

AllowNewAPI özellik değeri Davranış
Doğru Ekleme URL'si'ni Power BI'den alıp TileUrl değeri yaparak bir panoyu, raporu veya kutucuğu katıştırabilirsiniz.
Yanlış Ekleme URL'si'nden TileUrl değeri yaparak veya verilen grafik arabirimini kullanarak bir panoyu kutucuğunu katıştırabilirsiniz.

Not

Power BI URL katıştırması (örneğin iFrame), Power Apps mobilde desteklenmez çünkü Power BI URL isteğinin kimlik doğrulanması mobil oyuncut arafından işlenmez.

Filtreleme

Filtre uygulama, Power BI API'nin sürümleri arasında farklılık gösterir. Denetimi nasıl yapılandırdığınıza bağlı olarak aşağıdaki uygun bölümlere bakın.

Power BI hizmetini çağırmak için yeni API'yi kullanırken

AllowNewAPIözelliği "Doğru" olarak ayarlandığında, Power BI hizmetini çağırmak için yeni API'yi kullanıyorsunuz demektir. Daha fazla bilgi için bkz. URL'de sorgu dizesi parametreleri kullanarak bir raporu filtrelemek.

Power BI hizmetini çağırmak için orijinal API'yi kullanırken

AllowNewAPIözelliği "Yanlış" olarak ayarlandığında, Power BI hizmetini çağırmak için orijinal API'yi kullanıyorsunuz demektir. Bu durumda, uygulamadan tek bir parametre geçirerek, bir Power BI kutucuğunda görünen sonuçlara filtre uygulayabilirsiniz. Ancak, tablo adı veya sütun adı boşluklar içeriyorsa, yalnızca dize değerleri ve Eşittir işleci desteklenir ve filtre çalışmayabilir.

Tek bir filtre değerini geçirmek için, şu sözdizimini takip eden TileURL özelliğinin değerini değiştirin:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Bu değere şu söz dizimini ekleyin:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Örneğin, bir liste kutusundan bir değer kullanma:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Parametre, kutucuğun kaynaklandığı raporun veri kümesinde bir değeri filtre edecektir. Ancak, filtre özelliğinin aşağıdaki sınırlamaları vardır:

  • Yalnızca bir filtre uygulanabilir.
  • Yalnızca eq işleci desteklenir.
  • Alan türü dize olmalıdır.
  • Filtre uygulama, yalnızca sabitlenmiş görselleştirme kutucukları üzerinde kullanılabilir. Sabitlenmiş raporlar için desteklenmez.
  • R ve Python betik görselleri filtrelenemez.

Diğer değer türlerini dizeye dönüştürmek veya birden fazla alanı tek bir alan olarak birleştirmek için, Power BI raporundaki hesaplanan alanları kullanabilirsiniz.

Temel özellikler

AllowNewAPI - Power BI hizmetini çağırırken yeni API kullanılıp kullanılmayacağı. Değerin Doğru olarak ayarlanması , yeni Power BI API'sının kullanılmasına olanak tanır (Bu, mobil ve bazı katıştırılmış senaryolarda desteklenmez ancak bazı daha gelişmiş filtreler uygulamaya izin verir). Yanlış değeri orijinal API'yı kullanır. Varsayılan değer yanlış'tır.

Dashboard – Kutucuğun geldiği Power BI panosu.

LoadPowerBIContentDoğru olarak ayarlandığında Power BI içeriği yüklenir ve gösterilir. Yanlış olarak ayarlandığında Power BI içeriği yüklenmez ve belleği serbest bırakarak performansı artırır.

PowerBIInteractions - doğru olarak ayarlandığında , Power BI içerik ile etkileşim yapılabilir ancak Power Apps OnSelect olayı tetiklenemez. Yanlış olarak ayarlandığında, kutucuk ile etkileşim sağlanmayabilir, ancak kutucuk seçildiğinde Power Apps OnSelect olayı tetiklenir.

Tile – Görüntülemek istediğiniz Power BI kutucuğunun adı.

Workspace – Kutucuğun geldiği Power BI çalışma alanı.

Ek özellikler

BorderColor – Denetim kenarlığının rengi.

BorderStyleDüz, Kesik Çizgili, Noktalı veya Hiçbiri değerleriyle Denetimin kenarlık stili.

BorderThickness – Denetimin kenarlık kalınlığı.

DisplayMode: Denetimin kullanıcı girişine izin verip vermediği (Edit), yalnızca veri görüntüleyip görüntülemediği (View) veya devre dışı olup olmadığı (Disabled).

Height – Denetimin üst ve alt kenarları arasındaki uzaklık.

OnSelect: Kullanıcı bir denetimi seçtiğinde gerçekleştirilecek eylemler. Varsayılan olarak kutucukla ilgili Power BI raporu açılır.

TileUrl – Kutucuğun Power BI hizmetinden istendiği URL. URL'nize sorgu dizesi filtresi eklemek için yukarıdaki filtreleme bölümüne bakın.

Visible – Denetimin gizli veya görünür olması.

Width – Denetimin sol ve sağ kenarları arasındaki uzaklık.

X – Denetimin sol kenarı ile ana kapsayıcısının (veya—ana kapsayıcı yoksa ekranın) sol kenarı arasındaki uzaklık.

Y – Denetimin üst kenarı ile ana kapsayıcısının (veya—ana kapsayıcı yoksa ekranın) üst kenarı arasındaki uzaklık.

Örnek

  1. Ekle sekmesinde Grafikler menüsünü açın ve ardından bir Power BI kutucuğu denetimi ekleyin.

    Denetim eklemeyi ve yapılandırmayı bilmiyor musunuz?

  2. Seçenekler panelindeki Veri sekmesinde Workspace ayarı için Çalışma Alanım öğesini seçin.

  3. Pano listesinden bir pano seçin ve ardından kutucuk listesinden bir kutucuk seçin.

    Denetim Power BI kutucuğunu işler.

Erişilebilirlik yönergeleri

Power BI kutucuğu, Power BI içeriği için yalnızca bir kapsayıcıdır. Bu Power BI erişilebilirlik ipuçları ile, erişilebilir içeriklerin nasıl oluşturulduğunu öğrenin.

Power BI içeriğinin başlığı yoksa, ekran okuyucuları desteklemek için Etiket denetimini kullanarak bir başlık eklemeyi düşünün. Etiketi Power BI kutucuğundan hemen önce konumlandırabilirsiniz.

Not

Belge dili tercihlerinizi bizimle paylaşabilir misiniz? Kısa bir ankete katılın. (lütfen bu anketin İngilizce olduğunu unutmayın)

Anket yaklaşık yedi dakika sürecektir. Kişisel veri toplanmaz (gizlilik bildirimi).