Creare, modificare e salvare un report incorporato
L'analisi incorporata di Power BI consente di creare, modificare e salvare report incorporati. Un report può essere creato in base a un set di dati esistente oppure è possibile 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 disponga degli ambiti seguenti: Dataset.Read.All, Content.Createe Workspaces.ReadWrite.all. Per altre informazioni, vedere Incorpora token - Generare token .
Autorizzazioni 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.
Tutto : 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. Sarà necessario un ID set di dati e l'URL di incorporamento. Ad esempio, è possibile usare l'API getDatasetsInGroup REST e recuperare .CreateReportEmbedURL Per altre informazioni , vedere Set di dati - Ottenere set di dati in gruppo .
Nota
È necessario disporre delle autorizzazioni di compilazione o scrittura per il set di dati per creare un nuovo report.
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 rispettano lo stile del tema. Per altre informazioni, vedere Applica temi del report .
Come modificare un report
Informazioni su come modificare un report esistente e passare tra le modalità Visualizzazione e Modifica.
Autorizzazioni di token di accesso necessarie 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 disponga degli ambiti seguenti: Dataset.ReadWrite.All e Report.ReadWrite.All. È anche necessario impostare il allowEdit: true flag per ogni report che l'utente finale deve modificare. Per altre informazioni, vedere Incorpora token - Generare token .
Autorizzazioni lato client necessarie per la modifica
Per modificare 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.
Tutto : gli utenti possono creare, visualizzare, modificare, salvare e salvare una copia del report.
Modificare il report
Caricare il report esistente in modalità Modifica. Il report deve essere incorporato nello stesso modo in cui l'applicazione incorpora un report normale e la modalità di visualizzazione deve essere in Modifica. Assicurarsi di impostare il viewMode parametro su models.ViewMode.Edite di disporre delle autorizzazioni client corrette.
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, ad esempio il salvataggio di una copia di un report e il salvataggio di un report in un'altra area di lavoro.
Autorizzazioni di token di accesso necessarie 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 disponga degli ambiti seguenti: Report.ReadWrite.Alle Workspaces.ReadWrite.all. È anche necessario impostare il allowEdit: true flag per ogni report che il cliente deve modificare. Per altre informazioni, vedere Incorpora token - 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.
Tutto : 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 finché non si chiama l'operazione save dal menu file o 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 corrette per l'area di lavoro di destinazione.
let saveAsParameters = {
name: "newReport"
targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};
report.saveAs(saveAsParameters);
Verificare che il report venga salvato
Chiamare report.isSaved per assicurarsi che il report venga salvato. Questo metodo può aiutare a impedire la perdita di modifiche non salvate.
let isReportSaved = await report.isSaved();
Creare un'esperienza saveAs personalizzata
È possibile creare una finestra di dialogo personalizzata saveAs aggiungendo l'impostazione del report all'oggetto useCustomSaveAsDialog: true di configurazione. Questa impostazione nasconde la finestra di dialogo dell'interfaccia utente predefinita.
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 come operazione, è 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 salva e salvaAs
L'evento saved viene generato quando un salvataggio viene attivato da un'azione save o saveAs dall'interfaccia utente o usando le API. Per altre informazioni, vedere Come gestire gli eventi .
report.on("saved", function (event) {
console.log(event);
});