Update ServiceNow Record

UiPath.ServiceNow.Activities.UpdateRecord

A atividade Atualizar registro do ServiceNow usa a API ServiceNow Table-PUT 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 solução de problemas de desempenho do conjunto de importação, consulte conjuntos de importação na documentação do ServiceNow.

Para saber mais sobre como usar conjuntos de importação, consulte Conjunto de importação de serviço da 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 - PUT API.
   • 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 Object Wizard, consulte a página Business Activity Frameworks .

• sys_id - A 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 de registro exclusivo (sys_id) do ServiceNow ou clicar com o botão direito do mouse no registro na interface do usuário do ServiceNow e selecionar a opção Copiar sys_id no menu pop-up.

Propriedades

Nota: Se você não vir uma lista de propriedades para o objeto escolhido, mesmo olhando para a opção "Adicionar vários campos", talvez você não tenha permissões suficientes no ServiceNow para ver os metadados do objeto e modificar os dados. Consulte Solucionando problemas de permissão 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.