Power BI görselleri sistem entegrasyonu

Makalede Görsel API ve Power BI'ın, sizin, görselin ve konak arasında etkileşimleri nasıl işlediği açıklanmaktadır.

Power BI'daki eylemler ve sonraki güncelleştirmeler el ile veya otomatik olarak başlatılabilir. Güncelleştirme türleri:

Aşağıdaki şekilde, Power BI'da yer işareti seçme gibi yaygın görsel tabanlı eylemlerin nasıl işlendiği gösterilmektedir.

Power BI görsel işleminin diyagramı.

Power BI aracılığıyla bir görselle etkileşim kurma

Power BI ile bir görseli aşağıdaki gibi güncelleştirebilirsiniz:

  • Görselin özellikler panelini açın.

    Görselin özellikler panelini açtığınızda Power BI, görselin capabilities.json dosyasından desteklenen nesneleri ve özellikleri getirir. Power BI, özelliklerin gerçek değerlerini almak için görselin getFormattingModel yöntemini çağırır (bunun yerine sürüm 5.0'dan önceki API'ler çağırır enumerateObjectInstances ). API modern biçim bölmesi modeli bileşenlerini, özelliklerini ve bunların gerçek değerlerini döndürür.

    Daha fazla bilgi için Power BI görsellerinin yetenekleri ve özellikleri bölümüne bakın.

  • Görselleştirme başlıklarını, arka planları, etiketleri ve açıklamaları özelleştirin.

    Biçim panelinde bir özelliğin değerini değiştirdiğinizde Power BI yöntemini çağırır update . Power BI options yeni nesneyi update yöntemine geçirir ve nesneler yeni değerleri içerir.

    Daha fazla bilgi için bkz . Power BI görsellerinin nesneleri ve özellikleri.

  • Görseli yeniden boyutlandırın.

    Görselin boyutunu değiştirdiğinizde Power BI yöntemini çağırır update ve yeni options nesneyi geçirir. options nesneleri, görselin yeni genişliği ve yüksekliğini içeren iç içe geçmiş viewport nesneler barındırır.

  • Rapor, sayfa veya görsel düzeyinde filtre uygulama.

    Power BI, filtre koşullarına göre verileri filtreler. Power BI, görseli yeni verilerle güncellemek için görselin update metodunu çağırır.

    Görsel, iç içe nesnelerden birinde yeni veriler olduğunda options nesnelerinin yeni bir güncellemesini alır. Güncelleştirmenin nasıl gerçekleştiği, görselin veri görünümü eşleme yapılandırmasına bağlıdır.

    Daha fazla bilgi için Power BI görsellerinde veri görünümü eşlemesini anlama kısmına bakınız.

  • Rapordaki başka bir görselde bir veri noktası seçin.

    Rapordaki başka bir görselde bir veri noktası seçtiğinizde Power BI seçilen veri noktalarını filtreler veya vurgular ve görselin update yöntemini çağırır. Görsel yeni filtrelenmiş veriler alır veya bir dizi vurguyla aynı verileri alır.

    Daha fazla bilgi için bkz . Power BI Görsellerinde veri noktalarını vurgulama.

  • Raporun Yer İşaretleri panelinde bir yer işareti seçin.

    Yer İşaretleri panelinde bir yer işareti seçtiğinizde, ya:

    • Power BI, registerOnSelectionCallback yöntemi tarafından geçirilen ve kaydedilen bir işlevi çağırır. Geri çağırma işlevi, ilgili yer işareti için seçim dizilerini alır.

    • Power BI, options nesnesinin içindeki update yöntemini, karşılık gelen bir filter nesnesiyle çağırır.

      Her iki durumda da görsel, alınan seçimlere veya filter nesneye göre durumunu değiştirir.

      Yer işaretleri ve filtreler hakkında daha fazla bilgi için Power BI görsellerinde Görsel Filtreler API'si'ne bkz.

Görselle doğrudan etkileşim kurma

Ayrıca, güncelleştirmek için görselle doğrudan etkileşim kurabilirsiniz:

  • Farenizi bir veri öğesinin üzerine getirin.

    Görsel, Power BI Araç İpuçları API'sini kullanarak bir veri noktası hakkında daha fazla bilgi görüntüleyebilir. Bir görsel öğesinin üzerine geldiğinizde, görsel olayı işleyebilir ve ilişkili araç ipucu öğesi hakkındaki verileri görüntüleyebilir. Görsel standart bir araç ipucu veya rapor sayfası araç ipucu görüntüleyebilir.

    Daha fazla bilgi için bkz . Power BI görsellerinize araç ipuçları ekleme.

  • Görselin özelliklerini değiştirin (örneğin, bir ağacı genişleterek) ve görsel, yeni durumu özelliklerine kaydeder.

    Görsel, Power BI API'sini kullanarak özellik değerlerini kaydedebilir. Örneğin, görselle etkileşime geçtiğinizde ve görselin özellik değerlerini kaydetmesi veya güncellemesi gerektiğinde, görsel persistProperties yöntemini çağırabilir.

  • Bir URL seçin.

    Varsayılan olarak, görsel bir URL'yi doğrudan açamaz. Bir URL'yi yeni bir sekmede açmak için, launchUrl metodunu çağırabilir ve URL'yi parametre olarak geçirebilir.

    Daha fazla bilgi için bkz . Başlatma URL'si oluşturma.

  • Görselde filtre uygulama.

    Görsellerden biri applyJsonFilter yöntemini çağırarak, diğer görsellerdeki verileri filtrelemek için koşulları iletebilir. Temel, Gelişmiş ve Küme filtreleri de dahil olmak üzere çeşitli filtre türleri mevcuttur.

    Daha fazla bilgi için bkz . Power BI görsellerinde Görsel Filtreler API'si.

  • Görseldeki öğeleri seçin.

    Power BI görselindeki seçimler hakkında daha fazla bilgi için bkz . Power BI görsel seçimleriyle görsele etkileşim ekleme.

Görsel Power BI ile etkileşim kurar

Bazen görsel, sizden herhangi bir giriş yapmadan Power BI konağıyla iletişim başlatır:

  • Görsel, Power BI'dan daha fazla veri istemektedir.

    Bir görsel, verileri parça parça işler. fetchMoreData API yöntemi, semantik modelde bir sonraki veri parçasını ister.

    Daha fazla bilgi için bkz . Power BI'dan daha fazla veri getirme.

  • Hizmet olayı tetikler.

    Power BI bir raporu PDF'ye aktarabilir veya e-postayla rapor gönderebilir (yalnızca sertifikalı görseller için geçerlidir). Power BI'a işlemenin tamamlandığını ve görselin PDF veya e-posta olarak yakalanmaya hazır olduğunu bildirmek için görselin İşleme Olayları API'sini çağırması gerekir.

    Daha fazla bilgi için bkz . Raporları Power BI'dan PDF'ye aktarma.

    Olay hizmeti hakkında bilgi edinmek için bkz. "İşleme" olayları Power BI görsellerinde.

İlgili içerik

Görselleştirmeler oluşturmak ve bunları Microsoft AppSource'a eklemek istiyor musunuz? Şu makalelere bakın:

  • Last updated on