Designer de atividades

Visão geral

O designer de atividades é uma nova funcionalidade do Connector Builder. O designer de atividades permite visualizar o layout de suas atividades personalizadas do Integration Service, conforme elas aparecerão no UiPath® Studio.

Suas principais funcionalidades incluem:

• Visualizar o layout: visualize o design das suas atividades personalizadas e veja como elas aparecerão no Studio. Você pode visualizar a configuração e fazer os ajustes necessários antes de implantar seu conector.
• Configurações de parâmetros: crie e gerencie campos de parâmetros para maior flexibilidade na personalização de sua atividade. Isso inclui entrada, saída, argumentos In/Out e propriedades usadas no seu fluxo de trabalho.
• Campos de solicitação e resposta: adicione campos de solicitação e resposta. Isso ajuda a definir as informações exigidas pela atividade (solicitação) e as informações que serão retornadas pela atividade (resposta).

Campos de entrada

Para configurar os recursos de um conector personalizado, você usa a guia Parâmetros para adicionar campos específicos do seu tipo de solicitação. Agora, o designer de atividades recupera todos os campos de parâmetros e os exibe na seção Entrada .

A imagem a seguir mostra a guia Parâmetros do recurso. Apenas um campo está marcado como obrigatório:

A imagem a seguir mostra a guia Designer de atividades do recurso. Os mesmos parâmetros são listados à esquerda, mas apenas o campo marcado como Obrigatório é exibido na janela de Visualização:

Parâmetros de edição

Edite ou exclua parâmetros da guia Designer de atividades clicando no link Mais opções menu.

Altere a forma como o parâmetro é exibido na janela de Visualização (seu Nome de exibição e Descrição) clicando no botão Editar ao lado do nome do parâmetro.

Valores do parâmetro de entrada

Na guia Designer de atividade , você pode marcar cada campo de entrada como Obrigatório, Principal ou Adicional. Cada opção dita o comportamento do parâmetro e onde ele é exibido na tela da atividade.

• Obrigatório: o parâmetro é marcado como necessário usando o símbolo do asterisco (*). Isso significa que está sempre visível na tela e um valor deve ser fornecido para ela.

  
  

  

  
  
• Main: o parâmetro é exibido na seção primária da atividade. Ela pode ser deixada em branco ao usar a atividade em uma automação.
  
  

  

  
  
• Adicional: o parâmetro fica oculto na tela principal. Ela é exibida na seção Mostrar opções adicionais . Esses campos são opcionais e podem ser deixados em branco.
  
  

  

  
  

Ordenar parâmetros de entrada

A ordem dos parâmetros de entrada determina a localização dos parâmetros na janela de Visualização da atividade. Você pode alterar a ordem usando o Arrastar localizado ao lado de cada parâmetro.

Por exemplo, para mover o campo Quando para a parte superior da seção Entrada , arraste o campo ícone para cima.

Na janela Visualização da atividade, os campos são exibidos na ordem listada na guia Entrada , dependendo do grupo ao qual estão atribuídos (Obrigatório, Principal e Adicional).

Campos de solicitação

Os campos de solicitação permitem preencher o corpo de uma solicitação HTTP.

Os campos de solicitação são mais frequentemente associados a solicitações POST, PUT ou PATCH (atividades inserir, upsert ou atualizar registro). Se você adicionar um campo de solicitação a uma solicitação GET ou DELETE (atividades list, get ou delete), uma mensagem de erro será exibida, notificando você que o campo não será exibido para aquela operação.

A imagem a seguir mostra a mensagem de erro exibida ao se tentar adicionar um campo de solicitação a um recurso DELETE :

Preenchimento de campos de solicitação e resposta

Há duas maneiras de preencher os campos de solicitação e resposta.

Opção 1 (recomendada)

Use um JSON formatado corretamente.

1. Clique no botão Enviar Solicitação de um recurso.
2. Adicione o JSON.
3. Certifique-se de que a opção Substituir campos ao enviar a solicitação esteja habilitada.
4. Clique em Executar.

Se a resposta for bem-sucedida, os campos de entrada serão preenchidos com as propriedades JSON usadas para a solicitação e os campos de saída serão preenchidos com base na resposta.

Observação: se você usar esse método, certifique-se de fazer uma solicitação completa de todos os campos que deseja usar em sua atividade.

A imagem a seguir mostra um exemplo de carga útil para uma solicitação POST . Observe que o campo Substituir campos ao enviar solicitação está habilitado:

Opção 2

Você pode adicionar manualmente cada campo de solicitação e resposta a partir da guia Designer de atividade .

1. Navegue até a guia Designer de atividades .
2. Na aba Entrada , clique no botão Mais opções menu.
3. Selecione Adicionar campo de solicitação.
4. Adicione os detalhes do campo de solicitação de maneira semelhante à adição de um parâmetro.
   
   

   

   
   
5. Para adicionar campos de resposta, acesse a aba Saída e selecione a opção Adicionar campo de resposta .
   
   

   

   
   

Campos de saída

Os campos Saída no Designer de atividades são obtidos a partir dos campos Resposta. Os valores podem ser preenchidos fazendo com sucesso uma solicitação para o recurso.

Campos selecionados

Você pode marcar campos de saída como Selecionado. O valor do campo é extraído especificamente do objeto de resposta e pode ser atribuído a uma variável, facilitando o acesso e o uso em outras atividades quando usado em uma automação.

A seguinte imagem mostra como URL, o campo selecionado, é exibido diretamente na seção Saída da atividade: