Compartilhar via

  • Artigo

Formatando o arquivo de script do Reporting Services

Um script do Reporting Services é um arquivo de código em Microsoft Visual Basic .NET escrito em um proxy criado em WSDL que define a API SOAP do Reporting Services. Um arquivo de script é armazenado como arquivo de texto Unicode ou UTF-8 com extensão .rss.

O arquivo de script funciona como um módulo Visual Basic e pode conter procedimentos definidos pelo usuário e variáveis do nível de módulo. Para que o arquivo de script seja executado com êxito, ele deve conter um procedimento Main. O procedimento Main é o primeiro procedimento acessado quando o seu arquivo de script é executado. O Main é o local em que você pode acrescentar operações de serviço Web e executar subprocedimentos definidos pelo usuário. O código a seguir cria um procedimento Main:

Public Sub Main()
    ' Your code goes here.
End Sub

O ambiente de script se conecta automaticamente ao servidor de relatório, cria a classe de proxy da Web e gera uma variável de referência (rs) para o objeto proxy de serviço da Web. As instruções individuais que você cria precisam apenas fazer referência à variável do nível de módulo rs para realizar qualquer operação de serviço Web disponível na biblioteca de serviços da Web. O código Visual Basic a seguir chama o método de serviço Web ListChildren do arquivo de script:

Public Sub Main()
    Dim items() As CatalogItem
    items = rs.ListChildren("/", True)

    Dim item As CatalogItem
    For Each item In items
        Console.WriteLine(item.Name)
    Next item
End Sub
Observação sobre segurançaObservação sobre segurança

As credenciais de usuário são administradas pelo ambiente de script e passadas pelos argumentos de prompt de comando pelo uso do RS.exe. Embora seja possível usar a variável rs para definir a autenticação do serviço Web, é recomendável que você utilize o ambiente de script. Não é necessário autenticar o serviço Web no próprio arquivo de script. Para obter mais informações sobre a autenticação do ambiente de script, consulte Utilitário rs.

Não declare namespaces dentro do arquivo de script. O ambiente de geração de scripts torna diversos namespaces Microsoft.NET Framework úteis disponíveis para você: System.Web.Services, System.Web.Services.Protocols, System.Xml e System.IO.

Para obter mais informações sobre exemplos de scripts, consulte SQL Server Reporting Services Product Samples (em inglês).