SharePoint-Listenverbindungstyp (SSRS)

Gilt für: SQL Server 2016 (13.x) Power BI-Berichtsserver SharePoint

Wenn Sie Daten aus einer Microsoft SharePoint-Liste in den Bericht einschließen möchten, müssen Sie ein Dataset hinzufügen oder erstellen, das auf einer Berichtsdatenquelle vom Typ "Microsoft SharePoint-Liste" basiert. Dies ist ein integrierter Datenquellentyp, der auf der Microsoft SQL Server Reporting Services-Datenerweiterung für die SharePoint-Liste basiert. Verwenden Sie diesen Datenquellentyp, um Listendaten aus SharePoint 2013 und höher abzurufen.

Verwenden Sie die Informationen in diesem Thema, um eine Datenquelle zu erstellen. Eine Schritt-für-Schritt-Anleitung finden Sie unter Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS).

Verbindungszeichenfolge

Die Verbindungszeichenfolge für eine SharePoint-Liste ist die URL zur SharePoint-Website oder -Unterwebsite, z. B. https://MySharePointWeb/MySharePointSite oder https://MySharePointWeb/MySharePointSite/Subsite.

Im Abfrage-Designer werden automatisch die SharePoint-Listen angezeigt, für die Sie ausreichende Zugriffsberechtigungen besitzen.

Weitere Beispiele für Verbindungszeichenfolgen finden Sie unter Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS).

Anmeldeinformationen

Anmeldeinformationen sind erforderlich, um Abfragen auszuführen und den Bericht lokal oder vom Berichtsserver aus in der Vorschau anzuzeigen. Nachdem Sie den Bericht veröffentlicht haben, müssen Sie eventuell die Anmeldeinformationen für die Datenquelle ändern, sodass die Berechtigungen zum Abrufen der Daten beim Ausführen des Berichts auf dem Berichtsserver gültig sind. Die von dieser Datenerweiterung unterstützten Anmeldeinformationstypen hängen von der SharePoint-Technologiekonfiguration für die als Datenquelle verwendete SharePoint-Liste ab.

In den folgenden Tabellen wird das Verhalten beim Abrufen von Anmeldeinformationen für die SharePoint-Listenerweiterung erläutert, und zwar bei der Verbindung mit der SharePoint-Liste einer lokalen Farm oder einer SharePoint-Remoteliste.

Tabelle 1 wird für Berichte verwendet, die auf einer älteren Windows SharePoint-Website bereitgestellt werden. Ältere Windows-Websites unterstützen ausschließlich Kerberos, NTLM und die formularbasierte Authentifizierung (FBA). Tabelle 2 wird für Berichte verwendet, die auf einer SharePoint-Website mit anspruchsbasierter Authentifizierung bereitgestellt werden.

Tabelle 1

*Windows-Authentifizierung, formularbasierte Authentifizierung (FBA), SAML (Secure Application Markup Language)-Token, sonstige Identitätsanbieter oder eine Kombination aus mehreren der oben aufgeführten Authentifizierungsanbieter.

Tabelle 2

*Windows-Authentifizierung, formularbasierte Authentifizierung (FBA), SAML (Secure Application Markup Language)-Token, sonstige Identitätsanbieter oder eine Kombination aus mehreren der oben aufgeführten Authentifizierungsanbieter.

Windows-Authentifizierung
Diese Option wird nicht für eine SharePoint-Technologie unterstützt, die für die Verwendung mit einem Berichtsserver im Modus „Vertrauenswürdiges Konto“ konfiguriert ist. Dies gilt nur für Versionen vor SQL Server 2012 Reporting Services.

Bei einer SharePoint-Technologie, die für die Verwendung mit einem Berichtsserver im integrierten Windows-Modus konfiguriert ist, gilt diese Option sowohl für den aktuellen Windows-Benutzer als auch den aktuellen SharePoint-Benutzer.

Diese Option wird nicht für eine SharePoint-Technologie unterstützt, die für die Verwendung ohne Berichtsserver (lokaler Modus) konfiguriert ist. Weitere Informationen zum lokalen Modus finden Sie unter Berichte im lokalen Modus im Vergleich mit Berichten im verbundenen Modus im Berichts-Viewer (Reporting Services im SharePoint-Modus).

Anmeldeinformationen sind nicht erforderlich (keine Anmeldeinformationen verwenden):
Diese Option setzt voraus, dass zuvor das Konto für die unbeaufsichtigte Ausführung auf dem Berichtsserver konfiguriert wird. Weitere Informationen finden Sie unter Konfigurieren des Kontos für die unbeaufsichtigte Ausführung (Berichtsserver-Konfigurations-Manager).

