BCS-REST-API-Referenz für SharePoint

  • Artikel

Klassenbibliotheken und -verweise

Enthält Referenzinformationen zum Erstellen von URLs zum Aufrufen und Bearbeiten von externen Datenquellen, die mit Business Connectivity Services (BCS) in SharePoint Representational State Transfer (REST).

Mithilfe von Rest-APIs Zugriff auf externe Daten in SharePoint

Die REST-Schnittstelle bereitgestellt von SharePoint können Sie die meisten SharePoint Ressourcen durch speziell gestalteten URLs zugreifen. Business Connectivity Services (BCS) verwendet diese Architektur für den Zugriff auf externe Daten.

Sie können externe Daten durch Erstellen URLs zugreifen, wie für den Zugriff Standardliste Elemente.

Hinweis

Zugriff auf Entitäten über BDC direkt wird nicht bereitgestellt. Zum Arbeiten mit externen Daten müssen Sie eine externe Liste erstellen und die REST-URLs für den Zugriff auf Listenelemente in einer externen Liste verwenden.

Die unterstützten HTTP-Verben für das Arbeiten mit externen Listen sind GET, PUT, POSTund DELETE.

Im Gegensatz zu mit normalen Listen können nicht Sie eine externe Liste mithilfe von REST erstellen. Sie müssen dies tun, durch das Erstellen eines BDC-Modells und einer externen Liste mithilfe von Visual Studio 2012.

Die Informationen in Tabelle 1 veranschaulicht das Erstellen von Rest-URLs und die entsprechenden Client Objektmodellaufrufe und Bearbeiten von Daten aus externen Datenquellen zugreifen.

Tabelle 1. RESTful-URL-Formate für den Zugriff auf externe Daten

URL Beschreibung HTTP-Methode
http://[sharepointsite]/_api
Die Basis des eine REST-Anforderung. Das virtuelle Verzeichnis _api zugeordnet ist, um Aufrufe client.svc, wo das Clientobjektmodell verwendet werden.
GET
http://[sharepointsite]/_api/web/title
Ruft den Titel des aktuellen Web ab.
GET
http://[sharepointsite]/_api/lists
Ruft alle Listen auf einer Website ab
GET
http://[sharepointsite]/_api/lists/getbytitle('listname')
Ruft die Metadaten für eine angegebene Liste.
GET
http://[sharepointsite]/_api/lists/getbytitle('listname')/items
Ruft die Listenelemente in einer angegebenen Liste ab.
GET
http://[sharepointsite]/_api/lists/getbytitle('listname')?select=Title
Ruft den Titel einer bestimmten Liste ab.
GET

Erstellen von Abfragezeichenfolgen zum Filtern von Daten

Um die zurückgegebene Datenmenge beschränken oder mehr Stellen für den Benutzer relevant die Filteroperationen gefunden in Tabelle 2 können Sie.

Tabelle 2. Operatoren zum Filtern von Daten

Operator Beschreibung
EQ
 Gleich
Hinweis: Wenn Sie EQ zum Filtern verwenden, werden die Filterkriterien an das externe System übergeben, in dem Fall die Filterung auf dem Server.
GT
 Größer als
Hinweis: Wenn Sie den GT-Operator verwenden, wird nur die clientseitige Filterung ausgeführt.> Beispiel: web/lists/getByTitle('ListName')/Items?$select=Title&$filter=AverageRating gt 3 Gibt alle Titel mit einer durchschnittlichen Bewertung über 3 zurück.

Hinweis

Zum Abrufen von Spalten, die Teil einer Zuordnung sind, müssen Sie explizit die Spalte in der URL mithilfe von $select in der Abfragezeichenfolge mit einbeziehen.

Siehe auch