Файл конфигурации RSWebApplication

Статья
12/15/2008

Изменения: 17 июля 2006 г.

В файле RSWebApplication.config хранятся параметры конфигурации для диспетчера отчетов. В этом файле указываются параметры распространения отчета, а также количество открытых соединений для каждого пользователя.

Размещение файла

Файл находится в папке \Reporting Services\ReportManager.

Правила редактирования

Путем редактирования этого файла можно ограничивать число открытых соединений, изменять модуль доставки по умолчанию, а также формат подготовки к просмотру для каждого модуля доставки.

Пример конфигурации по умолчанию

В следующем примере показаны некоторые параметры и значения по умолчанию в файле RSWebApplication.config.

<Configuration>
     <UI>
     <ReportServerUrl></ReportServerUrl>
     <ReportServerVirtualDirectory>ReportServer</ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
     </UI>
     <Extensions>
          <DeliveryUI>
               <Extension Name="Report Server Email" Type="Microsoft.ReportingServices.EmailDeliveryProvider.EmailDeliveryProviderControl,ReportingServicesEmailDeliveryProvider">
                    <DefaultDeliveryExtension>True</DefaultDeliveryExtension>
                    <Configuration>
                         <RSEmailDPConfiguration>
                              <DefaultRenderingExtension>MHTML</DefaultRenderingExtension>
                         </RSEmailDPConfiguration>
                    </Configuration>
               </Extension>
               <Extension Name="Report Server FileShare" Type="Microsoft.ReportingServices.FileShareDeliveryProvider.FileShareUIControl,ReportingServicesFileShareDeliveryProvider"/>
          </DeliveryUI>
     </Extensions>
     <Add Key="MaxActiveReqForOneUser" Value="20"/>
     <Add Key="DisplayErrorLink" Value="true"/>
</Configuration>

Пример альтернативной конфигурации для доступа к конечной точке сервера отчетов

В данном примере показано, как использовать параметр ReportServerUrl вместо ReportServerVirtualDirectory.

Важно!
Настройки конфигурации учитывают регистр. При добавлении новых записей убедитесь, что настройки введены точно так, как показано. При использовании неправильного регистра будет получено сообщение об ошибке, подобное такому: «В файле конфигурации содержится недопустимый элемент. Элемент ElementName не является элементом файла конфигурации».

Настройки конфигурации учитывают регистр. При добавлении новых записей убедитесь, что настройки введены точно так, как показано. При использовании неправильного регистра будет получено сообщение об ошибке, подобное такому: «В файле конфигурации содержится недопустимый элемент. Элемент ElementName не является элементом файла конфигурации».

<UI>
     <ReportServerUrl>https://www.adventure-works.com/ReportServer</ReportServerUrl>
     <ReportServerVirtualDirectory></ReportServerVirtualDirectory>
     <ReportBuilderTrustLevel>FullTrust</ReportBuilderTrustLevel>
</UI>

Параметры конфигурации

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

Параметр	Описание
ReportServerVirtualDirectory	Задает конечную точку SOAP сервера отчетов, используемого диспетчером отчетов. Это значение представляет собой имя виртуального каталога сервера отчетов. Например, если сервер отчетов имеет URL-адрес http://adventure-works.com/reportserver, то значением для установки ReportserverVirtualDirectory будет reportserver. Этот параметр требует, чтобы диспетчер отчетов и сервер отчетов использовали один веб-узел. Если они используют разные веб-узлы, удалите значение аргумента ReportServerVirtualDirectory и используйте вместо него ReportServerURL. Дополнительные сведения об URL-адресах и данном параметре см. в разделах Настройка виртуальных каталогов сервера отчетов и Настройка сервера отчетов для доступа через Интернет.
ReportServerUrl	Позволяет альтернативным способом указывать конечную точку SOAP сервера отчетов, который используется диспетчером отчетов. Можно использовать эту настройку вместо ReportServerVirtualDirectory, когда диспетчер отчетов и виртуальные каталоги сервера отчетов расположены на разных серверах или веб-узлах или когда требуется указать полное имя домена для сервера отчетов. Параметры ReportServerURL и ReportServerVirtualDirectory являются взаимоисключающими. Если задан параметр ReportServerURL, то необходимо удалить запись для ReportServerVirtualDirectory. Чтобы задать этот параметр, необходимо вручную отредактировать файл RSWebApplication.config. В случае использования сертификатов допустимыми будут значения http://<server>/<reportserver> или https://<server>/<reportserver>. Если диспетчер отчетов установлен отдельно на веб-сервере, подключенном к Интернету, то в качестве этого значения должно быть задано полное имя домена, которое может применяться для доступа к экземпляру сервера отчетов, защищенному брандмауэром. Этот параметр никогда не принимает значение localhost. Если установлен сертификат протокола SSL, то этому значению необходимо присвоить имя сервера, зарегистрированного для данного сертификата. Если возникает сообщение об ошибке «Базовое соединение закрыто: не удалось установить доверительную связь для безопасного канала SSL/TLS», задайте в качестве значения параметра ReportServerUrl полное доменное имя сервера, для которого был выдан сертификат. Например, если сертификат зарегистрирован для домена https://adventure-works.com.onlinesales, то сервер отчетов будет иметь URL-адрес https://adventure-works.com.onlinesales/reportserver. Чтобы увидеть, как применяется эта настройка, см. пример, приведенный в этом разделе. Дополнительные сведения об URL-адресах и данном параметре см. в разделе Настройка виртуальных каталогов сервера отчетов.
ReportBuilderTrustLevel	Указывает, запущен ли построитель отчетов с полным или частичным уровнем доверия. Допустимые значения: FullTrust и PartialTrust. Значение по умолчанию равно FullTrust. Дополнительные сведения об этих уровнях доверия см. в разделе Запуск построителя отчетов.
PassThroughCookies	Этот параметр не включен в файл конфигурации по умолчанию. Для его использования необходимо вручную добавить соответствующую строку. Этот параметр настраивает диспетчер отчетов для проведения нестандартной проверки подлинности файлов «cookie». Дополнительные сведения о параметрах конфигурации и пример указания настроек конфигурации см. в разделе Настройка диспетчера отчетов для передачи файлов «cookie» для проверки подлинности пользователя.
ReportServerExternalUrl	Эта настройка более не используется. В предыдущих версиях она применялась для предоставления полного URL-адреса сервера отчетов приложениям и внутренним процессам, которым надо было отправлять запросы на сервер отчетов за брандмауэром. Этот параметр не был включен в файл конфигурации по умолчанию. Если он был добавлен вручную, его можно либо оставить в файле, либо удалить. Обратите внимание на то, что в этой версии развертывание построителя отчетов на сервере отчетов, имеющем выход в Интернет, считается непроверенным сценарием развертывания. Если в прошлом этот параметр использовался для поддержки доступа к построителю отчетов через Интернет, следует рассмотреть альтернативную стратегию.
DeliveryUI	Задает модули доставки, которые могут использоваться с подписками. Имена модулей, заданные в этом разделе, отображаются в виде параметров доставки на страницах определения подписки диспетчера отчетов. Службы Reporting Services по умолчанию содержат два модуля доставки для подписок: электронную почту и общую папку сервера отчетов. Дополнительные сведения см. в разделах Настройка сервера отчетов для работы с электронной почтой и Доставка в общую папку с помощью служб Reporting Services.
DefaultDeliveryExtension	Указывает, является ли данный модуль доставки модулем по умолчанию. Электронная почта сервера отчетов является модулем доставки по умолчанию. Допустимые значения: True и False. Если несколько модулей доставки содержат значение True, то модулем доставки по умолчанию считается первый модуль.
Configuration	Задает параметры конфигурации для модуля доставки. Для каждого модуля доставки можно задать формат подготовки к просмотру по умолчанию. Допустимыми значениями являются имена модулей подготовки отчетов, указанные в файле rsreportserver.config в разделе подготовки к просмотру.
MaxActiveReqForOneUser	Указывает максимальное количество одновременно созданных соединений с диспетчером отчетов, которые может открыть один пользователь. По достижении предельного значения дальнейшие запросы пользователя на соединение запрещаются. Эта настройка конфигурации предназначена для предотвращения воздействия, вызывающего отказ в обслуживании законных пользователей. Допустимые значения: от 0 до максимального значения, заданного целым числом. 0 соответствует неограниченному количеству соединений. Значение по умолчанию равно 20. Обратите внимание, что большинство запросов выполняется очень быстро, поэтому маловероятно, что для одного пользователя одновременно будут открыто более 20 соединений. Если пользователи открывают одновременно более 15 отчетов, интенсивно использующих процессы, то, возможно, это значение нужно увеличить.
DisplayErrorLink	Отображает ссылку на веб-узел справки и поддержки Майкрософт. Эта ссылка появляется в сообщениях об ошибке. Пользователи могут перейти по ней на веб-узел, чтобы просмотреть обновленное содержимое сообщения об ошибке. Допустимые значения: true и false. Значение по умолчанию: true.

См. также

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Новое содержимое Добавлен пример, демонстрирующий, как указывать ReportServerUrl.

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

Файл конфигурации RSWebApplication

Размещение файла

Правила редактирования

Пример конфигурации по умолчанию

Пример альтернативной конфигурации для доступа к конечной точке сервера отчетов

Параметры конфигурации

См. также

Основные понятия

Другие ресурсы

Справка и поддержка

Журнал изменений

Дополнительные ресурсы