Workflow-Aktivitäten

Letzte Aktualisierung 20. Dez. 2024

Benutzerdefinierte Eingabe (Custom Input)

UiPath.System.Activities.CustomInput

Lädt ein benutzerdefiniertes HTML-Formular in ein Browserfenster, mit dem Sie bestimmte Daten eines menschlichen Benutzers erfassen können, und zeigt es an. Die in diesem Formular zusammengetragenen Daten können mit den nachfolgenden Aktivitäten weiterverarbeitet werden. Die Sprache, die innerhalb der Datei verwendet werden kann, ist nicht auf HTML begrenzt, sondern es wird jede beliebige Sprache unterstützt. Um die Daten innerhalb Studio abfragen zu können, muss die HTML-Datei eine bestimmte JavaScript-Funktion enthalten, die hier ausführlich erläutert ist.

Eigenschaften

Allgemein

AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

URI - Die URI der HTML-Datei, die Sie laden möchten. Dieses Feld unterstützt nur Strings und Variablen des Typs String. In diesem Feld können Sie einen Dateipfad oder eine URL eingeben.

Hinweis: Bei Verwendung einer URL muss diese in Vollformat eingefügt werden, zum Beispiel: https://activities.uipath.com/docs/custom-input/.

Sonstiges

Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

Ergebnis (Result) - Die Daten aus dem benutzerdefinierten Eingabeformular, gespeichert in einer Stringvariablen. Dieses Feld unterstützt nur Variablen vom Typ String.

Erstellen der benutzerdefinierten HTML-Datei

Hinweis: Damit die Aktivität in der Lage ist, Daten abzurufen, die in das Formular eingegeben werden, muss das HTML-Skript den Tag window.external.setResult([Result]) enthalten, wobei Result die abzufragenden Daten sind.

Nehmen Sie zum Beispiel eine HTML-Datei, die den Vornamen, den Nachnamen und das Alter eines menschlichen Benutzers abfragt. Das Eingabeformular sieht folgendermaßen aus:

Der HTML-Code hinter dieser Seite sieht folgendermaßen aus:

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

Diese Seite enthält nicht den erforderlichen Code, um die erfassten Daten zurück zum Benutzer zu senden. Nach dem Hinzufügen sollte die Datei folgendermaßen aussehen:

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

Beispiel der Verwendung der benutzerdefinierten Eingabeaktivität

Um zu erklären, wie man mit dieser Aktivität arbeitet, haben wir ein einfaches Automatisierungsprojekt erstellt, das den Vornamen, den Nachnamen und das Alter eines menschlichen Benutzers erfasst und diese in einem Meldungsfenster anzeigt. Sie können das Projekt und die entsprechenden HTML-Beispiele hier herunterladen.

Auf dieser Seite