Entrada Personalizada

UiPath.System.Activities.CustomInput

Carrega e exibe um formulário HTML personalizado em uma janela do navegador, permitindo que você colete determinados dados de um usuário humano. Os dados coletados no formulário podem então ser processados com atividades subsequentes. O idioma que pode ser usado dentro do arquivo não está limitado ao HTML, qualquer outro idioma é suportado. Para poder recuperar os dados dentro do Studio, o arquivo HTML deve conter uma determinada função de JavaScript, que é detalhada aqui.

Propriedades

Comum

NomeDeExibição - o nome de exibição da atividade.

Entrada

URI — o URI do arquivo HTML que você deseja carregar. Este campo é compatível apenas com strings e variáveis string. Neste campo, você pode inserir um caminho de arquivo ou um URL.

Observação: ao usar uma URL, ela deve ser inserida no formato completo, por exemplo: https://activities.uipath.com/docs/custom-input/.

Diversos

Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

Resultado — os dados de um formulário de entrada personalizado, armazenado em uma variável String. Este campo é compatível apenas com variáveis String.

Como criar o arquivo HTML personalizado

Observação: para que a atividade possa recuperar os dados digitados no formulário, o script HTML deve conter a tag window.external.setResult([Result]), onde Result são os dados a serem recuperados.

Para exemplificar, vamos usar um arquivo HTML que recupera o Nome, Sobrenome e Idade de um usuário humano. O formulário de entrada se parece com este:

O código HTML por trás desta página se parece com este:

<!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
    
  </body>
  </html><!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
    
  </body>
  </html>

Esta página não contém o código necessário para enviar os dados coletados de volta ao usuário. Após adicioná-lo, o arquivo deve ficar assim:

<!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
          <script type="text/javascript">
          function SubmitValues(){
            var First_Name = document.getElementById("First_Name").value;
            var Last_Name = document.getElementById("Last_Name").value;
            var Age = document.getElementById("Age").value;
            window.external.setResult(First_Name + "," + Last_Name + "," + Age);
            return true;
          }
            
          </script>
  </body>
  </html><!DOCTYPE html>
<html lang="en">
 <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <title>UiPath KYC Solution</title>
  </head>
  <body>
      
          First Name:<br>
          <input type="text" id="First_Name"><br>
          Last Name:<br>
          <input type="text" id="Last_Name"><br>
          Age:<br>
          <input type="text" id="Age"><br>
          <button onclick="SubmitValues()">Submit</button>
          <script type="text/javascript">
          function SubmitValues(){
            var First_Name = document.getElementById("First_Name").value;
            var Last_Name = document.getElementById("Last_Name").value;
            var Age = document.getElementById("Age").value;
            window.external.setResult(First_Name + "," + Last_Name + "," + Age);
            return true;
          }
            
          </script>
  </body>
  </html>

Exemplo de uso da atividade Custom Input

Para exemplificar como usar esta atividade, construímos um projeto de automação simples que coleta o Nome, Sobrenome e Idade de um usuário humano e, em seguida, exibe-os em uma caixa de mensagem. Você pode baixar o projeto e o exemplo da página HTML correspondente aqui.

Nesta página