Insert Record

UiPath.MicrosoftDynamics.Activities.InsertRecord

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

Depois de inserir 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).

Se a solicitação for bem-sucedida, a atividade retornará o identificador String atribuído ao novo registro. Por exemplo, se você quiser inserir uma conta, você pode emitir o valor IdDaConta adicionando uma variável String usando o botão de configuração (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. Adicione a atividade Inserir registro dentro da atividade Escopo do aplicativo do Microsoft Dynamics .
4. Clique no botão Configurar dentro da atividade Inserir registro (isso abre o Assistente de objeto).
5. Selecione o Objeto que deseja inserir e adicione os campos (com valores) que deseja preencher.
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 de operação POST .
   • A operação retorna o identificador String e os valores ResponseStatus para suas variáveis de propriedade de saída.
     
     

     

     
     

Configurar

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

Quando você seleciona um Objeto usando o Assistentede Objetos, 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 TipoDeEntidade da API 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.