Freigeben über

Erstellen, Bearbeiten und Speichern eines eingebetteten Berichts

  • Artikel

Mit eingebetteten Power BI-Analysen können Sie eingebettete Berichte erstellen, bearbeiten und speichern. Ein Bericht kann basierend auf einem vorhandenen Dataset erstellt werden, oder Sie können einen vorhandenen Bericht bearbeiten. Sie können den Bericht auch speichern, nachdem er erstellt oder bearbeitet wurde.

Erstellen eines Berichts

Erfahren Sie, wie Sie einen neuen, leeren Bericht aus einem vorhandenen Dataset erstellen.

Erforderliche Zugriffstokenberechtigungen zum Erstellen eines Berichts

Generieren Sie ein Einbettungstoken mit Zugriff auf das Dataset. Wenn Sie die Masterbenutzer- Authentifizierungsmethode verwenden, stellen Sie sicher, dass Ihre Anwendung über die folgenden Bereiche verfügt: Dataset.Read.All, Content.Createund Workspaces.ReadWrite.all. Weitere Informationen finden Sie unter Embed Token – Generate Token.

Erforderliche clientseitige Berechtigungen zum Erstellen eines Berichts

Zum Erstellen eines Berichts sind die folgenden clientseitigen Berechtigungen erforderlich:

  • Erstellen von – Benutzer können einen neuen Bericht erstellen.

  • Alle – Benutzer können eine Kopie des Berichts erstellen, anzeigen, bearbeiten, speichern und speichern.

Erstellen eines neuen Berichts

Erstellen Sie einen neuen, leeren Bericht aus einem vorhandenen Dataset. Sie benötigen eine Dataset-ID und die Einbettungs-URL. Sie können z. B. die getDatasetsInGroup REST-API verwenden und die CreateReportEmbedURLabrufen. Weitere Informationen finden Sie unter Datasets – Abrufen von Datasets in Gruppen-.

Anmerkung

Sie müssen über Build- oder Schreibberechtigungen für das Dataset verfügen, um einen neuen Bericht zu erstellen.

