Update ServiceNow Record

UiPath.ServiceNow.Activities.UpdateRecord

A atividade Update ServiceNow Record usa a API PUT do ServiceNow Table para atualizar um registro específico (sys_id).

Depois de atualizar o registro, a atividade gera o status da solicitação (informações de sucesso/falha) em um objeto ResponseStatus (ServiceNowStatus) que você pode usar em atividades subsequentes (por exemplo, lógica condicional).

Dica:

Este pacote de atividades fornece três métodos diferentes para atualizar um registro: Atualizar Registro do ServiceNow,Upsert Recordsou Insert ImportSet Records.

As atividadesUpdate ServiceNow Record e Upsert Records usam APIs REST para gravar diretamente em uma tabela de produção. A atividade Insert ImportSet Records usa a API REST Import Set para gravar em uma tabela de conjunto de importação da qual os dados são transformados na tabela de produção de destino.

Para evitar a atualização de registros diretamente nas tabelas de produção, é recomendável usar a atividade Insert ImportSet Records para atualizar um novo registro.

Para obter informações detalhadas, incluindo a solução de problemas do desempenho do conjunto de importação, consulte conjuntos de importação na documentação do ServiceNow.

Para saber mais sobre o uso de conjuntos de importação, consulte Conjunto de importação de serviço web e Importação de dados usando conjuntos de importação na documentação do ServiceNow.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione a atividade ServiceNow Scope ao seu projeto.
3. Adicione a atividade Atualizar registro do ServiceNow dentro da atividade Escopo do ServiceNow .
4. Clique no botão Configurar dentro da atividade Atualizar registro do ServiceNow (isso abre o Assistente de objeto).
5. Selecione o Objeto que deseja atualizar e insira, no mínimo, o sys_id do registro.
6. Crie e insira uma variável ResponseStatus para a propriedade de saída .
   • Seus valores de propriedade de entrada são enviados para a Tabela - API PUT .
   • A API retorna o valor ResponseStatus para sua variável de propriedade de saída.

No corpo da atividade

Para inserir os valores de propriedade Atualizar registro do ServiceNow , você deve usar o Assistente de objeto clicando no botão Configurar .

Para saber mais sobre o Assistente de Objetos, consulte a página Estruturas de atividades de negócios .

• ID_sys - O ID do registro do ServiceNow que você deseja atualizar. Para obter o valor sys_id , você pode seguir um dos métodos mostrados na documentação do identificador exclusivo de registro do ServiceNow (sys_id) ou clicar com o botão direito do mouse no registro na interface gráfica do ServiceNow e selecionar a opção Copiar sys_id no menu pop-out.

Propriedades

Observação: se você não vir uma lista de propriedades para o objeto escolhido, mesmo olhando para a opção "Adicionar vários campos", você pode não ter permissões suficientes no ServiceNow para ver os metadados do objeto e modificar dados. Consulte Solução de problemas de permissões para obter mais detalhes.

Avançado

• AdicionalFields - Um DataRow que inclui as colunas e os valores que você deseja atualizar. Os nomes das colunas devem corresponder aos nomes que aparecem na tabela de banco de dados do ServiceNow para o tipo de objeto selecionado.

Comum

• NomeDeExibição — o nome de exibição da atividade. Este campo é compatível apenas com variáveis Strings ou String.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

• ServiceNowStatus - O status da solicitação (informações de sucesso/falha). Insira uma variável ResponseStatus (UiPath.BAF.Models.ResponseStatus). O objeto ResponseStatus inclui três propriedades que você pode usar em outras atividades.
  • Sucesso - Boolean - Especifica se a solicitação de API foi bem-sucedida.
  • ErrorCode - String - O erro de resposta se a solicitação da API não for bem-sucedida (Success=False).
  • Mensagem - String - A mensagem de erro.

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.

Para obter instruções passo a passo e exemplos, consulte o Guia de início rápido.