Update Record

UiPath.MicrosoftDynamics.Activities.UpdateRecord

A atividade Update Record usa a operação PATCH da API da Web para atualizar um registro.

Depois de atualizar 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 Atualizar registro dentro da atividade Escopo do aplicativo do Microsoft Dynamics .
5. Clique no botão Configurar dentro da atividade Atualizar registro (isso abre o Assistente de objeto).
6. Selecione o Objeto que deseja atualizar, insira o identificador do registro e adicione os campos (com valores) que deseja atualizar.
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 da operação PATCH .
   • A operação retorna o ResponseStatus e o valor para sua variável de propriedade de saída.
     
     

     

     
     

Propriedades

Os valores para as seguintes propriedades são especificados ao adicionar esta atividade ao seu projeto no UiPath Studio.

Configurar

Para inserir seus valores de propriedade Atualizar registro , você deve usar o Assistente de objeto clicando no botão Configurar .

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.

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.