Showcase "Berichtsansichten erfassen"
Power BI-Berichtsmarken erfassen den aktuellen Zustand einer eingebetteten Berichtsseite, einschließlich des Zustands ihrer Visuals und aller Slicing- oder Filtervorgänge. Benutzer können den Bericht in diesen Zustand zurückgeben, indem sie auf das erfasste oder freigegebene Lesezeichen zugreifen. Sie können die Power BI-Client-APIs verwenden, um Lesezeichenansichten mit Berichten zu speichern und Berichtsbenutzern das Erfassen und Freigeben eigener Lesezeichen zu ermöglichen.
In der Präsentation "Berichtsansichten erfassen " in der Eingebetteten Analyse in Power BI wird die Lesezeichen-API verwendet, um Benutzern den Zugriff auf Lesezeichen, das Erfassen, Speichern und Freigeben von Lesezeichen zu ermöglichen.
Benutzer haben folgende Möglichkeiten:
- Siehe Als Teil des Berichts gespeicherte Lesezeichenansichten.
- Verwenden Sie Filter, Datenschnitte und andere Steuerelemente, um eine benutzerdefinierte Berichtsansicht zu erstellen.
- Erfassen Sie die aktuelle Ansicht, indem Sie ein Lesezeichen speichern.
- Teilen Sie die erfasste Ansicht mit anderen, indem Sie ihnen einen Link senden.
- Kehren Sie zu lesezeichenbasierten Ansichten zurück, die sie während der aktuellen Anzeigesitzung erstellt haben.
Erfassen von Berichtsansichten
Im Showcase "Aufzeichnungsberichtsansichten " zeigt ein imaginäres Konglomerat namens Contoso seine Leistungsdaten in einem eingebetteten Power BI-Bericht an. Der Bericht verwendet eine Q&A, zwei Mehrzeilenkarten, eine Matrix und Spaltendiagramme, um Daten aus dem Jahr 2014 für alle Hersteller, Produkte und Regionen anzuzeigen. Die Visuals verfügen über Filter- und Slicersteuerelemente, sodass Benutzer Teile der Daten eingrenzen und anzeigen können.
Konfigurieren einer Ansicht
Ein Sales Manager in der Region West wählt West aus, um nur Die Daten der Region West anzuzeigen, und verwendet den Datumsschieberegler, um den Zeitrahmen auf die zweite Jahreshälfte einzugrenzen.
Der Sales Manager kann die konfigurierte Ansicht speichern oder freigeben, indem er Die Ansicht erfassen auswählt. Ein Popupdialogfeld bietet die Option In "Meine Ansichten" speichern oder Link kopieren.
Speichern eines Lesezeichens
Um ein Lesezeichen zu speichern, wählt der Vertriebsmanager In "Meine Ansichten" speichern aus, gibt einen Namen für die Ansicht ein und wählt Speichern aus.
Das Dialogfeld wird geschlossen, und es wird ein Bereich mit der Liste gespeicherter Lesezeichen angezeigt, in dem das neue gespeicherte Lesezeichen hervorgehoben ist. Wenn Sie ein Lesezeichen in der Liste auswählen, wird das Lesezeichen hervorgehoben und diese Ansicht angezeigt. Wenn Sie das Schließen-Symbol oder die Schaltfläche Gespeicherte Ansichten auswählen, wird der Bereich Lesezeichen geschlossen.
Freigeben eines Lesezeichens
Um einen Link zu der Ansicht abzurufen, die an Projektbeteiligte gesendet werden soll, wählt der Vertriebsmanager im Dialogfeld ErfassungsansichtLink kopieren und dann Kopieren aus, um den Link zu kopieren. Wenn Sie das Schließen-Symbol auswählen oder eine beliebige Stelle außerhalb des Dialogfelds auswählen, wird es geschlossen.
Anzeigen einer Mit Lesezeichen versehenen Ansicht
Um während der aktuellen Berichtsanzeigesitzung zu einer beliebigen gespeicherten Lesezeichenansicht zu wechseln, können Benutzer gespeicherte Ansichten auswählen, um die Lesezeichenliste aufzulisten, und die Ansicht auswählen, die sie anzeigen möchten. Der Lesezeichenname hebt hervor, und der Bericht zeigt die Mit Lesezeichen versehene Ansicht an.
Lesezeichen, die Sie bei der Berichtserstellung speichern, sind für alle Benutzer in allen Sitzungen verfügbar. Sie können auch vom Benutzer erstellte Lesezeichen zwischen Sitzungen speichern, aber in diesem Showcase sind Lesezeichen, die Benutzer erstellen, nur während derselben Anzeigesitzung oder über eine direkte URL verfügbar.
Empfänger von freigegebenen Lesezeichenlinks können die Links in ihren Browsern verwenden, um Berichte direkt für die mit Lesezeichen versehenen Ansichten zu öffnen.
Erfassen von Berichtsansichten– Showcasecode
Der Code für die Implementierung des Showcases befindet sich im GitHub-Repository PowerBI-Embedded-Showcases .
Der HTML-Code der Anwendung erstellt den Berichtscontainer und die Elemente, die Schaltfläche " Gespeicherte Ansichten " und die Dropdownliste sowie die Schaltfläche und das Dialogfeld "Ansicht erfassen ".
Der Bericht JavaScript bettet den Bericht mit einer gespeicherten Liste von Lesezeichen ein, lädt den Bericht mit der ersten aktivierten Lesezeichenansicht "All Year 2014 " und implementiert die Lesezeichenerfassungs-, Speicher-, Freigabe- und Auswahlfunktionen.
Wendet in der BookmarksManager-Klasseapply
des Berichts ein zuvor gespeichertes Lesezeichen nach Name an, capture
erfasst und gibt eine Zeichenfolge zurück, die den aktuellen Zustand des Berichts darstellt, und applyState
wendet einen zuvor erfassten Zustand an. Beim Anwenden eines gespeicherten Lesezeichens können Sie das Lesezeichen entweder durch name
oder durch state
angeben.
Weitere Informationen zu Lesezeichenvorgängen und APIs finden Sie unter Berichtsmarken.
Anwenden einer Lesezeichenansicht auf das Laden des Berichts
Der Showcase-Code decodiert den Lesezeichennamen aus dem Argument ansichts-URL id
und ruft dieses Lesezeichen aus dem lokalen Speicher ab. Das Showcase verwendet aus Gründen der Einfachheit den lokalen Speicher, aber Sie können eine beliebige Datenbank verwenden. Das bookmark
Attribut im Bericht embedConfiguration
wendet das Lesezeichen beim Laden an.
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
}
};
Erfassen einer Ansicht und Speichern in der Lesezeichenliste
Der Showcasecode erfasst den aktuellen Berichtsstatus, fügt den neuen Lesezeichennamen zur Lesezeichenliste hinzu und öffnet die Dropdownliste lesezeichen mit dem neuen Lesezeichen.
// 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));
Anzeigen einer ausgewählten Ansicht aus der Lesezeichenliste
Dieser Code legt ein ausgewähltes Lesezeichen als aktiv fest, hebt es in der Lesezeichenliste hervor und wendet den aktiven Status an.
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);
}