Insert Record

UiPath.MicrosoftDynamics.Activities.InsertRecord

A atividade Insert Record usa a operação POST da API da Web para inserir um novo registro.

After inserting 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).

Se a solicitação for bem-sucedida, a atividade retorna o identificador String atribuído ao novo registro. Por exemplo, se você quiser inserir uma Conta, você pode gerar o valor de AccountId adicionando uma variável String usando o botão configurar (consulte o exemplo abaixo).

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. Add the Insert Record activity inside the Microsoft Dynamics Application Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) that you want to populate.
6. 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 POST .

   • A operação retorna o identificador String e os valores ResponseStatus para suas variáveis de propriedade de saída.

     

Configurar

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

Quando você seleciona um Objeto usando o Assistente de Objeto, você pode adicionar os campos que deseja incluir no novo registro. 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.

Para instruções passo a passo e exemplos, consulte o Guia de início rápido .