Vloženie zostáv služby Power BI

  • 8 min

Zostavy Power BI sú najčastejšie vloženým typom obsahu z dôvodu veľkého počtu typov vizuálov (vrátane umelej inteligencie a vlastných vizuálov) a interaktívnych funkcií.

Zostavu služby Power BI môžete vložiť do troch rôznych režimov:

  • Vloženie existujúcej zostavy Power BI
  • Úprava vloženej zostavy
  • Vloženie novej zostavy Power BI

Pre každý režim môžete nastaviť mnohé vlastnosti objektu konfigurácie a presne určiť, ako aplikácia zostavu prezentuje. Vlastnosť type konfiguračného objektu je vždy nastavená na zostavu.

Vloženie existujúcej zostavy

Pri vkladaní existujúcej zostavy použite konfiguračný objekt typu IReportLoadConfiguration. Okrem požadovaných vlastností (popísaných v jednotke 1) môže vaša aplikácia nastaviť nasledujúce voliteľné vlastnosti.

  • contrastMode and theme – voliteľné. Ovládajte úroveň motívu a kontrastu, ktorú používa vložený obsah. Každý obsah, ktorý vložíte, sa predvolene zobrazí s nulovým kontrastom. Toto správanie môžete prepísať nakonfigurovaním konkrétneho motívu alebo úrovne kontrastu. Ďalšie informácie nájdete v téme Motívy a režim vysokého kontrastu.
  • pageName -Voliteľné. Určuje, ktorá strana vloženej zostavy sa na začiatku zobrazí. Ak nie je nastavená, otvorí sa vybratá strana, keď autor naposledy uložil zostavu.
  • filters -Voliteľné. Nastaví stav filtra. Zvážte nastavenie stavu filtra na základe kontextu aplikácie, napríklad na filtrovanie podľa oblasti predaja používateľa aplikácie. Ďalšie informácie nájdete v téme Ovládanie filtrov zostáv.
  • slicers -Voliteľné. Podobne ako filtre, aj tu je možné nastaviť stav rýchleho filtra. Ďalšie informácie nájdete v téme Ovládanie rýchlych filtrov zostáv.
  • bookmark -Voliteľné. Použiť konkrétnu záložku.
  • datasetBinding -Voliteľné. Pripojí zostavu k inej množine údajov, ktorá definuje schému údajov, ku ktorej sa vložená zostava pripája. Ďalšie informácie nájdete v téme Dynamická väzba množín údajov k zostave.
  • permissions -Voliteľné. Udelí operácie, ktoré môže používateľ vykonať. Možnosti operácií zahŕňajú vytvorenie, zobrazenie, úpravu, uloženie alebo uloženie kópie zostavy. Úprava a vytváranie zostáv je popísaná ďalej v tejto lekcii.
  • viewMode -Voliteľné. Určuje, či sa zostava otvorí v režime zobrazenia (predvolený) alebo režime úprav. Ako už bolo uvedené vyššie, vaša aplikácia musí udeliť povolenia na úpravy, aby povolila režim úprav.
  • settings -Voliteľné. Upravuje vzhľad a správanie zostavy. Môžete zobraziť a rozbaliť otvorené tably, aby ste mohli pracovať so záložkami, poľami, filtrami, navigáciou na stránke, výberom, synchronizáciou rýchlych filtrov alebo vizualizácií. Môžete tiež nastaviť typ rozloženia na mobilné zobrazenie alebo nastaviť miestne nastavenia, ktoré určujú jazyk a formátovanie zostavy. Ďalšie informácie nájdete v téme Prispôsobenie nastavení.

Poznámka

V mnohých prípadoch je možné zmeniť nastavenia po načítaní zostavy, napríklad v reakcii na interakcie používateľov.

Zadajte, ako môže vaša aplikácia vložiť zostavu Power BI, prejdite na ihrisko s vloženou analýzou služby Power BI a postupujte podľa nasledujúcich pokynov.

Poznámka

Ihrisko pre vloženú analýzu Power BI je webová lokalita, ktorá vám pomáha učiť sa, skúmať a skúšať vložené analýzy služby Power BI. Jeho súčasťou je testovacie prostredie (sandbox) pre vývojárov, ktoré poskytuje praktické ukážky používania klientskych rozhraní API s ukážkovým obsahom služby Power BI alebo vlastným obsahom. Úryvky kódu a prezentácie sú k dispozícii na preskúmanie.

Ďalšie informácie nájdete v téme Čo je ihrisko pre vloženú analýzu služby Power BI?

Na ľavej table vyberte položku Preskúmať naše rozhrania API.

Snímka obrazovky ľavej tably so zvýraznenou možnosťou Preskúmať naše rozhrania API.

