Osadzanie innych typów zawartości usługi Power BI

Ukończone

Możesz osadzić inne typy zawartości usługi Power BI, w tym wizualizacje raportów usługi Power BI, raporty podzielone na strony, pulpity nawigacyjne, kafelki pulpitów nawigacyjnych i środowisko Q&A. W przeciwieństwie do raportów usługi Power BI nie można edytować ani tworzyć innych typów zawartości.

Osadzanie wizualizacji raportów usługi Power BI

Możesz osadzić pojedyncze wizualizacje raportu pochodzące z raportu usługi Power BI. Użyj obiektu konfiguracji typu IVisualLoadConfiguration. Oprócz wymaganych właściwości (opisanych w lekcji 1; type właściwość jest ustawiona na wizualizację), należy również ustawić następujące właściwości.

  • pageName — Wymagana nazwa strony zawierającej osadzaną wizualizację. Funkcja GetPages raportu umożliwia uzyskanie stron w raporcie.
  • visualName -Wymagane. Nazwa osadzonej wizualizacji. Funkcja GetVisuals strony umożliwia uzyskanie wizualizacji na stronie.

Aplikacja może stosować filtry do wizualizacji przy użyciu funkcji updateFilters .

Porada

Nie osadzaj zbyt wielu wizualizacji, które pochodzą z tej samej strony, ponieważ może nie działać dobrze. Ponadto jeśli potrzebujesz większej kontroli podczas osadzania kilku wizualizacji z tego samego raportu, możesz to zrobić wydajniej przy użyciu układów niestandardowych. Aby uzyskać więcej informacji na temat układów niestandardowych, zobacz Personalizowanie układu raportu.

Aby uzyskać pełny opis osadzania wizualizacji raportów usługi Power BI, zobacz Osadzanie wizualizacji raportu.

Osadzanie raportów podzielonych na strony

Raporty podzielone na strony można osadzać przy użyciu obiektu konfiguracji typu IEmbedConfigurationBase. Oprócz wymaganych właściwości (opisanych w lekcji 1; type właściwość jest ustawiona na raport), należy również ustawić następujące właściwości.

  • id -Wymagane. Identyfikator obszaru roboczego (GroupID), który zawiera raport podzielony na strony.
  • uniqueId -Wymagane. Identyfikator reportID raportu podzielonego na strony.

Istnieje również settings właściwość , która jest opcjonalna. Można przekazać obiekt typu IPaginatedReportSettings , aby określić informacje o wyglądzie panelu parametrów raportu. Aplikacja może włączyć i rozwinąć panel.

Aby ustawić parametry raportu podzielonego na strony, przekaż je w adresie URL osadzania. Nie można jednak ustawić wartości wieloparametrowych. Aby uzyskać więcej informacji, zobacz Przekazywanie parametru raportu w adresie URL raportu podzielonego na strony w usłudze Power BI.

Aby uzyskać pełny opis osadzania raportów podzielonych na strony, zobacz Osadzanie raportu podzielonego na strony.

Osadzanie pulpitów nawigacyjnych

Pulpity nawigacyjne można osadzić przy użyciu obiektu konfiguracji typu IDashboardLoadConfiguration. Oprócz wymaganych właściwości (opisanych w lekcji 1; type właściwość jest ustawiona na pulpit nawigacyjny), można również ustawić pageView właściwość . Dostępne są następujące opcje:

  • fitToWidth — Szerokość osadzonego pulpitu nawigacyjnego div odpowiada szerokości elementu, który zawiera pulpit nawigacyjny.
  • oneColumn — Osadzony pulpit nawigacyjny jest wyświetlany w jednej kolumnie. Ta opcja jest odpowiednia dla małych urządzeń kształtowych, takich jak telefon komórkowy.
  • actualSize — Osadzony pulpit nawigacyjny jest wyświetlany w pełnym rozmiarze.

Pełny opis osadzania pulpitów nawigacyjnych można znaleźć w temacie Osadzanie pulpitu nawigacyjnego.

Osadzanie kafelków pulpitu nawigacyjnego

Kafelki pulpitu nawigacyjnego można osadzić przy użyciu obiektu konfiguracji typu ITileLoadConfiguration. Oprócz wymaganych właściwości (opisanych w lekcji 1; type właściwość jest ustawiona na kafelek), należy również ustawić następujące właściwości.

  • dashboardId -Wymagane. Identyfikator pulpitu nawigacyjnego pulpitu nawigacyjnego, który zawiera kafelek.
  • id -Wymagane. Identyfikator kafelka pulpitu nawigacyjnego. Interfejs API REST usługi Power BI umożliwia uzyskiwanie kafelków pulpitu nawigacyjnego i ich właściwości.

Pełny opis osadzania kafelków pulpitu nawigacyjnego można znaleźć w temacie Osadzanie kafelka pulpitu nawigacyjnego.

Osadzanie środowiska Q&A

Środowisko Q&A można osadzić przy użyciu obiektu konfiguracji typu ILoadQnaConfiguration. Oprócz wymaganych właściwości (opisanych w lekcji 1; type właściwość jest ustawiona na wartość qna), należy również ustawić następujące właściwości.

  • datasetIds -Wymagane. Tablica identyfikatorów zestawów danych. Jednak obecnie obsługiwany jest tylko jeden identyfikator zestawu danych.
  • viewMode -Opcjonalne. Element QnaMode.Interactive, który umożliwia użytkownikowi wprowadzanie pytań lub QnaMode.ResultOnly, co wymaga podanego pytania.
  • question -Opcjonalne. Pytanie, które dostarcza Aplikacja. Właściwość musi być ustawiona viewMode na QnaMode.ResultOnlywartość .

Porada

Zachęcanie do korzystania z usługi Q&A może pomóc zmniejszyć liczbę raportów i pulpitów nawigacyjnych, które należy opracować. Ponadto możesz osadzić wizualizację Q&A z raportu usługi Power BI. Takie podejście zapewnia możliwość formatowania wizualizacji, a aplikacja może stosować do niej filtry.

Pełny opis osadzania środowiska Q&A można znaleźć w temacie Embed a standalone Q&A visual (Osadzanie autonomicznej wizualizacji Q&A).