Freigeben über

Ausblenden oder Anzeigen visueller Kopfzeilen

  • Artikel

Power BI-Berichte, die Sie in Apps einbetten, enthalten visuelle Elemente wie Diagramme, Wärmekarten und Messgeräte. Diese visuellen Elemente verfügen über Kopfzeilen, die Benutzern Aktionen zur Verfügung stellen. Wenn Sie Power BI verwenden, können Sie die Kopfzeile der einzelnen visuellen Elemente in einem Bericht ausblenden oder anzeigen. Jedes visuelle Element verfügt über eine Karte im Abschnitt Formatierung des Bereichs Visualisierungen Bereich visuelle Kopfzeile. Sie können diese Karte verwenden, um die Kopfzeile des visuellen Elements zu aktivieren und zu deaktivieren. Erfahren Sie mehr über visuelle Kopfzeilen in visuellen Kopfzeilen.

Beispiele für Aktionen in visuellen Kopfzeilen sind:

  • Öffnen des visuellen Elements im Fokusmodus.
  • Drilldown oder Nach oben.
  • Anzeigen, welche Filter und Datenschnitte derzeit auf das visuelle Element angewendet werden.
  • Öffnen des Menüs "Optionen" des visuellen Elements.

Manchmal ist es hilfreich, diese Aktionen auszublenden. Wenn sich beispielsweise zwei visuelle Elemente überlappen, möchten Sie möglicherweise nicht beide Visuellen Kopfzeilen anzeigen.

Diese API bietet eine Möglichkeit, Kopfzeilen aller visuellen Elemente in einem Bericht oder nur bestimmte auszublenden oder anzuzeigen. Sie können die Sichtbarkeit beim Laden des Berichts konfigurieren oder die Report updateSettings-Methode aufrufen, um die Sichtbarkeit nach dem Laden eines Berichts zu ändern, siehe Aktualisieren von Berichtseinstellungen zur Laufzeit.

Sie können die API in vielen Szenarien verwenden, einschließlich der folgenden Anwendungsfälle:

  • Blenden Sie nur einige der visuellen Kopfzeilen in einem Bericht aus.
  • Verwenden Sie Geschäftslogik in einer App, z. B. einen Klick auf eine Schaltfläche, um eine Kopfzeile auszublenden oder anzuzeigen, nachdem ein Bericht geladen wurde.

So blenden Sie visuelle Kopfzeilen aus oder zeigen sie an

Um visuelle Header in der API auszublenden oder anzuzeigen, konfigurieren Sie bestimmte Parameter in den Einstellungen eines Berichts. Allgemeine Informationen zum Konfigurieren von Optionen in eingebetteten Berichten finden Sie unter Konfigurieren von Berichtseinstellungen.

Visuelle Kopfzeileneinstellungen

Bei visuellen Kopfzeilen ist die Sichtbarkeit derzeit die einzige Einstellung, die Sie konfigurieren können. Zum Ausblenden oder Anzeigen von Kopfzeilen stellen Sie eine Liste visueller Headerkonfigurationsobjekte bereit. Jeder enthält ein Einstellungsobjekt und kann auch eine Auswahl enthalten. Selektoren die visuellen Elemente identifizieren, auf die Sie die Einstellungen anwenden. Erfahren Sie mehr über Selektoren in Selectors.

Der Typ des Konfigurationsobjekts, das Sie der API bereitstellen, ist IVisualSettings. Später in diesem Artikel finden Sie Beispiele, die die Verwendung dieser Schnittstelle in Ihrem Code veranschaulichen. Power BI-Modelle listet alle Schnittstellendefinitionen auf, die in den Beispielen verwendet werden.

Beachten Sie die folgenden Punkte:

  • Die Auswahl ist in diesen Einstellungen optional. Wenn Sie keine Selektoren auflisten, wendet die API Ihre Einstellungen auf alle visuellen Elemente im Bericht an.
  • Wenn Sie Selektoren verwenden, können Sie visuelle Elemente entweder anhand des Namens oder des Typs angeben. Um die Namen und Typen der visuellen Elemente auf einer bestimmten Seite abzurufen, verwenden Sie die Page-getVisuals--Methode.

Rangfolgeregeln

Die API wendet Konfigurationseinstellungen in der folgenden Reihenfolge an:

  • Einstellungen, die im Bericht gespeichert werden.
  • Einstellungen, die Sie im Einbettungskonfigurationsobjekt definieren, das von der API beim Laden angewendet wird.
  • Einstellungen, die Sie für die updateSettings-API bereitstellen.

Wenn mehrere Einstellungen auf ein visuelles Element angewendet werden können, verwendet die API die letzte angewendete Einstellung. Das Ausblenden aller visuellen Kopfzeilen Beispiel im nächsten Abschnitt veranschaulicht diesen Punkt.

Beispiele

In diesen Beispielen werden verschiedene Möglichkeiten der Verwendung der API zum Ausblenden oder Anzeigen visueller Header gezeigt.

Ausblenden aller visuellen Kopfzeilen

Dieses einfache Szenario bietet Kunden eine übersichtliche Berichtsansicht, indem alle visuellen Kopfzeilen in einem Bericht ausgeblendet werden:

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);

Ausblenden der Kopfzeile eines bestimmten visuellen Elements

In diesem Beispiel wird eine Auswahl verwendet, um eine Sichtbarkeitseinstellung auf ein einzelnes visuelles Element anzuwenden. Dieses Szenario tritt auf, wenn Sie Funktionen ausblenden möchten, die für ein visuelles Element nicht sinnvoll sind. Verwenden Sie diesen Code in diesem Fall:

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);

Ausblenden aller visuellen Kopfzeilen

Verwenden Sie diesen Code, um alle visuellen Kopfzeilen in einem Bericht mit Ausnahme der Kopfzeile eines bestimmten visuellen Elements auszublenden:

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);

Wenn Sie mehr als eine Kopfzeile sichtbar machen möchten, können Sie diesen Code erweitern. Richten Sie zusätzliche Instanzen von IVisualHeader ein, wobei der Parameter visible in settings auf truefestgelegt ist. Fügen Sie für jedes visuelle Element, das über eine sichtbare Kopfzeile verfügen soll, eine IVisualHeader Instanz zur Liste hinzu.

Überlegungen und Einschränkungen

  • Sie können die Sichtbarkeit visueller Kopfzeilen nur steuern, wenn sich der eingebettete Bericht im Ansichtsmodus befindet.
  • Sie können nur die gesamte Kopfzeile eines visuellen Elements ausblenden oder anzeigen. Sie können die Sichtbarkeit bestimmter Elemente im Kopfzeilenmenü nicht konfigurieren.
  • Wenn Sie einen Selektor verwenden, um den Namen oder Typ eines visuellen Elements anzugeben, verwenden Sie die Page getVisuals Methode, um den Namen des visuellen Elements abzurufen, bei dem es sich um einen eindeutigen Bezeichner handelt. Konfigurieren Sie die Auswahl nicht mit dem Titel des visuellen Elements.
  • Wenn ein Benutzer einen Bericht speichert, den Sie mit der API einbetten, werden die von Ihnen definierten visuellen Einstellungen im Bericht gespeichert. Sie können diese Situation vermeiden, indem Sie den Bericht mit einer Berechtigungsstufe von View anstelle von Edit oder Savekonfigurieren.

Verwandte Inhalte