Incorporar outros tipos de conteúdo do Power BI

Concluído

Pode incorporar outros tipos de conteúdo do Power BI, incluindo elementos visuais de relatórios do Power BI, relatórios paginados, dashboards, mosaicos do dashboard e a experiência de 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 únicos 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 provenientes de uma página, uma vez que pode 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 através de 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 aplicação pode ativar e expandir para abrir 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 com 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 do div 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 do 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 os mosaicos do dashboard e as respetivas propriedades.

Para obter uma descrição completa da incorporação de mosaicos do dashboard, veja Incorporar um mosaico do dashboard.

Incorporar a experiência de Q&A

Pode incorporar a experiência de 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. Ou QnaMode.Interactive, o que permite ao utilizador introduzir perguntas, ou QnaMode.ResultOnly, o que requer uma pergunta fornecida.
  • question - Opcional. A pergunta que a sua aplicação fornece. A viewMode propriedade tem de ser definida como QnaMode.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 de Q&A a partir de um relatório do Power BI. Esta abordagem permite 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 de Q&A, veja Incorporar um elemento visual Q&A autónomo.