Sdílet prostřednictvím

Vytvoření, úprava a uložení vložené sestavy

  • Článek

Vložené analytické možnosti Power BI umožňují vytvářet, upravovat a ukládat vložené sestavy. Sestavu lze vytvořit na základě existující datové sady nebo můžete upravit existující sestavu. Sestavu můžete také uložit po jejím vytvoření nebo úpravě.

Jak vytvořit sestavu

Zjistěte, jak vytvořit novou prázdnou sestavu z existující sady dat.

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 vaše aplikace má následující obory: Dataset.Read.All, Content.Createa Workspaces.ReadWrite.all. Další informace najdete v tématu Token pro vložení – Generování tokenů.

Požadovaná oprávnění na straně klienta pro vytvoření sestavy

K 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šechny – 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 rozhraní getDatasetsInGroup REST API a načíst CreateReportEmbedURL. Další informace najdete v tématu Datové sady – Získání datových sad ve skupině.

Poznámka

K vytvoření nové sestavy 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 použitým motivem. Nové vizuály přidané do sestavy budou respektovat styl motivu. Další informace najdete v tématu Použití motivů sestav.

Ú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 vaše aplikace má následující obory: Dataset.ReadWrite.All a Report.ReadWrite.All. Musíte také nastavit příznak allowEdit: true pro každou sestavu, kterou musí koncový uživatel upravit. Další informace najdete v tématu Token pro vložení – Generování tokenů.

Požadovaná oprávnění na straně klienta pro úpravy

K úpravě sestavy se vyžadují následující oprávnění na straně klienta:

  • kopírování – uživatelé mohou uložit kopii sestavy pomocí Uložit jako.

  • ReadWrite – uživatelé můžou sestavu zobrazit, upravit a uložit.

  • Všechny – 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, jakým aplikace vloží běžnou sestavu a režim zobrazení musí být v režimu úprav. Ujistěte se, že jste nastavili parametr viewMode na models.ViewMode.Edita ž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);

Uživatel teď může sestavu upravovat na základě oprávnění, která jsou povolená.

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

Jak uložit sestavu

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 vaše aplikace má následující obory: Report.ReadWrite.Alla Workspaces.ReadWrite.all. Musíte také nastavit příznak allowEdit: true pro každou sestavu, kterou zákazník potřebuje upravit. Další informace najdete v tématu Token pro vložení – Generování tokenů.

Požadovaná oprávnění na straně klienta pro ukládání

K uložení sestavy se vyžadují následující oprávnění na straně klienta:

  • ReadWrite – uživatelé můžou sestavu zobrazit, upravit a uložit.

  • Vytvořit – Uživatelé můžou vytvořit novou sestavu.

  • kopírování – uživatelé mohou uložit kopii sestavy pomocí Uložit jako.

  • Všechny – 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 nevoláte operaci save 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 uložit také 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á.

Zavolejte report.isSaved, abyste měli jistotu, že je sestava uložená. Tato metoda může pomoct zabránit ztrátě neuložených změn.

let isReportSaved = await report.isSaved();

Vytvoření vlastního prostředí saveAs

Vlastní dialogové okno saveAs můžete vytvořit 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 v uživatelském rozhraní klikne na Uložit jako. 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);

Naslouchání událostem save and saveAs

Událost saved je vyvolána při aktivaci uložení save nebo saveAs akcí 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);
});

Související obsah