Sincronizar elementos de SharePoint con el servicio RESTSynchronize SharePoint items using the REST service

Si quiere sincronizar elementos entre SharePoint y sus complementos o servicios, puede hacerlo con el recurso GetListItemChangesSinceToken.If you want to synchronize items between SharePoint and your add-ins or services, you can use the GetListItemChangesSinceToken resource to do so. El recurso GetListItemChangesSinceToken, que forma parte del servicio REST de SharePoint, se corresponde con la llamada al servicio web Lists.GetListItemChangesSinceToken.The GetListItemChangesSinceToken, part of the SharePoint REST service, corresponds to the Lists.GetListItemChangesSinceToken web service call.

Realice una solicitud POST que incluya un objeto Propiedades del objeto SP.ChangeLogItemQuery en el cuerpo de la solicitud.Perform a POST request that includes a SP.ChangeLogItemQuery object properties object in the request body.

La solicitud devuelve el XML rowset de ADO, que incluye las filas correspondientes a cualquier cambio de elemento de lista que coincida con la consulta especificada.The request returns ADO rowset XML which includes rows corresponding to any list item change matching the specified query. Para obtener más información sobre estas propiedades, incluidas las estructuras de datos de las propiedades, descripciones de elementos CAML y valores de devolución, vea Lists.GetListItemChangesSinceToken.For more information on these properties, including property data structures, CAML element descriptions, and return values, see Lists.GetListItemChangesSinceToken .

EjemploExample

Ejemplo de solicitudExample request

POST http://server/site/_api/web/Lists/GetByTitle('Announcements')/GetListItemChangesSinceToken

Ejemplo de cuerpo de POSTExample POST Body

{ '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>' } 
  } 
}


Propiedades del objeto SP.ChangeLogItemQuerySP.ChangeLogItemQuery object properties

PropiedadProperty DescripciónDescription
ListNameListName Cadena que contiene el título o el GUID de la lista. Al consultar la tabla UserInfo, la cadena contiene UserInfo. Si se usa el GUID, se obtiene un mejor rendimiento.A string that contains either the title or the GUID for the list. When querying the UserInfo table, the string contains UserInfo. Using the GUID results in better performance.
ViewNameviewName Cadena que contiene el GUID de la vista, que determina la vista que se usará para los atributos de vista predeterminada, representados por los parámetros query, viewFields y rowLimit.A string that contains the GUID for the view, which determines the view to use for the default view attributes represented by the query, viewFields, and rowLimit parameters. Si no se proporciona este argumento, se presupone que es la vista predeterminada.If this argument is not supplied, the default view is assumed.

Si se proporciona, el valor del parámetro query, viewFields o rowLimit invalida la configuración equivalente en la vista.If it is supplied, the value of the query, viewFields, or r_owLimit _parameter overrides the equivalent setting within the view.

Por ejemplo, si la vista especificada por el parámetro viewFields tiene un límite de 100 filas, pero el parámetro rowLimit contiene un valor de 1000, entonces se devuelven 1000 filas en la respuesta.For example, if the view specified by the viewFields parameter has a row limit of 100 rows but the rowLimit parameter contains a value of 1000, then 1,000 rows are returned in the response.
QueryQuery Un elemento Query que contiene la consulta que determina qué registros se devuelven y en qué orden.A Query element containing the query that determines which records are returned and in what order.
QueryOptionsQueryOptions Un fragmento XML en el formulario siguiente que contiene nodos independientes para las diferentes propiedades del objeto SPQuery.An XML fragment in the following form that contains separate nodes for the various properties of the SPQuery object.
ChangeTokenChangeToken Una cadena que contiene el token de cambio de la solicitud.A string that contains the change token for the request.

Para obtener una descripción del formato que se ha usado en esta cadena, vea Información general acerca del registro de cambios.For a description of the format that is used in this string, see Overview of the Change Log. Si se transfiere un valor nulo, se devuelven todos los elementos de la lista.If null is passed, all items in the list are returned.
ContainsContains Un elemento Contains que define un filtro personalizado para la consulta.A Contains element that defines custom filtering for the query.

Ver tambiénSee also