Aracılığıyla paylaş

Görsel üst bilgileri gizleme veya gösterme

Uygulamalara eklediğiniz Power BI raporları grafikler, ısı haritaları ve ölçerler gibi görseller içerir. Bu görseller, eylemleri kullanıcıların kullanımına sağlayan üst bilgiler içeriyor. Power BI'ı kullandığınızda, rapordaki her görselin üst bilgisini gizleyebilir veya gösterebilirsiniz. Her görselin Görselleştirmeler bölmesinin Biçimlendirme bölümünde Görsel üst bilgisiadlı bir kart bulunur. Görselin üst bilgisini açmak ve kapatmak için bu kartı kullanabilirsiniz. Görsel üst bilgilerigörsel üst bilgileri hakkında daha fazla bilgi edinin.

Görsel üst bilgilerdeki eylemlere örnek olarak şunlar verilebilir:

  • Görseli odak modunda açma.
  • Detaya gitme veya yukarı gitme.
  • Görsele şu anda hangi filtrelerin ve dilimleyicilerin uygulandığını görüntüleme.
  • Görselin seçenekler menüsü açılır.

Bazen bu eylemleri gizlemek yararlı olabilir. Örneğin, iki görsel çakıştığında, her iki görselin üst bilgilerini de görüntülemek istemeyebilirsiniz.

Bu API, bir rapordaki tüm görsellerin veya yalnızca belirli görsellerin üst bilgilerini gizlemenin veya göstermenin bir yolunu sağlar. Rapor yükünde görünürlüğü yapılandırabilir veya rapor yüklendikten sonra görünürlüğü değiştirmek için Rapor updateSettings yöntemini çağırabilirsiniz. bkz. Çalışma zamanında rapor ayarlarını güncelleştirme.

API'yi aşağıdaki kullanım örnekleri dahil olmak üzere birçok senaryoda kullanabilirsiniz:

  • Rapordaki görsel üst bilgilerden yalnızca bazılarını gizleyin.
  • Bir rapor yüklendikten sonra üst bilgiyi gizlemek veya göstermek için bir uygulamada düğme tıklaması gibi iş mantığını kullanın.

Görsel üst bilgileri gizleme veya gösterme

API'de görsel üst bilgileri gizlemek veya göstermek için, raporun ayarlarında belirli parametreleri yapılandırabilirsiniz. Katıştırılmış raporlarda seçenekleri yapılandırma hakkında genel bilgi için bkz. Rapor ayarlarını yapılandırma.

Görsel üst bilgi ayarları

Görsel üst bilgilerle, şu anda yapılandırabileceğiniz tek ayar görünürlüktir. Üst bilgileri gizlemek veya görüntülemek için görsel üst bilgi yapılandırma nesnelerinin listesini sağlarsınız. Her biri bir ayarlar nesnesi içerir ve bir seçici de içerebilir. Seçiciler ayarları uyguladığınız görselleri tanımlar. Seçiciler'nde seçiciler hakkında daha fazla bilgi edinin.

API'ye sağladığınız yapılandırma nesnesinin türü IVisualSettings' dir. Bu makalenin devamında, kodunuzda bu arabirimin nasıl kullanılacağını gösteren örnekler bulacaksınız. Power BI modelleri örneklerin kullandığı tüm arabirim tanımlarını listeler.

Aşağıdaki noktaları not edin:

  • Seçici bu ayarlarda isteğe bağlıdır. Hiçbir seçiciyi listelemediğinizde, API ayarlarınızı rapordaki tüm görsellere uygular.
  • Seçicileri kullandığınızda, görselleri ada veya türe göre belirtebilirsiniz. Belirli bir sayfadaki görsellerin adlarını ve türlerini almak için Page getVisuals yöntemini kullanın.

Öncelik kuralları

API, yapılandırma ayarlarını aşağıdaki sırayla uygular:

  • Rapora kaydedilen ayarlar.
  • API'nin yükte geçerli olduğu ekleme yapılandırma nesnesinde tanımladığınız ayarlar.
  • updateSettings API'sine sağladığınız ayarlar.

Bir görsele birden fazla ayar uygulanabiliyorsa, API geçerli olan son ayarı kullanır. Sonraki bölümdeki tek bir görsel üst bilgi dışında tümünü gizle bu nokta gösterilmektedir.

Örnekler

Bu örnekler, görsel üst bilgileri gizlemek veya göstermek için API'yi kullanmanın farklı yollarını gösterir.

Tüm görsel üst bilgileri gizle

Bu basit senaryo, müşterilere bir rapordaki tüm görsel üst bilgileri gizleyerek temiz bir rapor görünümü sağlar:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Belirli bir görselin üst bilgisini gizleme

Bu örnekte tek bir görsele görünürlük ayarı uygulamak için bir seçici kullanılır. Bu senaryo, görsel için anlamlı olmayan işlevleri gizlemek istediğinizde ortaya çıkar. Bu durumda şu kodu kullanın:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual>  // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Tek bir görsel üst bilgi dışında tümünü gizleme

Belirli bir görselin üst bilgisi dışında bir rapordaki tüm görsel üst bilgilerini gizlemek için bu kodu kullanın:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                },
                {
                    settings: {
                        visible: true
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Birden fazla üst bilginin görünür olmasını istiyorsanız, bu kodu genişletebilirsiniz. IVisualHeader içindeki visible parametresiyle ek settings örneklerini trueolarak ayarlayın. Görünür üst bilgisi olması gereken her görsel için listeye bir IVisualHeader örneği ekleyin.

Dikkat edilmesi gerekenler ve sınırlamalar

  • Görsel üst bilgilerinin görünürlüğünü yalnızca eklediğiniz rapor görüntüleme modundaysa denetleyebilirsiniz.
  • Yalnızca görselin üst bilgisinin tamamını gizleyebilir veya gösterebilirsiniz. Üst bilgi menüsünde belirli öğelerin görünürlüğünü yapılandıramazsınız.
  • Görselin adını veya türünü belirtmek için seçici kullandığınızda, görselin adını (benzersiz bir tanımlayıcı) almak için Page getVisuals yöntemini kullanın. Seçiciyi görselin başlığıyla yapılandırmayın.
  • Kullanıcı, API ile eklediğiniz bir raporu kaydederse, tanımladığınız görsel ayarları rapora kaydedilir. Raporu View veya Edityerine Save izin düzeyiyle yapılandırarak bu durumdan kaçınabilirsiniz.

İlgili içerik

  • Last updated on