Ausblenden oder Anzeigen visueller Kopfzeilen

Power BI-Berichte, die Sie in Apps einbetten, enthalten visuelle Elemente, z. B. Diagramme, Wärmekarten und Messgeräte. Diese Visuals verfügen über Kopfzeilen, die Aktionen für Benutzer 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 Visual verfügt über eine Karte im Abschnitt "Formatierung" des Bereichs "Visualisierungen" namens Visual Header. Sie können diese Karte verwenden, um die Kopfzeile des Visuellen zu aktivieren und zu deaktivieren. Erfahren Sie mehr über visuelle Kopfzeilen in Visual Headern.

Beispiele für Aktionen in visuellen Headern sind:

• Öffnen des visuellen Fokusmodus.
• Bohren sie nach unten oder oben.
• Anzeigen, welche Filter und Datenschnitte derzeit auf das Visuelle angewendet werden.
• Öffnen des Menüs "Optionen" des Visuellen.

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

Diese API bietet eine Möglichkeit zum Ausblenden oder Anzeigen von Kopfzeilen aller Visuellen in einem Bericht oder nur bestimmten. Sie können die Sichtbarkeit zum Laden des Berichts konfigurieren oder die Report-Methode updateSettings aufrufen, um die Sichtbarkeit zu ändern, nachdem ein Bericht geladen wurde, finden Sie zur Laufzeit unter Aktualisieren von Berichtseinstellungen.

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. ein Schaltflächenklick, um eine Kopfzeile auszublenden oder anzuzeigen, nachdem ein Bericht geladen wurde.

Ausblenden oder Anzeigen visueller Kopfzeilen

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

Visuelle Kopfzeileneinstellungen

Mit visuellen Kopfzeilen ist die Sichtbarkeit derzeit die einzige Einstellung, die Sie konfigurieren können. Um Kopfzeilen auszublenden oder anzuzeigen, stellen Sie eine Liste der visuellen Headerkonfigurationsobjekte bereit. Jeder enthält ein Einstellungsobjekt und kann auch einen Auswahlgeber enthalten. Auswahlgeber identifizieren die Visuellen, auf die Sie die Einstellungen anwenden. Erfahren Sie mehr über Auswahloren in Selectors.

Der Typ des Konfigurationsobjekts, das Sie für die API bereitstellen, ist IVisualSettings. Später in diesem Artikel finden Sie Beispiele , die zeigen, wie Sie diese Schnittstelle in Ihrem Code verwenden. Power BI-Modelle listet alle Schnittstellendefinitionen auf, die die Beispiele verwenden.

Beachten Sie folgende Punkte:

• Der Auswahlgeber ist in diesen Einstellungen optional. Wenn Sie keine Auswahlen auflisten, wendet die API Ihre Einstellungen auf alle Visuellen im Bericht an.
• Wenn Sie Auswahlelemente verwenden, können Sie visuelle Elemente entweder nach Namen oder nach Typ angeben. Um die Namen und Typen der Visuellen 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 die API zum Laden anwendet.
• Einstellungen, die Sie der updateSettings API bereitstellen.

Wenn mehr als eine Einstellung auf eine visuelle Anwendung angewendet werden kann, verwendet die API die letzte Einstellung, die angewendet wird. Im nächsten Abschnitt wird dieser Punkt veranschaulicht, wie ein gesamtes visuelles Kopfzeilenbeispiel ausgeblendet wird.

Beispiele

In diesen Beispielen werden verschiedene Möglichkeiten der Verwendung der API gezeigt, um visuelle Kopfzeilen auszublenden oder anzuzeigen.

Alle visuellen Kopfzeilen ausblenden

In diesem einfachen Szenario erhalten Kunden eine saubere Berichtsansicht, indem sie alle visuellen Kopfzeilen in einem Bericht ausblenden:

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 einer bestimmten Visuellen Kopfzeile

In diesem Beispiel wird ein Auswahlgeber verwendet, um eine Sichtbarkeitseinstellung auf ein einzelnes Visuelles anzuwenden. Dieses Szenario kommt auf, wenn Sie Funktionen ausblenden möchten, die für eine visuelle Darstellung 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);

Alle, aber eine visuelle Kopfzeile ausblenden

Verwenden Sie diesen Code, um alle visuellen Kopfzeilen in einem Bericht mit Ausnahme einer bestimmten visuellen Kopfzeile 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 mehrere Kopfzeilen sichtbar machen möchten, können Sie diesen Code erweitern. Richten Sie zusätzliche Instanzen mit IVisualHeader dem Parameter ein, der visible auf true"festgelegt" festgelegt istsettings. Fügen Sie für jede Visuelle, die über eine sichtbare Kopfzeile verfügen soll, eine IVisualHeader Instanz zur Liste hinzu.

Einschränkungen

• Sie können nur die Sichtbarkeit visueller Kopfzeilen steuern, wenn sich der Bericht, den Sie einbetten, 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 Auswahlgeber verwenden, um den Namen oder den Typ eines visuellen Elements anzugeben, verwenden Sie die Page getVisuals-Methode , um den Namen des Visuellen abzurufen, was ein eindeutiger Bezeichner ist. Konfigurieren Sie den Auswahlgeber nicht mit dem Titel des Visuellen.
• 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 View anstelle von Edit oder Savekonfigurieren.

Nächste Schritte

Konfigurieren von Berichteinstellungen

Verwenden von Auswahlgebern zum Steuern, welche Visuellen betroffen sind

get-visuals.md