Na table obsahu si všimnite rozbaľovací zoznam Ukážka a susediaci rozbaľovací zoznam režimu Embedded . Predvolene sú oba rozbaľovacie zoznamy nastavené na zobrazenie zostavy Power BI v režime zobrazenia.

Snímka obrazovky dvoch rozbaľovacích zoznamov nastavených na zobrazenie zostavy Power BI v režime zobrazenia.

Ak chcete zobraziť, ako bola zostava vložená, vyberte položku Zobraziť vzorový kód v ľavom hornom rohu tably.

Snímka obrazovky panela s ponukami so zvýrazneným príkazom Zobraziť vzorový kód.

V okne úryvku kódu prejdite cez kód zvislým posúvaním zhora nadol. Nájdite riadky kódu, pomocou čoho vytvoríte konfiguračný objekt a vložíte zostavu (približne na polceste nadol).

// Create the embed configuration object for the report
// For more information see https://go.microsoft.com/fwlink/?linkid=2153590
let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: embedReportId,
    permissions: permissions,
    settings: {
        panes: {
            filters: {
                visible: true
            },
            pageNavigation: {
                visible: true
            }
        }
    }
};

// Get a reference to the embedded report HTML element
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
report = powerbi.embed(embedContainer, config);```

Všimnite si, že konfiguračný objekt nastaví filtre a navigačné tably strany na viditeľné.

Úprava vloženej zostavy

Ak chcete povoliť používateľovi upravovať vloženú zostavu, použite konfiguračný objekt typu IReportLoadConfiguration. viewMode Nastavte vlastnosť na models.ViewMode.Edithodnotu .

Informácie o povoleniach prístupových tokenov na úpravu zostavy nájdete v téme Create, úpravách a ukladaní vloženej zostavy. Keď má Copy používateľ povolenie, môže kópiu zostavy uložiť pomocou možnosti Uložiť ako.

Na ihrisku vloženej analýzy služby Power BI vyberte v rozbaľovacom zozname Režim vloženia položku Režim úprav.

Snímka obrazovky rozbaľovacieho zoznamu režimu Vložené, ktorý je nastavený na možnosť Režim úprav.

Vložená zostava má teraz panel akcií v hornej časti zostavy. Obsahuje príkaz Uložiť , ktorý sa nachádza úplne napravo od zostavy. Teraz je možné zmeniť zostavu a (pokúsiť sa) uložiť upravenú zostavu.

Poznámka

Pri pokuse o uloženie zostavy na ihrisku pre vloženú analýzu služby Power BI sa zobrazí chyba, pretože ide o ukážkovú aplikáciu.

Otvorte okno úryvku kódu a vyhľadajte príkaz, ktorý vytvorí objekt config . Všimnite si, že vlastnosť viewMode je nastavená na hodnotu Edit.

viewMode: models.ViewMode.Edit,

Výberom položky Zrušiť zatvorte okno úryvku kódu.

Vloženie novej zostavy

Ak chcete vložiť novú zostavu, použite konfiguračný objekt typu IReportCreateConfiguration. Vlastnosti v tomto rozhraní sú podobné vlastnostiam objektu konfigurácie načítania zostavy s nasledujúcimi dvoma výnimkami:

  • datasetId -Požadované. Údaj DatasetID, ku ktorému sa nová zostava pripája.

  • embedUrl -Požadované. URL adresa množiny údajov na vloženie.

Vlastnosť musíte nastaviť tak, permissions aby umožňovala vytvorenie zostavy (Create a All).

Informácie o povoleniach prístupového tokenu na vytvorenie a uloženie zostavy nájdete v téme Create, úpravách a ukladaní vloženej zostavy.

Na ihrisku vloženej analýzy služby Power BI vyberte v rozbaľovacom zozname Režim vloženia položku Create režime.

Snímka obrazovky rozbaľovacieho zoznamu režimu Embedded nastavený na možnosť Create režime.

Vložená zostava má teraz panel akcií v hornej časti zostavy. Obsahuje ponuku Súbor , ktorá sa nachádza úplne vľavo od zostavy. Teraz je možné zostavu (s pokusom) uložiť.

Poznámka

Pri pokuse o uloženie zostavy na ihrisku pre vloženú analýzu služby Power BI sa zobrazí chyba, pretože ide o ukážkovú aplikáciu.

Otvorte okno úryvku kódu a vyhľadajte príkaz, ktorý vytvorí objekt embedCreateConfiguration . Všimnite si, že kód nastaví vlastnosť datasetId .

// This object is used when calling powerbi.createReport.
let embedCreateConfiguration = {
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    datasetId: embedDatasetId,
};

Výberom položky Zrušiť zatvorte okno úryvku kódu.

Úplný popis vkladania zostáv služby Power BI nájdete v téme Vloženie zostavy.