Rapor görünümlerini yakalama vitrini

Power BI rapor yer işaretlerini görsellerinin durumu ve dilimleme veya filtreleme dahil olmak üzere eklenmiş rapor sayfasının geçerli durumunu yakalar. Kullanıcılar yakalanan veya paylaşılan yer işaretine erişerek raporu bu duruma döndürebilir. Power BI İstemci API'lerini kullanarak raporlarla yer işaretli görünümleri kaydedebilir ve rapor kullanıcılarının kendi yer işaretlerini yakalayıp paylaşmasına izin vekleyebilirsiniz.

Yakalama raporu görünümleri, Power BI tümleşik analiz oyun alanında vitrini yer işaretleri API'sini kullanarak kullanıcıların yer işaretlerine erişmesini, yer işaretlerini yakalamasını, kaydetmesini ve paylaşmasını sağlar.

Kullanıcılar:

  • Raporun parçası olarak kaydedilen yer işaretli görünümlere bakın.
  • Özelleştirilmiş rapor görünümü oluşturmak için filtreleri, dilimleyicileri ve diğer denetimleri kullanın.
  • Yer işaretini kaydederek geçerli görünümü yakalayın.
  • Yakalanan görünümü bir bağlantı göndererek başkalarıyla paylaşın.
  • Geçerli görüntüleme oturumu sırasında oluşturdukları yer işaretli görünümlere geri dönün.

Rapor görünümlerini yakalama vitrini deneyimi

Yakalama raporu görünümlerinde contoso adlı hayali bir şirket, performans verilerini Power BI tümleşik raporunda gösterir. Rapor, tüm üreticileri, ürünleri ve bölgeleri için 2014 verilerini göstermek için Q&A, iki çok yerli kart, matris ve sütun grafik kullanır. Görsellerde filtre ve dilimleyici denetimleri olduğundan kullanıcılar verilerin bölümlerini daraltabilir ve görüntüleyebilir.

Görünümü yapılandırma

Batı bölgesindeki Sales Manager, yalnızca Batı bölgesi verilerini görüntülemek için Batı seçer ve zaman çerçevesini yılın ikinci yarısına daraltmak için tarih kaydırıcısını kullanır.

Rapor görünümlerini yakala vitrinindeki görselleştirmeleri ve denetimleri gösteren ekran görüntüsü.

Sales Manager,Yakalama görünümü seçerek yapılandırılmış görünümü kaydedebilir veya paylaşabilir. Açılan iletişim kutusu, 'Görünümlerim' kaydet'e veya bağlantıyı kopyalaseçeneği sunar.

Yakalama görünümü iletişim kutusunu gösteren ekran görüntüsü.

Yer işaretini kaydetme

Yer işaretini kaydetmek için Sales Manager 'Görünümlerim'Kaydet'i seçer, görünüm için bir ad girer veKaydet seçer.

İletişim kutusu kapatılır ve kaydedilen yer işaretleri listesini gösteren ve yeni kaydedilen yer işaretinin vurgulandığı bir panel görüntülenir. Listede yer işareti seçildiğinde yer işareti vurgulanır ve bu görünüm görüntülenir. Kapat simgesinin veya Kaydedilen görünümler düğmesinin seçilmesi yer işaretleri panelini kapatır.

Yeni oluşturulan görünümün seçili olduğu yer işaretleri listesini gösteren ekran görüntüsü.

Yer işareti paylaşma

Paydaşlara gönderilecek görünümün bağlantısını almak için Sales Manager, Yakalama görünümü iletişim kutusunda Bağlantıyı Kopyala seçer ve ardından bağlantıyı kopyalamak için Kopyala seçer. Kapat simgesinin seçilmesi veya iletişim kutusunun dışında herhangi bir yerde seçilmesi, simgeyi kapatır.

Geçerli görünümün bağlantısını içeren Bağlantıyı Kopyala iletişim kutusunu gösteren ekran görüntüsü.

Yer işareti uygulanmış görünüme bakın

Geçerli rapor görüntüleme oturumu sırasında kaydedilmiş herhangi bir yer işareti görünümüne gitmek için, kullanıcılar Kaydedilmiş görünümler seçerek yer işareti listesini açabilir ve görmek istedikleri görünümü seçebilir. Yer işareti adı vurgulanır ve rapor yer işaretli görünümü görüntüler.

