Criar um mapa do documento ou um sumário em relatórios paginados (Construtor de Relatórios)

  • Artigo

Aplica-se a: Microsoft Report Builder (SSRS) Power BI Report Builder Report Designer no SQL Server Data Tools

Crie um mapa do documento para fornecer um conjunto de links clicáveis ou um sumário em seu relatório paginado. Ao exibir um relatório paginado que inclui um mapa do documento, um painel lateral separado é mostrado ao lado do relatório. Você pode clicar nos links do mapa do documento para ir até a página do relatório que exibe esse item. Seções e grupos de relatórios são organizados em uma hierarquia de links. Clicar nos itens do mapa do documento atualiza o relatório e exibe a área do relatório que corresponde ao item no mapa do documento.

Para adicionar links ao mapa do documento, defina a propriedade DocumentMapLabel do item de relatório para o texto que você criar ou para uma expressão que seja avaliada como o texto que você deseja exibir no mapa do documento. Você também pode adicionar valores exclusivos ao grupo de tabelas ou matrizes para o mapa do documento. Por exemplo, para um grupo com base em cores, cada cor exclusiva tem um link que o direciona para a página do relatório que exibe a instância de grupo daquela cor.

Também é possível criar uma URL para um relatório que substitui a exibição do mapa do documento, portanto, você poderá executar o relatório sem exibir o mapa do documento e clicar no botão Mostrar/Ocultar Mapa do Documento na barra de ferramentas do visualizador de relatórios para alternar a exibição.

Observação

Você pode criar e modificar arquivos de definição de relatório paginado (.rdl) no Construtor de Relatórios da Microsoft, Construtor de Relatórios do Power BI e no Designer de Relatórios no SQL Server Data Tools.

Os mapas do documento não são renderizados quando você exibe um relatório paginado no serviço do Power BI. Eles são renderizados quando você exporta o relatório.

Mapas do documento e extensões de renderização

O mapa do documento é planejado para uso na extensão de renderização HTML, por exemplo, na Versão prévia e no Visualizador de Relatórios. Outras extensões de renderização têm maneiras diferentes de articular um mapa do documento:

Para obter mais informações, confira Funcionalidade interativa para extensões de renderização de relatório diferentes (Construtor de Relatórios e SSRS).

Adicionar um item de relatório a um mapa do documento

  1. No modo de exibição Design, selecione o item de relatório (por exemplo, tabela, matriz ou medidor) que você deseja adicionar ao mapa do documento. As propriedades do item de relatório aparecem no painel Propriedades.

    Observação

    Para selecionar uma região de dados tablix, clique em uma célula para exibir as alças de linha e coluna e, em seguida, clique na alça de canto.

  2. No painel Propriedades, digite o texto que deseja exibir no mapa do documento na propriedade DocumentMapLabel ou insira uma expressão que seja avaliada como um rótulo. Por exemplo, digite Gráfico de Vendas.

    Observação

    Se você não vir o painel Propriedades, na guia Exibir , no grupo Mostrar/Ocultar , clique em Propriedades.

  3. Repita as etapas 1 e 2 para cada item de relatório que você deseja exibir no mapa do documento.

  4. Clique em Executar. O relatório é executado e o mapa do documento exibe os rótulos criados. Clique em qualquer link para ir para a página do relatório relacionada ao item.

Adicionar valores de grupo exclusivos a um mapa do documento

  1. Na exibição Design, selecione a tabela, matriz ou lista que contém o grupo que você deseja exibir no mapa do documento. O painel Agrupamento exibe os grupos de linhas e colunas.

  2. No painel Grupos de Linhas, clique com o botão direito do mouse no grupo e escolha Editar Grupo. A página Geral da caixa de diálogo Propriedades do Grupo Tablix é aberta.

  3. Clique em Avançado.

  4. Na caixa de lista Mapa do Documento , digite ou selecione uma expressão que corresponda à expressão do grupo.

  5. Selecione OK.

  6. Repita as etapas 1 a 4 para cada grupo que você deseja exibir no mapa do documento.

  7. Clique em Executar. O relatório é executado e o mapa do documento exibe os valores do grupo. Clique em qualquer link para ir para a página do relatório relacionada ao item.

Ocultar o mapa do documento ao exibir um relatório

  1. No portal da Web, navegue até o relatório que contém o mapa do documento.

    Por exemplo, para os relatórios de exemplo em AdventureWorks2022 , a URL a seguir especifica o relatório chamado Catálogo de Produtos.

    https://localhost/Reports/Pages/Report.aspx?ItemPath=%2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog

  2. Copie o caminho do relatório no servidor. No exemplo, o caminho do relatório é %2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog.

  3. Crie uma nova URL com os três componentes a seguir:

    • O visualizador de relatórios no servidor de relatórios: https://localhost/ReportServer/Pages/ReportViewer.aspx?

    • O nome do relatório que você copiou na etapa 1, por exemplo: %2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog

    • Os parâmetros de informação do dispositivo que especificam se o mapa do documento será ocultado: &rs%3aCommand=Render&rc%3aFormat=HTML4.0&rc%3aDocMap=False

    A URL a seguir é composta por esses três componentes anexos na ordem em que foram listados.

    https://localhost/ReportServer/Pages/ReportViewer.aspx?  
%2fAdventureWorks2022+Sample+Reports%2fProduct+Catalog  
&rs%3aCommand=Render&rc%3aFormat=HTML4.0&rc%3aDocMap=False

    Para usar essa URL, copie-a e remova todas as quebras de linha.

  4. Cole a URL no portal da Web e pressione ENTER. O relatório será executado e o mapa do documento será ocultado.

Observação

Para obter mais informações, consulte Acesso por URL.

Mais perguntas? Experimente perguntar no fórum do Reporting Services