Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

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

After retrieving 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 os dados do campo associados ao sys_id. Por exemplo, se você quiser recuperar um objeto de incidente do ServiceNow, você pode gerar os dados Short_description e contact_type adicionando os campos (com variáveis) no assistente de objeto (consulte 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. Add the Get ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Get ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to retrieve and enter, at a minimum, the sys_id of the record.
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 Tabela - GET{sys_id} .

   • A API retorna o valor ResponseStatus para sua variável de propriedade de saída.

     

No corpo da atividade

To enter your Get 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 you want to retrieve. Enter a String or String variable.
  • Para obter o valor de sys_id , você pode seguir um dos métodos mostrados na documentação do identificador de registro exclusivo do ServiceNow (sys_id) ou clicar com o botão direito do mouse no registro na interface do usuário 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", 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 retrieve. 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 .