Vytvoření, úprava a uložení vložené sestavy
Vložené analýzy Power BI umožňují vytvářet, upravovat a ukládat vložené sestavy. Sestavu můžete vytvořit na základě existující datové sady nebo můžete upravit existující sestavu. Sestavu můžete uložit i po jejím vytvoření nebo úpravě.
Vytvoření sestavy
Zjistěte, jak vytvořit novou prázdnou sestavu z existující datové sady.
Požadovaná oprávnění přístupového tokenu pro vytvoření sestavy
Vygenerujte token pro vložení s přístupem k datové sadě. Pokud používáte metodu ověřování hlavního uživatele , ujistěte se, že má vaše aplikace následující obory: Dataset.Read.All
, Content.Create
a Workspaces.ReadWrite.all
. Další informace najdete v tématu Vložení tokenu – vygenerování tokenu .
Požadovaná oprávnění na straně klienta pro vytvoření sestavy
Pro vytvoření sestavy se vyžadují následující oprávnění na straně klienta:
Vytvořit – Uživatelé můžou vytvořit novou sestavu.
Všichni – Uživatelé můžou vytvářet, zobrazovat, upravovat, ukládat a ukládat kopii sestavy.
Vytvoření nové sestavy
Vytvořte novou prázdnou sestavu z existující datové sady. Budete potřebovat ID datové sady a adresu URL pro vložení. Můžete například použít getDatasetsInGroup
rozhraní REST API a načíst CreateReportEmbedURL
. Další informace najdete v tématu Datové sady – Získání datových sad ve skupině .
Poznámka
Abyste mohli vytvořit novou sestavu, musíte mít oprávnění k sestavení nebo zápisu datové sady.
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);
Máte také možnost vytvořit sestavu s motivem použitým na ni. Nové vizuály přidané do sestavy budou respektovat styl motivu. Další informace najdete v tématu Použití motivů sestavy .
Úprava sestavy
Zjistěte, jak upravit existující sestavu a přepínat mezi režimy Zobrazení a Úpravy.
Požadovaná oprávnění přístupového tokenu pro úpravy
Vygenerujte token pro vložení s přístupem k sestavě. Pokud používáte metodu ověřování hlavního uživatele , ujistěte se, že má vaše aplikace následující obory: Dataset.ReadWrite.All
a Report.ReadWrite.All
. Musíte také nastavit příznak pro každou sestavu allowEdit: true
, kterou musí koncový uživatel upravit. Další informace najdete v tématu Vložení tokenu – vygenerování tokenu .
Požadovaná oprávnění na straně klienta pro úpravy
Pro úpravu sestavy se vyžadují následující oprávnění na straně klienta:
Kopírování – Uživatelé můžou uložit kopii sestavy pomocí funkce Uložit jako.
ReadWrite – Uživatelé můžou sestavu zobrazovat, upravovat a ukládat.
Všichni – Uživatelé můžou vytvářet, zobrazovat, upravovat, ukládat a ukládat kopii sestavy.
Úprava sestavy
Načtěte existující sestavu v režimu úprav. Sestava musí být vložena stejným způsobem jako aplikace vloží běžnou sestavu a režim zobrazení musí být v režimu úprav. Ujistěte se, že jste parametr nastavili viewMode
na models.ViewMode.Edit
a že máte správná oprávnění klienta.
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);
Váš uživatel teď může sestavu upravit na základě povolených oprávnění .
Po načtení sestavy můžete také přepínat mezi režimy upravit a zobrazit.
report.switchMode("view");
Přepnutí do režimu úprav:
report.switchMode("edit");
Postup uložení sestavy
Zjistěte, jak uložit sestavu, včetně dalších možností, jako je uložení kopie sestavy a uložení sestavy do jiného pracovního prostoru.
Požadovaná oprávnění přístupového tokenu pro ukládání
Vygenerujte token pro vložení s přístupem k sestavě a datové sadě. Pokud chcete sestavu uložit do jiného pracovního prostoru, musí mít token přístup k cílovému pracovnímu prostoru. Pokud používáte metodu ověřování hlavního uživatele , ujistěte se, že má vaše aplikace následující obory: Report.ReadWrite.All
a Workspaces.ReadWrite.all
. Pro každou sestavu allowEdit: true
, kterou zákazník potřebuje upravit, musíte také nastavit příznak. Další informace najdete v tématu Vložení tokenu – vygenerování tokenu .
Požadovaná oprávnění na straně klienta pro ukládání
Pro uložení sestavy se vyžadují následující oprávnění na straně klienta:
ReadWrite – Uživatelé můžou sestavu zobrazovat, upravovat a ukládat.
Vytvořit – Uživatelé můžou vytvořit novou sestavu.
Kopírování – Uživatelé můžou uložit kopii sestavy pomocí funkce Uložit jako.
Všichni – Uživatelé můžou vytvářet, zobrazovat, upravovat, ukládat a ukládat kopii sestavy.
Uložení sestavy
Při vytváření sestavy se sestava neuloží, dokud nevyvoláte save
operaci z nabídky souboru nebo JavaScriptu.
report.save();
Uložení kopie sestavy
Uložte další kopii s jiným názvem. Kopie sestavy se uloží do stejného pracovního prostoru jako datová sada sestavy.
let saveAsParameters = {
name: "newReport"
};
report.saveAs(saveAsParameters);
Sestavu můžete také uložit do jiného pracovního prostoru. Ujistěte se, že máte správná oprávnění pro cílový pracovní prostor.
let saveAsParameters = {
name: "newReport"
targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};
report.saveAs(saveAsParameters);
Ověřte, že je sestava uložená.
Zavolat report.isSaved
, abyste měli jistotu, že je sestava uložená. Tato metoda může pomoct zabránit ztrátě neuložené změny.
let isReportSaved = await report.isSaved();
Vytvoření vlastního prostředí saveAs
Vlastní dialogové okno můžete vytvořit saveAs
přidáním nastavení sestavy useCustomSaveAsDialog: true
do objektu konfigurace. Toto nastavení skryje výchozí dialogové okno uživatelského rozhraní.
Událost saveAsTriggered
se vyvolá, když uživatel klikne na Uložit jako v uživatelském rozhraní. Tyto informace slouží k zobrazení vlastního dialogového okna.
report.on("saveAsTriggered", function (event) {
console.log(event);
});
Pokud chcete provést operaci uložit jako, můžete volat report.saveAs
z vlastního dialogového okna. Další informace najdete v tématu Uložení kopie sestavy .
let saveAsParameters = {
name: "newReport"
targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};
report.saveAs(saveAsParameters);
Poslech událostí uložit a uložitAs
Událost saved
se vyvolá, když se uloží pomocí save
uživatelského rozhraní nebo saveAs
akce v uživatelském rozhraní nebo pomocí rozhraní API. Další informace najdete v tématu Zpracování událostí .
report.on("saved", function (event) {
console.log(event);
});