Como utilizar assemblagens personalizadas ou códigos incorporados no Reporting Services

Criar uma assemblagem personalizada

1. Crie uma biblioteca de classe do Visual Studio. No menu ficheiro , aponte para Novo , aponte para o Project e clique em Biblioteca de classes .
2. Especifique o nome e a localização. Por exemplo, É utilizado 2005\projects SimpleClassLibrary e C:\Documents and Settings\user1\My Documents\Visual Studio.
3. Abrir o ficheiro de classe (no meu caso, Class1.vb) e, em seguida, criar as funções que pretende utilizar no Reporting Services. No meu caso, apenas criar uma função de partilhada simples.
   
   Nota Visto tratar-se uma função partilhada (estático no C#), não é necessário acedê-lo utilizando um objecto com instâncias criadas. Tenha isto em mente, este tem um efeito no modo como é fazer referência a nossa assemblagem posteriormente no artigo.

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

4. Depois de ter terminado a adicionar todo o código, clique em Criar SimpleClassLibrary no menu de criar . Este passo cria a assemblagem ou .dll geridos na pasta respectiva posição. O exemplo, este passo criado a assemblagem, SimpleClassLibrary.dll, na pasta Os meus Documents\Visual Studio 2005\Projects\ SimpleClassLibrary\bin\Debug.

Copie a assemblagem personalizada para as pastas SQL Reporting Services

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

@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"

Adicionar uma referência à assemblagem personalizado no Reporting Services

1. Abra o relatório fizer referência a assemblagem personalizada.
2. No menu relatório , clique em Propriedades do relatório .
3. Na caixa de diálogo Propriedades do relatório , clique no separador de referências .
4. Em referências , clique no botão reticências (... ) junto de cabeçalho da coluna nome da assemblagem .
   
   Nota A secção de classes é apenas para instância baseadas em membros. Não é para membros estáticos. Estática (também referida como "partilha" em alguns nossa documentação de serviços de relatório) significa que o membro está disponível para cada instância da classe e todas as ocorrências utiliza a mesma localização de armazenamento. Membros estáticos são declarados utilizando a palavra-chave partilhada no Visual Basic e a palavra-chave estática no C#. Isto pode ser um pouco confuso. O que isto significa é, se a assemblagem personalizada contiver membros de instância tem de aceder, terá de especificar o nome de classe e nome de instância na secção classes . Uma vez que o método que irá ser chamar a partir dos serviços de relatório foi definido como estático utilizando a palavra-chave partilhada no Visual Basic, vai utilizar a secção referências em vez da secção de classes .
5. Na caixa de diálogo Adicionar referências , clique em Procurar . (No SQL Server 2005, clique no separador Procurar .)
6. Localize e clique em assemblagem personalizada. Clique em Abrir . (No SQL Server 2005, clique em Adicionar em vez de Abrir .)
7. Na caixa de diálogo Adicionar referências , clique em OK .
8. Na caixa de diálogo Propriedades do relatório , clique em OK .

1. Abra o relatório (um ficheiro .RDL) no estruturador de relatórios.
2. Para demonstrar como utilizar a assemblagem personalizada no Reporting Services, adicione uma caixa de texto. Para efectuar este procedimento, arraste uma caixa de texto em branco da caixa de ferramentas para o relatório.
3. Nas propriedades da caixa de texto, clique na propriedade valor e, em seguida, chamar uma função utilizando a sintaxe seguinte.

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

   No exemplo, É especificado o seguinte.

   =SimpleClassLibrary.Class1.DoSomething()

   Outros formatos são utilizados para referenciar o código no Reporting Services. Por exemplo, utilize o seguinte formato se chamar incorporado código.

   =Code.MethodName()

   se chamar um utilizador não estático ou instância com base, método de dentro de uma assemblagem personalizada utilizando uma instância, utilizar o seguinte formato.

   =Code.InstanceName.Method

   Nota Seria definiu uma referência diferente se pretender utilizar um método baseado na instância. Para efectuar este procedimento, faria necessita para aceder às Propriedades do relatório , clique no separador referências e, em seguida, especificar o nome de classe e o nome de instância na secção classes .

Código de segurança de acesso se a assemblagem personalizada requer 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>

Código incorporado

1. No menu relatório , clique em Propriedades do relatório .
2. Na caixa de diálogo Propriedades do relatório , clique no separador de 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 à propriedade de valor .

   =code.EmbeddedFunction

Voltar ao topo | Submeter comentários