Pesquisar Registros

UiPath.MicrosoftDynamics.Activities.SearchRecords

Usando seus parâmetros de pesquisa (QueryOptions e Object), a atividade Search Records usa a operação Web API GET para recuperar registros.

Depois de recuperar os registros, a atividade gera os resultados em um objeto DataTable (Result) e o status da solicitação (informações de sucesso/falha) em um objeto ResponseStatus (MicrosoftDynamicsStatus), ambos os quais poderão ser usados em atividades subsequentes (por exemplo, lógica condicional, Update Record, Download Activity Attachment, etc.).

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 Microsoft Dynamics Application Scope ao seu projeto.
3. Adicione a atividade Pesquisar registros dentro da atividade Escopo do aplicativo do Microsoft Dynamics .
4. Selecione o Objeto que deseja recuperar e insira os parâmetros de pesquisa na propriedade Opções .
5. Crie e insira uma variável DataTable e ResponseStatus para as propriedades de Saída .
   • Seus valores de propriedade de entrada são enviados na solicitação de operação GET .
   • A operação retorna os valores DataTable e ResponseStatus para suas variáveis de propriedade de saída.
     
     

     

     
     

No corpo da atividade

• Objeto - Selecione um Objeto usando o Assistente de Objetos.

Propriedades

Comum

• DisplayName - O nome de exibição da atividade. Este campo suporta apenas strings ou variáveis String .

Diversos

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

Opções

• QueryOptions - Os parâmetros de pesquisa que você deseja usar para recuperar seus registros. Insira uma variável Dictionary<String, String> ou Dictionary<String, String> . Para obter mais informações sobre valores de consulta, consulte as páginas de metadados de consulta e/ou dados de consulta na documentação da Microsoft. Veja as etapas abaixo para uma maneira de criar e preencher uma variável Dictionary<String, String> .
  Observação:

  Veja a seguir uma maneira de preencher uma variável Dictionary<String, String> :

  • Instale o pacote Microsoft.Activities.Extensions .
  • Crie uma nova variável Dictionary<String, String> (por exemplo, queryOption).
  • Adicione uma atividade Adicionar ao dicionário .
  • Digite sua variável de dicionário (por exemplo, queryOption)
  • Insira um único método de consulta na propriedade Key (por exemplo, "$filter", "$select", etc.)

  • Insira o valor a ser aplicado ao método de consulta (por exemplo, "name eq 'Quickstart_Account'")

    • Repita a etapa 3 para aplicar QueryOptionsadicionais.

Saída

• ResponseStatus - 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.
• Resultado - Os registros que correspondem aos seus parâmetros de pesquisa. Insira uma variável DataTable .

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.