Incorporar outros tipos de conteúdo do Power BI
Pode incorporar outros tipos de conteúdo do Power BI, incluindo elementos visuais de relatório do Power BI, relatórios paginados, dashboards, mosaicos de dashboard e a experiência Q&A. Ao contrário dos relatórios do Power BI, não é possível editar ou criar estes outros tipos de conteúdo.
Incorporar elementos visuais de relatório do Power BI
Pode incorporar elementos visuais de relatório único que são provenientes de um relatório do Power BI. Utilize um objeto de configuração do tipo IVisualLoadConfiguration
. Além das propriedades necessárias (descritas na Unidade 1; a type
propriedade está definida como elemento visual), também tem de definir as seguintes propriedades.
-
pageName
- Obrigatório O nome da página que contém o elemento visual que está a incorporar. Pode utilizar a função Report getPages para obter as páginas no relatório. -
visualName
- Necessário. O nome do elemento visual que está a incorporar. Pode utilizar a função Page getVisuals para obter os elementos visuais numa página.
A sua aplicação pode aplicar filtros ao elemento visual com a função updateFilters .
Dica
Não incorpore demasiados elementos visuais que são provenientes da mesma página porque podem não ter um bom desempenho. Além disso, se precisar de mais controlo ao incorporar vários elementos visuais do mesmo relatório, pode fazê-lo de forma mais eficiente com esquemas personalizados. Para obter mais informações sobre esquemas personalizados, consulte Personalizar um esquema de relatório.
Para obter uma descrição completa da incorporação de elementos visuais de relatórios do Power BI, veja Incorporar um elemento visual de relatório.
Incorporar relatórios paginados
Pode incorporar relatórios paginados com um objeto de configuração do tipo IEmbedConfigurationBase
. Além das propriedades necessárias (descritas na Unidade 1; a type
propriedade está definida como relatório), também tem de definir as seguintes propriedades.
-
id
- Necessário. O ID da área de trabalho (GroupID) que contém o relatório paginado. -
uniqueId
- Necessário. O ReportID do relatório paginado.
Também existe a settings
propriedade, que é opcional. Pode transmitir um objeto do tipo IPaginatedReportSettings
para especificar informações sobre o aspeto do painel de parâmetros do relatório. A sua aplicação pode ativar e expandir o painel.
Para definir parâmetros de relatório paginados, transmita-os no URL de incorporação. No entanto, não é possível definir valores de vários parâmetros. Para obter mais informações, veja Transmitir um parâmetro de relatório num URL para um relatório paginado no Power BI.
Para obter uma descrição completa da incorporação de relatórios paginados, veja Incorporar um relatório paginado.
Incorporar dashboards
Pode incorporar dashboards com um objeto de configuração do tipo IDashboardLoadConfiguration
. Além das propriedades necessárias (descritas na Unidade 1; a type
propriedade está definida como dashboard), também pode definir a pageView
propriedade. As opções incluem:
-
fitToWidth
- A largura do dashboard incorporado corresponde à largura dodiv
elemento que contém o dashboard. -
oneColumn
- O dashboard incorporado aparece numa coluna. Esta opção é adequada para pequenos dispositivos de fator de forma, como um telemóvel. -
actualSize
- O dashboard incorporado é apresentado em tamanho total.
Para obter uma descrição completa da incorporação de dashboards, veja Incorporar um dashboard.
Incorporar mosaicos do dashboard
Pode incorporar mosaicos de dashboard com um objeto de configuração do tipo ITileLoadConfiguration
. Além das propriedades necessárias (descritas na Unidade 1; a type
propriedade está definida como mosaico), também tem de definir as seguintes propriedades.
-
dashboardId
- Necessário. O DashboardID do dashboard que contém o mosaico. -
id
- Necessário. O ID do mosaico do dashboard. Pode utilizar a API REST do Power BI para obter mosaicos do dashboard e as respetivas propriedades.
Para obter uma descrição completa da incorporação de mosaicos do dashboard, veja Incorporar um mosaico de dashboard.
Incorporar a experiência Q&A
Pode incorporar a experiência Q&A com um objeto de configuração do tipo ILoadQnaConfiguration
. Além das propriedades necessárias (descritas na Unidade 1; a type
propriedade está definida como qna), também deve definir as seguintes propriedades.
-
datasetIds
- Necessário. Uma matriz de DatasetIDs. No entanto, apenas um DatasetID é atualmente suportado. -
viewMode
- Opcional. OuQnaMode.Interactive
, o que permite ao utilizador introduzir perguntas, ouQnaMode.ResultOnly
, que requer uma pergunta fornecida. -
question
- Opcional. A pergunta que a sua aplicação fornece. AviewMode
propriedade tem de ser definida comoQnaMode.ResultOnly
.
Dica
Incentivar a utilização do Q&A pode ajudar a reduzir o número de relatórios e dashboards que precisa de desenvolver. Além disso, pode incorporar um elemento visual Q&A a partir de um relatório do Power BI. Esta abordagem fornece a capacidade de formatar o elemento visual e a aplicação pode aplicar filtros ao mesmo.
Para obter uma descrição completa da incorporação da experiência Q&A, veja Incorporar um elemento visual Q&A autónomo.