Weitere Informationen finden Sie unter Erstellen von Datenverbindungszeichenfolgen – Berichts-Generator und SSRS, Angeben der Anmeldeinformationen und Verbindungsinformationen für Berichtsdatenquellen und Von Reporting Services unterstützte Datenquellen (SSRS).

Abfragen

Erstellen Sie auf Grundlage der Datenquelle ein neues Dataset, und öffnen Sie dann den entsprechenden Abfrage-Designer, um eine Abfrage zu entwerfen. Weitere Informationen finden Sie unter Erstellen eines freigegebenen Datasets oder eingebetteten Datasets (Berichts-Generator und SSRS).

Der grafische Abfrage-Designer für SharePoint-Listen zeigt vier Bereiche an:

SharePoint-Listen Zeigt eine Liste aller SharePoint-Listen auf der Website für diese Datenquelle an. Wählen Sie eine Liste aus, und wählen Sie dann die Felder aus, die Sie in die Abfrage einschließen möchten. Die Namen der Felder in diesem Bereich sind die SharePoint-Anzeigenamen, die auch als Anzeigenamen bezeichnet werden. Zeigen Sie mit dem Mauszeiger auf ein Element, um die folgenden Eigenschaften in der QuickInfo anzuzeigen:

• Name Der eindeutige Name des Felds.

• Bezeichner Der eindeutige Bezeichner des Felds.

• Feldtyp Der Datentyp des Felds.

• Ausgeblendet Zeigt an, ob das Feld in der SharePoint-Listenansicht angezeigt wird.

Die Auswahl von Feldern aus mehreren Listen wird nicht unterstützt. Sie können einen Datensatz für jede Liste erstellen und Felder aus jedem Datensatz auswählen. Wenn die Listen über ein gemeinsames Feld verfügen, können Sie die Suchfunktion in einem Tablix-Datenbereich verwenden, der an einen Datensatz gebunden ist, um einen Wert aus dem anderen Datensatz abzurufen, der nicht an den Datenbereich gebunden ist. Weitere Informationen finden Sie unter Lookup-Funktion (Berichts-Generator und SSRS).

• Ausgewählte Felder Zeigt die Felder an, die Sie ausgewählt haben. Die Namen der Felder in diesem Bereich sind Anzeigenamen, die ein SharePoint-Benutzer angegeben hat. Wenn Sie den Abfrage-Designer schließen, werden diese Namen in der Dataset-Feldauflistung im Berichtsdatenbereich angezeigt. Die Beziehung zwischen eindeutigen Namen und Anzeigenamen steht auf der Seite Dataseteigenschaften (Dialogfeld), Felder (Berichts-Generator).

• Übernommene Filter Schränkt die Daten ein, die aus der SharePoint-Liste zurückgegeben werden, bevor die Daten an den Bericht zurückgegeben werden. Wählen Sie den Feldnamen, den Operator und den Wert aus, die verwendet werden sollen, um die abgerufenen Daten in der Liste einzuschränken. Die Operatoren hängen vom Datentyp des Werts ab, den Sie auswählen.

  Sie können die Sortierreihenfolge nicht ändern und keine Gruppen im grafischen Abfrage-Designer angeben. Legen Sie festgelegte Sortierungsausdrücke für das Berichtsdataset und Gruppenausdrücke für die Datenbereiche des Berichts aus, wenn Sie dies möchten. Abfrageparameter werden nicht unterstützt. Um Daten im Bericht zu filtern, verwenden Sie Berichtsfilter oder Berichtsparameter, die Sie erstellen. Weitere Informationen finden Sie unter Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS) und Berichtsparameter (Berichts-Generator und Berichts-Designer).

• Abfrageergebnisse Zeigt Beispielzeilen an, die bei Ausführung der Abfrage zurückgegeben werden. Wenn sich die Werte in der SharePoint-Liste auf der SharePoint-Website häufig ändern, unterscheiden sich die in den Abfrageergebnissen angezeigten Werte möglicherweise von den Werten, die im Bericht angezeigt werden.

• Ausgewählte Felder Zeigt die Felder an, die Sie ausgewählt haben. Die Namen der Felder in diesem Bereich sind Anzeigenamen, die ein SharePoint-Benutzer angegeben hat. Wenn Sie den Abfrage-Designer schließen, werden diese Namen in der Dataset-Feldauflistung im Berichtsdatenbereich angezeigt. Die Beziehung zwischen eindeutigen Namen und Anzeigenamen steht auf der Seite Dataseteigenschaften (Dialogfeld), Felder (Berichts-Generator).

