Variablentypen

Textvariablen

Eine Text- oder String-Variable ist ein Variablentyp, der nur Strings speichern kann. Diese Arten von Variablen können zum Speichern von Informationen wie Mitarbeitername, Benutzername oder allen anderen Strings verwendet werden.

Hinweis: In UiPath müssen alle Strings in Anführungszeichen gesetzt werden.

Beispiel der Verwendung einer Textvariable

Um zu veranschaulichen, wie Sie mit Textvariablen arbeiten können, erstellen wir ein Projekt, das nach dem Namen des Benutzers fragt, diesen speichert und nur den ersten Buchstaben seines Namens im Panel Ausgabe (Output) anzeigt.

1. Erstellen Sie eine Sequence.
2. Erstellen Sie zwei einfache String-Variablen, FullName und FirstLetter.
   
   

   

   
   
3. Fügen Sie eine Eingabedialog (Input Dialog)-Aktivität in das Panel Designer (Designer) ein.
4. Schreiben Sie Folgendes in das Feld Eingabebezeichnung: „Geben Sie Ihren vollständigen Namen ein.“
5. Schreiben Sie Folgendes in das Feld Dialogfeldtitel: „Wie lautet Ihr Name?“
6. Fügen Sie im Feld Eingegebener Wert die Variable FullName hinzu. Diese Variable speichert alles, was der Benutzer in die Eingabeaufforderung der Input Dialog-Aktivität schreibt.
7. Fügen Sie eine Zuweisen (Assign)-Aktivität unter der Eingabedialog (Input Dialog)-Aktivität ein.
8. Fügen Sie die Variable FirstLetter im Panel Eigenschaften (Properties) im Feld An (To) hinzu.
9. Geben Sie FullName.Substring(0,1) im Feld Wert ein. Die Variable FirstLetter wird dem neu erstellten Wert, der durch den Ausdruck FullName.Substring(0,1) erstellt wurde, zugewiesen.
   Hinweis: Dieses Feld verwendet die Funktion Substring(), um das erste Zeichen aus dem String zu finden, der vom Benutzer im Eingabedialog (Input Dialog) hinzugefügt wurde.
10. Fügen Sie eine Zeile schreiben (Write Line)-Aktivität unter der Aktivität Zuweisen (Assign) hinzu.
11. Geben Sie die Variable FirstLetter im Panel Eigenschaften im Feld Text ein. Hierdurch wird im Panel Ausgabe der erste Buchstabe angezeigt, den der Benutzer im Eingabedialog eingegeben hat. Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.
    
    

    

    
    
12. Drücken Sie F5. Das Fenster What is your name? wird angezeigt.
13. Geben Sie Ihren Namen in das Textfeld ein und klicken Sie auf OK (OK). Beachten Sie, dass der erste Buchstabe Ihres Namens in UiPath Studio (UiPath Studio) im Panel Ausgabe (Output) angezeigt wird.
    
    

    

    
    

Beispiel herunterladen

Variablen „True“ oder „False“

Die Variable "True" oder "False", auch als boolescher Wert bezeichnet, ist ein Variablentyp, der nur zwei mögliche Werte (true oder false) besitzt. Diese Variablen ermöglichen es Ihnen, Entscheidungen zu treffen und somit Ihren Flow besser zu steuern.

Beispiel der Verwendung von "True"- oder "False"-Variablen

Um zu veranschaulichen, wie Sie mit "True"- oder "False"-Variablen arbeiten können, erstellen wir eine Automatisierung, die den Benutzer nach seinem Namen und seinem Geschlecht fragt und die Ergebnisse in einem anderen Fenster anzeigt.

1. Erstellen Sie einen neuen Prozess und fügen Sie ein Flowchart hinzu.
2. Erstellen Sie zwei String-Variablen Name und Gender. Die erste wird verwendet, um den Namen des Benutzers zu speichern, und die zweite, um das Geschlecht des Benutzers zu speichern.
3. Erstellen Sei eine boolesche Variable, Male. Diese Variable wird verwendet, um zu überprüfen, ob der Benutzer männlich ist.
   
   

   

   
   
4. Fügen Sie eine Eingabedialog (Input Dialog)-Aktivität im Panel Designer (Designer) hinzu und verbinden Sie sie mit dem Knoten Start.
5. Geben Sie "Wie heißen Sie?" in das Feld Beschriftung (Label) im Panel Eigenschaften (Properties) ein.
6. Fügen Sie einen Titel und die Variable Name im Feld Ergebnis (Result) hinzu.
7. Fügen Sie eine weitere Eingabedialog (Input Dialog)-Aktivität hinzu und verbinden Sie sie mit der vorherigen.
8. Geben Sie "Was ist Ihr Geschlecht?" in das Feld Beschriftung (Label) im Panel Eigenschaften (Properties) ein.
9. Fügen Sie einen Titel und die Variable Gender im Feld Ergebnis (Result) hinzu.
10. Fügen Sie eine Flow-Entscheidung (Flow Decision)-Aktivität im Panel Designer (Designer) hinzu und verbinden Sie sie mit der zweiten Eingabedialog (Input Dialog)-Aktivität.
11. Geben Sie Gender = "Männlich" oder Gender = "männlich" im Panel Eigenschaften (Properties) in das Feld Bedingung (Condition) ein. Diese Aktivität überprüft, ob der Benutzer männlich oder weiblich ist.
12. Fügen Sie zwei Zuweisen (Assign)-Aktivitäten hinzu.
13. Verbinden Sie die Verzweigung Wahr (True) mit einer Flussentscheidung(Flow Decision)-Aktivität.
14. Geben Sie die Variable Male im Panel Eigenschaften (Properties) in das Feld An (To) ein.
15. Geben Sie im Feld Wert Wahr ein. Dies weist der Variablen Male den Wert Wahr zu, wenn die Bedingung Gender = "Männlich" oder Gender = "männlich" erfüllt ist.
16. Verbinden Sie die zweite Zuweisen (Assign)-Aktivität mit der Verzweigung Falsch (False) der Flow-Entscheidung (Flow Decision).
17. Geben Sie die Variable Male im Panel Eigenschaften (Properties) in das Feld An (To) ein.
18. Geben Sie im Feld Wert Falschein. Dies weist der Variablen Male den Wert Falsch zu, wenn die Bedingung Gender = "Männlich" oder Gender = "männlich" nicht erfüllt ist.
19. Fügen Sie eine neue Flow-Entscheidung (Flow Decision)-Aktivität hinzu und verbinden Sie die zuvor erstellten Zuweisen (Assign)-Aktivitäten damit.
20. Geben Sie Male = True im Panel Eigenschaften (Properties) in das Feld Bedingung (Condition) ein.
21. Fügen Sie eine Nachrichtenbox (Message box)-Aktivität hinzu und verbinden Sie diese mit der Verzweigung Wahr (True) der Aktivität Flow-Entscheidung (Flow Decision).
22. Geben Sie Name + " ist ein(e) " + Gender + "." in das Feld Text (Text) im Panel Eigenschaften (Properties) ein. Diese Nachricht zeigt den Namen und das Geschlecht des Benutzers an, wenn Male "True" ist.
23. Fügen Sie eine weitere Nachrichtenbox (Message box)-Aktivität hinzu und verbinden Sie diese mit der Verzweigung Falsch (False) der Flow-Entscheidung (Flow Decision).
24. Geben Sie Name + " ist ein(e) " + Gender + "." in das Feld Text (Text) im Panel Eigenschaften (Properties) ein. Diese Nachricht zeigt den Namen und das Geschlecht des Benutzers an, wenn Male "False" ist. Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.
    
    

    

    
    
25. Drücken Sie F5. Die Automatisierung wird ausgeführt. Beachten Sie, dass das finale Nachrichtenbox (Message box) die Nachricht wie erwartet anzeigt.
    
    

    

    
    

Beispiel herunterladen

Zahlenvariablen

Zahlenvariablen werden auch als Integer oder Int32 bezeichnet und zum Speichern numerischer Informationen verwendet. Sie können unter anderem verwendet werden, um Gleichungen oder Vergleiche durchzuführen und wichtige Daten zu übergeben.

Beispiel der Verwendung einer Zahlenvariable