let embedCreateConfiguration = {
    tokenType: tokenType,
    accessToken: accessToken,
    embedUrl: embedURL,
    datasetId: datasetId,
    settings: settings,
    theme: theme, // optional
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Create report
let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Sie haben auch die Möglichkeit, einen Bericht mit einem darauf angewendeten Design zu erstellen. Neue visuelle Elemente, die dem Bericht hinzugefügt werden, respektieren den Designstil. Weitere Informationen finden Sie unter Anwenden von Berichtsdesigns.

So bearbeiten Sie einen Bericht

Erfahren Sie, wie Sie einen vorhandenen Bericht bearbeiten und zwischen Ansichts- und Bearbeitungsmodi wechseln.

Erforderliche Zugriffstokenberechtigungen zum Bearbeiten

Generieren Sie ein Einbettungstoken mit Zugriff auf den Bericht. Wenn Sie die Masterbenutzer- Authentifizierungsmethode verwenden, stellen Sie sicher, dass Ihre Anwendung über die folgenden Bereiche verfügt: Dataset.ReadWrite.All und Report.ReadWrite.All. Sie müssen auch das allowEdit: true Flag für jeden Bericht festlegen, den der Endbenutzer bearbeiten muss. Weitere Informationen finden Sie unter Embed Token – Generate Token.

Erforderliche clientseitige Berechtigungen für die Bearbeitung

Für die Bearbeitung eines Berichts sind die folgenden clientseitigen Berechtigungen erforderlich:

  • Kopieren – Benutzer können eine Kopie des Berichts mithilfe von Speichern unterspeichern.

  • ReadWrite- – Benutzer können den Bericht anzeigen, bearbeiten und speichern.

  • Alle – Benutzer können eine Kopie des Berichts erstellen, anzeigen, bearbeiten, speichern und speichern.

Bearbeiten des Berichts

Laden Sie Ihren vorhandenen Bericht im Bearbeitungsmodus. Der Bericht muss auf die gleiche Weise eingebettet werden, wie die Anwendung einen regulären Bericht einbettet, und der Ansichtsmodus muss sich im Bearbeitungsmodus befinden. Stellen Sie sicher, dass Sie den parameter viewMode auf models.ViewMode.Editfestlegen und über die richtigen Clientberechtigungen verfügen.

let config = {
    type: 'report',
    tokenType: models.TokenType.Aad or models.TokenType.Embed,
    accessToken: YourAccessToken,
    embedUrl: YourEmbedUrl,
    id: YourEmbedReportId,
    permissions: models.Permissions.All,
    viewMode: models.ViewMode.Edit,
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Embed report
let report = powerbi.embed(embedContainer, config);

Der Benutzer kann den Bericht jetzt basierend auf den Berechtigungen bearbeiten, aktiviert wurden.

Sie können auch zwischen den Bearbeitungs- und Ansichtsmodi wechseln, nachdem der Bericht geladen wurde.

report.switchMode("view");

So wechseln Sie zum Bearbeitungsmodus:

report.switchMode("edit");

Speichern eines Berichts

Erfahren Sie, wie Sie einen Bericht speichern, einschließlich zusätzlicher Optionen wie dem Speichern einer Kopie eines Berichts und dem Speichern eines Berichts in einem anderen Arbeitsbereich.

Erforderliche Zugriffstokenberechtigungen zum Speichern

Generieren Sie ein Einbettungstoken mit Zugriff auf den Bericht und das Dataset. Wenn Sie den Bericht in einem anderen Arbeitsbereich speichern möchten, muss das Token Zugriff auf den Zielarbeitsbereich haben. Wenn Sie die Masterbenutzer- Authentifizierungsmethode verwenden, stellen Sie sicher, dass Ihre Anwendung über die folgenden Bereiche verfügt: Report.ReadWrite.Allund Workspaces.ReadWrite.all. Sie müssen auch das allowEdit: true Flag für jeden Bericht festlegen, den der Kunde bearbeiten muss. Weitere Informationen finden Sie unter Embed Token – Generate Token.

Erforderliche clientseitige Berechtigungen zum Speichern

Zum Speichern eines Berichts sind die folgenden clientseitigen Berechtigungen erforderlich:

  • ReadWrite- – Benutzer können den Bericht anzeigen, bearbeiten und speichern.

  • Erstellen von – Benutzer können einen neuen Bericht erstellen.

  • Kopieren – Benutzer können eine Kopie des Berichts mithilfe von Speichern unterspeichern.

  • Alle – Benutzer können eine Kopie des Berichts erstellen, anzeigen, bearbeiten, speichern und speichern.

Speichern eines Berichts

Beim Erstellen eines Berichts wird der Bericht erst gespeichert, wenn Sie den save Vorgang aus dem Dateimenü oder JavaScript aufrufen.

report.save();

Speichern einer Kopie eines Berichts

Speichern Sie eine zusätzliche Kopie mit einem anderen Namen. Die Kopie des Berichts wird im gleichen Arbeitsbereich wie das Dataset des Berichts gespeichert.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

Sie können Ihren Bericht auch in einem anderen Arbeitsbereich speichern. Stellen Sie sicher, dass Sie über die richtigen Berechtigungen für den Zielarbeitsbereich verfügen.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Überprüfen, ob der Bericht gespeichert ist

Rufen Sie report.isSaved auf, um sicherzustellen, dass der Bericht gespeichert ist. Diese Methode kann verhindern, dass nicht gespeicherte Änderungen verloren gehen.

let isReportSaved = await report.isSaved();

Erstellen einer benutzerdefinierten SaveAs-Oberfläche

Sie können ein benutzerdefiniertes dialogfeld saveAs erstellen, indem Sie die Einstellung useCustomSaveAsDialog: true Berichts zum Konfigurationsobjekt hinzufügen. Diese Einstellung blendet das Standarddialogfeld der Benutzeroberfläche aus.

Das saveAsTriggered-Ereignis wird ausgelöst, wenn ein Benutzer auf Speichern unter auf der Benutzeroberfläche klickt. Verwenden Sie diese Informationen, um Ihr benutzerdefiniertes Dialogfeld anzuzeigen.

report.on("saveAsTriggered", function (event) {
    console.log(event);
});

Zum Ausführen eines Vorgangs "Speichern unter" können Sie report.saveAs aus dem benutzerdefinierten Dialogfeld aufrufen. Weitere Informationen finden Sie unter Speichern einer Kopie eines Berichts.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Überwachen der Save- und saveAs-Ereignisse

Das saved-Ereignis wird ausgelöst, wenn ein Speichern durch eine save- oder saveAs-Aktion auf der Benutzeroberfläche oder mithilfe der APIs ausgelöst wird. Weitere Informationen finden Sie unter Behandeln von Ereignissen.

report.on("saved", function (event) {
    console.log(event);
});

Verwandte Inhalte