• Übernommene Filter Schränkt die Daten ein, die aus der SharePoint-Liste zurückgegeben werden, bevor die Daten an den Bericht zurückgegeben werden. Wählen Sie den Feldnamen, den Operator und den Wert aus, die verwendet werden sollen, um die abgerufenen Daten in der Liste einzuschränken. Die Operatoren hängen vom Datentyp des Werts ab, den Sie auswählen.

  Sie können die Sortierreihenfolge nicht ändern und keine Gruppen im grafischen Abfrage-Designer angeben. Legen Sie festgelegte Sortierungsausdrücke für das Berichtsdataset und Gruppenausdrücke für die Datenbereiche des Berichts aus, wenn Sie dies möchten. Abfrageparameter werden nicht unterstützt. Um Daten im Bericht zu filtern, verwenden Sie Berichtsfilter oder Berichtsparameter, die Sie erstellen. Weitere Informationen finden Sie unter Filtern, Gruppieren und Sortieren von Daten (Berichts-Generator und SSRS) und Berichtsparameter (Berichts-Generator und Berichts-Designer).

• Abfrageergebnisse Zeigt Beispielzeilen an, die bei Ausführung der Abfrage zurückgegeben werden. Wenn sich die Werte in der SharePoint-Liste auf der SharePoint-Website häufig ändern, unterscheiden sich die in den Abfrageergebnissen angezeigten Werte möglicherweise von den Werten, die im Bericht angezeigt werden.

Weitere Informationen finden Sie unter Designer für SharePoint-Listenabfragen (Berichts-Generator).

Abfragetext

Wenn Sie die Abfrage anzeigen möchten, die im grafischen Abfrage-Designer generiert wird, wechseln Sie zum textbasierten Abfrage-Designer. In dieser Ansicht können Sie die XML anzeigen, die vom grafischen Abfrage-Designer erstellt wird. Die XML umfasst Elemente für den Listennamen, die Feldauflistung und den Filter.

Beispiel 1: Angegebene Felder für eine Liste

Im folgenden Beispiel wird eine wohlgeformte SharePoint-Abfrage dargestellt:

<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>  

Sie können diese Ansicht der Abfrage bearbeiten, solange es wohlgeformter XML-Text bleibt.

Beispiel 2: Alle Felder für eine Liste

Sie können auch nur den Namen einer Liste angeben, und alle Felder einschließlich der ausgeblendete Felder werden zurückgegeben. Im folgenden Beispiel werden alle Felder aus einer Liste, die Tasks genannt wird:

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

Alle Felder für die Liste "Tasks" werden in den Abfrageergebnissen zurückgegeben.

Parameter

Parameter werden von dieser Datenerweiterung nicht unterstützt.

Themen zur Vorgehensweise

Dieser Abschnitt enthält schrittweise Anweisungen zum Arbeiten mit Datenverbindungen, Datenquellen und Datasets.

Hinzufügen und Prüfen einer Datenverbindung (Berichts-Generator und SSRS)

Erstellen eines freigegebenen Datasets oder eingebetteten Datasets (Berichts-Generator und SSRS)

Hinzufügen eines Filters zu einem Dataset (Berichts-Generator und SSRS)

Verwandte Abschnitte

Diese Abschnitte der Dokumentation enthalten umfassende grundlegende Informationen zu Berichtsdaten sowie Informationen zum Definieren, Anpassen und Verwenden der mit Daten zusammenhängenden Teile eines Berichts.

Berichtsdatasets (SSRS)
Bietet eine Übersicht über den Zugriff auf Daten für den Bericht.

Erstellen von Datenverbindungszeichenfolgen (Berichts-Generator und SSRS)
Enthält Informationen zu Datenverbindungen und Datenquellen.

Erstellen von Berichten zu eingebetteten und freigegebenen Datasets (Berichts-Generator und SSRS)
Enthält Informationen zu eingebetteten und freigegebenen Datasets.

Datasetfeldauflistung (Berichts-Generator und SSRS)
Enthält Informationen zur von der Abfrage generierten Datasetfeldauflistung.

Von Reporting Services unterstützte Datenquellen (SSRS).
Enthält ausführliche Informationen zur Plattform- und Versionsunterstützung für die einzelnen Datenerweiterungen.

Weitere Informationen

Berichtsparameter
Filtern, Gruppieren und Sortieren von Daten
Ausdrücke (Berichts-Generator und SSRS)

Haben Sie dazu Fragen? Stellen Sie eine Frage im Reporting Services-Forum