Inserir Registro do ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

A atividade Insert ServiceNow Record usa a API ServiceNow Table - POST para inserir um novo objeto de registro.

After inserting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

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, você pode gerar o valor de sys_id adicionando uma variável String no assistente de objeto (consulte o exemplo abaixo).

Dica:

Esse pacote de atividades fornece três métodos diferentes para inserir um registro: Insert ServiceNow Record,Upsert Records ou 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 Records para gravar em uma tabela de conjunto de importação a partir 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 que você use a atividade Upsert ServiceNow Record para inserir um novo registro. Para obter informações detalhadas, incluindo solução de problemas de desempenho de conjuntos 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. Add the Insert ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Insert ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) you want to populate.
6. Crie e insira ResponseStatus variável para a propriedade Saída .

   • 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

To enter your Insert ServiceNow Record property values, you must use the Object Wizard by clicking the Configure button.

Para saber mais sobre o Assistente de Objetos, consulte a página Estruturas de atividades de negócios .

• sys_id - The id of the ServiceNow record that gets created. Enter a String variable. The sys_id is auto-generated by ServiceNow when you insert your new record. To retrieve this value for use in other activities, create and enter a String variable in the object wizard (example shown below).

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

Avançado

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. The column names must match the names as they appear in the ServiceNow database table for the selected object type.

Comum

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Diversos

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

Saída

• ServiceNowStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.

Para instruções passo a passo e exemplos, consulte o Guia de início rápido .