Get Record

UiPath.MicrosoftDynamics.Activities.GetRecord

A atividade Get Record usa a operação GET da API da Web para recuperar um registro.

Depois de recuperar o registro, a atividade gera o status da solicitação (informações de sucesso/falha) em um objeto ResponseStatus (MicrosoftDynamicsStatus) que você pode usar em atividades subsequentes (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 Microsoft Dynamics Application Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gere o identificador de registro (por exemplo, Insert Record, Search Records).
4. Adicione a atividade Get Record dentro da atividade Microsoft Dynamics Application Scope .
5. Clique no botão Configurar dentro da atividade Obter registro (isso abre o Assistente de objeto).
6. Selecione o Objeto que deseja recuperar, insira o identificador do registro e adicione os campos (com valores) que deseja preencher.
7. Crie e insira uma variável ResponseStatus para a propriedade Saída .
   • Seus valores de propriedade de entrada são enviados na solicitação de operação POST .
   • A operação retorna o ResponseStatus e o valor para sua variável de propriedade de saída.
     
     

     

     
     

Configurar

Para inserir os valores da propriedade Get Record , você deve usar o Object Wizard clicando no botão Configure .

Quando selecionar um objeto usando o Assistente de objeto, você pode adicionar os campos que deseja atualizar. Para obter uma lista completa dos campos disponíveis para cada objeto, consulte a Referência do EntityType da API da Web na documentação da Microsoft.

Propriedades

Avançado

• Camposadicionais - Um DataRow que inclui as colunas e os valores que você deseja inserir. Insira uma variável DataRow .
  • Para determinar/validar seus nomes de coluna DataRow , clique no botão Configurar , selecione seu Objetoe revise os nomes mostrados na coluna Campo ; seus nomes de coluna DataRow devem corresponder ao valor mostrado.
  • Se você inserir um valor para um campo no Assistente de objeto e na propriedade Camposadicionais , o valor inserido no Assistente de objeto terá precedência (sobrescrevendo o valor Camposadicionais ).

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

• 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.

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.