Share via

Sincronize os itens do SharePoint usando o serviço REST

  • Artigo

Se quiser sincronizar itens entre o SharePoint e seus suplementos ou serviços, você pode usar o recurso GetListItemChangesSinceToken para fazê-lo. O GetListItemChangesSinceToken, parte do serviço REST do SharePoint corresponde à chamada de serviço Web Lists.GetListItemChangesSinceToken.

Executar uma solicitação POST que inclui um objeto propriedades do objeto SP.ChangeLogItemQuery no corpo da solicitação.

A solicitação retorna ADO rowset XML que inclui linhas correspondentes a qualquer alteração de item de lista correspondente à consulta especificada. Para obter mais informações sobre essas propriedades, incluindo as estruturas de dados de propriedade, descrições de elemento CAML e valores de retorno, consulte Lists.GetListItemChangesSinceToken.

Exemplo

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

Propriedades do objeto SP.ChangeLogItemQuery

Propriedade Descrição
ListName Uma cadeia de caracteres que contém o título ou o GUID da lista. Ao fazer uma consulta na tabela UserInfo, a cadeia de caracteres contém UserInfo. Usando os resultados GUID em melhorar o desempenho.
ViewName Uma cadeia de caracteres que contém o GUID do modo de exibição, o que determina o modo de exibição a ser usado para os atributos padrão do modo de exibição representados pelos parâmetros query, viewFields e rowLimit. Se esse argumento não for fornecido, o modo de exibição padrão será considerado.

Se for fornecido, o valor do parâmetro consulta, viewFields ou rowLimit substituirá a configuração equivalente no modo de exibição.

Por exemplo, se o modo de exibição especificado pelo parâmetro viewFields tiver um limite de 100 linhas, mas o parâmetro rowLimit tiver um valor de 1000, então 1.000 linhas serão retornadas na resposta.
Consulta O elemento Consulta que contém a consulta que determina quais registros são retornados e em que ordem.
QueryOptions Um fragmento XML no seguinte formato que contém nós separados para as várias propriedades do objeto SPQuery.
ChangeToken Uma cadeia de caracteres que contém o token de alteração da solicitação.

Para obter uma descrição do formato que é usado nesta cadeia de caracteres, consulte Visão geral do log de alteração. Se nulo for passado, todos os itens na lista serão retornados.
Contém R Contém elemento que define a filtragem personalizada para a consulta.

Confira também