Pesquisar Registros do ServiceNow

UiPath.ServiceNow.Activities.SearchRecords

A atividade Pesquisar registros do ServiceNow usa a API ServiceNow Table-GET para recuperar registros específicos (Object) usando sua string de consulta codificada (Query).

Depois de recuperar os registros, a atividade gera o resultado da consulta como um objeto DataTable (Result) e o status da solicitação (informações de sucesso/falha) em um objeto ResponseStatus (ServiceNowStatus). Ambas as saídas podem ser usadas como variáveis de entrada em atividades subseqüentes (por exemplo, lógica condicional).

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 Pesquisar registros do ServiceNow dentro da atividade Escopo do ServiceNow .
4. Clique no botão Configurar dentro da atividade Pesquisar registros do ServiceNow (isso abre o Assistente de objeto).
5. Selecione o Objeto que você deseja recuperar e insira valores para as propriedades de Entrada .
6. Crie e insira variáveis DataTable e ResponseStatus para as propriedades de Saída .
   • Seus valores de propriedade de entrada são enviados para a API Table - GET .
   • A API retorna os valores DataTable e ResponseStatus para suas variáveis de propriedade de saída.
     
     

     

     
     

No corpo da atividade

Para inserir seus valores de propriedade Pesquisar registros do ServiceNow e/testar suas entradas de consulta , você pode usar o Assistente de objeto clicando no botão Configurar .

Para saber mais sobre o Object Wizard, consulte a página Business Activity Frameworks .

• Objeto - o tipo de objeto ServiceNow que você deseja recuperar. Use o Assistente de objeto para selecionar um objeto ou inserir uma variável String ou String válida. Se você usar o Object Wizard para selecionar seu objeto, também deverá usá-lo para alterar sua seleção. As alterações feitas sem usar o assistente de objeto fazem com que a atividade falhe normalmente.

Propriedades

Comum

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

Entrada

• Consulta - Os parâmetros do filtro. Insira uma variável String ou String .
  • Insira sua consulta seguindo o formato de string de consulta codificada do ServiceNow (por exemplo, "sysparm_query=short_descriptionLIKEUiPath&sysparm_fields=number,short_description").
  • Para criar sua consulta, é recomendável seguir as etapas para gerar uma string de consulta codificada por meio de um filtro na documentação do ServiceNow.
  • Para testar sua consulta, abra o Assistente de objeto, digite seu String (sem aspas ("")) e clique no botão Testar consulta para ver os resultados.
  • A consulta String inserida no Assistente de objeto também preenche a propriedade Consulta no Painel de propriedades.

    Mais informações sobre como criar consultas facilmente são descritas em Como usar a atividade Search ServiceNow Records .

Diversos

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

Saída

• Result - Os resultados da consulta. Insira uma variável DataTable .
• 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 os guias de início rápido .