Rapor oluşturma işleminde kaydettiğiniz yer işaretleri tüm oturumlardaki tüm kullanıcılar için kullanılabilir. Oturumlar arasında kullanıcı tarafından oluşturulan yer işaretlerini de kaydedebilirsiniz, ancak bu vitrinde kullanıcıların oluşturduğu yer işaretleri yalnızca aynı görüntüleme oturumu sırasında veya doğrudan URL ile kullanılabilir.

Paylaşılan yer işareti bağlantılarının alıcıları, tarayıcılarındaki bağlantıları kullanarak raporları doğrudan yer işaretli görünümlere açabilir.

Rapor görünümlerini yakalama vitrini kodu

Vitrini uygulamaya yönelik kod, PowerBI-Embedded-Showcases GitHub deposundadır.

  • Uygulama HTML kodu rapor kapsayıcısını ve öğelerini, Kaydedilmiş görünümler düğmesini ve açılan listesini ve Yakalama görünümü düğmesini ve iletişim kutusunu oluşturur.

  • raporu JavaScript raporu kaydedilmiş yer işaretleri listesiyle ekler, raporu ilk, Tüm Yıl 2014 yer işaretli görünümü etkin olarak yükler ve yer işareti yakalama, kaydetme, paylaşma ve seçim işlevlerini uygular.

BookmarksManager sınıfı raporda, önceden kaydedilmiş bir yer işaretini ada göre uygular, raporun geçerli durumunu temsil eden bir dize yakalar ve döndürür ve daha önce yakalanan bir durumu uygular. Kaydedilmiş bir yer işareti uygularken, yer işaretini name veya statebelirtebilirsiniz.

Yer işareti işlemleri ve API'ler hakkında daha fazla bilgi için bkz. Rapor yer işaretleri.

Rapor yüküne yer işareti uygulanmış görünüm uygulama

Vitrin kodu, görünüm URL'si id bağımsız değişkeninden yer işareti adının kodunu çözer ve bu yer işaretini yerel depolama alanından alır. Vitrin, kolaylık sağlamak için yerel depolamayı kullanır, ancak herhangi bir veritabanını kullanabilirsiniz. Rapordaki bookmark özniteliği embedConfiguration yükte yer işaretini uygular.

async function embedSharedBookmarkReport() {
    ...
    // Get the bookmark name from url param
    let bookmarkName = getBookmarkNameFromURL();

    // Get the bookmark state from local storage
    let bookmarkState = localStorage.getItem(bookmarkName);

    // Embed configuration used to describe the what and how to embed
    let config = {
        ...
        // Adding bookmark attribute will apply the bookmark on load
        bookmark: {
            state: bookmarkState
        }
    };

Görünümü yakalayın ve yer işaretleri listesine kaydedin

Vitrin kodu geçerli rapor durumunu yakalar, yeni yer işareti adını yer işareti listesine ekler ve yeni yer işaretinin etkin olduğu açılan yer işareti listesini açar.

        // Capture the report's current state with personalized visuals
        const capturedBookmark = await bookmarkShowcaseState.report.bookmarksManager.capture({ personalizeVisuals: true });

        // Build bookmark element
        let bookmark = {
            name: "bookmark_" + bookmarkShowcaseState.bookmarkCounter,
            displayName: capturedViewname,
            state: capturedBookmark.state
        }

        // Add the new bookmark to the HTML list
        bookmarksList.append(buildBookmarkElement(bookmark));

        // Open the bookmarks list div and show the applied bookmark
        bookmarksList.addClass("show position");

        bookmarksDropdown.addClass(displayClass);
        ...

        // Set the captured bookmark as active
        const newBookmark = "bookmark_" + bookmarkShowcaseState.bookmarkCounter;
        setBookmarkActive($(newBookmark));

Yer işareti listesinden seçili görünümü gösterme

Bu kod seçili yer işaretini etkin olarak ayarlar, yer işareti listesinde vurgular ve etkin durumu uygular.

function onBookmarkClicked(element) {

    // Set the clicked bookmark as active
    setBookmarkActive($(element));

    // Apply respective color to the label of the bookmark
    applyColor(element.id);

    // Get bookmark ID from HTML
    const bookmarkId = $(element).attr("id");

    // Find the bookmark in the bookmarks array
    let currentBookmark = getBookmarkByID(bookmarkId);

    // Apply the bookmark state
    bookmarkShowcaseState.report.bookmarksManager.applyState(currentBookmark.state);
}

İlgili içerik

  • Last updated on