Примеры URL-адресов для элементов опубликованного отчета на сервере отчетов в режиме SharePoint (SSRS)

Чтобы опубликовать отчеты и связанные с ними элементы в библиотеке SharePoint, можно опубликовать содержимое с помощью таких средств разработки Службы Reporting Services, как конструктор отчетов, или передать содержимое средствами сайта SharePoint.

Сайты SharePoint используют веб-адреса, отличные от адресов сервера отчетов служб Службы Reporting Services в собственном режиме. Веб-иерархия сайта SharePoint включает веб-приложение SharePoint, сайт верхнего уровня, необязательные вложенные сайты и библиотеки. Необходимо знать правила создания URL-адреса, определяющего сервер SharePoint и расположение объектов иерархии сайта SharePoint, на котором будет опубликован отчет или связанные с ним элементы.

К элементам, связанным с отчетом, относятся общие источники данных, вложенные отчеты, детализированные отчеты и ресурсы, например файлы веб-изображений. Отчет, опубликованный в библиотеке SharePoint, должен указывать расположение таких связанных элементов в библиотеке SharePoint.

Примеры в этом разделе помогут создавать URL-адреса для отчетов и связанных с ними элементов в ваших системах отчетности.

Иерархия сайта

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

Для доступа к содержимому сервера отчетов и его защите могут быть использованы следующие элементы веб-иерархии. Прочие объекты (списки, страницы и т. д.) не используются для доступа к содержимому сервера отчетов и в данной таблице не описаны.

