Inserir Registro do ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

A atividade Inserir registro do ServiceNow usa a tabela ServiceNow - API POST para inserir um novo objeto de registro.

Depois de inserir 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).

Essa atividade também retorna o valor sys_id do novo objeto de registro. Por exemplo, se você quiser inserir um objeto de incidente do ServiceNow, é possível gerar o valor sys_id adicionando uma variável String no assistente de objetos (consulte o exemplo abaixo).

Dica:

Esse pacote de atividades fornece três métodos diferentes para inserir um registro: Insert ServiceNow Record,Upsert Recordsou Insert ImportSet Records.

As atividadesInsert 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 inserção de registros diretamente nas tabelas de produção, é recomendável usar a atividade Upsert ServiceNow Record para inserir 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 Inserir Registro do ServiceNow dentro da atividade Escopo do ServiceNow .
4. Clique no botão Configurar dentro da atividade Inserir registro do ServiceNow (isso abre o Assistente de objeto).
5. Selecione o Objeto que deseja inserir e adicione os campos (com valores) que deseja preencher.
6. Crie e insira uma variável ResponseStatus para a propriedade Output .
   • Seus valores de propriedade de entrada são enviados para a Tabela - API POST .
   • A API retorna o valor ResponseStatus para sua variável de propriedade de saída.
     
     

     

     
     

No corpo da atividade

Para inserir os valores da propriedade Inserir 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 é criado. Insira uma variável String . O sys_id é gerado automaticamente pelo ServiceNow quando você insere seu novo registro. Para recuperar esse valor para uso em outras atividades, crie e insira uma variável String no assistente de objeto (exemplo mostrado abaixo).

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

• Camposadicionais - Um DataRow que inclui as colunas e os valores que você deseja inserir. 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.