Activités de workflow

Dernière mise à jour 20 déc. 2024

Custom Input

UiPath.System.Activities.CustomInput

Charge et affiche un formulaire HTML personnalisé dans une fenêtre de navigateur, ce qui vous permet de collecter certaines données auprès d'un utilisateur humain. Les données recueillies dans le formulaire peuvent ensuite être traitées à l'aide d'activités ultérieures. Le langage pouvant être utilisé dans le fichier ne se limite pas à HTML, tout autre langage étant pris en charge. Pour pouvoir récupérer les données dans Studio, le fichier HTML doit contenir une certaine fonction JavaScript, qui est détaillée ici .

Propriétés

Commun

NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

URI : l'URI du fichier HTML à charger. Ce champ ne prend en charge que les chaînes et les variables String. Dans ce champ, vous pouvez entrer un chemin d'accès au fichier ou une URL.

Remarque :Lorsque vous utilisez une URL, elle doit être insérée au format complet, par exemple : https://activities.uipath.com/docs/custom-input/.

Divers

Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

Result : les données provenant du formulaire d'entrée personnalisé, stockées dans une variable String. Ce champ ne prend en charge que les variables String.

Création du fichier HTML personnalisé

Note : Pour que l'activité puisse récupérer les données saisies dans le formulaire, le script HTML doit contenir la balise window.external.setResult([Result]), où window.external.setResult([Result]) représente les données devant être récupérées.

Prenons, par exemple, le fichier HTML qui récupère le prénom, le nom de famille et l'âge de l'utilisateur humain. Le formulaire d'entrée ressemble à ceci :

Le code HTML derrière cette page doit ressembler à ceci :

<!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>

Cette page ne contient pas le code nécessaire pour renvoyer les données collectées à l'utilisateur. Après l'avoir ajouté, le fichier doit ressembler à ceci :

<!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>

Exemple d'utilisation de l'activité Custom Input

Pour illustrer comment utiliser cette activité, nous avons créé un projet d'automatisation simple qui recueille le prénom, le nom de famille et l'âge d'un utilisateur humain puis l'affiche dans une boîte de message. Vous pouvez télécharger le projet et l'exemple de page HTML correspondant ici.

Sommaire de la page