Artigo
09/28/2010

Personalizando uma Web Part do Report Viewer

Você pode usar a Web Part do Report Viewer 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 Report Viewer em uma nova página automaticamente, mas você também pode adicionar uma Web Part do Report Viewer a uma página ou site exsitente se quiser que um determinado relatório sempre esteja visível nessa página.

Você pode personalizar a Web Part do Report Viewer 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 Report Viewer tem uma área de exibição de relatório, uma área de Parâmetros e uma área de Credenciais.

Você não pode ampliar a Web Part do Report Viewer para oferecer suporte a diferentes tipos de arquivos e não pode 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 de recursos padrão, deverá criar uma Web Part personalizada.

Definindo propriedades da Web Part

Uma Web Part tem propriedades personalizadas usadas para configurar a funcionalidade específica. Uma Web Part também tem propriedades comuns que são padrão para toda Web Part.

Alterar propriedades padrão

A Web Part do Report Viewer tem propriedades padrão idealmente adequadas para abrir relatórios sob demanda a partir 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 definidos para usarem todo o espaço disponível na página da Web. Se quiser modificar as propriedades padrão, poderá personalizar a Web Part com as Configurações de Site.

No menu Ações do Site, clique em Configurações de Site.
Em Galerias, clique em Web parts.
Clique em ReportViewer.dwp.
Abra o painel de ferramentas e defina as propriedades que deseja usar.

Personalizar um Report Viewer incorporado em uma página da Web

Você pode definir as propriedades para ajustar o Report Viewer em uma página da Web. O Report Viewer pode usar o mesmo estilo e cores qie a página que o contém. Você pode ocultar toda ou parte da barra de ferramentas, mapa de documentos e á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 definidos para ele quando ele foi criado; você não pode personalizar a aparência do relatório depois de publicá-lo em uma biblioteca do SharePoint.

Se estiver incorporando a Web Part do Report Viewer em uma página da Web, você deve definir a propriedade URL de Relatório para um relatório especificado. Se não estiver, o Report Viewer 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 Report Viewer

Ao definir propriedades personalizadas, verifique se algumas propriedades são usadas somente quando a Web Part do Report Viewer está incorporada 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 Report Viewer aparecer em uma página ou abrir um relatório em modo de página inteira.

As propriedades personalizadas da Web Part do Report Viewer são listadas a seguir.

Propriedade	Descrição
Relatório	Um URL que seja totalmente qualificado para um relatório que está no site do SharePoint atual ou em um site no mesmo aplicativo ou farm da Web. Para obter os melhores resultados ao definir propriedades adicionais, clique em Aplicar depois de especificar o URL do relatório.
Destino do Hiperlink	O Destino de 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, ele não deve ser usado para uma Web Part do Report Viewer incorporada a uma página.
Gerar automaticamente o título da Web Part	Um título gerado inclui o nome da Web Part do Report Viewer 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 automaticamente o link de detalhes da Web Part	Um hiperlink gerado que é exibido acima da Web Part. Você pode clicar no link para abrir o relatório em uma nova página, em modo de página inteira.
Barra de Ferramentas	Os valores válidos incluem Full, None e Navigation. O Full mostra a barra de ferramentas inteira. O None oculta a barra de ferramentas. O Navigation mostra somente os controles de navegação de página, sem zoom, atualizar ou o menu Ações.
Parâmetros	Os valores válidos incluem Displayed, Collapsed e 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 mapa do documento é um controle de navegação do relatório definido e usado para fornecer acesso com um só clique a seções específicas de um 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, Collapsed e 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á clicar na 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	Clique neste botão para recuperar 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ê estiver definindo propriedades de um relatório recém-carregado, poderá receber um erro indicando que a conexão da fonte de dados foi excluída. Se isso acontecer, redefina a conexão e termine de definir as propriedades dos parâmetros depois que a conexão for especificada. Para obter instruções sobre como definir a conexão, consulte Como criar e gerenciar fontes de dados compartilhadas (Reporting Services no modo integrado do SharePoint). Para obter os melhores resultados, clique em 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, consulte Como definir parâmetros em um relatório publicado (Reporting Services no modo integrado do SharePoint).

Personalizando a caixa de ferramentas

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 em um relatório, imprimir o relatório e, para relatórios com base em modelo, abrir o relatório no Construtor de Relatórios.

Você não pode personalizar o menu Ações nem adicionar novos comandos a ele, mas pode ocultá-lo definindo propriedades na barra de ferramentas. 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 até pelo menos 400 pixels.

Personalizando 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, consulte Como 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 Parâmetros ou Credenciais são exibidas, a exibição do relatório é ajustada para usar a largura restante da Web Part. Você pode definir propriedades na Web Part para personalizar a largura da área Parâmetros. Também pode definir os rótulos exibidos ao lado dos parâmetros individuais na página. Para mais informações sobre como modificar rótulos de parâmetro, consulte Como definir parâmetros em um relatório publicado (Reporting Services no modo integrado do SharePoint).