Тип соединения список SharePoint (службы SSRS)

  • Статья

Область применения: SQL Server 2016 (13.x) Сервер отчетов Power BI SharePoint

Для включения данных из списка Microsoft SharePoint в отчет следует добавить или создать набор данных, основанный на источнике данных отчета типа «Список Microsoft SharePoint». Это встроенный тип источника данных, основанный на модуле обработки данных «Список SharePoint служб Microsoft SQL Server Reporting Services». Используйте этот тип источника данных для подключения к данным в списках и их извлечения из SharePoint 2013 и более поздних версий.

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

Строка подключения

Строка подключения к списку SharePoint — это URL-адрес сайта или дочернего сайта SharePoint, например https://MySharePointWeb/MySharePointSite или https://MySharePointWeb/MySharePointSite/Subsite.

Конструктор запросов автоматически отображает списки SharePoint, для доступа к которым имеются достаточные разрешения.

Дополнительные сведения о примерах строк подключения см. в статье Create data connection strings - Report Builder & SSRS (Создание строк подключения к данным (построитель отчетов и службы SSRS))

Учетные данные

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

В следующих таблицах описано получение учетных данных для расширения списка SharePoint при подключении к локальному списку фермы SharePoint и к удаленному списку SharePoint.

Таблица 1 предназначена для отчетов, развернутых на устаревшем сайте Windows SharePoint. Устаревший сайт Windows поддерживает только проверку подлинности Kerberos, NTLM и проверку подлинности на основе форм (FBA). Таблица 2 предназначена для отчетов, развернутых на сайте SharePoint с проверкой подлинности на основе утверждений.

Таблица 1

