Proprietäre UiPath-Variablen

GenericValue-Variablen

Die GenericValue-Variable ist ein Studio-spezifischer Variablentyp, in dem beliebige Daten, einschließlich Text, Zahlen, Datumsangaben und Arrays gespeichert werden können.

GenericValue-Variablen werden automatisch in andere Typen konvertiert, um bestimmte Aktionen auszuführen. Es ist jedoch wichtig, diese Variablentypen sorgfältig zu verwenden, da ihre Konvertierung möglicherweise nicht immer für Ihr Projekt geeignet ist.

UiPath Studio verfügt über einen automatischen Konvertierungsmechanismus für GenericValue-Variablen, der Sie durch sorgfältiges Definieren ihrer Ausdrücke zum gewünschten Ergebnis führen kann. Berücksichtigen Sie, dass das erste Element in Ihrem Ausdruck als Richtlinie für die von Studio durchgeführte Operation verwendet wird. Wenn Sie beispielsweise versuchen, zwei GenericValue-Variablen hinzuzufügen, ist das Ergebnis, wenn die erste im Ausdruck als String definiert ist, die Verkettung der beiden. Wenn sie als Integer definiert ist, ist das Ergebnis ihre Summe.

Unterstützte .NET-Methoden

Name/Syntax	Beschreibung
CompareTo Funktion GenericValue.CompareTo(anderer als GenericValue) als Integer Funktion GenericValue.CompareTo(obj als Object) als Integer	Klicken Sie hier für Details.
Enthält Funktion GenericValue.Contains(anderer als String) als Boolean	Klicken Sie hier für Details. Wird verwendet, um zu überprüfen, ob eine String-Variable einen bestimmten Teilstring enthält oder nicht. Wenn Sie beispielsweise prüfen möchten, ob ein Satz ein bestimmtes Wort enthält, sollte der Ausdruck [SentenceVariable].Contains("term") lauten, wobei [SentenceVariable] die GenericValue-Variable ist, die den Satz enthält, und "term" das Wort, nach dem gesucht werden soll. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Equals Funktion GenericValue.Equals(anderer als GenericValue) als Boolean Funktion GenericValue.Equals(obj als Object) als Boolean	Klicken Sie hier für Details.
GetHashCode Funktion GenericValue.GetHashCode() als Integer	Klicken Sie hier für Details.
GetType Funktion Object.GetType() als Type	Klicken Sie hier für Details.
GetTypeCode Funktion GenericValue.GetTypeCode() als TypeCode	Klicken Sie hier für Details.
IndexOf Funktion GenericValue.IndexOf(Wert als String) als Integer Funktion GenericValue.IndexOf(value As String, ComparisonType As StringComparson) As Integer Funktion GenericValue.IndexOf(value As String, startIndex As Integer) As Integer Funktion GenericValue.IndexOf(value As String, startIndex As Integer, invoiceType) As Integer	Klicken Sie hier für Details. Wird verwendet, um den Index einer Teilzeichenfolge zurückzugeben, die in einer Zeichenfolgenvariablen enthalten ist. Wenn Sie beispielsweise den Index des Worts „suchen“ innerhalb des Satzes „In diesem Satz 'suchen' finden“ finden möchten, sollte der Ausdruck [SentenceVariable].IndexOf("locate") sein, wobei [SentenceVariable] die GenericValue-Variable ist, die den Satz enthält, und "locate" der Begriff ist, nach dem gesucht werden soll. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Länge Function GenericValue.Lenght() As Integer	Klicken Sie hier für Details. Wird verwendet, um die Anzahl der Zeichen in einer String-Variable zurückzugeben. Wenn Sie beispielsweise herausfinden möchten, wie viele Buchstaben ein Wort hat, sollte der Ausdruck [WordVariable].Length lauten, wobei [WordVariable] die GenericValue-Variable ist, die das Wort enthält. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Ersetzen (Replace) Funktion GenericValue.Replace(alterWert als String, neuer Wert als String) als String	Klicken Sie hier für Details. Wird verwendet, um Daten in einer String-Variable zu ersetzen. Wenn Sie beispielsweise einen lokalen Dateipfad C:\ExampleFolder\Main.xaml in den entsprechenden Serverdateipfad C:/ExampleFolder/Main.xaml ändern möchten, sollte der Ausdruck [PathVariable].Replace("\","/") lauten, wobei [PathVariable] die GenericValue-Variable mit dem Dateipfad ist, "\" das zu ersetzende Zeichen und "/" das stattdessen zu verwendende Zeichen. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Teilen Funktion GenericValue.Split(ParamArray-Trennzeichen als Char()) als String() Function GenericValue.Split(ParamArray separator As String()) As String() Funktion GenericValue.Split(Trennzeichen als Char(), Optionen als StringSplitOptions) als String() Function GenericValue.Split(separator As String(), options As StringSplitOptions) As String()	Klicken Sie hier für Details. Wird verwendet, um einzelne Komponenten aus einer String-Variable zurückzugeben. Wenn Sie beispielsweise das Jahr aus einem Datumsformat MM.TT.JJJJ extrahieren möchten, sollte der Ausdruck [DateVariable].Split(".".ToCharArray)(2) lauten, wobei [DateVariable] die GenericValue-Variable ist, die das Datum enthält, "." das Zeichen, das als Trennzeichen verwendet wird, .ToCharArray eine Methode, die einen Array mit den durch das Trennzeichen begrenzten Elementen erstellt und (2) der Index des Elements, das zurückgegeben werden soll, in unserem Fall das Jahr. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Substring Funktion GenericValue.Substring(startIndex als Integer) als String Funktion GenericValue.Substring(startIndex als Integer, Länge als Integer) als String	Klicken Sie hier für Details. Wird verwendet, um eine Teilzeichenfolge zurückzugeben, die in einer Zeichenfolgenvariablen enthalten ist. Wenn Sie z. B. ein Wort aus dem Satz „Es sind 100 Maschinen verfügbar“ extrahieren möchten, sollte der Ausdruck [SentenceVariable].Substring(10,3) sein, wobei [SentenceVariable] die GenericValue-Variable ist, die den Satz enthält, 10 der Index des ersten zurückzugebenden Zeichens und 3 die Länge der Teilzeichenfolge ab dem ersten Zeichen ist. In diesem Beispiel wäre die resultierende Teilzeichenfolge „100“. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
ToBoolean Funktion GenericValue.ToBoolean(Anbieter als IFormatProvider) als Boolean	Klicken Sie hier für Details.
ToByte Function GenericValue.ToByte(provider As IFormatProvider) As Byte	Klicken Sie hier für Details.
ToChar Function GenericValue.ToChar(provider As IFormatProvider) As Char	Klicken Sie hier für Details.
ToDecimal Function GenericValue.ToDecimal(provider As IFormatProvider) As Decimal Funktion GenericValue.ToDecimal(Format als NumberStyles) als Decimal	Klicken Sie hier für Details.
ToDouble Function GenericValue.ToDouble(provider As IFormatProvider) As Double Funktion GenericValue.ToDouble(Format als NumberStyles) als Double	Klicken Sie hier für Details.
ToInt Funktion GenericValue.ToInt(Kultur als IFormatProvider) als Integer? Function GenericValue.ToInt() As Integer?	Wird verwendet, um einen angegebenen Wert in einen Integer-Wert zu konvertieren, der einen Nullwert zulässt. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToInt16 Function GenericValue.ToInt16(provider As IFormatProvider) As Short	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToInt32 Function GenericValue.ToInt32(provider As IFormatProvider) As Integer	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToInt64 Function GenericValue.ToInt64(provider As IFormatProvider) As Long	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToLower Function GenericValue.ToLower() As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
ToLowerInvariant Function GenericValue.ToLowerInvariant() As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
ToSByte Funktion GenericValue.ToSByte(provider As IFormatProvider) As SByte	Klicken Sie hier für Details.
ToSingle Function GenericValue.ToSingle(provider As IFormatProvider) As Single	Klicken Sie hier für Details.
In Zeichenfolge umwandeln Function GenericValue.ToString(formatProvider As IFormatProvider) As String Funktion GenericValue.ToString(format As String, formatProvider As IFormatProvider) As String Funktion GenericValue.ToString() As String	Klicken Sie hier für Details.
ToType Funktion GenericValue.ToType(Konversionstyp als Type, Anbieter als IFormatProvider) als Object	Klicken Sie hier für Details.
ToUInt16 Funktion GenericValue.ToUInt16(provider As IFormatProvider) As UShort	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToUInt32 Funktion GenericValue.ToUInt32(provider As IFormatProvider) As UInteger	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToUInt64 Funktion GenericValue.ToUInt64(provider As IFormatProvider) As Ulong	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Boolean verwenden, werden die Werte „True“ und „False“ in 1 bzw. 0 konvertiert.
ToUpper Function GenericValue.ToUpper() As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
ToUpperInvariant Function GenericValue.ToUpperInvariant() As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
Trim Funktion GenericValue.Trim(ParamArray trimChars als Char()) als String Function GenericValue.Trim() As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
TrimEnd Funktion GenericValue.TrimEnd(ParamArray trimChars As Char()) As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.
TrimStart Function GenericValue.TrimStart(ParamArray trimChars As Char()) As String	Klicken Sie hier für Details. Hinweis: Wenn Sie diese Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean verwenden, werden die Daten automatisch in einen String konvertiert, der entsprechend behandelt wird.

Wenn Sie Strg + K, Strg + M oder Strg + Umschalt + M direkt im Aktivitätstext Formatwert verwenden, ist die erstellte Variable oder das Argument vom Typ GenericValue. Bei anderen Aktivitäten entspricht der erstellte Typ dem erforderlichen Typ der Aktivität.

Beispiel der Verwendung einer GenericValue-Variable

Um zu veranschaulichen, wie eine GenericValue-Variable funktioniert, erstellen wir eine Automatisierung, die verschiedene Vorgänge ausführt, deren Ergebnisse davon abhängen, wie wir ihre Ausdrücke definieren. Wir erstellen zwei GenericValue-Variablen mit unterschiedlichen Datentypen und zeigen die Ergebnisse im Panel Ausgabe (Output) an.

1. Erstellen Sie ein neues leeres Projekt.
2. Erstellen Sie drei GenericValue-Variablen: Int, Str und Result.
3. Geben Sie den Wert 12 für die Variable Int in der Spalte Standard (Default) ein und für die Variable Str den Wert "34". Die erste Variable wird als Integer, die zweite als String interpretiert.
   
   

   

   
   
4. Fügen Sie eine Zuweisen (Assign)-Aktivität in das Panel Designer (Designer) ein und verbinden Sie sie mit dem Knoten Start.
5. Geben Sie die Variable Result im Panel Eigenschaften (Properties) in das Feld An (To) ein.
6. Geben Sie Int + Str in das Feld Wert (Value) ein.
7. Fügen Sie eine Zeile schreiben (Write Line)-Aktivität hinzu und verbinden Sie diese mit der Aktivität Zuweisen (Assign).
8. Doppelklicken Sie auf die Aktivitätskarte und geben Sie im Text-Feld die Variable Result ein.

   Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.

   
   

   

   
   

9. Drücken Sie F5, um Ihre Automatisierung auszuführen. Beachten Sie, dass im Panel Ausgabe (Output) die Summe der beiden Zahlen angezeigt wird.

   
   

   

   
   
10. Gehen Sie zur zuvor hinzugefügten Zuweisen (Assign)-Aktivität zurück und ändern Sie das Feld Wert (Value) in Str + Int, um die Reihenfolge der Variablen umzukehren. Das finale Projekt sollte wie auf dem folgenden Screenshot aussehen.
    
    

    

    
    

11. Drücken Sie F5, um Ihre Automatisierung auszuführen. Beachten Sie, dass im Panel Ausgabe (Output) die Verkettung der beiden Zahlen angezeigt wird.

    
    

    

    
    

Das bedeutet, dass UiPath Studio das erste in Ihrem Ausdruck definierte Element als Richtlinie für die auszuführende Operation verwendet. Wenn das erste Element in Ihrem Ausdruck eine Integer- oder GenericValue-Variable ist, die als Integer eingegeben ist, addiert UiPath Studio die Elemente.

Wenn das erste Element in Ihrem Ausdruck ein String oder eine GenericValue-Variable ist, die als String eingegeben ist, verkettet UiPath Studio die Elemente.

Beispiel herunterladen

Warteschlangenobjekt-Variablen

Wir empfehlen Ihnen, die Seite Über Warteschlangen und Transaktionen (About Queues and Transactions) zu lesen, die eine Übersicht der Warteschlangen und Transaktionen enthält, bevor Sie mit der Variablen Warteschlangenobjekt fortfahren.

Bevor Sie sich tiefer in die Details des Themas einarbeiten, sollten Sie den Unterschied zwischen Warteschlangenobjekten (Objekten, die in Orchestrator in einer Warteschlange gespeichert sind) und Warteschlangenobjekt-Variablen (Variablen, mit denen in Studio Warteschlangenobjekte bearbeitet werden) verstanden haben. Wir bezeichnen sie genau folgendermaßen: „Warteschlangenobjekt-Variablen“ und „Warteschlangenobjekte“.

Generell speichert die Warteschlangenobjekt-Variable, wie schon der Name besagt, ein Objekt, das aus einem Objekt-Container, einer Warteschlange, extrahiert wurde. Diese Extraktion wird generell zu dem Zweck durchgeführt, diese Warteschlangenobjekte in verschiedenen Szenarien weiterzuverwenden. Sagen wir, Sie repräsentieren eine Bank und haben Einlagen von 50 Kunden. Sie möchten die Daten jedes Kunden bearbeiten, der zuvor einen auf uns bezogenen Scheck von weniger als $ 5000 mit einer Fremdfinanzanwendung eingezahlt hat. Dazu können Sie einen Workflow erstellen, bei dem in der Warteschlangenobjekt-Variablen jeweils die Daten eines Kunden gespeichert sind. Jeder von der Warteschlangenobjekt-Variablen gelesene Eintrag wird in einem Warteschlangenobjekt gespeichert und in Orchestrator zur angegebenen Warteschlange hinzugefügt. Als Ergebnis dieses Prozesses entsteht eine Warteschlange, welche die Kundendaten im entsprechenden Warteschlangenobjekt enthält.

Zur weiteren Bearbeitung der Daten, welche die Bedingung erfüllen, müssen Sie einen weiteren Workflow erstellen, welcher aus der zuvor erstellten Warteschlange diejenigen Objekte extrahiert, die einen entsprechenden auf uns bezogenen Scheckwert von unter $ 5000 aufweisen. Am Ende dieses Kapitels können Sie lesen, wie man ein derartiges Projekt erstellt.

Unterstützte .NET-Methoden

Name/Syntax	Beschreibung
Equals Funktion Object.Equals(obj als Object) als Boolean	Klicken Sie hier für Details.
GetHashCode Function Object.GetHashCode() als Integer	Klicken Sie hier für Details.
GetType Funktion Object.GetType() als Type	Klicken Sie hier für Details.
In Zeichenfolge umwandeln Funktion Object.ToString() als String	Klicken Sie hier für Details.

Unterstützte Eigenschaften

Name/Syntax	Beschreibung
Zugewiesen zu (AssignedTo) Eigenschaft QueueItem.AssignedTo als String	Klicken Sie hier für Details.
Fälligkeitsdatum (DueDate) Eigenschaft QueueItem.DueDate als Date?	Das aktuellste Datum mit Uhrzeit, an dem das Objekt verarbeitet werden soll. Ist das Objekt leer, kann es jederzeit bearbeitet werden.
Verschiebungsdatum (DeferDate) Eigenschaft QueueItem.DueDate als Date?	Das aktuellste Datum mit Uhrzeit, an dem das Objekt zur Verarbeitung zur Verfügung steht. Ist das Objekt leer, kann es baldmöglichst bearbeitet werden.
ID Eigenschaft QueueItem.Id als Long?	Klicken Sie hier für Details.
Objektschlüssel (ItemKey) Eigenschaft QueueItem.ItemKey als Guid	Der einmalige Identifier des Objekts. Zum Beispiel 1bf829e1-cd6b-4275-a364-19db3cfe09c7.
Priorität Eigenschaft QueueItem.Priority als QueueItemPriority	Die Priorität des Warteschlangenobjekts, die bei Studio im Feld Priorität (Priority) im Abschnitt Eigenschaften (Properties) festgelegt wurde.
Verarbeitungsausnahme (ProcessingException) Eigenschaft QueueItem.ProcessingException als ProcessingException	Die Verarbeitungsausnahme eines fehlgeschlagenen Objekts.
Fortschritt Eigenschaft QueueItem.Progress als String	Benutzerdefinierte Fortschrittsinformationen über ein Warteschlangenobjekt mit dem Status (In Bearbeitung (InProgress).
ID Warteschlangendefinition (QueueDefinitionId) Eigenschaft QueueItem.QueueDefinitionId als Long	Der einmalige Identifier der Warteschlange, unter dem ein Warteschlangenobjekt/eine Transaktion erstellt wurde.
Warteschlangenname (QueueName) Eigenschaft QueueItem.QueueName als String	Der Name der Warteschlange, welche die bearbeiteten Objekte enthält.
Referenz (Reference) Eigenschaft QueueItem.Reference As String	Ein benutzerdefinierter Wert zur einfacheren Erkennung des Warteschlangenobjekts.
Anzahl Wiederholungen (RetryNo) Eigenschaft QueueItem.RetryNo als Integer	Wie oft das Objekt wiederholt wurde.
Status überprüfen (Review Status) Eigenschaft QueueItem.Reference als String	Der Überprüfungsstatus des von Orchestrator abgerufenen Warteschlangenobjekts.
RowVersion Eigenschaft QueueItem.RowVersion als Byte()	Ein internes Feld, das für den Versionsstempel verwendet wird. Es wird immer dann aktualisiert, wenn eine Eigenschaft der aktuellen Transaktion geändert wird.
Spezieller Inhalt (SpecificContent) Eigenschaft QueueItem.SpecificContent als Dictionary(Of String, Object)	Eine Gruppe von Schlüsselwertepaaren mit benutzerdefinierten zur aktuellen Transaktion gehörenden Daten, wie in der Aktivität Warteschlangenobjekt hinzufügen (Add Queue Item) konfiguriert.
Start Transaktionszeit (StartTransactionTime) Eigenschaft QueueItem.StartTransactionTime als Date?	Uhrzeit und Datum des Beginns der Transaktionsverarbeitung.
Status Eigenschaft QueueItem.Status als QueueItemStatus	Der Status des von Orchestrator abgerufenen Warteschlangenobjekts.

Beispiel der Verwendung einer Warteschlangenobjekt-Variablen

Aufgrund der Eigenart dieses Beispiels haben wir diesen Abschnitt in zwei Teile aufgespalten, die jeweils einen der beiden Haupt-Workflows darstellen, die beim Arbeiten mit Warteschlangen und Warteschlangenobjekten verwendet werden müssen.

• Hochladen von Objekten in eine Warteschlange
• Bearbeiten der Transaktionen aus einer Warteschlange

Hinzufügen von Objekten zu einer Warteschlange

Zur Veranschaulichung, wie man Objekte in eine Warteschlange einfügt, möchten wir einen Automationsablauf erstellen, der in einer Datei .xlsx enthaltene Einträge verarbeitet. Sagen wir, Sie repräsentieren eine Bank und haben Einlagen von 50 Kunden. Sie möchten die Daten jedes Kunden bearbeiten, der zuvor einen auf uns bezogenen Scheck von weniger als $ 5000 mit einer Fremdfinanzanwendung eingezahlt hat. Der Bericht enthält den Namen des Kunden, den Wert des auf uns bezogenen Schecks und zwei weitere Werte, etwa Einzahlung und Nicht auf uns bezogener Scheck. Wir erstellen einen Workflow, bei dem in der Warteschlangenobjekt-Variablen jeweils die Daten jedes Kunden gespeichert sind. Jeder von der Variablen Warteschlangenobjekt gelesene Eintrag wird in einem Warteschlangenobjekt gespeichert und in Orchestrator zur angegebenen Warteschlange hinzugefügt. Als Ergebnis dieses Prozesses entsteht eine Warteschlange, welche die speziellen Informationen jedes Kunden enthält. Bevor wir mit dem eigentlichen Workflow fortfahren, sollten Sie sich den Kundenbericht hier ansehen. Wir arbeiten mit dem Arbeitsblatt „Juliberichte“.

Ohne weitere Umstände:

1. Erstellen Sie eine neue Sequence.
2. Fügen Sie eine Excel Process Scope-Aktivität in die Sequence ein.
3. Fügen Sie eine Use Excel File-Aktivität hinzu und definieren Sie den Speicherort der Arbeitsmappe im Feld Excel-Datei der Aktivität.
4. Fügen Sie eine Read Range-Aktivität hinzu, um den gewünschten Wertebereich aus dem Bericht zu lesen und in einer Datentabelle-Variablen zu speichern.
5. Wählen Sie auf der rechten Seite des Felds Bereich die Option Plus > Excel > In Excel angeben aus und wählen Sie einen Zellbereich aus (z. B. A1:D51).
6. Drücken Sie Strg + K im Feld Speichern unter, um eine neue Datentabelle-Variable zu erstellen, die den zuvor gelesenen Datenbereich speichert. Nennen Sie sie dt_DataTable1 oder so ähnlich. Im Variablen-Bereich sollte die neu erstellte Variable auch wie folgt angezeigt werden:
   
   

   

   
   
7. Fügen Sie als Nächstes eine For Each Row in Data Table-Aktivität zum Designer-Bereich hinzu und füllen Sie die leeren Felder mit „row“ bzw. dem Namen der Datentabelle-Variablen, dt_DataTable1, aus. Diese Aktivität führt die darin definierte Aktion für jede Zeile in der Datentabelle aus. Die Sequence sollte jetzt wie im folgenden Screenshot aussehen:
   
   

   

   
   
8. Fügen Sie eine Add Queue Item-Aktivität in die For Each Row in Data Table-Aktivität ein. Dadurch wird für jede Zeile in der Tabelle ein Element zu einer Warteschlange (in den folgenden Schritten 8 und 12 definiert) hinzugefügt.
9. Geben Sie im Feld Warteschlangenname den Namen der Warteschlange ein, in der Ihre Elemente gespeichert werden sollen, z. B. ReportQueue.

10. Klicken Sie auf das Feld unter Elementinformationen, um das Wörterbuchgenerator-Fenster zu öffnen. Erstellen Sie 4 Argumente, die jeweils einer Spalte aus dem Bericht entsprechen. Definieren Sie sie wie folgt:

    • Name, behält die Standardwerte für Richtung (Direction) und Typ (Typ), wobei Wert (Value) auf row(0).ToString festgelegt ist. Damit wird der Wert aus der Spalte mit dem Zähler 0 für jede Zeile des Arbeitsbuches abgerufen. In unserem Fall ist dies der Name des Kunden.
    • CashIn, behält die Standardwerte für Richtung (Direction) und Typ (Typ), wobei Wert (Value) auf row(1).ToString festgelegt ist. Damit wird der Wert aus der Spalte mit dem Zähler 1 für jede Zeile des Arbeitsbuches abgerufen. In unserem Fall ist dies der Einzahlungswert (Cash In).
    • OnUsCheck, behält die Standardwerte für Richtung (Direction) und Typ (Typ), wobei Wert (Value) auf row(2).ToString festgelegt ist. Damit wird der Wert aus der Spalte mit dem Zähler 2 für jede Zeile des Arbeitsbuches abgerufen. In unserem Fall ist dies der Wert des auf uns bezogenen Schecks (On-Us Check).
    • NotOnUsCheck, behält die Standardwerte für Richtung (Direction) und Typ (Typ), wobei Wert (Value) auf row(3).ToString festgelegt ist. Damit wird der Wert aus der Spalte mit dem Zähler 3 für jede Zeile des Arbeitsbuches abgerufen. In unserem Fall ist dies der Wert des Nicht auf uns bezogenen Schecks (Not On-Us Check).

11. Das Wörterbuchgenerator-Fenster sollte wie auf dem folgenden Screenshot aussehen:

    
    

    

    
    
12. Verbinden Sie den Studio-Roboter mit Orchestrator. Die Vorgehensweise ist hier beschrieben.
13. Navigieren Sie zu https://cloud.uipath.com, melden Sie sich mit Ihren Anmeldeinformationen an und anschließend erstellen Sie eine Warteschlange, „ReportQueue“, um die Elemente zu speichern. Stellen Sie sicher, dass Sie hier den gleichen Namen wie zuvor in Schritt 8 verwenden.
14. Gehen Sie zurück zu Studio. Bis dahin sollte Ihr Workflow fehlerfrei und funktionstüchtig sein. Im nächsten Schritt müssen Sie ihn für Orchestrator zur Verfügung stellen. Klicken Sie in dieser Hinsicht auf Design (Design) > Veröffentlichen (Publish).

15. Klicken Sie auf Design (Design) > Ausführen (Run), um den Prozess auszuführen.

    Hinweis: TBerücksichtigen Sie, dass Warteschlangenobjekte nach Bearbeitung zu Transaktionen werden und als solche zu behandeln sind.
16. Navigieren Sie wieder zu https://cloud.uipath.com und zeigen Sie die Transaktionen an.

Bearbeiten der Transaktionen aus einer Warteschlange

Um zu veranschaulichen, wie Transaktionen aus einer Warteschlange weiterbearbeitet werden, erstellen wir einen weiteren Workflow, welcher aus der zuvor erstellten Warteschlange diejenigen Transaktionen abruft, die einen entsprechenden auf uns bezogenen Scheckwert von unter $ 5000 aufweisen. Für jede Transaktion, welche die Bedingung erfüllt, werden die Werte abgerufen und in eine Drittparteien-Dummy-Anwendung eingefügt. Die restlichen werden als Geschäftsausnahmen beschriftet.

1. Gehen Sie zu Design (Design) > Neu (New) > Flowchart, um eine neue Datei im oben begonnenen Projekt zu erstellen.
2. Fügen Sie eine Use Application/Browser-Aktivität hinzu, um die Dummy-Drittanbieteranwendung zu öffnen. Verbinden Sie sie mit dem Startknoten.
3. Geben Sie die erforderlichen Details (Anzeigename, Dateipfad, Selektor) im Eigenschaften-Bereich ein und konfigurieren Sie die Aktivität, um sich mit den entsprechenden Anmeldeinformationen anzumelden. Verwenden Sie admin für das Feld Benutzername und password für das Feld Kennwort.
4. Tragen Sie in das Feld Dateipfad den Pfad der Anwendung ein.
5. Definieren Sie im Feld Selektor (Selector) mit dem Selektor Editor einen Selektor für UIDemo.
6. Fügen Sie eine Sollte anhalten (Should Stop)-Aktivität in das Panel Designer (Designer) ein und verbinden Sie diese mit der Aktivität Anwendung öffnen (Open Application).

7. Fügen Sie eine Ablaufentscheidung (Flow Decision)-Aktivität in das Panel Designer (Designer) ein und verbinden Sie diese mit der Aktivität Sollte anhalten (Should Stop). Diese beiden letzten Aktivitäten prüfen, ob Sie den Job angehalten haben, während er noch ausgeführt wurde. Dies gibt Ihnen die Möglichkeit, den Workflow weiter zu konfigurieren, um verschiedene Sicherheitsroutinen auszuführen, nachdem das Anhalten ausgelöst wurde. Nachfolgend sehen Sie ein Beispiel für solch eine Routine:

   • Fügen Sie eine Log Message-Aktivität hinzu, und verbinden Sie diese mit der Verzweigung True der zuvor hinzugefügten Ablaufentscheidung.
   • Geben Sie im Bereich Eigenschaften (Properties) im Feld Meldung (Message) „Prozess anhalten erforderlich“ oder Ähnliches ein, das angezeigt wird, wenn Anhalten ausgelöst wird.
   • Fügen Sie eine Close Application-Aktivität hinzu, und verbinden Sie diese mit der zuvor hinzugefügten Aktivität Log Message.
   • Geben Sie im Panel Eigenschaften (Properties) im Feld Anzeigename (DisplayName) hinter Anwendung schließen (Close Application) UIDemo.exe UIDemo ein.
8. Fügen Sie eine Get Transaction Item-Aktivität zur Verzweigung False der zuvor hinzugefügten Ablaufentscheidung (Schritt 7) hinzu. Diese Aktivität ruft die Transaktionsobjekte aus der Warteschlange ab und speichert sie bei jeder Iteration der Schleife in einer QueueItem-Variablen.
9. Geben Sie im Abschnitt Eigenschaften (Properties) im Feld Name der Warteschlange (QueueName) den Namen der Warteschlange ein, in der die Objekte gespeichert werden. In unserem Fall lautet der Name „ReportQueue“, wie im Abschnitt Objekte in eine Warteschlange hochladen (Uploading Items into a Queue) festgelegt.
10. Drücken Sie im Feld TransactionItem Strg+K, um die QueueItem-Variable zu erstellen, in welcher jedes Transaktionsobjekt gespeichert wird. Nennen Sie sie „TransItem“ oder ähnlich.
11. Fügen Sie eine Flow Decision-Aktivität in das Panel Designer ein, und verbinden Sie diese mit der Aktivität Get Transaction Item.
12. Geben Sie im Abschnitt Eigenschaften TransItem isNot Nothing in das Feld Bedingung ein. Diese Aktivität prüft den Wert jedes Elements, um festzustellen, ob das Ende der Warteschlange erreicht ist.
13. Verbinden Sie die Verzweigung False der Ablaufentscheidung mit der in Schritt 7 erstellten Aktivität Log Message. Dadurch wird sichergestellt, dass der Auftrag angehalten wird, wenn das Ende der Warteschlange erreicht ist.
14. Fügen Sie dem Panel Designer eine weitere Flow Decision-Aktivität hinzu, und verbinden Sie sie mit der in Schritt 11 erstellten Verzweigung True der Ablaufentscheidung.
15. Geben Sie im Abschnitt Eigenschaften (Properties) in das Feld Bedingung (Condition) cint(TransItem.SpecificContent("OnUSCheck").ToString) < 5000 ein, wobei:
    • cint eine Variable des Typs String in eine vom Typ „Integer“ konvertiert.
    • TransItem Ist die QueueItem-Variable (Schritt 18), die zum Speichern der Elemente dient.
    • SpecificContent("OnUSCheck") den Inhalt des Arguments des auf UNS bezogenen Schecks in jedem Objekt abruft.
    • .ToString den Inhalt der Warteschlangenobjekt-Variablen in eine Variable vom Typ „String“ konvertiert.
    • < 5000 ist die Bedingung, gegen die geprüft werden soll.

      Der obige Ausdruck konvertiert den Wert des auf UNS bezogenen Schecks in jeder Warteschlangenobjekt-Variablen in eine String-Variable, die dann weiter in eine „Integer“ konvertiert wird. Der so erhaltene Wert wird auf Übereinstimmung mit der Bedingung geprüft.

16. Fügen Sie eine Aktivität Transaktionsstatus festlegen zum Panel Designer hinzu und verbinden Sie diese mit der Verzweigung False der vorherigen Ablaufentscheidung (Schritt 13).
17. Achten Sie darauf, dass im Abschnitt Eigenschaften (Properties) das Feld Status (Status) auf Fehlgeschlagen (Failed) und der Fehlertyp (ErrorType) auf Geschäft (Business) festgelegt ist. Auf diese Weise wird die Transaktion als fehlgeschlagen mit einer Geschäftsausnahme markiert, wenn der Wert des auf UNS bezogenen Schecks größer oder gleich 5000 lautet.
18. Fügen Sie die Variable TransItem in das Feld Transaktionselement (TransactionItem) ein.
19. Geben Sie im Feld Grund (Reason) „Auf UNS bezogener Scheckbetrag ist höher als 5000“ oder Ähnliches ein, um anzuzeigen, dass die Transaktion fehlgeschlagen ist.
20. Verbinden Sie die Transaktionsstatus festlegen (Set Transaction Status)-Aktivität mit der Aktivität Sollte anhalten (Should Stop) (Schritt 6), um eine Schleife zu erstellen und die nächste Transaktion in der Warteschlange zu bearbeiten.
21. Fügen Sie eine Sequence-Aktivität zum Panel Designer, und verbinden Sie diese mit der Verzweigung True der vorherigen Ablaufentscheidung (Schritt 13). Fügen Sie in der Sequence eine Try Catch-Aktivität hinzu, und konfigurieren Sie diese so, dass potenzielle Fehler beim Bearbeiten der Elemente korrekt als Anwendungsfehler gekennzeichnet werden.
22. Öffnen Sie die UIDemo-Anwendung und melden Sie sich mit dem Benutzernamen admin und dem Passwort password an.

23. Führen Sie die folgende Serie von Aktivitäten für jedes der Felder Einzahlung (Cash In), Auf uns bezogener Scheck (On Us Check) und Nicht auf uns bezogener Scheck (Not On Us Check) in der UIDemo-Anwendung durch:

    • Fügen Sie in der vorherigen Try Catch-Aktivität eine Use Application/Browser-Aktivität hinzu, um die Anwendung zu öffnen.
    • Fügen Sie eine Type Into-Aktivität hinzu.
    • Klicken Sie auf Auf Bildschirm anzeigen und wählen Sie das leere Feld, das „Cash In“ entspricht, in der UIDemo-Benutzeroberfläche aus.
    • Geben Sie im Feld Dies eingeben transItem.SpecificContent("CashIn").ToString ein. Jeder Begriff im Ausdruck wird oben erläutert (Schritt 15). Dieser Ausdruck wandelt den Wert in jeder „QueueItem“-Variablen in eine String-Variable um.
24. Fügen Sie eine Get Text-Aktivität nach den vorherigen Type Into-Aktivitäten hinzu und wählen Sie „Ziel auf Bildschirm anzeigen“ aus dem Optionsmenü aus.
25. Zeigen Sie auf die Transaktionsnummer in der UIDemo-Anwendung und klicken Sie auf Bestätigen.
26. Legen Sie das Feld Text auf eine neue Variable fest, z. B. TransNumber. Dadurch wird die Transaktionsnummer für jedes Warteschlangenelement abgerufen, das die ursprüngliche Bedingung erfüllt.
27. Fügen Sie eine Set transaction status-Aktivität hinter der Get Text-Aktivität hinzu.
28. Stellen Sie sicher, dass das Status-Feld auf Erfolgreich und Fehlertyp auf Anwendung festgelegt ist. Wenn der Wertesatz erfolgreich in die Anwendung eingeführt wird, wird der Status der Transaktion auf Erfolgreich festgelegt oder als Anwendungsausnahme bezeichnet.
29. Definieren Sie im Fenster Ausgabe ein neues Argument, und fügen Sie die zuvor erstellte Variable TransNumber (Schritt 25) als Wert hinzu.
30. Fügen Sie die Variable TransItem in das Feld Transaktionselement (TransactionItem) ein.
31. Fügen Sie eine Click-Aktivität nach der Set transaction status-Aktivität hinzu.
32. Klicken Sie auf Ziel auf Bildschirm anzeigen und wählen Sie die Schaltfläche Akzeptieren in der UIDemo-Benutzeroberfläche aus.

33. Die Try Catch-Aktivität sollte wie auf dem folgenden Screenshot aussehen.

    
    

    

    
    
34. Gehen Sie zurück zum Flowchart, und verbinden Sie die vorherige Sequence-Aktivität (Schritt 21) mit der Aktivität Should Stop (Schritt 6), um eine Schleife zu erstellen und die nächste Transaktion in der Warteschlange zu bearbeiten.

35. Das Flowchart sollte wie auf dem folgenden Screenshot aussehen.

    
    

    

    
    
36. Klicken Sie auf Design (Design) > Ausführen (Run), um den Prozess auszuführen.
37. Nach dem Abschluss der Ausführung können Sie zu https://cloud.uipath.com navigieren und die verarbeiteten Transaktionen anzeigen, mit den entsprechenden Verarbeitungsdetails:

• Erfolgreiche Transaktion

  
  

  

  
  

• Fehlgeschlagene Transaktion

  
  

  

  
  

Beispiel herunterladen