Formattare un file di script di Reporting Services

  • Articolo

Uno script Reporting Services è un file di codice Visual Basic specificato su un proxy compilato in WSDL (Web Service Description Language), che definisce l'API SOAP di Reporting Services. Un file script viene archiviato come file di testo Unicode o UTF-8 con estensione .rss.

Il file script funge da modulo Visual Basic e può contenere procedure definite dall'utente e variabili a livello del modulo. Per una corretta esecuzione, il file di script deve contenere una procedura Main. La procedura Main è la prima alla quale viene eseguito l'accesso quando si esegue il file di script. In Main è possibile aggiungere le operazioni del servizio Web ed eseguire le sottoprocedure definite dall'utente. Nel codice seguente viene creata una procedura Main:

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

L'ambiente di script si connette automaticamente al server di report, crea la classe proxy Web e genera una variabile di riferimento (rs) nell'oggetto proxy del servizio Web. Le singole istruzioni che vengono create devono solo fare riferimento alla variabile a livello di modulo rs per eseguire una delle operazioni del servizio Web disponibili nella raccolta del servizio Web. Il codice Visual Basic seguente chiama il metodo ListChildren del servizio Web dall'interno di un file 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

Le credenziali dell'utente vengono gestite dall'ambiente di script e vengono passate agli argomenti del prompt dei comandi tramite RS.exe. Anche se è possibile usare la variabile rs per impostare l'autenticazione del servizio Web, si consiglia di usare l'ambiente di script. Non è necessario autenticare il servizio Web nel file di script. Per altre informazioni sull'autenticazione degli ambienti di script, vedere Utilità RS.exe (SSRS).

Non dichiarare gli spazi dei nomi all'interno del file di script. L'ambiente di scripting rende disponibili diversi utili spazi dei nomi Microsoft .NET framework di System.Web.Services, System.Web.Services.Protocols, System.Xml e System.IO:

Per esempi di script, vedere SQL Server Reporting Services Product Samples(Esempi del prodotto SQL Server Reporting Services).

Contenuto correlato