Развертывание моделей и общих источников данных на сайте SharePoint
Для развертывания отчетов, моделей отчетов, общих источников данных и ресурсов в библиотеке 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/сервер_отчетов.
URL-адрес сайта или вложенного сайта SharePoint
При развертывании отчета или источника данных необходимо указывать URL-адрес сайта и вложенного сайта SharePoint, если он есть. В URL-адресе имя сайта указывается сразу после имени сервера, например http://имя_сервера/сайт или http://имя_сервера/сайт/дочерний_сайт.
В веб-приложении Microsoft Office SharePoint Server 2007 или SharePoint Server 2010 сайт и дочерний сайт часто соответствуют вкладкам главного сайта. Чтобы узнать имя сайта, выберите Корневая папка, а затем Все содержимое сайта. Прокрутите страницу до конца и найдите раздел Сайты и рабочие области. В этом разделе отображается список сайтов.
URL-адрес библиотеки SharePoint
При развертывании отчета или связанного элемента в библиотеке SharePoint необходимо указывать URL-адрес этой библиотеки. Точная структура URL-адреса для библиотеки зависит от версии SharePoint.
В Microsoft Windows SharePoint Services 3.0 или SharePoint Foundation 2010 библиотека указывается после имени сервера, например http://имя_сервера/Общие документы.
В Office SharePoint Server 2007 или SharePoint Server 2010 библиотека указывается после имени сайта и дочернего сайта. Например: http://имя_сервера/сайт/Документы.
Чтобы узнать путь к новой библиотеке 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 или SharePoint Foundation 2010. |
http://тестовый_сервер/тестовый_сайт/Общие документы/CompanySales.rdl |
Образец отчета Company Sales в папке Документы на экземпляре Office SharePoint Server SharePoint Server 2010. |
http://тестовый_сервер/тестовый_сайт/Документы/Doc/CompanySales.rdl |
Образец отчета Company Sales в папке Центр отчетов на экземпляре Office SharePoint Server SharePoint Server 2010. |
http://тестовый_сервер/тестовый_сайт/Отчеты/Doc/CompanySales.rdl |
Публикация в библиотеке 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, необходимо указать расширение файла.
Если не указать расширение файла для элементов, передаваемых на сайт SharePoint, возникнет ошибка rsInvalidDataSourceReference. Имена файлов не могут содержать символы, которые воспринимаются приложениями SharePoint как недопустимые в именах файлов. Не используйте следующие символы: # % & * : < > ? / { | }.
Если в определении отчета содержатся ссылки на вложенные отчеты, необходимо указывать их полные URL-адреса. Относительные пути указывать нельзя, они недопустимы.
Указание ссылок на зависимые элементы
Определение отчета, созданного с помощью построителя отчетов, содержит ссылку на модель отчета и источник данных модели, используемые при построении отчета. Они указаны в файле определения отчета. Если этот отчет добавляется в проект сервера отчетов в конструкторе отчетов для внесения изменений и последующей публикации в библиотеке SharePoint, то необходимо открыть его в библиотеке SharePoint и повторно привязать ссылку на источник данных. Повторная привязка источника данных необходима только при первой публикации отчета. Сервер отчетов не в состоянии из определения отчета выяснить, является источник данных RSDS или SMDL-файлом. Дополнительные сведения см. в разделе Как привязать отчет или модель к общему источнику данных.
Публикация на сайте SharePoint элементов до пакета обновления 2
Чтобы опубликовать определения отчетов, модели отчетов и общие источники данных, которые были созданы в версиях средств разработки ранее пакета обновления 2, необходимо открыть или создать проект в версии этого средства разработки с пакетом обновления 2, а затем опубликовать эти файлы.
Или же файлы необходимо передать непосредственно из файловой системы в библиотеку SharePoint, а затем запустить отчет, чтобы проверить его работу. Перед запуском отчета необходимо задать ссылки на все зависимые элементы.
Различия между передачей и публикацией
Если публикация отчетов и связанных с ними файлов производится при помощи конструктора отчетов, построителя отчетов или конструктора моделей, все файлы перед добавлением проверяются. При передаче отчетов и связанных файлов с помощью действия Передача из библиотеки SharePoint никакая проверка не проводится. Является ли файл допустимым, будет неизвестно до тех пор, пока к отчету не будет осуществлен доступ для управления, изменения или запуска.
Передача опубликованного элемента
После публикации или передачи элемента в библиотеку SharePoint перед его обновлением необходимо извлечь этот элемент из библиотеки. Пока отчет извлечен пользователем, только этот пользователь будет иметь разрешение на изменение отчета. После окончания работы с отчетом его необходимо вернуть.
Если отчет передан или опубликован без предварительного извлечения (например, при передаче элемента с тем же именем, что и у существующего), то сервер отчетов производит его извлечение, добавление новой версии существующего элемента, а затем возврат документа.
Внешние изображения как ресурсы
Сервер отчетов, работающий в собственном режиме, поддерживает понятие ресурса, который определяется как произвольный файл, хранение и защита которого обеспечивается сервером отчетов, однако он не обрабатывает его содержимое. В собственном режиме это может быть файл любого типа.
Когда сервер отчетов работает в режиме интеграции с SharePoint, для ресурса используется более узкое определение. Сервер отчетов поддерживает ресурсы для хранимых отчетов, ссылающихся на внешние изображения. Это относится к отчетам, которые являются моментальными снимками или копиями, сохраняемыми для внутреннего использования.