Como usar assemblies personalizados ou código incorporado no Reporting Services

Criar um assembly personalizado

1. Crie uma biblioteca de classe do Visual Studio. No menu arquivo , aponte para novo , aponte para Project e, em seguida, clique em Class Library .
2. Especifique o nome e o local. Por exemplo, eu usado 2005\projects SimpleClassLibrary e C:\Documents and Settings\user1\My Documentos\Visual Studio.
3. Abra o arquivo de classe (no meu caso, Class1.vb) e, em seguida, crie as funções que você deseja usar no Reporting Services. No meu caso, basta criar uma função compartilhada simples.
   
   Observação Como esta é uma função compartilhada (estática no translation from VPE for Csharp), não temos acessá-lo, usando um objeto instanciado. Tenha isso em mente que isso tenha um efeito em como nós referência nosso assembly mais adiante neste artigo.

   Public Class Class1
   
       Public Shared Function DoSomething() As String
           Return "string data returned from custom assembly"
       End Function
   
   End Class
   

4. Depois de terminar de adicionar todo o código, clique em Criar SimpleClassLibrary no menu Build . Esta etapa cria o assembly ou gerenciado .dll na pasta bin respectivos. No meu exemplo, esta etapa criados meu assembly, SimpleClassLibrary.dll, na pasta Meus Documentos\Visual Studio 2005\Projects\ SimpleClassLibrary\bin\Debug.

Voltar para o início

Copiar o assembly personalizado para as pastas SQL Reporting Services

• Para o Reporting Services 2005, copie o arquivo .dll para as seguintes pastas:
  • Programa de Programas\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies
  • Programa Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin
• Para Reporting Services 2000, copie o arquivo .dll para as seguintes pastas:
  • Programa de Programas\Microsoft SQL Server\80\Tools\Report Designer
  • Programa de Programas\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\bin

@ECHO OFF
REM   Name: SRSDeploy.bat
REM
REM   This batch files copies my custom assembly to my Reporting Services folders.
REM   Run this from the directory where the customer assembly was compiled.
REM   Be sure to close any applications that have your custom assembly open. 
REM
REM   This is the SQL Server 2005 version:
copy SimpleClassLibrary.dll "C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies"  
copy SimpleClassLibrary.dll "C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin" 

REM This is the SQL Server 2000 version:
REM copy SimpleClassLibrary.dll "C:\Program Files\Microsoft SQL Server\80\Tools\Report Designer"
REM copy SimpleClassLibrary.dll "C:\Program Files\Microsoft SQL Server\MSSQL\Reporting Services\ReportServer\bin"

Voltar para o início

Adicionar uma referência ao assembly personalizado no Reporting Services

1. Abra o relatório que fará referência o assembly personalizado.
2. No menu Report , clique em Propriedades do relatório .
3. Na caixa de diálogo Propriedades do relatório , clique na guia References .
4. Em referências , clique no botão reticências (... ) que está próximo ao cabeçalho da coluna nome do assembly .
   
   Observação A seção de classes é somente para membros de instância. Ele não é para membros estáticos. Estático (também conhecido como "compartilhado" em alguns nossa documentação do Reporting Services) significa que o membro está disponível para cada instância da classe e cada instância usa o mesmo local de armazenamento. Membros estáticos são declarados usando a palavra-chave compartilhada no Visual Basic e a palavra-chave estática em translation from VPE for Csharp. Isso pode ser um pouco confuso. Isso significa, se seu assembly personalizado contém membros de instância que você precisa acessar, você precisará especificar o nome de classe e o nome de instância na seção classes . Porque o método que será chamado do Reporting Services foi definido como estático, utilizando a palavra-chave compartilhada no Visual Basic, usarei a seção referências em vez da seção de classes .
5. Na caixa de diálogo Add References , clique em Procurar . (No SQL Server 2005, clique na guia Procurar .)
6. Localize e, em seguida, clique no assembly personalizado. Clique em Abrir . (No SQL Server 2005, clique em Adicionar em vez de Abrir .)
7. Na caixa de diálogo Add References , clique em OK .
8. Na caixa de diálogo Propriedades do relatório , clique em OK .

1. Abra o relatório (um arquivo .RDL) no Report Designer.
2. Para demonstrar como usar o assembly personalizado no Reporting Services, adicione uma caixa de texto. Para fazer isso, arraste uma caixa de texto em branco da caixa de ferramentas para o relatório.
3. Nas propriedades de caixa de texto, clique na propriedade Value e chamar uma função usando a sintaxe a seguir.

   =ClassLibraryName.ClassName.MethodName or Namespace.ClassName.MethodName

   No meu exemplo, especifiquei a seguir.

   =SimpleClassLibrary.Class1.DoSomething()

   Outros formatos são usados para fazer referência a código no Reporting Services. Por exemplo, use o formato a seguir se você chamar incorporado código.

   =Code.MethodName()

   se você chamar um não-estático, ou com base instância, o método de dentro de um assembly personalizado usando uma instância, usar o seguinte formato.

   =Code.InstanceName.Method

   Observação Você poderia configurou sua referência diferente se você quisesse usar um método de instância. Para fazer isso, você poderia precisar para ir para Propriedades do relatório , clique na guia References e, em seguida, especifique o nome de classe e o nome de instância na seção classes .

Voltar para o início

Segurança de acesso de código se o assembly personalizado necessita de permissões adicionais

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="MyCodeGroup"
   Description="Code group for my data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\pathtocustomassembly\customassembly.dll"
       />
</CodeGroup>

Voltar para o início

Código incorporado

1. No menu Report , clique em Propriedades do relatório .
2. Na caixa de diálogo Propriedades do relatório , clique na guia código
3. Adicione a seguinte função e, em seguida, clique em OK .

   Public Function EmbeddedFunction() as String
    	Return "this is from embedded code function"
   End Function
   

4. No relatório, adicione uma nova caixa de texto.
5. Adicione o seguinte para a propriedade Value .

   =code.EmbeddedFunction

Voltar para o início