Ihre Variablen (benutzerdefiniert)

Nutzer und einige Aktionen erstellen benutzerdefinierte Variablen, um Werte vorübergehend zu speichern. Verwenden Sie diese Art von Variablen, um Werte in eine Aktion einzugeben (Fenstertitel, Anmeldedaten oder Dateipfad) oder um die Ausgabe einer Aktion zu akzeptieren (aus einer Datei gelesene Werte oder eine boolesche Rückgabe).

Wenn Sie automatisierte Aufgaben erstellen, müssen einige Aktionen auf einige Werte verweisen und diese verwenden. Diese Werte können in Variablen gespeichert werden. Variablen können zum Beispiel zum Abrufen von Online-Daten oder für das Übertragen von Daten zwischen Anwendungen eingesetzt werden, z. B. Microsoft Excel. Eine Variable kann einen oder mehrere Werte enthalten. Die Werte, die eine Variable enthalten kann, und die Operationen, die mit der Variable durchgeführt werden können, werden durch ihren Datentyp bestimmt.
Anmerkung:
  • Ein Bot kann nur maximal 3 MB an eine Ausgangsvariable zurückgeben. Darüber hinaus ist die Tabellenstruktur in BotOutputVariable auf 300.000 Zellen begrenzt.

    Wenn Sie mehr als 300.000 Zellen einfügen, wird eine Fehlermeldung angezeigt, die darauf hinweist, dass die debug-Variable zu groß zum Debuggen ist oder dass BotOutputVariable zu groß zum Verarbeiten ist.

    Problemumgehung: Speichern Sie die Bot-Ausgabe auf dem Gerät, z. B. in einer .txt-Datei. Wenn die Ausgabe von mehreren Bot Runnern gemeinsam genutzt werden muss, speichern Sie die Ausgabe auf einem freigegebenen Laufwerk.

  • Die Größe der Bot-Eingabevariablen ist auf 1.900.000 Bytes begrenzt. Wir empfehlen die Verwendung einer .txt-Datei, um große Datenmengen zu speichern.

Variablentypen

Der Datentyp einer Variable ist ein Attribut, das die Art der Daten bestimmt, die der in der Variable gespeicherte Wert haben kann. Zu den Datentypen gehören Speicherklassifikationen wie Ganzzahlen, Zeichenfolgen und Zeichen. Variablen wie Wörterbücher, Datensätze, Listen oder Tabellen können mehrere Datentypen enthalten.

Die meisten Variablentypen haben ein Paket mit einem ähnlichen Namen, das Aktionen enthält, mit denen die in der Variable gespeicherten Werte bearbeitet werden können. Verwenden Sie zum Beispiel die Aktionen im Zeichenfolge Paket, um mit Zeichenfolgenvariablen zu arbeiten. Um mit Zahlenvariablen zu arbeiten, verwenden Sie die Option Aktionen in der Datei Nummer Paket. Informationen zum Umwandeln des Werts eines Variablentyps in einen anderen finden Sie unter Typumwandlung

Sie können zudem identische Werte zwischen Bots wiederverwenden, anstatt für jeden Bot neue Variablen zu erstellen. Einzelheiten finden Sie unter Globale Werte.

Variablennamen

Ein Variablenname darf maximal 50 Unicode-Zeichen enthalten, darunter Zahlen (0–9), lateinische Buchstaben (A–Z, a–z) und Sonderzeichen (- und _). Sie können Doppelbyte-Zeichen, wie chinesische, japanische oder koreanische Zeichen, in einem Variablennamen verwenden. In Variablen unterstützter Unicode-Bereich

Es wird empfohlen, für Variablennamen Binnenversalien zu verwenden und dem Variablennamen ein Präfix voranzustellen, um den Geltungsbereich und den Datentyp anzugeben. Beispiel: iFileEmailAttachment für eine Dateitypvariable, die zur Bereitstellung einer Eingabe verwendet wird.
Anmerkung: Nachfolgend ein empfohlener Standard für die Benennung von Variablen: <type/scope indicator><data type><Variable name>. Es gibt zwar viele Optionen für Namenskonventionen, aber einige Standards müssen übernommen und innerhalb der Organisation einheitlich verwendet werden.

