Insert ImportSet Records

UiPath.ServiceNow.Activities.InsertImportSetRecords

A atividade Insert ImportSet Records usa o ServiceNow Import Set - GET API para atualizar registros existentes ou inserir novos.

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 atividadesAtualizar 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 Insert ImportSet Records dentro da atividade ServiceNow Scope .
4. Clique no botão Configurar dentro da atividade Inserir registros ImportSet (isso abre o Assistente de objeto).
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 conjunto de importação - GET API.
   • A API retorna os valores DataTable and ResponseStatus` para suas variáveis de propriedade de saída.
     
     

     

     
     

No corpo da atividade

Para selecionar seu conjunto de importação, você deve usar o Assistente de objeto clicando no botão Configurar .

• Objeto - O conjunto de importação que você deseja usar. Use o Object Wizard para selecionar seu conjunto de importação. A lista suspensa Assistente de objetos inclui os conjuntos de importação que você possui em seu aplicativo ServiceNow.

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", talvez não tenha permissões suficientes no ServiceNow para ver os metadados do objeto e modificar dados. Consulte Solução de problemas para obter mais detalhes.

Comum

• DisplayName - O nome de exibição da atividade. Insira uma variável String ou String .

Entrada

• DataTable - Os dados que você deseja inserir. Insira uma variável DataTable .

Diversos

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

Saída

• Resultado - Os dados do resultado da inserção. Insira uma variável DataTable .
• 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.