Um zu veranschaulichen, wie Sie mit Zahlenvariablen arbeiten können, erstellen wir eine Automatisierung, die den Benutzer nach seinem Geburtsjahr fragt und das Alter in einem Fenster anzeigt.

1. Erstellen Sie eine neue Sequence.
2. Erstellen Sie zwei Int32-Variablen, BirthYear und Age. Die erste speichert das Geburtsjahr, die zweite das Alter des Benutzers.
3. Fügen Sie der Sequence eine Eingabedialog (Input Dialog)-Aktivität hinzu.
4. Geben Sie in den Feldern Dialogfeldtitel und Eingabebezeichnung einen geeigneten Titel und eine geeignete Bezeichnung ein.
5. Fügen Sie im Feld Eingegebener Wert die Variable BirthYear hinzu.
6. Fügen Sie eine Zuweisen (Assign)-Aktivität unter der Eingabedialog (Input Dialog)-Aktivität ein.
7. Fügen Sie die Variable Age im Panel Eigenschaften (Properties) im Feld An (To) hinzu.
8. Geben Sie 2022 – BirthYear im Feld Wert ein. Dadurch wird der Wert der Subtraktion (2022 minus Geburtsjahr des Benutzers) der Variablen Age zugewiesen.
9. Fügen Sie eine Nachrichtenbox (Message box)-Aktivität unter die Aktivität Zuweisen (Assign) hinzu.
10. Geben Sie in das Feld Text (Text) im Panel Eigenschaften (Properties) den Text „Herzlichen Glückwunsch! Sie sind " + Age.ToString + ".“ ein.
    Hinweis: Die Methode .ToString konvertiert den in der Variable Age gespeicherten Integer-Wert in einen String und zeigt ihn als solchen an.

Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.

11. Drücken Sie F5. Die Automatisierung wird ausgeführt. Beachten Sie, dass das Nachrichtenbox (Message box) wie erwartet Ihr Alter anzeigt.

Beispiel herunterladen

Array-Variablen

Die Array-Variable ist ein Variablentyp, mit dem Sie mehrere Werte desselben Typs speichern können.

UiPath Studio unterstützt so viele Typen von Arrays wie Typen von Variablen. Dies bedeutet, dass Sie ein Array aus Zahlen, aus Strings, aus booleschen Werten usw. erstellen können.

Beispiel der Verwendung von Array-Variablen

Um zu veranschaulichen, wie Sie mit Array-Variablen arbeiten können, erstellen wir eine Automatisierung, die den Benutzer nach seinem Vor- und Nachnamen und dem Alter fragt, die Informationen in einem Array speichert und anschließend in eine .txt-Datei schreibt.

1. Erstellen Sie eine neue Sequence.
2. Erstellen Sie drei String-Variablen, FirstName, LastName und Age, in welchen die Informationen, die vom Benutzer erfasst wurden, gespeichert werden.
3. Erstellen Sie ein Array mit String-Variablen mit dem Namen NameAge.
   
   

   

   
   
4. Fügen Sie eine Eingabedialog (Input Dialog)-Aktivität in das Panel Designer (Designer) ein.
5. Füllen Sie die Felder Dialogfeldtitel und Eingabebezeichnung aus, um nach dem Vornamen des Benutzers zu fragen.
6. Geben Sie in das Feld Eingegebener Wert die Variable FirstName ein. Diese Variable speichert den Vornamen des Benutzers.
7. Fügen Sie eine weitere Eingabedialog (Input Dialog)-Aktivität unter die vorherige hinzu.
8. Füllen Sie die Felder Dialogfeldtitel und Eingabebezeichnung aus, um nach dem Nachnamen des Benutzers zu fragen.
9. Geben Sie in das Feld Eingegebener Wert die Variable LastName ein. Diese Variable speichert den Nachnamen des Benutzers.
10. Fügen Sie eine weitere Eingabedialog (Input Dialog)-Aktivität unter die vorherige hinzu.
11. Füllen Sie die Felder Dialogfeldtitel und Eingabebezeichnung aus, um nach dem Alter des Benutzers zu fragen.
12. Geben Sie in das Feld Eingegebener Wert die Variable Age ein. Diese Variable speichert das Alter des Benutzers.
    Hinweis: Wir verwenden eine String-Variable und keine Integer, um das Alter zu speichern, sodass wir es später nicht mehr konvertieren müssen, wenn wir es der String-Array-Variablen hinzufügen.
