Insert ServiceNow ImportSet

UiPath.ServiceNow.Activities.InsertImportSet

A atividade Inserir ServiceNow Importset usa a API ServiceNow Import Set- POST para importar um novo objeto ImportSet.

Depois de inserir o registro ImportSet, 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:

Este pacote de atividades fornece quatro métodos diferentes para inserir um registro: Insert ServiceNow Record,Upsert Records, Insert ImportSet Recordse Insert ServiceNow ImportSet.

As atividadesInsert ServiceNow Record e Upsert Records usam APIs REST para gravar diretamente em uma tabela de produção. As atividades Insert ImportSet Records e Insert ServiceNow ImportSet usam 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 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 ServiceNow ImportSet dentro da atividade ServiceNow Scope .
4. Clique no botão Configurar dentro da atividade Inserir ServiceNow ImportSet (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 Saída.
   • Seus valores de propriedade de entrada são enviados para o ImportSet - POST API.
   • 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 ServiceNow ImportSet , 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.

Comum

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

Diversos

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