Поделиться через

  • Статья

Форматирование файла сценария служб Reporting Services

Сценарий служб Reporting Services — это файл кода Microsoft Visual Basic .NET, написанный для прокси-сервера, построенного на основе языка описания веб-служб (язык WSDL), определяющего API-интерфейс протокола простого доступа к объектам служб Reporting Services (SOAP). Файл сценария хранится как текстовый файл Юникод или UTF-8 с расширением RSS.

Файл сценария действует как модуль языка Visual Basic. Он может содержать пользовательские процедуры и переменные уровня модуля. Для успешного выполнения файла сценария он должен содержать главную процедуру. Главная процедура — это первая процедура, к которой идет обращение при запуске файла сценария. В ней можно создавать операции веб-службы и запускать определяемые пользователем подпроцедуры. Следующий фрагмент кода создает главную процедуру:

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

Среда сценариев автоматически соединяется с сервером отчетов, создает класс-посредник и формирует ссылку на переменную (rs) для объекта записи-посредника веб-службы. Отдельные создаваемые инструкции должны ссылаться только на переменную уровня модуля rs, для выполнения любых операций веб-службы, доступных в библиотеке веб-службы. Следующий код на языке Visual Basic вызывает метод ListChildren веб-службы из файла сценария:

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
Примечание по безопасностиПримечание по безопасности

Учетными данными пользователей управляет среда сценариев, они передаются через аргументы командной строки с помощью программы RS.exe. Хотя проверку подлинности веб-службы можно задать с помощью переменной rs, рекомендуется использовать среду сценариев. Внутри самого файла сценария выполнять проверку подлинности веб-службы не требуется. Дополнительные сведения о проверке подлинности в среде сценариев см. в разделе Программа rs.

Пространства имен не объявляются в файлах сценариев. Среда сценариев предоставляет доступ к нескольким полезным пространствам имен Microsoft.NET Framework: System.Web.Services, System.Web.Services.Protocols, System.Xml и System.IO.

Дополнительные сведения об образцах сценариев см. на странице Образцы продуктов служб SQL Server Reporting Services.