Развертывание отчетов, моделей и общих источников данных на узле SharePoint

Статья
12/15/2008

Добавления: 12 декабря 2006 г.

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

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

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

Иерархия узла

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

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

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

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

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

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

URL-адрес сервера SharePoint указывается при развертывании проекта сервера отчетов или модели отчетов из среды Business Intelligence Development Studio на сервере отчетов.

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

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

URL-адрес узла или вложенного узла SharePoint

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

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

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

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

В Microsoft Windows SharePoint Services 3.0 библиотека указывается после имени сервера, например http://*имя_сервера/*Shared Documents.

В Office SharePoint Server 2007 библиотека указывается после имени узла и вложенного узла. Например: http://*имя_сервера/узел/*Documents.

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

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

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

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

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

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

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

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

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

Зарезервированные имена на узлах SharePoint

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

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

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

Цель	Пример URL-адреса
Сервер SharePoint.	http://тестовый_сервер
Узел или вложенный узел сервера SharePoint.	http://тестовый_сервер/узел/вложенный_узел
Образец отчета Company Sales в папке Общие документы в развернутых службах Windows SharePoint Services.	http://тестовый_сервер/тестовый_узел/Shared Documents/CompanySales.rdl
Образец отчета Company Sales в папке Документы на экземпляре служб Office SharePoint Server .	http://тестовый_сервер/тестовый_узел/Documents/Doc/CompanySales.rdl
Образец отчета Company Sales в папке Центр отчетов на экземпляре Office SharePoint Server .	http://тестовый_сервер/тестовый_узел/Reports/Doc/CompanySales.rdl

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

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

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

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

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

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

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

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

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

Если публикация общих источников данных (RDS или SMDL-файлов) производится из проекта конструктора моделей, необходимо указывать URL-адрес целевой библиотеки. Относительные пути указывать нельзя, они недопустимы. Если папка в пути библиотеки документа не существует, она будет создана. И модель (SMDL), и общий источник данных (RSDS) будут опубликованы в этой папке, например http://сервер/узел/Documents/Data Sources.

Имена файлов

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

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

Если в определении отчета содержатся ссылки на вложенные отчеты, необходимо указывать их полные URL-адреса. Относительные пути указывать нельзя, они недопустимы.

Указание ссылок на зависимые элементы

Определение отчета, созданного с помощью построителя отчетов, содержит ссылку на модель отчета и источник данных модели, используемые при построении отчета. Они указаны в файле определения отчета. Если этот отчет добавляется в проект сервера отчетов для внесения изменений и последующей публикации в библиотеке SharePoint, то необходимо открыть его в библиотеке SharePoint и заново привязать ссылки на источник данных. Повторная привязка источника данных необходима только при первой публикации отчета. Сервер отчетов не в состоянии из определения отчета выяснить, является источник данных RSDS или SMDL-файлом. Дополнительные сведения см. в разделе Как привязать отчет или модель к общему источнику данных.

Публикация на узле SharePoint элементов до пакета обновления 2

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

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

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

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

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

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

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

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

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

См. также

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