• Artigo

Programabilidade do Web Part do Visualizador de Relatórios na Integração do SharePoint

A Web Part do Visualizador de Relatórios é um controle de servidor de ReportViewerWebPart que contém um conjunto de APIs (interfaces de programação de aplicativos) públicas, permitindo que os desenvolvedores criem aplicativos de SharePoint personalizados. Você pode criar Web Parts personalizadas que fornecem o caminho do relatório e parâmetros para a Web Part do Visualizador de Relatórios que usa conexões de Web Part. Você também pode inserir a Web Part em uma página personalizada de Web Parts do SharePoint e personalizá-la usando a API pública.

Conectando-se a uma Web Part do Visualizador de Relatórios com Web Parts personalizadas

A Web Part do Visualizador de Relatórios é um consumidor de conexão para Web Parts de SharePoint que implementam IWebPartRow ou IFilterValues. Uma Web Part IWebPartRow, como Documentos, pode fornecer um caminho de relatório a uma Web Part de Visualizador de Relatórios quando colocada na mesma página de Web Parts que a Web Part do Visualizador de Relatórios. Da mesma forma, uma Web Part IFilterValues, como Filtro de Texto ou Escolher Filtro, poderá fornecer um parâmetro de relatório a uma Web Part do Visualizador de Relatórios se for colocada na mesma página da Web Part que a Web Part do Visualizador de Relatórios.

Implementando um provedor de caminho de relatório com IWebPartRow

Para fornecer um caminho de relatório à Web Part do Visualizador de Relatórios através de conexões de Web Parts, faça o seguinte:

  1. Crie uma Web Part que implemente a interface IWebPartRow.

  2. Adicione a Web Part à mesma página de Web Parts da Web Part do Visualizador de Relatórios.

  3. Conecte sua Web Part à Web Part do Visualizador de Relatórios na interface de usuário de design de Web Parts na Web.

    ObservaçãoObservação

    Você pode conectar somente uma Web Part de IWebPartRow à Web Part do Visualizador de Relatórios por vez, e não pode conectar uma Web Part de IWebPartRow e uma Web Part de IFilterValues à Web Part do Visualizador de Relatórios ao mesmo tempo.

Para que a sua Web Part IWebPartRow funcione corretamente com a ReportViewerWebPart, faça o seguinte no método GetRowData(RowCallback):

  • Invoque o método de retorno de chamada com um objeto DataRowView como o parâmetro de entrada.

  • Verifique se o objeto DataRowView contém uma coluna chamada "DocUrl", que contém o caminho do relatório.

    ObservaçãoObservação

    A Web Part do Visualizador de Relatórios no suplemento do Office SharePoint Server 2010 também permite o recebimento do caminho do relatório, utilizando a coluna "FileRef."

Implementando um provedor de parâmetro de relatório com IFilterValues

Uma Web Part que implementa o IFilterValues pode fornecer um valor de parâmetro à Web Part do Visualizador de Relatórios. O valor de parâmetro enviado à Web Part do Visualizador de Relatórios está sujeito às mesmas restrições impostas ao parâmetro de relatório especificadas na definição do relatório, como tipo de dados, valores válidos, etc.

Para fornecer um parâmetro de relatório à Web Part do Visualizador de Relatórios, faça o seguinte:

  1. Crie uma Web Part que implemente a interface IFilterValues.

  2. Acrescente a Web Part à mesma página do [T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.]

  3. Conecte sua Web Part IFilterValues à Web Part do Visualizador de Relatórios na interface de usuário de design de Web Parts na Web.

    ObservaçãoObservação

    Você pode conectar várias Web Parts de IFilterValues à Web Part do Visualizador de Relatórios por vez. No entanto, você não pode conectar uma Web Part de IWebPartRow e uma Web Part de IFilterValues à Web Part do Visualizador de Relatórios ao mesmo tempo.