13. Fügen Sie eine Zuweisen (Assign) Aktivität unter dem letzten Eingabedialog (Input Dialog) hinzu.
14. Geben Sie im Panel Eigenschaften (Properties) im Feld An (To) die Variable NameAge ein.
15. Geben Sie {FirstName,LastName,Age} in das Feld Wert (Value) ein. Diese Zuweisen (Assign)-Aktivität ermöglicht es Ihnen, alle Werte aus den initialen String-Variablen in der Variable NameAge zu speichern.
16. Fügen Sie eine Textdatei schreiben (Write Text File)-Aktivität unter die Aktivität Zuweisen (Assign) hinzu.
17. Geben Sie im Panel Eigenschaften im Feld FileName den Pfad der Datei, in die Sie schreiben möchten, in Anführungszeichen ein, z. B. "%HOMEPATH%\Desktop\array_variable.txt".
    Hinweis: Wenn die Datei am angegebenen Pfad nicht existiert, wird sie erstellt.
18. Geben Sie NameAge(0) + " " + NameAge(1) + " " +NameAge(2) + " " in das Feld Text (Text) ein.
    Hinweis: Durch Hinzufügen der Indexnummer der Array-Elemente können Sie auf deren Werte zugreifen und sie (in diesem Beispiel) in eine Textdatei schreiben.

    Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.

    
    

    

    
    
19. Drücken Sie Strg + F5, um das Projekt auszuführen.
20. Navigieren Sie zur Datei, die in in Schritt 17 bereitgestellt wurde, und doppelklicken Sie darauf. Ein Editor (Notepad)-Fenster wird angezeigt, mit der Information, die Sie in Schritt 20 hinzugefügt haben.
    
    

    

    
    

Beispiel herunterladen

Datums- und Zeitvariablen

Die Datums- und Zeitvariable ist ein Variablentyp, mit dem Sie Informationen über ein beliebiges Datum und eine beliebige Uhrzeit speichern können. Diese Art von Variable befindet sich im Fenster .NET-Typ suchen und auswählen unter dem System-Namespace System.DateTime. Weitere Informationen finden Sie unter Suchen nach .Net-Variablentypen.

Sie können beispielsweise verwendet werden, um Daten an Rechnungen oder andere Dokumente anzuhängen, mit denen Sie möglicherweise arbeiten, und die zeitabhängig sind.

Beispiel der Verwendung von Datums- und Zeitvariablen

Um zu veranschaulichen, wie Sie mit einer Datums- und Uhrzeitvariablen arbeiten können, erstellen wir eine Automatisierung, die das aktuelle Datum und die aktuelle Uhrzeit ermittelt, eine bestimmte Zeit subtrahiert und das Ergebnis in ein Microsoft Excel-Arbeitsblatt schreibt.

1. Erstellen Sie eine neue Sequence.
2. Erstellen Sie zwei DataTime-Variablen, Today und LastTime.
3. Erstellen Sie eine TimeSpan-Variable mit dem Namen Span, und geben Sie 1.02:10:04 im Feld Standard ein.
   Hinweis: Der der VariableSpan zugewiesene Standardwert verwendet das „Tag.HH:MM:SS“- Format.
4. Fügen Sie eine Zuweisen (Assign)-Aktivität im Panel Designer (Designer) hinzu.
5. Fügen Sie die Variable Today im Panel Eigenschaften (Properties) im Feld An (To) hinzu.
6. Geben Sie Now im Feld Wert ein. So erhalten Sie das Datum und die Uhrzeit der Projektausführung in den Formaten dd/MM/yyyy und hh:mm:ss
7. Fügen Sie eine weitere Zuweisen (Assign)-Aktivität unter der vorherigen hinzu.
8. Fügen Sie die Variable LastTime im Panel Eigenschaften (Properties) im Feld An (To) hinzu.
9. Geben Sie Today.Subtract(Span) im Feld Wert ein. Dadurch wird der Standardwert der Span-Variable vom aktuellen Datum abgezogen, das in der Today-Variable gespeichert ist.
10. Fügen Sie eine Excel Process Scope-Aktivität unter der letzten Assign-Aktivität hinzu. Diese Aktivität öffnet Excel-Prozesse oder verwendet sie wieder, lädt die Excel-Projekteinstellungen und wendet sie auf die zugehörige Excel-Datei an.
11. Fügen Sie eine Use Excel File-Aktivität in die Excel Process Scope-Aktivität ein.
    Hinweis: Verwenden Sie die Funktion Pakete verwalten (Manage Packages), um die Excel-Aktivitäten herunterzuladen, falls Sie diese noch nicht installiert haben.
