Upsert Records

UiPath.ServiceNow.Activities.UpsertRecords

A atividade Upsert Records usa o ServiceNow Batch - POST API para atualizar ou inserir um ou mais registros.

Depois de concluir a operação, a atividade gera o resultado da inserção em um objeto DataTable (Result) e o status da operaçã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 quatro métodos diferentes para atualizar e/ou inserir um registro: Atualizar Registro do ServiceNow, Inserir Registro do ServiceNow, Upsert Recordsou Insert ImportSet Records.

As atividades Atualizar registro do ServiceNow, Inserir registro do ServiceNowe Atualizar registros 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 gravar diretamente nas tabelas de produção, é recomendável usar a atividade Insert ImportSet Records para atualizar ou inserir um novo registro.

Para obter informações detalhadas, incluindo a solução de problemas de desempenho do conjunto de importação, consulte os 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 Upsert Records dentro da atividade ServiceNow Scope .
4. Clique no botão Configurar dentro da atividade Upsert Records (isso abre o Object Wizard).
5. Selecione o Objeto que deseja usar para seu conjunto de importação e insira suas propriedades de entrada .
6. Crie e insira uma variável DataTable e uma variável ResponseStatus para as propriedades de Saída .
   • Seus valores de propriedade de entrada são enviados para o Batch - POST API.
   • A API retorna os valores DataTable e ResponseStatus para suas variáveis de propriedade de saída.
     
     

     

     
     

Configurar

Para selecionar seu objeto, você deve usar o Object Wizard clicando no botão Configurar .

Para saber mais sobre o Object Wizard, consulte a página Business Activity Frameworks .

• Objeto - O tipo de registro que você deseja inserir ou atualizar. Isso será definido e aparecerá na tela de tempo de design, mas não no painel de propriedades. Use o Object Wizard para selecionar seu objeto.

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.

Comum

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

Entrada

• DataTable - Os dados do registro que você deseja inserir ou atualizar. Insira uma variável DataTable .
  • Para atualizar um registro existente, adicione o valor sys_Id à linha de dados que contém as atualizações que você deseja fazer.
  • As linhas de dados sem um valor sys_id são inseridas como novos registros (o sys_id do novo registro é retornado no objeto Resultados DataTable ).
  • O número máximo de registros que você pode atualizar ou inserir por execução de atividade é 200. Se você deseja inserir/atualizar mais de 200 registros, pode adicionar um loop for ou adicionar uma Upsert Activity para cada DataTable que contém 200 registros (por exemplo, se você tiver 4.000 registros no total, poderá dividir os registros em 20 registros separados Atividades). Para obter mais informações, consulte Batch API na documentação do ServiceNow.

Diversos

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

Saída

• Status - 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.
• Resultado - O resultado do(s) registro(s) inserido(s) ou atualizado(s). O Resultados DataTable tem a mesma estrutura da DataTablede entrada, com as seguintes exceções:
  • Novos registros que foram inseridos com sucesso agora incluem um valor sys_id .
  • Uma nova coluna "ActionType" é anexada e inclui um valor de Add ou Update para indicar se um registro foi atualizado ou adicionado à tabela.
  • Uma nova coluna "Error" é anexada e inclui informações de erro se a operação falhou.