Designer de atividades

Visão geral

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 ao seu tipo de solicitação. O designer de atividades recupera todos os parâmetros e campos das guias Parâmetros ou Campos de solicitação 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:

Figura 1. Parâmetros com um campo obrigatório

Figura 2. Campos de solicitação com um campo obrigatório

A imagem a seguir mostra a guia Campos de solicitação do recurso. Apenas um campo está marcado como obrigatório:

A imagem a seguir mostra a guia Designer de atividades do recurso. Os campos de parâmetro e solicitação necessários são exibidos na janela Visualização:

Parâmetros de edição

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

Configure o posicionamento de parâmetros e campos de solicitação escolhendo uma opção de Posição : Primário, Secundário ou Nenhum. Quando você define um campo como Obrigatório, sua Posição é automaticamente definida como Primária e o campo é exibido na seção principal da tela da atividade.

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 atividades , é possível especificar a posição de um parâmetro ou campo na tela da atividade como Primário, Secundário ou Nenhum. Cada opção dita o comportamento do parâmetro e onde ele é exibido na tela da atividade. Como alternativa, você pode marcar um campo como Obrigatório para definir automaticamente sua posição como Primário.

• Obrigatório: o parâmetro ou campo requer um valor para executar com sucesso a atividade. O parâmetro é marcado como necessário usando o símbolo do asterisco (*). Isso significa que ela estará sempre visível na tela e que você deve fornecer um valor para ela.

  
  

  

  
  
• Primário: o parâmetro é exibido na seção primária da atividade. Pode ser deixado em branco ao usar a atividade em uma automação.
  
  

  

  
  
• Secundário: 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.
  
  

  

  
  
• Nenhum: o parâmetro está oculto da atividade. Você deve usar o assistente Gerenciar propriedades para adicioná-la à tela.

Ordenar parâmetros de entrada

A ordem dos parâmetros de entrada determina sua localização na janela de Visualização da atividade. Você pode alterar a ordem de exibição usando o ícone localizado na extremidade esquerda de cada parâmetro para arrastar o item da lista para cima ou para baixo.

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

Preenchimento de campos de solicitação e resposta

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

Opção 1 (recomendada): usar 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. Selecione 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, faça uma solicitação que seja exaustiva de todos os campos que você 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: adição manual de cada campo de solicitação e resposta da guia Designer de atividades .

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 extraídos dos campos Resposta. Os valores podem ser preenchidos fazendo uma chamada com sucesso 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 imagem a seguir mostra como Status, o campo selecionado, é exibido diretamente na seção Saída da atividade: