Update Record

UiPath.MicrosoftDynamics.Activities.UpdateRecord

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

After updating the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (MicrosoftDynamicsStatus) that you can use in subsequent activities (e.g., conditional logic).

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, Inserir registro, Pesquisar registros).
4. Add the Update Record activity inside the Microsoft Dynamics Application Scope activity.
5. Click the Configure button inside the Update Record activity (this opens the Object Wizard).
6. Select the Object you want to update, enter the record identifier, and add the fields (with values) that you want to update.
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

To enter your Update Record property values, you must use the Object Wizard by clicking the Configure button.

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

Propriedades

Avançado

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. Enter a DataRow variable.
  • To determine/validate your DataRow column names, click the Configure button, select your Object, and review the names shown in the Field column; your DataRow column names must match the shown value.
  • If you enter a value for a field in both the Object Wizard and the AdditionalFields property, the value entered in the Object Wizard takes precedent (overwriting the AdditionalFields value).

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

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

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 .