Объект	Описание
Веб-приложение SharePoint	Веб-приложение SharePoint может быть установлено как на изолированном сервере, так и в составе фермы, содержащей коллекцию виртуальных серверов. Веб-приложение имеет URL-адрес (например, https://servername) и может содержать несколько веб-сайтов.
Сайт	Сайт является либо родительским сайтом для веб-приложения, либо вложенным сайтом.
Библиотека SharePoint	Библиотека содержит документы или папки. Библиотека и папка являются единственными объектами сайта, в которых могут храниться отчеты, модели отчетов, общие источники данных и внешние изображения.
Элемент	Элементы сервера отчетов, на которые можно ссылаться по URL-адресу, включают в себя определения отчетов (для основного или вложенного отчета), модели отчетов, общие источники данных и внешние изображения.

Синтаксис и правила формирования URL-адресов

Каждый элемент сервера отчетов в библиотеке характеризуется полным URL-адресом, который состоит из префикса протокола, имени сервера, сайта, библиотеки, имени и расширения файла.

URL-адрес сервера SharePoint

URL-адрес сервера SharePoint указывается при развертывании на сервере отчетов проекта сервера отчетов или модели отчетов из среды SQL Server Data Tools (SSDT).

Чтобы узнать имя сервера, откройте браузер и найдите библиотеку SharePoint, в которой необходимо опубликовать отчет. Имя сервера указывается сразу после префикса протокола, например, https://servername.

Конечная точка-посредник для URL-адреса служб Службы Reporting Services не поддерживается. Конечная точка прокси включает номер порта, например, https://servername:8080/reportserver.

URL-адрес сайта или дочернего сайта SharePoint

При развертывании отчета или источника данных необходимо указывать URL-адрес сайта и вложенного сайта SharePoint, если он есть. В URL-адресе имя веб-сайта находится сразу после имени сервера, например, https://servername/site или https://servername/site/subsite.

В Microsoft Office SharePoint Server 2007 или веб-приложении SharePoint Server 2010 сайт и дочерний сайт часто соответствуют вкладкам на основном сайте. Чтобы узнать имя сайта, выберите Корневая папка, а затем Все содержимое сайта. Прокрутите страницу до конца и найдите раздел Сайты и рабочие области. В этом разделе отображается список сайтов.

URL-адрес библиотеки SharePoint

При развертывании отчета или связанного элемента в библиотеке SharePoint необходимо указывать URL-адрес этой библиотеки. Точная структура URL-адреса для библиотеки зависит от версии SharePoint.

В Microsoft Windows SharePoint Services 3.0 и SharePoint Foundation 2010 библиотека появляется сразу после имени сервера, например, https://servername/Shared Documents.

В Office SharePoint Server 2007 или SharePoint Server 2010 библиотека указывается после имени сайта и дочернего сайта. Например, https://servername/site/Documents.

Чтобы узнать путь к новой библиотеке SharePoint или к незнакомому сайту, откройте браузер и найдите библиотеку SharePoint, в которой должен быть опубликован отчет. Если библиотека пуста, передайте в нее любой файл. Чтобы открыть окно Свойства, щелкните правой кнопкой мыши этот файл и выберите пункт Свойства. Адрес файла содержит URL-адрес, который необходим для публикации.

Полные URL-адреса для элементов сайта SharePoint

К элементам, которые хранятся в библиотеке SharePoint, необходимо обращаться по полным URL-адресам, которые начинаются с веб-приложения (https://server) как корневого узла и заканчиваются именем файла, к которому вы обращаетесь.

Имя файла, указанное в URL-адресе, должно включать расширение.

Для зависимых элементов в отчетах, публикуемых на сайте SharePoint, нельзя использовать относительные URL-адреса. Например, нельзя указать относительный URL-адрес для ссылки на общий источник данных, модель отчета или вложенный отчет. Для каждого элемента должен всегда указываться полный URL-адрес в библиотеке SharePoint. Невозможно предсказать, где будет расположен зависимый файл, поскольку отсутствует стандартная иерархия для сайтов, которую можно было бы использовать при синтаксическом анализе формата URL-адреса.

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

URL-адреса для внешних изображений

Определение отчета может включать изображения, которые хранятся в виде внешних файлов. Ссылаться на эти файлы можно в определении отчета, указывая полный URL-адрес файла изображения. Он может храниться как на сайте SharePoint, так и на удаленном компьютере.

Важно!
Если внешний URL-адрес изображения указывает на сайт SharePoint, то при предварительном просмотре отчета в построителе отчетов появляется значок разорванного изображения. После передачи отчета на сайт SharePoint и обработки отчета в подключенном режиме значок разорванного изображения появляется, если имеются только разрешения View Items.

Независимо от режима работы сервера отчетов ссылки на файлы внешних изображений в отчете должны быть полными URL-адресами. Кроме того, использование ссылок на внешние изображения обычно требует настройки учетной записи для автоматической обработки отчета.

Задание вложенных отчетов и детализированных отчетов

Вложенные отчеты должны находиться в той же папке, что и главный отчет. Нельзя указывать относительную папку.

Чтобы указать детализированные отчеты, включите в выражение URL-адрес. Например, чтобы указать отчет с именем SalesDetails в качестве детализированного, в окне действия для текстового поля или текста-заполнителя установите в параметре ReportName следующее выражение:

="http://site/subsite/documentlibrary/SalesDetails.rdl"

Зарезервированные имена на сайтах SharePoint

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

Примеры URL-адресов

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

Назначение	Пример URL-адреса
Сервер SharePoint.	http://тестовый_сервер
Сайт или дочерний сайт сервера SharePoint.	http://тестовый_сервер/сайт/дочерний_сайт
Образец отчета Company Sales в папке Общие документы в развертывании Windows SharePoint Services или SharePoint Foundation 2010.	http://тестовый_сервер/тестовый_сайт/Общие%20документы/Company%20Sales.rdl
Образец отчета «Company Sales» (Продажи компании) в папке Documents/Doc на экземпляре Office SharePoint Server или SharePoint Server 2010.	http://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl
Образец отчета «Продажи компании» в папке Центр отчетов на экземпляре Office SharePoint Server или SharePoint Server 2010.	http://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl

Публикация в библиотеке SharePoint из средств разработки

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

Примечание
Для публикации отчетов на сайте SharePoint из среды SQL Server Data Tools (SSDT) может понадобиться добавить сайт SharePoint в список надежных расположений в браузере Internet Explorer.

Общие источники данных

При публикации общего источника данных из средства разработки отчетов задается свойство проекта TargetDataSourceFolder. Это свойство определяет папку целевого источника данных и должно представлять собой URL-адрес библиотеки SharePoint. В отличие от служб Службы Reporting Services в собственном режиме, указание относительных путей недопустимо. Если папка в пути библиотеки документа не существует, она будет создана.

При публикации общего источника данных (RDS-файла) на сайте SharePoint, его расширение изменяется на RSDS. После этого он не может быть ни сохранен локально с сайта SharePoint, ни импортирован в существующий проект служб Службы Reporting Services. Общие источники данных с расширениями RDS и RSDS не являются взаимозаменяемыми.

Общие источники данных из конструктора отчетов

При публикации общего источника данных из проекта конструктора отчетов необходимо либо указать URL-адрес целевой библиотеки, либо оставить это поле пустым. В отличие от служб Службы Reporting Services в собственном режиме, указание относительных путей недопустимо. Если папка в пути библиотеки документа не существует, она будет создана. Если поле папки целевого источника данных оставить пустым, источник данных будет опубликован в папке целевого отчета.

Имена файлов

Имя файла в URL-адресе элементов отчета должно включать расширение, определяющее тип файла. При публикации элементов отчета из средства разработки отчетов расширение имени файла добавляется автоматически. Если элемент отчета передается в библиотеку SharePoint, необходимо указать расширение файла.

Если не указать расширение файла для элементов, передаваемых на сайт SharePoint, возникнет ошибка rsInvalidDataSourceReference. Имена файлов не могут содержать символы, которые воспринимаются приложениями SharePoint как недопустимые в именах файлов. Не используйте следующие символы: # % & * : < > ? / { | }.

Различия между передачей и публикацией

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

Передача опубликованного элемента

После публикации или передачи элемента в библиотеку SharePoint перед его обновлением необходимо извлечь этот элемент из библиотеки. Пока отчет извлечен пользователем, только этот пользователь будет иметь разрешение на изменение отчета. После окончания работы с отчетом его необходимо вернуть.

Если отчет передан или опубликован без предварительного извлечения (например, при передаче элемента с тем же именем, что и у существующего), то сервер отчетов производит его извлечение, добавление новой версии существующего элемента, а затем возврат документа.

Внешние изображения как ресурсы

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

Когда сервер отчетов работает в режиме интеграции с SharePoint, для ресурса используется более узкое определение. Сервер отчетов поддерживает ресурсы для хранимых отчетов, ссылающихся на внешние изображения. Это относится к отчетам, которые являются моментальными снимками или копиями, сохраняемыми для внутреннего использования.

См. также

Задания

опубликовать отчет в библиотеке SharePoint

опубликовать общий источник данных в библиотеке SharePoint

Справочник

Диалоговое окно страниц свойств проекта