12. Geben Sie im Feld Arbeitsmappenpfad den Pfad der Excel-Datei, in die Sie schreiben möchten, in Anführungszeichen ein. In unserem Fall "%HOMEPATH%\Desktop\urgent_invoice.xlsx".
    Hinweis: Wenn die Datei am angegebenen Pfad nicht existiert, wird sie erstellt.
13. Fügen Sie eine Write Cell-Aktivität in die Use Excel File-Aktivität ein.
14. Geben Sie im Feld Was geschrieben werden soll LastTime.ToString ein. Dadurch wird der Wert der Variablen LastTime in einen String umgewandelt und in die zuvor angegebenen Koordinaten geschrieben.
15. Wählen Sie auf der rechten Seite des Felds Was geschrieben werden soll die Option Plus > Excel > In Excel angeben aus.
16. Geben Sie in der Excel-Datei die Zelle an, in die Sie schreiben möchten (in unserem Fall „E3“). Klicken Sie auf Bestätigen, nachdem Sie die Zelle angegeben haben.

    Das fertige Projekt sollte wie auf dem folgenden Screenshot aussehen:

    
    

    

    
    
17. Drücken Sie F5. Die Automatisierung wird ausgeführt.
18. Navigieren Sie zu Ihrer Excel-Datei und doppelklicken Sie auf die Zelle, in der Sie das Datum hinzugefügt haben. Beachten Sie, dass die Zeit- und Datumsinformationen in der Zelle angezeigt werden, auf die Sie zeigen.
    
    

    

    
    

Beispiel herunterladen

Datentabellenvariablen

DataTable-Variablen repräsentieren einen Typ von Variablen, der große Teile von Informationen speichern und als Datenbank oder einfaches Arbeitsblatt mit Zeilen und Spalten funktionieren kann. Sie befinden sich im Fenster .Net-Typ suchen und auswählen (Browse and Select a .Net Type) unter dem System.Data Namespace (System.Data.DataTable). Weitere Informationen finden Sie unter Suchen nach .Net-Variablentypen.

Diese Variablen können nützlich sein, um bestimmte Daten von einer Datenbank in eine andere zu migrieren, Informationen von einer Website zu extrahieren und lokal in einem Arbeitsblatt zu speichern und vieles mehr.

Beispiel der Verwendung von DataTable-Variablen

Um zu veranschaulichen, wie Sie DataTable-Variablen verwenden können, werden wir eine Automatisierung erstellen, die nur zwei von mehreren Spalten eines Excel-Arbeitsblatts liest und diese in ein anderes Arbeitsblatt, das bereist andere Informationen enthält, überträgt.

Die Ausgangsdatei ist eine Datenbank mit Personen, Transaktionen, Daten und Produkten. In diesem Beispiel werden wir ihre Namen und Bestelldaten extrahieren und sie einem Excel-Arbeitsblatt anfügen, das bereits ähnliche Informationen enthält.

1. Erstellen Sie eine neue Sequence.
2. Fügen Sie eine Excel Process Scope-Aktivität hinzu. Diese Aktivität öffnet Excel-Prozesse oder verwendet sie wieder, lädt die Excel-Projekteinstellungen und wendet sie auf die zugehörige Excel-Datei an.
3. Fügen Sie eine Use Excel File-Aktivität zur Sequence hinzu. Diese Aktivität ist für die meisten Excel-bezogenen Aktivitäten erforderlich.
   Hinweis: Wenn in Ihrer Version von UiPath keine Excel-Aktivitäten installiert sind, verwenden Sie die Funktion Manage Packages, um sie zu erhalten.
