Atualizar Item da Lista

Altera uma linha em uma Lista de um Site no Sharepoint

Visão Geral

O objeto Atualizar Item da Lista é utilizado para modificar os dados de um item existente em uma lista do SharePoint durante a execução de um robô.

Esse objeto permite alterar os valores de colunas específicas de um registro, utilizando o ID da linha como identificador do item que será atualizado. A operação é realizada dentro de um site específico do SharePoint, utilizando uma autenticação previamente configurada.

Esse recurso é utilizado quando a automação precisa atualizar informações já registradas em listas do SharePoint.

---

Funcionamento

O objeto Atualizar Item da Lista localiza um item existente em uma lista do SharePoint e altera os valores das colunas configuradas.

Fluxo de execução:

1. O robô utiliza a Autenticação do SharePoint previamente configurada.

2. O sistema acessa o ambiente SharePoint utilizando essa autenticação.

3. O robô identifica o site definido no campo Nome do Site.

4. Dentro do site, o objeto localiza a lista configurada no campo Nome da Lista.

5. O item da lista é identificado utilizando o Id da Linha.

6. Para cada coluna configurada, o robô atualiza o valor correspondente.

7. As alterações são aplicadas ao registro existente na lista.

Após a execução, o item da lista passa a conter os novos valores definidos.

Quando usar

• Quando for necessário atualizar dados de um item existente em uma lista do SharePoint.

• Em automações que precisam modificar registros armazenados em listas do SharePoint.

• Quando o robô precisa alterar valores de colunas após o processamento de dados.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô. Pode ser alterado para facilitar a identificação no fluxo.
Autenticação	Configuração de autenticação previamente criada utilizando o objeto Configurar SharePoint.
Nome do Site	Nome do site do SharePoint onde a lista está localizada.
Nome da Lista	Nome da lista do SharePoint que contém o item que será atualizado.
Id da Linha	Identificador do item da lista que será atualizado.
Nome da coluna	Nome da coluna da lista que terá o valor alterado.
Valor da coluna	Novo valor que será atribuído à coluna correspondente.
Incluir coluna	Permite adicionar novas colunas que terão seus valores atualizados no item da lista.

---

Exemplos

Exemplo simples

Um robô precisa atualizar o status de um item em uma lista do SharePoint.

Configuração:

• Autenticação: configurada previamente

• Nome do Site: Documentos

• Nome da Lista: ControleProcessos

• Id da Linha: 10

• Coluna: Status

• Valor: Concluído

Fluxo:

1. O robô executa o objeto Configurar SharePoint.

2. O objeto Atualizar Item da Lista é executado.

3. O item com ID 10 é atualizado com o novo status.

Exemplo aplicado

Automação de acompanhamento de tarefas.

Fluxo do robô:

1. O robô consulta uma lista de tarefas no SharePoint.

2. Após processar uma tarefa, o robô atualiza o registro correspondente.

3. O objeto Atualizar Item da Lista altera o status da tarefa na lista.

---

Retornos

Não há retornos documentados para este objeto.

---

Erros comuns e como evitar

Autenticação não configurada

Se nenhuma autenticação for definida, o robô não conseguirá acessar o SharePoint.

Como evitar:

• Executar previamente o objeto Configurar SharePoint.

Nome do site incorreto

Se o site informado não existir, o robô não conseguirá localizar a lista.

Como evitar:

• Verificar o nome correto do site no SharePoint.

Nome da lista incorreto

Se o nome da lista estiver incorreto, o sistema não conseguirá localizar o item.

Como evitar:

• Confirmar o nome correto da lista dentro do site do SharePoint.

Id da linha inválido

Se o ID informado não corresponder a nenhum item da lista, o registro não será atualizado.

Como evitar:

• Confirmar o ID do item antes de executar o objeto.

Coluna inexistente

Se o nome da coluna informado não existir na lista, a atualização pode falhar.

Como evitar:

• Garantir que o nome da coluna corresponda exatamente ao definido na lista do SharePoint.

---

Boas práticas

• Garantir que a autenticação do SharePoint esteja configurada corretamente antes de executar o objeto.

• Verificar se o ID da linha existe na lista antes de tentar atualizá-lo.

• Utilizar nomes de colunas exatamente iguais aos definidos na lista do SharePoint.

• Atualizar apenas as colunas necessárias para manter a consistência dos dados.