Partilhar via


Formatar um ficheiro de script do Reporting Services

Um script de Serviços de Relatórios é um ficheiro de código Visual Basic, escrito sobre um proxy construído na Web Service Description Language (WSDL), que define a API SOAP dos Serviços de Relatório. Um ficheiro de script é armazenado como um ficheiro de texto Unicode ou UTF-8 com a extensão .rss.

O ficheiro script funciona como um módulo Visual Basic e pode conter procedimentos definidos pelo utilizador e variáveis ao nível do módulo. Para que o ficheiro de script corra com sucesso, deve conter um Main procedimento. O Main procedimento é o primeiro a ser acedido quando o seu ficheiro de script é executado. Main é onde podes adicionar as operações do teu serviço Web e executar os subprocedimentos definidos pelo utilizador. O seguinte código cria um Main procedimento:

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

O ambiente de script liga-se automaticamente ao servidor de relatórios, cria a classe proxy Web e gera uma variável de referência (rs) para o objeto proxy do serviço Web. As instruções individuais que cria só precisam de se referir à rs variável ao nível do módulo para realizar qualquer uma das operações de serviço Web disponíveis na biblioteca de serviços Web. O seguinte código Visual Basic chama o método do serviço ListChildren Web a partir de um ficheiro 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

As credenciais do utilizador são geridas pelo ambiente de script e passadas através de argumentos no prompt de comando usando RS.exe. Embora possas usar a rs variável para definir a autenticação do serviço Web, deves usar o ambiente de scripts em vez disso. Não precisas de autenticar o serviço Web no ficheiro de script. Para mais informações sobre autenticação do ambiente de scripts, veja RS.exe utilidade (SSRS).

Não declaras namespaces dentro do ficheiro de script. O ambiente de scripting disponibiliza vários namespaces úteis do Microsoft .NET Framework: System.Web.Services, System.Web.Services.Protocols, System.Xml, e System.IO.

Para exemplos de scripts, consulte Exemplos de Produto dos Serviços de Relatórios do SQL Server.