Inserir Registro do ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

A atividade Insert ServiceNow Record usa a API do ServiceNow Table — 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 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 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 Assistente de Objetos, consulte a página Estruturas de atividades de negócios .

• 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

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

• 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.