Creare, modificare e salvare un report incorporato

  • Articolo

L'analisi incorporata di Power BI consente di creare, modificare e salvare report incorporati. È possibile creare un report in base a un set di dati esistente oppure modificare un report esistente. È anche possibile salvare il report dopo la creazione o la modifica.

Come creare un report

Informazioni su come creare un nuovo report vuoto da un set di dati esistente.

Autorizzazioni di token di accesso necessarie per la creazione di un report

Generare un token di incorporamento con accesso al set di dati. Se si usa il metodo di autenticazione utente master , assicurarsi che l'applicazione abbia gli ambiti seguenti: , e . Per altre informazioni, vedere Token di incorporamento - Generare token.

Autorizzazioni sul lato client necessarie per la creazione di un report

Per la creazione di un report sono necessarie le autorizzazioni lato client seguenti:

  • Crea: gli utenti possono creare un nuovo report.

  • Tutti i: gli utenti possono creare, visualizzare, modificare, salvare e salvare una copia del report.

Creare un nuovo report

Creare un nuovo report vuoto da un set di dati esistente. Sono necessari un ID set di dati e l'URL di incorporamento. Ad esempio, è possibile usare l'API REST getDatasetsInGroup e recuperare il CreateReportEmbedURL. Per altre informazioni, vedere set di dati - Ottenere set di dati nel di gruppo.

Nota

Per creare un nuovo report, è necessario disporre delle autorizzazioni di compilazione o scrittura per il set di dati.

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

È anche possibile creare un report con un tema applicato. I nuovi oggetti visivi aggiunti al report rispetteranno lo stile del tema. Per altre informazioni, vedere Applicare i temi del report.

Come modificare un report

Informazioni su come modificare un report esistente e passare dalla modalità Visualizzazione a Modifica.

Autorizzazioni necessarie per il token di accesso per la modifica

Generare un token di incorporamento con accesso al report. Se si usa il metodo di autenticazione utente master , assicurarsi che l'applicazione abbia gli ambiti seguenti: e . È inoltre necessario impostare il flag di allowEdit: true per ogni report che l'utente finale deve modificare. Per altre informazioni, vedere Token di incorporamento - Generare token.

Autorizzazioni lato client necessarie per la modifica

Per la modifica di un report sono necessarie le autorizzazioni lato client seguenti:

  • Copia : gli utenti possono salvare una copia del report usando Salva con nome.

  • ReadWrite: gli utenti possono visualizzare, modificare e salvare il report.

  • Tutti i: gli utenti possono creare, visualizzare, modificare, salvare e salvare una copia del report.

Modificare il report

Caricare il report esistente in modalità di modifica. Il report deve essere incorporato nello stesso modo in cui l'applicazione incorpora un normale report e la modalità di visualizzazione deve essere in Modifica. Assicurarsi di impostare il parametro viewMode su models.ViewMode.Edite di disporre delle autorizzazioni client appropriate.

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

L'utente può ora modificare il report in base alle autorizzazioni abilitate.

È anche possibile passare tra le modalità Modifica e Visualizzazione dopo il caricamento del report.

report.switchMode("view");

Per passare alla modalità di modifica:

report.switchMode("edit");

Come salvare un report

Informazioni su come salvare un report, incluse opzioni aggiuntive come il salvataggio di una copia di un report e il salvataggio di un report in un'altra area di lavoro.

Autorizzazioni necessarie per il token di accesso per il salvataggio

Generare un token di incorporamento con accesso al report e al set di dati. Se si vuole salvare il report in un'altra area di lavoro, il token deve avere accesso all'area di lavoro di destinazione. Se si usa il metodo di autenticazione utente master , assicurarsi che l'applicazione abbia gli ambiti seguenti: e . È inoltre necessario impostare il flag di allowEdit: true per ogni report che il cliente deve modificare. Per altre informazioni, vedere Token di incorporamento - Generare token.

Autorizzazioni lato client necessarie per il salvataggio

Per salvare un report sono necessarie le autorizzazioni lato client seguenti:

  • ReadWrite: gli utenti possono visualizzare, modificare e salvare il report.

  • Crea: gli utenti possono creare un nuovo report.

  • Copia : gli utenti possono salvare una copia del report usando Salva con nome.

  • Tutti i: gli utenti possono creare, visualizzare, modificare, salvare e salvare una copia del report.

Salvare un report

Quando si crea un report, il report non viene salvato fino a quando non si chiama l'operazione di save dal menu file o Da JavaScript.

report.save();

Salvare una copia di un report

Salvare una copia aggiuntiva con un nome diverso. La copia del report verrà salvata nella stessa area di lavoro del set di dati del report.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

È anche possibile salvare il report in un'altra area di lavoro. Assicurarsi di disporre delle autorizzazioni appropriate per l'area di lavoro di destinazione.

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

report.saveAs(saveAsParameters);

Verificare che il report sia stato salvato

Chiamare report.isSaved per assicurarsi che il report venga salvato. Questo metodo può aiutare a evitare la perdita di modifiche non salvate.

let isReportSaved = await report.isSaved();

Creare un'esperienza saveAs personalizzata

È possibile creare una finestra di dialogo di saveAs personalizzata aggiungendo l'impostazione del report useCustomSaveAsDialog: true all'oggetto di configurazione. Questa impostazione nasconde la finestra di dialogo predefinita dell'interfaccia utente.

L'evento saveAsTriggered viene generato quando un utente fa clic su Salva con nome nell'interfaccia utente. Usare queste informazioni per visualizzare la finestra di dialogo personalizzata.

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

Per eseguire un'operazione salva con nome, è possibile chiamare report.saveAs dalla finestra di dialogo personalizzata. Per altre informazioni, vedere Salvare una copia di un report.

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

report.saveAs(saveAsParameters);

Ascoltare gli eventi save e saveAs

L'evento saved viene generato quando un salvataggio viene attivato da un'azione save o saveAs nell'interfaccia utente o usando le API. Per altre informazioni, vedere Come gestire gli eventi.

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

Contenuto correlato