Der <type/scope indicator> ist ein einzelner Wert wie folgt:

  • p = lokale Variable (weder Eingang noch Ausgang)
  • i = Eingangsvariable
  • o = Ausgangsvariable
  • io = Eingangs- und Ausgangsvariable
  • c = Konstante
Im Folgenden finden Sie einige weitere Beispiele für die Benennung von Variablen.
  • iStrAuditLogPath: eine Variable vom Typ Zeichenfolge, die von einer aufrufenden Aufgabe empfangen wird
  • oNumReturnValue : eine Variable vom Typ Zahl, die an eine aufrufende Aufgabe zurückgegeben wird
  • ioStrStatus: eine Zeichenfolge, die von einer aufrufenden Aufgabe empfangen und an diese zurückgegeben wird
  • cStrNull: eine Zeichenfolge, die keinen Wert enthält; z. B. nützlich für Zeichenfolgenvergleiche, um zu prüfen, ob ein Wert vorhanden ist

Weitere Informationen zum Geltungsbereich finden Sie unter TaskBot Paket. Dieser Standard ermöglicht die Suche nach Variablen nach Typ. Beispielsweise gibt oStr Variablen zurück, die für die Ausgabe von Zeichenfolgenwerten verwendet werden.

Variablentypen

Variablentyp und vorgeschlagener Name Beschreibung Anwendungsbeispiele
Beliebig

Any

Speichert die folgenden Datentypen: boolescher Wert, Datentabelle, Datum, Datei/Zeit, Zahl, Datensatz, Zeichenfolge oder Fenster. Verwenden Sie diesen Variablentyp, wenn Sie sich nicht sicher sind, welchen Datentyp eine Aktion ausgeben wird. Beispiel für die Verwendung der Aktion „Ausführen“
Boolescher Wert

Bool

Speichert entweder den Wert „Wahr“ oder „Falsch“.
Anmeldedaten

Cred

Speichert Zeichenfolgenwerte sicher und verhindert, dass die Werte in einem Meldungsfeld angezeigt oder in eine Datei geschrieben werden. Der Wert wird entweder aus dem Credential Vault ausgewählt oder vom Nutzer selbst eingegeben.

Anmeldedaten und Anmeldedaten-Variablen im Bot Editor

Datum/Zeit

Date

Speichert einen Wert, der einen einzelnen Datums- und Zeitwert enthält. Sie können die Werte formatieren, indem Sie ein vordefiniertes Format auswählen oder ein benutzerdefiniertes Format angeben.

Datum/Zeit-Formate

Wörterbuch

Dict

Speichert Daten in Form von Schlüssel-Werte-Paaren. Der Wert kann ein boolescher Wert, eine Zahl oder eine Zeichenfolge sein.

Wörterbuch-Paket

Datei

File

Speichert einen Dateipfad.

Beispiel für die Verwendung einer Dateivariablen

Formular

Form

Speichert den Wert, der in ein interaktives Formularfeld eingegeben wurde.

Interaktive Formulare

Liste

List

Speichert eine Folge von booleschen Werten, Zahlen oder Zeichenfolgenwerten.

Liste Paket

Nummer

Num

Speichert numerische Werte, einschließlich Ganzzahlen und Dezimalzahlen. Sie enthält Werte von -9.223.372.036.854.775.808 bis 9.223.372.036.854.775.807 und bis zu 15 Dezimalstellen.

Sie können dieser Variable einen zufällig generierten Wert zuweisen.

Zufallszahl-Aktion

Sie können die Ziffern nach einer Dezimalstelle entfernen, wenn Sie den Wert in eine Zeichenfolge umwandeln.

Aktion zu Umwandlung einer Zahl in eine Zeichenfolge

Datensatz

Rec

Speichert eine einzelne Zeile mit Werten, die aus einer Tabelle extrahiert wurden. Die Werte können ein boolescher Wert, Datum/Zeit, eine Zahl oder eine Zeichenfolge sein.

Datensatzvariable

Beispiel für die Eingabe von Daten in ein Webformular aus einem Arbeitsblatt
Sitzung

Sess

