Condividi tramite

  • Articolo

Formattazione del file script di Reporting Services

Uno script di Reporting Services è un file di codice Microsoft Visual Basic .NET, specificato su un proxy generato 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 script deve contenere una routine Main. La routine Main è la prima routine alla quale viene eseguito l'accesso quando si esegue il file script. Nella routine Main è possibile aggiungere le operazioni del servizio Web ed eseguire le sottoroutine definite dall'utente. Nel codice seguente viene creata una routine 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) all'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 libreria 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
Nota sulla protezioneNota sulla protezione

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 utilizzare la variabile rs per impostare l'autenticazione del servizio Web, si consiglia di utilizzare l'ambiente di script. Non è necessario autenticare il servizio Web nel file script. Per ulteriori informazioni sull'autenticazione degli ambienti di script, vedere Utilità rs.

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

Per ulteriori informazioni su esempi di script, vedere la pagina relativa agli esempi del prodotto per SQL Server Reporting Services.