Sincronizar elementos de SharePoint con el servicio REST

  • Artículo

Si quiere sincronizar elementos entre SharePoint y sus complementos o servicios, puede hacerlo con el recurso GetListItemChangesSinceToken. El recurso GetListItemChangesSinceToken, que forma parte del servicio REST de SharePoint, se corresponde con la llamada al servicio web Lists.GetListItemChangesSinceToken.

Realice una solicitud POST que incluya un objeto Propiedades del objeto SP.ChangeLogItemQuery en el cuerpo de la solicitud.

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

Ejemplo

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

Propiedades del objeto SP.ChangeLogItemQuery

Propiedad Descripción
ListName 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.
ViewName 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. Si no se proporciona este argumento, se presupone que es la vista predeterminada.

Si se proporciona, el valor del parámetro query, viewFields o rowLimit invalida la configuración equivalente dentro de la vista.

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.
Query Un elemento Query que contiene la consulta que determina qué registros se devuelven y en qué orden.
QueryOptions Un fragmento XML en el formulario siguiente que contiene nodos independientes para las diferentes propiedades del objeto SPQuery.
ChangeToken Una cadena que contiene el token de cambio de la solicitud.

Para obtener una descripción del formato que se ha usado en esta cadena, vea Información general acerca del registro de cambios. Si se transfiere un valor nulo, se devuelven todos los elementos de la lista.
Contains Un elemento Contains que define un filtro personalizado para la consulta.

Consulte también