Designer de atividades

Visão geral

O designer de atividades permite visualizar o layout de suas atividades personalizadas do Integration Service, como 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 aba 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 aba 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 selecionando as 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ário e o campo é exibido na seção principal da tela da atividade.

Altere como o parâmetro é exibido na janela Visualização ( seu Nome de exibição e Descrição) selecionando o Editar ícone 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 determina o comportamento do parâmetro e onde ele é exibido na tela da atividade. Ou então, 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 a atividade com sucesso. O parâmetro é marcado como necessário usando o símbolo de asterisco (*). Isso significa que 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 fica 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. Selecione o botão Enviar Solicitação de um recurso.
2. Adicione o JSON.
3. Certifique-se de que a opção Substituir campos ao enviar 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 uma carga de exemplo para uma solicitação POST . Observe que o campo Substituir campos ao enviar solicitação está habilitado:

Opção 2: adicionar manualmente cada campo de solicitação e resposta na guia Designer de atividades .

1. Navegue até a guia Designer de atividades .

2. Na aba Entrada , selecione 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 Output no Designer de atividades são extraídos dos campos Response. Os valores podem ser preenchidos fazendo uma chamada para o recurso com sucesso.

Campos selecionados

Você pode marcar campos de saída como Selecionados. 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: