Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

A atividade Get ServiceNow Record usa a API do ServiceNow Table - GET{sys_id} para recuperar um registro específico (sys_id).

Depois de recuperar 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 os dados do campo associados ao sys_id. Por exemplo, se você quiser recuperar um objeto de incidente do ServiceNow, você pode produzir os dados short_description e contact_type como saída adicionando os campos (com variáveis) no assistente de objetos (veja o exemplo abaixo).

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 Get ServiceNow Record dentro da atividade ServiceNow Scope .
4. Clique no botão Configurar dentro da atividade Obter registro do ServiceNow (isso abre o Assistente de objeto).
5. Selecione o Objeto que deseja recuperar e insira, no mínimo, o sys_id do registro.
6. Crie e insira uma variável ResponseStatus para a propriedade Saída .
   • Seus valores de propriedade de entrada são enviados para a API de Tabela - GET{sys_id} .
   • A API retorna o valor ResponseStatus para sua variável de propriedade de saída.
     
     

     

     
     

No corpo da atividade

Para inserir os valores de propriedade Obter 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 você deseja recuperar. Insira uma variável String ou String .
  • Para obter o valor sys_id , você pode seguir um dos métodos mostrados na documentação do identificador exclusivo de registro do ServiceNow (sys_id) ou clicar com o botão direito do mouse no registro na interface gráfica do ServiceNow e selecionar a opção Copiar sys_id no menu pop-out.

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

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