Ihre Variablen (benutzerdefiniert)
- Zuletzt aktualisiert2023/09/11
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).
- 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 TypumwandlungSie 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
iFileEmailAttachment
für eine Dateitypvariable, die zur Bereitstellung einer Eingabe verwendet wird.<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
-
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. | |
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. |
Wörterbuch Dict |
Speichert Daten in Form von Schlüssel-Werte-Paaren. Der Wert kann ein boolescher Wert, eine Zahl oder eine Zeichenfolge sein. | |
Datei File |
Speichert einen Dateipfad. | |
Formular Form |
Speichert den Wert, der in ein interaktives Formularfeld eingegeben wurde. | |
Liste List |
Speichert eine Folge von booleschen Werten, Zahlen oder Zeichenfolgenwerten. | |
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. | 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
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. |
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. |
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
- 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.