Speichert den Sitzungsnamen aus den Pakete Excel Basic, Excel Advanced oder Terminalemulation. Übergeben Sie diese Variable von einem übergeordneten an einen untergeordneten Bot unter TaskBot > Ausführen Aktion, damit der untergeordnete Bot die Daten in der im übergeordneten Bot geöffneten Datei verarbeiten kann.
Anmerkung: Wählen Sie bei der Initialisierung dieser Variable im untergeordneten Bot die Option Als Eingabe verwenden.
Beispiel für die gemeinsame Nutzung einer Excel-Sitzung durch Bots
Zeichenfolge

Str

Speichert alphanumerische Zeichen, Sonderzeichen und leere Werte. Kann bis zu 65535 UTF-8-Zeichen enthalten. Eine Zeichenfolgenvariable kann mehrere Textzeilen enthalten. Sie können den Wert in einer Zeichenfolgenvariable mit einer leeren Stringvariable vergleichen.

Beispiel für die Verwendung einer bedingten Anweisung

Tabelle

Table

Speichert mehrere Werte in einer Tabelle mit Zeilen und Spalten. Die Werte können ein boolescher Wert, Datum/Zeit, eine Zahl oder eine Zeichenfolge sein. Weisen Sie Werte einer Tabellenvariable durch Extraktion von Werten aus einer CSV/TXT-Datei, einer Excel-Datei oder einem Webformular zu.
Fenster

Win

Speichert einen Fenstertitel und eine URL.

Wenn Sie eine Variable vom Fenstertyp erstellen, beachten Sie, dass die Auswahl von Browser als Standardwert nur Registerkarten von Google Chrome unterstützt, während die Auswahl von Anwendung als Standardwert ein beliebiges Anwendungsfenster unterstützt.

Einige Aktionen, z. B. die Aktion zum Erfassen, erstellen eine Fenstervariable, um den angegebenen Fenstertitel und die URL zu speichern.

Beispiel für die Extraktion von Daten aus einer Webtabelle

Wie sich Fenstervariablen verhalten

Wenn Sie den Recorder verwenden, um ein bestimmtes Fenster zu automatisieren, z. B. Fenster 1, eine Klick-Aktion auf das Fenster ausführen und den Bot starten, sucht der Bot zum ersten Mal dieses bestimmte Fenster, weist ihm ein Fensterhandle zur Identifizierung zu und speichert es im Cache. Wenn Sie eine zweite Klick-Aktion auf dasselbe Fenster 1 ausführen, prüft der Bot, ob das Fenster 1 verfügbar ist. Wenn das Fenster 1 verfügbar ist, dann muss der Bot nicht mehr nach dem spezifischen Fenster suchen, da das Fenster bereits im Cache gespeichert ist und es automatisch von dort abgerufen wird. Dies verbessert die Leistung des Bots und spart Zeit, da der Bot nicht jedes Mal das Fenster suchen muss, wenn es bereits vorhanden ist.

Angenommen, Sie führen nun eine dritte Klick-Aktion auf dasselbe Fenster 1 aus, das eine andere Seite öffnet, wodurch sich der Fenstertitel nun geändert hat. Wenn Sie zum Beispiel eine Yahoo India-Webseite öffnen und eine Klick-Aktion auf die Option News auf der Webseite ausführen, navigiert die Aktion Sie zu einer anderen Seite, wodurch sich der Fenstertitel ändert.

Wenn Sie also in diesem Fall den Bot ausführen, ruft der Bot immer noch dasselbe Fenster ab, das im Cache gespeichert ist, und führt die Aktion darauf aus, weil das Fenster immer noch dasselbe ist, aber nur der Titel geändert wurde. Dieses Verhalten sorgt für eine bessere Benutzererfahrung, und Sie können bei der Automatisierung von Webseiten die Erstellung mehrerer Fenstervariablen für jedes Fenster vermeiden, dessen Titel sich ändert.

Variable löschen

Sie können vom Nutzer erstellte Variablen auf eine der folgenden Arten löschen:
  • Eine Variable löschen: Klicken Sie in der Palette Variablen auf die vertikale Ellipse rechts neben dem Variablennamen und dann auf Variable löschen.
  • Nicht verwendete Variablen löschen: Klicken Sie in der Palette Variablen auf Nicht verwendete Variablen löschen, wählen Sie die zu löschenden Variablen aus und klicken Sie auf Löschen.