Тип извлечения Поддерживаемые учетные данные Классический режим проверки подлинности Windows *Проверка подлинности на основе утверждений
Локальный список фермы SharePoint Проверка подлинности Windows (встроенная) или токен пользователя SharePoint Да Да
Хранимые, запрос, нет (с учетными данными Windows

Хранимые учетные данные и учетные данные по запросу не поддерживаются с учетными данными, отличными от Windows.		 Да Нет
Удаленный список SharePoint Проверка подлинности Windows (встроенная) или токен пользователя SharePoint Да Нет

Проверка подлинности на основе форм и на основе утверждений не поддерживается для удаленных списков SharePoint.
Хранимые, запрос, нет (с учетными данными Windows

Хранимые учетные данные и учетные данные по запросу не поддерживаются с учетными данными, отличными от Windows.		 Да Нет

Проверка подлинности на основе форм и на основе утверждений не поддерживается для удаленных списков SharePoint.

*Проверка подлинности Windows, проверка подлинности на основе форм (FBA), маркеры SAML, другие поставщики удостоверений или сочетание нескольких из упомянутых выше поставщиков проверки подлинности.

Таблица 2

Тип извлечения Поддерживаемые учетные данные Классический режим проверки подлинности Windows *Проверка подлинности на основе утверждений
Локальный список фермы SharePoint Проверка подлинности Windows (встроенная) или токен пользователя SharePoint Да Да
Хранимые, запрос, нет (с учетными данными Windows

Хранимые учетные данные и учетные данные по запросу не поддерживаются с учетными данными, отличными от Windows.		 No No
Удаленный список SharePoint Проверка подлинности Windows (встроенная) или токен пользователя SharePoint Да Нет

Проверка подлинности на основе форм и на основе утверждений не поддерживается для удаленных списков SharePoint.
Хранимые, запрос, нет (с учетными данными Windows

Хранимые учетные данные и учетные данные по запросу не поддерживаются с учетными данными, отличными от Windows.		 No No

Проверка подлинности на основе форм и на основе утверждений не поддерживается для удаленных списков SharePoint.

*Проверка подлинности Windows, проверка подлинности на основе форм (FBA), маркеры SAML, другие поставщики удостоверений или сочетание нескольких из упомянутых выше поставщиков проверки подлинности.

Проверка подлинности Windows.
Для технологии SharePoint, настроенной для работы с сервером отчетов в режиме «Доверенная учетная запись», этот параметр не поддерживается. Относится только к выпускам до версии служб SQL Server 2012 Reporting Services.

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

Для технологии SharePoint, настроенной для работы без сервера отчетов (в локальном режиме), этот параметр не поддерживается. Дополнительные сведения о локальном режиме см. в статье Отчеты, созданные в локальном и подключенном режимах в средстве просмотра отчетов.

Учетные данные не требуются (не использовать учетные данные).
Чтобы использовать этот параметр, необходима учетная запись автоматического выполнения, настроенная на сервере отчетов. Дополнительные сведения см. в статье Настройка учетной записи автоматического выполнения (диспетчер конфигурации сервера отчетов).

Дополнительные сведения см. в разделе "Создание строка подключения данных " построитель отчетов и SSRS", "Указание учетных данных и Подключение сведений" для источников данных отчета и источников данных, поддерживаемых службами Reporting Services (SSRS).

Запросы

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

Графический конструктор запросов списка SharePoint имеет четыре панели.

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

  • Имя. Уникальное имя поля.

  • Идентификатор. Уникальный идентификатор поля.

  • Тип поля. Тип данных поля.

  • Скрыто. Отображается ли поле в представлении списка SharePoint.

Выбор полей из нескольких списков не поддерживается. Можно создать набор данных для каждого списка и выбирать поля из каждого набора данных. Если списки имеют общее поле, можно использовать функцию уточняющего запроса в области данных табликса, которая привязана к одному набору данных, чтобы получать значение из другого набора данных, который не привязан к области данных. Дополнительные сведения см. в статье Функции построителя отчетов — функция Lookup в отчете с разбивкой на страницы (построитель отчетов).

  • Выбранные поля. Отображает выбранные поля. Имена полей на этой панели являются понятными именами SharePoint, которые были указаны пользователем SharePoint. При закрытии конструктора запросов эти имена можно увидеть в наборе полей набора данных в области данных отчета. Связь между уникальными именами и понятными именами описана на странице Диалоговое окно "Свойства набора данных" — "Поля" (построитель отчетов).

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

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

  • Результаты запроса. Отображает примеры строк, возвращаемых при выполнении этого запроса. Если значения списка SharePoint часто изменяются на сайте SharePoint, то значения на панели результатов запросов могут отличаться от значений, выводимых в отчете.

  • Выбранные поля. Отображает выбранные поля. Имена полей на этой панели являются понятными именами SharePoint, которые были указаны пользователем SharePoint. При закрытии конструктора запросов эти имена можно увидеть в наборе полей набора данных в области данных отчета. Связь между уникальными именами и понятными именами описана на странице Диалоговое окно "Свойства набора данных" — "Поля" (построитель отчетов).

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

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

  • Результаты запроса. Отображает примеры строк, возвращаемых при выполнении этого запроса. Если значения списка SharePoint часто изменяются на сайте SharePoint, то значения на панели результатов запросов могут отличаться от значений, выводимых в отчете.

Дополнительные сведения см. в статье Конструктор запросов к спискам SharePoint (построитель отчетов).

Текст запроса

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

Пример 1. Указанные поля для списка

В следующем примере показан правильно составленный запрос SharePoint:

<RSSharePointList>  
<listName>MyList</listName>  
<viewFields>  
  <FieldRef Name="Field1"/>  
  <FieldRef Name="Field4"/>  
</viewFields>  
<Query>  
  <Where>  
    <And>  
      <Gt>  
        <FieldRef Name="Field1"/>  
        <Value Type="Integer">1</Value>  
      </Gt>  
      <IsNotNull>  
        <FieldRef Name="Field2"/>  
        <Value Type="string"/>  
      </IsNotNull>   
    </And>  
  </Where>  
</Query>  
</RSSharePointList>

Данное представление запроса можно изменить, если запрос представлен в виде XML-текста.

Пример 2. Все поля для списка

Достаточно указать имя списка, и будут возвращены все поля, включая скрытые. В следующем примере из списка Tasks извлекаются все поля:

<RSSharePointList>  
<listName>Tasks</listName>  
</RSSharePointList>

В результатах запроса возвращаются все поля для списка Tasks.

Параметры

Параметры не поддерживаются этим модулем обработки данных.

Инструкции

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

Добавление и проверка Подключение данных (построитель отчетов и SSRS)

Создание общего набора данных или внедренного набора данных (построитель отчетов и SSRS)

Добавление фильтра в набор данных (построитель отчетов и службы SSRS)

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

Наборы данных отчетов (SSRS)
Предоставляет общие сведения о доступе к данным отчета.

Создание строк подключения к данным (построитель отчетов и службы SSRS)
Предоставляет сведения о подключениях к данным и источникам данных.

Отчет о внедренных наборах данных и общих наборах данных (построитель отчетов и SSRS)
Предоставляет сведения об общих и внедренных наборах данных.

Коллекция полей набора данных (построитель отчетов и службы SSRS)
Предоставляет сведения о коллекции полей набора данных, создаваемой запросом.

Источники данных, поддерживаемые службами Reporting Services (SSRS).
Предоставляет подробные сведения о поддержке платформ и версий для каждого модуля обработки данных.

См. также

Параметры отчета
Фильтрация, группирование и сортировка данных
Выражения (построитель отчетов и службы SSRS)

Есть еще вопросы? Посетите форум служб Reporting Services.