Synchronisieren von SharePoint-Elementen mithilfe des REST-Diensts
Zum Synchronisieren von Elementen zwischen SharePoint und Ihren Add-ins oder Diensten können Sie die Ressource GetListItemChangesSinceToken verwenden. GetListItemChangesSinceToken ist Teil des SharePoint REST-Diensts und entspricht dem Webdienstaufruf Lists.GetListItemChangesSinceToken.
Führen Sie eine POST-Anforderung aus, die ein Objekt SP.ChangeLogItemQuery-Objekteigenschaften im Hauptteil enthält.
Die Anforderung gibt ADO rowset XML mit den Zeilen zurück, die alle mit der Abfrage übereinstimmenden Änderungen an Listenelementen enthalten. Weitere Informationen zu diesen Eigenschaften, einschließlich Eigenschaftendatenstrukturen, CAML-Elementbeschreibungen und Rückgabewerten finden Sie unter Lists.GetListItemChangesSinceToken.
Beispiel
POST https://{site_url}/_api/web/Lists/GetByTitle('Announcements')/GetListItemChangesSinceToken`
Authorization: "Bearer " + accessToken
Content-Type: "application/json"
Content-Length: {length of request body as integer}
{
"d" : {
"query": {
"__metadata": {
"type": "SP.ChangeLogItemQuery"
},
"ViewName": "",
"Query": "
<Query>
<Where>
<Contains>
<FieldRef Name='Title' />
<Value Type='Text'>Te</Value>
</Contains>
</Where>'
</Query>,
"QueryOptions": "
<QueryOptions>
<IncludeMandatoryColumns>FALSE</IncludeMandatoryColumns>
<DateInUtc>False</DateInUtc>
<IncludePermissions>TRUE</IncludePermissions>
<IncludeAttachmentUrls>FALSE</IncludeAttachmentUrls>
<Folder>Shared Documents/Test1</Folder>
</QueryOptions>',
"ChangeToken":"1;3;eee4c6d5-f88a-42c4-8ce1-685122984870;634397182229400000;3710",
"Contains": "
<Contains>
<FieldRef Name="Title"/>
<Value Type="Text">Testing</Value>
</Contains>"
}
}
}
SP.ChangeLogItemQuery-Objekteigenschaften
| Eigenschaft | Description |
|---|---|
| ListName | Eine Zeichenfolge, die entweder Titel oder GUID der Liste enthält. Bei Abruf der Tabelle "UserInfo" enthält die Zeichenfolge UserInfo. Die Verwendung der GUID führt zu einer besseren Leistung. |
| ViewName | Eine Zeichenfolge, die die GUID für die Ansicht enthält, die die Ansicht bestimmt, die für die Standardansichtsattribute verwendet werden soll, die durch die Parameter query, viewFields und rowLimit dargestellt werden. Wenn dieses Argument nicht angegeben wird, wird die Standardansicht angenommen. Wenn er angegeben wird, setzt der Wert der Abfrage, des viewFields- oder rowLimit-Parameters die entsprechende Einstellung in der Ansicht außer Kraft. Weist z. B. die durch den Parameter viewFields angegebene Ansicht ein Zeilenlimit von 100 auf, während der Parameter rowLimit den Wert 1000 enthält, dann werden in der Antwort 1000 Zeilen zurückgegeben. |
| Query | Ein Query-Element mit der Abfrage, die festlegt, welche Datensätze in welcher Reihenfolge zurückgegeben werden. |
| QueryOptions | Ein XML-Fragment in der folgenden Form, das separate Knoten für die verschiedenen Eigenschaften des Objekts SPQuery enthält. |
| ChangeToken | Eine Zeichenfolge, die das Änderungstoken für die Anforderung enthält. Eine Beschreibung des Formats, das in dieser Zeichenfolge verwendet wird, finden Sie unter Übersicht über das Änderungsprotokoll. Wenn Null übergeben wird, werden alle Elemente in der Liste zurückgegeben. |
| Contains | Ein Contains-Element, das das benutzerdefinierte Filtern für die Abfrage definiert. |