Примеры URL-адресов для элементов на сервере отчетов — режим SharePoint
Чтобы опубликовать отчеты и связанные элементы в библиотеке SharePoint, можно опубликовать содержимое с помощью средств разработки служб Reporting Services, таких как конструктор отчетов. Вы также можете отправить содержимое с помощью действий сайта SharePoint.
Сайты SharePoint используют разные веб-адреса, отличные от сервера отчетов Служб Reporting Services в собственном режиме. Веб-иерархия сайта SharePoint включает веб-приложение SharePoint, сайт верхнего уровня, необязательные вложенные сайты и библиотеки. Необходимо знать, как создать URL-адрес, указывающий сервер SharePoint и расположение в иерархии сайта SharePoint, где требуется опубликовать отчет или связанные элементы.
К элементам, связанным с отчетом, относятся общие источники данных, вложенные отчеты, детализированные отчеты и ресурсы, например файлы веб-изображений. Отчет, опубликованный в библиотеке SharePoint, должен указывать эти связанные элементы по их расположению в библиотеке SharePoint.
Используйте примеры, приведенные в этой статье, чтобы создать URL-адреса для отчетов и связанных элементов в решениях отчетов.
Иерархия сайтов
При настройке сервера отчетов для запуска в режиме интеграции с SharePoint для адресации элементов, обрабатываемых и управляемых сервером отчетов, используется веб-иерархия SharePoint.
Для доступа к содержимому сервера отчетов и его защите могут быть использованы следующие элементы веб-иерархии. Другие объекты, такие как списки и страницы, не используются для доступа к содержимому сервера отчетов и поэтому не описаны в следующей таблице.
| Объект | Description |
|---|---|
| Веб-приложение SharePoint | Веб-приложение SharePoint может быть установлено как на изолированном сервере, так и в составе фермы, содержащей коллекцию виртуальных серверов. Веб-приложение имеет URL-адрес (например, http:*//servername*) и может содержать несколько сайтов. |
| Сайт | Сайт является либо родительским сайтом для веб-приложения, либо вложенным сайтом. |
| библиотека SharePoint | Библиотека содержит документы или папки. Библиотека и папка являются единственными объектами сайта, в которых могут храниться отчеты, модели отчетов, общие источники данных и внешние изображения. |
| Товар | Элементы сервера отчетов, на которые можно ссылаться по URL-адресу, включают в себя определения отчетов (для основного или вложенного отчета), модели отчетов, общие источники данных и внешние изображения. |
Синтаксис URL-адреса и правила
Каждый элемент сервера отчетов в библиотеке можно определить по полному URL-адресу. URL-адрес включает префикс протокола, имя сервера, сайт, библиотеку, имя файла и расширение имени файла для типа файла.
URL-адрес сервера SharePoint
При развертывании проекта сервера отчетов или модели отчетов из SQL Server Data Tools (SSDT) на сервере отчетов необходимо использовать URL-адрес сервера SharePoint.
Чтобы узнать имя сервера, откройте браузер и найдите библиотеку SharePoint, в которой необходимо опубликовать отчет. Имя сервера указывается сразу после префикса протокола, например http:*//servername*.
Использование конечной точки прокси-сервера URL-адреса служб Reporting Services не поддерживается. Конечная точка прокси включает номер порта, например http:*//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-адресе, должно включать расширение.
Нельзя использовать относительные URL-адреса для зависимых элементов в отчетах, которые вы публикуете на сайте SharePoint. Например, нельзя использовать относительный URL-адрес для ссылки на общий источник данных, модель отчета или вложенный отчет. Для каждого элемента должен всегда указываться полный URL-адрес в библиотеке SharePoint. Нет способа предсказать расположение зависимых файлов. Вы не можете предсказать его, так как не существует предопределенной иерархии для сайтов, которые можно использовать для анализа формата URL-адреса.
При публикации или передаче отчета, который содержит зависимые элементы, ссылки на них необходимо задавать после публикации отчета. Ссылки, которые работали правильно в режиме предварительной версии в конструктор отчетов, не гарантированы работать после публикации отчета. Дополнительные сведения см. в статье "Публикация из средства разработки в библиотеку SharePoint".
URL-адреса для внешних образов
Определение отчета может включать изображения, которые хранятся в виде внешних файлов. Ссылаться на эти файлы можно в определении отчета, указывая полный URL-адрес файла изображения. Он может храниться как на сайте SharePoint, так и на удаленном компьютере.
Внимание
Если внешний URL-адрес изображения указывает на сайт SharePoint, то при предварительном просмотре отчета в построителе отчетов появляется значок разорванного изображения. После передачи отчета на сайт SharePoint и обработки отчета в подключенном режиме значок разорванного изображения появляется, если имеются только разрешения View Items .
Независимо от режима работы сервера отчетов ссылки на файлы внешних изображений в отчете должны быть полными URL-адресами. Кроме того, использование ссылок на внешние изображения обычно требует настройки учетной записи для автоматической обработки отчета.
Указание вложенных отчетов и отчетов детализации
Вложенные отчеты должны находиться в той же папке, что и главный отчет. Нельзя указать относительную папку.
Чтобы указать детализированные отчеты, включите в выражение URL-адрес. Например, укажите отчет с именем SalesDetails в качестве детализации отчета. В действии для текстового поля или заполнителя задайте для параметра ReportName следующее выражение:
="https://site/subsite/documentlibrary/SalesDetails.rdl"
Зарезервированные имена на сайтах SharePoint
Если вы создаете или создаете URL-адрес элемента, расположенного на сайте SharePoint, знают, что слова "Личные " и "Сайты " являются зарезервированными именами на сайте по умолчанию.
Примеры URL-адресов
При публикации элементов в библиотеке SharePoint необходимо указывать полный URL-адрес целевой библиотеки. Полный URL-адрес SharePoint включает веб-приложение SharePoint, сайт, библиотеку, папку (необязательно), имя и расширение файла. В следующем примере приведено несколько примеров синтаксиса, которым следует пользоваться.
| Назначение | Пример URL-адреса |
|---|---|
| Сервер SharePoint. | https://TestServer |
| Сайт или дочерний сайт сервера SharePoint. | https://TestServer/toplevelsite/subsite |
| Пример отчета о продажах компании в общих документах в развертывании Windows SharePoint Services или SharePoint Foundation 2010. | https://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl |
| Пример отчета о продажах компании в папке Documents/Doc в экземпляре Office SharePoint Server или SharePoint Server 2010. | https://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl |
| Пример отчета о продажах компании в Центре отчетов на экземпляре Office SharePoint Server или SharePoint Server 2010. | https://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-файла. RSDS-файл не может быть сохранен локально с сайта SharePoint и импортирован в существующий проект служб Reporting Services. Общие источники данных с расширениями имен файлов RDS и RSDS не являются взаимозаменяемыми.
Общие источники данных из конструктор отчетов
Если вы публикуете общие источники данных из проекта конструктор отчетов, можно использовать URL-адрес, указывающий целевую библиотеку, или оставить свойство пустым. В отличие от собственного режима служб Reporting Services, нельзя указать относительную папку; относительные пути недопустимы. Если папка в пути библиотеки документов не существует, создается папка. Если оставить целевую папку источника данных пустой, источник данных публикуется в целевой папке отчета.
Имена файлов
Имя файла в URL-адресе элементов отчета должно включать расширение, определяющее тип файла. При публикации элементов отчета из средства разработки отчетов расширение имени файла добавляется автоматически. Если элемент отчета передается в библиотеку SharePoint, необходимо указать расширение файла.
Если не указать расширение имени файла для элементов, которые вы отправляете на сайт SharePoint, возникает ошибка rsInvalidDataSourceReference . Имена файлов могут не содержать символы, которые не распознаны как допустимые символы имени файла приложениями SharePoint. Не включайте следующие символы: # % & * : < > ? / { | }
Различия между отправкой и публикацией
При использовании конструктор отчетов или построитель отчетов для публикации отчетов и связанных файлов в библиотеке система проверяет файлы перед их добавлением. При передаче отчетов и связанных файлов с помощью действия Передача из библиотеки SharePoint никакая проверка не проводится. Вы не знаете, является ли файл допустимым, пока вы не получите доступ к отчету, управляя, редактируется или запускаете его.
Обновление опубликованного элемента
После публикации или отправки элемента в библиотеку SharePoint перед его обновлением необходимо извлечь элемент из библиотеки. Хотя отчет извлечен, вы являетесь единственным пользователем, у которого есть разрешение на изменение отчета. Когда вы закончите, проверьте его обратно.
Вы можете сначала отправить или опубликовать отчет, не извлекая документ, например, отправляя элемент с тем же именем, что и существующий элемент. Если это сделать, сервер отчетов проверяет его для вас, добавляет обновленный отчет в качестве новой версии существующего элемента, а затем проверяет документ обратно.
Внешние изображения в качестве ресурсов
Сервер отчетов, работающий в собственном режиме, поддерживает концепцию ресурса. Концепция ресурса определяется как любой файл, хранящийся и защищенный на сервере отчетов, но сервер отчетов не обрабатывает его. В собственном режиме это может быть файл любого типа.
Когда сервер отчетов работает в режиме интеграции с SharePoint, для ресурса используется более узкое определение. Сервер отчетов поддерживает ресурсы для хранимых отчетов, ссылающихся на внешние изображения. Эта концепция применяется, если отчет является моментальным снимком или копией, которая хранится для внутреннего использования.