Vložení stránkované sestavy

PLATÍ PRO: Power BI Tvůrce sestav Power BI Desktopu

Tento článek obsahuje přehled rozdílů mezi vložením sestavy Power BI a vložením stránkované sestavy Power BI. Tento článek je zaměřený na vývojáře, kteří k vložení stránkované sestavy používají vložené analytické možnosti Power BI.

Důležité informace o sémantických modelech

Sestava Power BI je vždy svázaná s jedním zdrojem dat. Stránkovaná sestava ale jako zdroj dat nevyžaduje sémantický model Power BI. Stránkovanou sestavu lze také vytvořit na několika sémantických modelech. To znamená, že při vkládání stránkované sestavy nemůžete spoléhat na datasetId vlastnost objektu sestavy.

Důležité informace o tokenech

Při generování tokenu pro vložení pro stránkovanou sestavu se službou Embed pro vaše zákazníky je potřeba vzít v úvahu některé zvláštní aspekty. Pokud má stránkovaná sestava jeden nebo více sémantických modelů Power BI nakonfigurovaných jako zdroje dat, musíte pro každý sémantický model vytvořit objekt GenerateTokenRequestV2Dataset s následujícími parametry:

• xmlaPermissions musí být nastaveno na ReadOnly

• allowEdit musí být nastaveno na false

Nepodporované funkce

Před vložením stránkované sestavy zvažte následující funkce Power BI, které nejsou podporované:

• Režim úprav nebo jakýkoli typ samoobslužného vytváření

• Události na straně klienta, jako loaded jsou arendered

• Dynamická vazba

• Čtení nebo aktualizace nastavení filtru

• Navigace na stránce

• Načtení hodnoty parametru aktualizované uživatelem pomocí rozhraní API

Příklad kódu

Následující výpis kódu ukazuje vygenerování tokenu pro vložení stránkované sestavy založené na sémantickém modelu Power BI.

string datasetId = "11111111-1111-1111-1111-111111111111";
Guid reportId = new Guid("22222222-2222-2222-2222-222222222222");

// create semantic model request for embed token with XmlaPermissions.ReadOnly
var datasetRequests = new List<GenerateTokenRequestV2Dataset> {
  new GenerateTokenRequestV2Dataset(datasetId, xmlaPermissions: XmlaPermissions.ReadOnly)
};

// create report request for embed token with allowEdit set to false
var reportRequests = new List<GenerateTokenRequestV2Report>{
  new GenerateTokenRequestV2Report(reportId, allowEdit: false)
};

// create token request
var tokenRequest = new GenerateTokenRequestV2 {
  Datasets = datasetRequests,
  Reports = reportRequests,
};

// call GenerateToken to retrieve embed token from Power BI REST API
var EmbedTokenResult = pbiClient.EmbedToken.GenerateToken(tokenRequest);

// extract embed token for embed token result
var embedToken = EmbedTokenResult.Token;

Související obsah

Použití rozhraní REST API Power BI

Klientská rozhraní API vložených analytických možností Power BI