4. Erstellen Sie zwei DataTable-Variablen, dt_NamesList und dt_DateInfo. Diese werden verwendet, um Informationen aus dem ursprünglichen Excel-Arbeitsblatt zu speichern.
5. Geben Sie den Pfad der ursprünglich zu verwendenden Excel-Datei in Anführungszeichen in das Panel Eigenschaften (Properties) im Feld DateiPfad (WorkbookPath) ein.
6. Fügen Sie zwei Read Range-Aktivitäten hinzu und setzen Sie sie untereinander in die Use Excel File-Aktivität. Diese werden verwendet, um Informationen aus der ursprünglichen Kalkulationstabelle abzurufen.
7. Wählen Sie die erste Read Range-Aktivität aus. Wählen Sie auf der rechten Seite des Felds Bereich die Option Plus > Excel > In Excel angeben aus.
8. Geben Sie für UiPath Studio in der Excel-Datei die Koordinaten an, von denen die Informationen extrahiert werden sollen (in unserem Fall „G7:G37“). Klicken Sie auf Bestätigen, nachdem Sie den Bereich ausgewählt haben.
9. Geben Sie im Feld Speichern unter den Namen der ersten Datentabelle-Variablen ein, dt_NamesList. Diese Variable speichert alle Informationen, die zwischen den Zeilen G7 und G37 verfügbar sind.
10. (Optional) Ändern Sie den Wert im Feld Anzeigename zu „Namen lesen“, um diese Aktivität einfach von der zweiten unterscheiden zu können.
11. Wählen Sie die zweite Read Range-Aktivität aus. Wählen Sie auf der rechten Seite des Felds Bereich die Option Plus > Excel > In Excel angeben aus.
12. Geben Sie in der Excel-Datei die Koordinaten mit dem Bestelldatum an, das wir extrahieren möchten (in unserem Fall „C7:C37“). Klicken Sie auf Bestätigen, nachdem Sie den Bereich ausgewählt haben.
13. Geben Sie im Feld Speichern unter die Variable dt_DateInfo an. Diese Variable enthält alle erforderlichen Datumsinformationen.
14. Fügen Sie eine zweite Use Excel File-Aktivität zur Sequence hinzu.
15. Geben Sie den Pfad der Excel-Datei, die verwendet wird, um alle in den vorherigen Schritten gesammelten Informationen zu speichern, im Panel Eigenschaften (Properties) in das Feld DateiPfad (WorkbookPath) ein.
16. Fügen Sie eine Write DataTable to Excel-Aktivität unter der zweiten Use Excel File im Designer-Panel hinzu. Diese Aktivität wird verwendet, um die gespeicherten Informationen in eine andere Excel-Datei zu schreiben.
    Hinweis: Die Datei, die mit der Aktivität BereichSchreiben (Write Range) verwendet wird, muss geschlossen sein, wenn Sie das Projekt ausführen. Andernfalls wird ein Fehler angezeigt und die Ausführung der Automatisierung gestoppt.
17. Geben Sie die Variable dt_NamesList in das Feld Was geschrieben werden soll ein.
18. Wählen Sie auf der rechten Seite des Felds Ziel die Option Plus > Excel > In Excel angeben aus.
19. Wählen Sie in der zweiten Excel-Datei die Startzelle aus, in die Informationen aus der ursprünglichen Datei eingefügt werden sollen (in unserem Fall „B7“). Klicken Sie auf Bestätigen.
20. Fügen Sie eine weitere Write DataTable to Excel-Aktivität hinzu und setzen Sie sie unter die erste.
21. Geben Sie die Variable dt_DateInfo in das Feld Was geschrieben werden soll ein.
22. Wählen Sie auf der rechten Seite des Felds Ziel die Option Plus > Excel > In Excel angeben aus.
23. Wählen Sie die Startzelle aus (in unserem Fall „A7“). Klicken Sie auf Bestätigen.
    
    

    

    
    
24. Drücken Sie F5. Ihre Automatisierung wird ausgeführt.
25. Doppelklicken Sie auf die finale Excel-Datei. Beachten Sie, dass die kopierten Informationen verfügbar und korrekt aktualisiert worden sind.
    
    

    

    
    

Beispiel herunterladen