Personalizar a web part do Visualizador de Relatórios
Aplica-se a:
SQL Server 2016 (13.x) Reporting Services e posterior Servidor de Relatórios do Power BI SharePoint 2013 e posterior ❌ SharePoint Online
Para obter conteúdo relacionado a versões anteriores do SSRS (SQL Server Reporting Services), confira SQL Server 2014 Reporting Services.
Use a Web part do Visualizador de Relatórios para exibir relatórios executados em um servidor de relatório configurado para integração do SharePoint. Os relatórios que você pode exibir incluem arquivos de definição de relatório (.rdl) e relatórios do Construtor de Relatórios. Os relatórios são abertos na Web part do Visualizador de Relatórios em uma nova página automaticamente. Você também poderá adicionar uma Web part do Visualizador de Relatórios a uma página da Web ou um site existente se você quiser que um determinado relatório sempre esteja visível nessa página.
Observação
Apesar de terem nomes idênticos, a web part do Visualizador de Relatórios instalada pelo Suplemento de Reporting Services é diferente da web part do Visualizador de Relatórios incluída no arquivo RSWebParts.cab. As instruções deste tópico são específicas à web part do Visualizador de Relatórios instalada por meio do Suplemento de Reporting Services.
Personalize a web part do Visualizador de Relatórios das seguintes formas:
Altere a aparência da web part definindo propriedades.
Escolha quais recursos de relatórios interativos estão disponíveis na barra de ferramentas do relatório.
Especifique quais áreas de exibição estão disponíveis. A web part do Visualizador de Relatórios tem uma área de exibição de relatório, uma área de Parâmetros e uma área de Credenciais.
Não é possível estender a web part do Visualizador de Relatórios para dar suporte a diferentes tipos de arquivos e não é possível substituir a barra de ferramentas do relatório por uma barra de ferramentas personalizada nem adicionar nova funcionalidade à barra de ferramentas existente. Se você precisar de personalização dos recursos padrão, crie uma web part personalizada.
Definir as propriedades da web part
Uma web part tem propriedades personalizadas usadas para configurar uma funcionalidade específica. Uma web part também tem propriedades comuns que são padrão a todas as web parts.
Alterar as propriedades padrão
A web part do Visualizador de Relatórios tem propriedades padrão idealmente adequadas para abrir relatórios sob demanda por meio de uma biblioteca ou pasta. Por padrão, todos os controles disponíveis são exibidos na barra de ferramentas. Altura e largura são definidas para usar todo o espaço disponível na página da Web. Se desejar modificar as propriedades padrão, personalize a web part por meio das Configurações de Site.
No menu Ações do Site, selecione Configurações de Site.
Em Galerias, selecione web parts.
Selecione ReportViewer.dwp.
Abra o painel de ferramentas e defina as propriedades que deseja usar.
Personalizar um Visualizador de Relatórios inserido em uma página da Web
Defina as propriedades para ajustar o Visualizador de Relatórios em uma página da Web. O Visualizador de Relatórios pode usar o mesmo estilo e cores que a página que o contém. Você pode ocultar toda ou parte da barra de ferramentas, o mapa do documento e a área de parâmetros para maximizar a área de exibição do relatório no espaço alocado. O relatório sempre usa os estilos que você definiu para ele ao criá-lo. Você não pode personalizar a aparência do relatório após publicá-lo em uma biblioteca do SharePoint.
Se estiver inserindo a web part do Visualizador de Relatórios em uma página da Web, defina a propriedade URL de Relatório com um relatório específico. Se não estiver, o Visualizador de Relatórios exibirá instruções para vincular a um relatório. Você não pode personalizar nem remover as instruções.
Propriedades personalizadas da web part do Visualizador de Relatórios
Ao definir propriedades personalizadas, lembre-se de que algumas propriedades são usadas somente quando a web part do Visualizador de Relatórios está inserida em uma página. Os exemplos incluem Título, Altura, Largura, Tipo de cromado e Zona. Outras propriedades, como as configurações da Barra de Ferramentas e Parâmetros, são usadas independentemente de o Visualizador de Relatórios aparecer em uma página ou abrir um relatório em modo de página inteira.
As propriedades personalizadas da web part do Visualizador de Relatórios são listadas na tabela a seguir.
| Propriedade | Descrição |
|---|---|
| Report | Um caminho totalmente qualificado para um relatório que esteja no site do SharePoint atual ou em um site no mesmo aplicativo Web ou farm. Para obter os melhores resultados ao definir propriedades adicionais, selecione Aplicar depois de especificar a URL do relatório. |
| Destino do Hiperlink | HTML padrão que especifica o quadro de destino para exibir conteúdo vinculado no documento atual. Para relatórios que incluem hiperlinks para sites externos, você pode especificar se um documento de destino substitui o relatório existente dentro da janela atual ou se ele é aberto em uma nova janela do navegador. Os valores válidos incluem _Top, _Blank, e _Self. _Top usa a janela atual, _Blank carrega o documento em uma nova janela do navegador e _Self abre o documento dentro do quadro atual. Embora _Parent seja um valor válido para o atributo Target em HTML, não use-o em uma web part do Visualizador de Relatórios inserida em uma página. |
| Gerar o título da web part automaticamente | Um título gerado que inclui o nome da web part do Visualizador de Relatórios e o nome do relatório, separados por um traço. Se o relatório não tiver um título, será usado o nome do arquivo do relatório. O título fica visível quando você adiciona uma web part a uma página. Se essa caixa de seleção estiver marcada, o título será gerado sempre que a página for atualizada. |
| Gerar o link Detalhes do Título da web part automaticamente | Um hiperlink gerado que é exibido acima da web part. Você pode selecionar o link para abrir o relatório em uma nova página, em modo de página inteira. |
| Mostrar item de menu do construtor de relatórios | Mostra ou oculta a opção de menu Ações para abrir o Construtor de Relatórios. |
| Mostrar item de menu de assinatura | Mostra ou oculta a opção de menu Ações para criar uma assinatura para o relatório. |
| Mostrar item do menu imprimir | Mostra ou oculta a opção de menu Ações para imprimir o relatório. |
| Mostrar item do menu exportar | Mostra ou oculta a opção de menu Ações para exportar o relatório. |
| Mostrar botão atualizar | Mostra ou oculta o botão atualizar na barra de ferramentas. |
| Mostrar controles de navegação de página | Mostra ou oculta os botões de navegação de relatório na barra de ferramentas. Esta opção altera a visibilidade de todos os controles de navegação. |
| Mostrar botão voltar | Mostra ou oculta o botão voltar na barra de ferramentas. |
| Mostrar controles de localização | Mostra ou oculta os controles de localização na barra de ferramentas. Esses controles permitem que um usuário procure texto no relatório renderizado. Esta opção altera a visibilidade de todos os controles de localização. |
| Mostrar controle de zoom | Mostra ou oculta o controle de zoom na barra de ferramentas. |
| Mostrar botão feed ATOM | Mostra ou oculta o botão feed ATOM na barra de ferramentas. |
| Localização da Barra de Ferramentas | Determina o local da barra de ferramentas dentro do visualizador de relatórios. Os valores válidos incluem Top e Bottom. |
| Área de prompt | Os valores válidos incluem Displayed, Collapsede Hidden. Displayed é exibido na área Parâmetros para os relatórios que incluem valores com parâmetros e que exigem a entrada do usuário antes de o relatório ser executado. Use Hidden se todos os parâmetros do relatório estiverem especificados e você não quiser que a área de parâmetros fique visível para os usuários. |
| Largura da Área de Parâmetros | Você pode escolher a medida e o valor. O padrão é 200 pixels. A única exigência desta propriedade é que o valor seja maior do que zero. |
| Mapa do documento | Um controle de navegação definido em um relatório e usado para fornecer acesso com um único clique a seções específicas do relatório. Ele está disponível em relatórios HTML. O mapa do documento é exibido em uma área recolhível ao lado da área de exibição do relatório. Os valores válidos incluem Displayed, Collapsede Hidden. Se um mapa do documento estiver definido para um relatório, a área será expandida por padrão, a menos que seja marcada como oculta ou recolhida nas propriedades da web part. Se o mapa do documento estiver recolhido, você poderá selecionar a seta para expandi-lo. |
| Largura da Área de Mapa do Documento | Você pode escolher a medida e o valor. O padrão é 200 pixels. A única exigência desta propriedade é que o valor seja maior do que zero. |
| Carregar Parâmetros | Recupera as propriedades dos parâmetros do relatório. Nem todos os relatórios têm parâmetros. Se o relatório não tiver parâmetros, nenhum valor será retornado. Se você definir propriedades de um relatório carregado, poderá receber um erro indicando que a conexão da fonte de dados foi excluída. Se esse erro acontecer, redefina a conexão e termine de definir as propriedades dos parâmetros depois que a conexão for especificada. Para obter mais informações sobre como definir a conexão, confira Criar e gerenciar fontes de dados compartilhadas (Reporting Services no modo integrado SharePoint). Para obter os melhores resultados, selecione Aplicar antes de clicar em Carregar Parâmetros. Depois de carregar as propriedades dos parâmetros, você poderá defini-las da mesma maneira como faria nas páginas de propriedades de parâmetros do relatório. Para obter mais informações sobre como definir parâmetros, confira Definir parâmetros em um relatório publicado (Reporting Services no modo integrado do SharePoint). |
Personalizar a barra de ferramenta
A barra de ferramentas é exibida abaixo do título e abrange a parte superior do relatório. Ela proporciona o menu Ações , a navegação de página para relatórios paginados, atualização e zoom. Também inclui um controle de mapa do documento para relatórios que têm um mapa do documento. O menu Ações inclui comandos para exportar o relatório, procurar texto ou números no relatório, imprimir o relatório e abrir o relatório no Construtor de Relatórios.
Não é possível adicionar novos comandos ao menu Ações, mas é possível personalizá-lo alterando as opções que ficam visíveis para os usuários. Para alterar a visibilidade dos botões e controles da barra de ferramentas, altere as opções da seção Visibilidade de Itens da Barra de Ferramentas da web part. Também é possível remover apenas o comando Imprimir ou formatos de exportação específicos tornando esses recursos não disponíveis no servidor de relatório. Os controles de navegação de página estão disponíveis para relatórios que têm quebras de página; caso contrário, o relatório é uma única página de comprimento variável. Atualizar reprocessa o relatório usando os parâmetros atuais. Para exibir todos os controles em uma linha, defina a largura geral da web part como, pelo menos, 400 pixels.
Personalizar a área de exibição
A área de exibição é usada para exibir relatórios. A área de exibição de relatório é compartilhada com as áreas Parâmetros e Credenciais, se elas forem usadas. Se forem necessárias credenciais, a área Credenciais será exibida ao lado de uma área de exibição de relatório em branco. A área Credenciais é fechada depois que o usuário fornecer credenciais e executar o relatório. Para personalizar o texto que pede aos usuários para definir credenciais, modifique as propriedades de conexão da fonte de dados. Para obter mais informações, confira Criar e gerenciar fontes de dados compartilhadas (Reporting Services no modo integrado do SharePoint).
A área Parâmetros fornece campos para digitar valores antes de executar o relatório. Ela só é usada quando a definição de um relatório inclui parâmetros. Quando as áreas de Parâmetros ou Credenciais são exibidas, a exibição de relatório é ajustada para usar a largura restante da web part. Defina as propriedades na web part para personalizar a largura de Parâmetros. Também pode definir os rótulos exibidos ao lado dos parâmetros individuais na página. Para obter mais informações sobre como modificar rótulos de parâmetros, confira Definir parâmetros em um relatório publicado (Reporting Services no modo integrado do SharePoint).
Conteúdo relacionado
Web part do Visualizador de Relatórios em um site do SharePoint
Adicionar a web part do Visualizador de Relatórios a uma página da Web
Mais perguntas? Experimente perguntar no fórum do Reporting Services
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de