Proprietäre UiPath-Variablen

GenericValue-Variablen

Die GenericValue-Variable ist ein UiPath 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 Function GenericValue.CompareTo(other As GenericValue) As Integer Function GenericValue.CompareTo(obj As Object) As Integer	[Klicken Sie hier für Details.][1] [1]: https://msdn.microsoft.com/en-us/library/system.string.compareto(v=vs.110).aspx
Enthält Function GenericValue.Contains(other As String) As Boolean	[Klicken Sie hier für Details.][2] [2]: https://msdn.microsoft.com/en-us/library/dy85x1sa(v=vs.110).aspx 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Equals Function GenericValue.Equals(other As GenericValue) As Boolean Function GenericValue.Equals(obj As Object) As Boolean	[Klicken Sie hier für Details.][3] [3]: https://msdn.microsoft.com/en-us/library/system.string.equals(v=vs.110).aspx
GetHashCode Function GenericValue.GetHashCode() As Integer	[Klicken Sie hier für Details.][5] [5]: https://msdn.microsoft.com/en-us/library/system.string.format(v=vs.110).aspx
GetType Function Object.GetType() As Type	[Klicken Sie hier für Details.][6] [6]: https://msdn.microsoft.com/en-us/library/system.object.gettype(v=vs.110).aspx
GetTypeCode Function GenericValue.GetTypeCode() As TypeCode	[Klicken Sie hier für Details.][7] [7]: https://msdn.microsoft.com/en-us/library/system.string.gettypecode(v=vs.110).aspx
IndexOf Function GenericValue.IndexOf(value As String) As Integer Function GenericValue.IndexOf(value As String, comparisonType As StringComparison) As Integer Function GenericValue.IndexOf(value As String, startIndex As Integer) As Integer Function GenericValue.IndexOf(value As String, startIndex As Integer, comparisonType As StringComparison) As Integer	[Klicken Sie hier für Details.][8] [8]: https://msdn.microsoft.com/en-us/library/system.string.indexof(v=vs.110).aspx 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Länge Function GenericValue.Lenght() As Integer	[Klicken Sie hier für Details.][9] [9]: https://msdn.microsoft.com/en-us/library/system.string.length(v=vs.110).aspx 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Ersetzen (Replace) Function GenericValue.Replace(oldValue As String, new value As String) As String	[Klicken Sie hier für Details.][10] [10]: https://msdn.microsoft.com/en-us/library/system.string.replace(v=vs.110).aspx 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Teilen Function GenericValue.Split(ParamArray separator As Char()) As String() Function GenericValue.Split(ParamArray separator As String()) As String() Function GenericValue.Split(separator As Char(), options As StringSplitOptions) As String() Function GenericValue.Split(separator As String(), options As StringSplitOptions) As String()	[Klicken Sie hier für Details.][11] [11]: https://msdn.microsoft.com/en-us/library/system.string.split(v=vs.110).aspx 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Substring Function GenericValue.Substring(startIndex As Integer) As String Function GenericValue.Substring(startIndex As Integer, length As Integer) As String	[Klicken Sie hier für Details.][12] [12]: https://msdn.microsoft.com/en-us/library/system.string.substring(v=vs.110).aspx 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“. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
ToBoolean Function GenericValue.ToBoolean(provider As IFormatProvider) As Boolean	[Klicken Sie hier für Details.][13] [13]: https://msdn.microsoft.com/en-us/library/bb346937(v=vs.110).aspx
ToByte Function GenericValue.ToByte(provider As IFormatProvider) As Byte	[Klicken Sie hier für Details.][14] [14]: https://msdn.microsoft.com/en-us/library/bb355898(v=vs.110).aspx
ToChar Function GenericValue.ToChar(provider As IFormatProvider) As Char	[Klicken Sie hier für Details.][15] [1]: https://msdn.microsoft.com/en-us/library/t249c2y7(v=vs.110).aspx
ToDecimal Function GenericValue.ToDecimal(provider As IFormatProvider) As Decimal Function GenericValue.ToDecimal(format As NumberStyles) As Decimal	[Klicken Sie hier für Details.][17] [17]: https://msdn.microsoft.com/en-us/library/bb359959(v=vs.110).aspx
ToDouble Function GenericValue.ToDouble(provider As IFormatProvider) As Double Function GenericValue.ToDouble(format As NumberStyles) As Double	[Klicken Sie hier für Details.][18] [18]: https://msdn.microsoft.com/en-us/library/bb154906(v=vs.110).aspx
ToInt Function GenericValue.ToInt(culture As IFormatProvider) As Integer? Function GenericValue.ToInt() As Integer?	Wird verwendet, um einen angegebenen Wert in einen Integer-Wert zu konvertieren, der einen Nullwert zulässt. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean 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.][20] [20]: https://msdn.microsoft.com/en-us/library/bb293091(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean 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.][21] [21]: https://msdn.microsoft.com/en-us/library/bb300452(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean 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.][22] [22]: https://msdn.microsoft.com/en-us/library/bb359566(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
ToLower Function GenericValue.ToLower() As String	[Klicken Sie hier für Details.][23] [23]: https://msdn.microsoft.com/en-us/library/system.string.tolower(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
ToLowerInvariant Function GenericValue.ToLowerInvariant() As String	[Klicken Sie hier für Details.][24] [24]: https://msdn.microsoft.com/en-us/library/system.string.tolowerinvariant(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
ToSByte Function GenericValue.ToSByte(provider As IFormatProvider) As SByte	[Klicken Sie hier für Details.][25] [25]: https://msdn.microsoft.com/en-us/library/bb342232(v=vs.110).aspx
ToSingle Function GenericValue.ToSingle(provider As IFormatProvider) As Single	[Klicken Sie hier für Details.][26] [26]: https://msdn.microsoft.com/en-us/library/bb360375(v=vs.110).aspx
In Zeichenfolge umwandeln Function GenericValue.ToString(formatProvider As IFormatProvider) As String Function GenericValue.ToString(format As String, formatProvider As IFormatProvider) As String Function GenericValue.ToString() As String	[Klicken Sie hier für Details.][27] [27]: https://msdn.microsoft.com/en-us/library/system.string.tostring(v=vs.110).aspx
ToType Function GenericValue.ToType(conversionType As Type, provider As IFormatProvider) As Object	[Klicken Sie hier für Details.][29] [29]: https://msdn.microsoft.com/en-us/library/bb358540(v=vs.110).aspx
ToUInt16 Function GenericValue.ToUInt16(provider As IFormatProvider) As UShort	[Klicken Sie hier für Details.][30] [30]: https://msdn.microsoft.com/en-us/library/bb337265(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
ToUInt32 Function GenericValue.ToUInt32(provider As IFormatProvider) As UInteger	[Klicken Sie hier für Details.][31] [31]: https://msdn.microsoft.com/en-us/library/bb357762(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
ToUInt64 Function GenericValue.ToUInt64(provider As IFormatProvider) As Ulong	[Klicken Sie hier für Details.][32] [32]: https://msdn.microsoft.com/en-us/library/bb155099(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
ToUpper Function GenericValue.ToUpper() As String	[Klicken Sie hier für Details.][33] [33]: https://msdn.microsoft.com/de-de/library/system.string.toupper(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
ToUpperInvariant Function GenericValue.ToUpperInvariant() As String	[Klicken Sie hier für Details.][34] [34]: https://msdn.microsoft.com/en-us/library/system.string.toupperinvariant(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Trim Function GenericValue.Trim(ParamArray trimChars As Char()) As String Function GenericValue.Trim() As String	[Klicken Sie hier für Details.][35] [35]: https://msdn.microsoft.com/en-us/library/system.string.trim(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
TrimEnd Function GenericValue.TrimEnd(ParamArray trimChars As Char()) As String	[Klicken Sie hier für Details.][36] [36]: https://msdn.microsoft.com/en-us/library/system.string.trimend(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
TrimStart Function GenericValue.TrimStart(ParamArray trimChars As Char()) As String	[Klicken Sie hier für Details.][37] [37]: https://msdn.microsoft.com/en-us/library/system.string.trimstart(v=vs.110).aspx Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.

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) im 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. Geben Sie die Variable Result im Panel Eigenschaften im Feld Text 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. Kehren Sie zur zuvor hinzugefügten Aktivität Zuweisen zurück und ändern Sie das Feld Wert in Str + Int, um die Reihenfolge der Variablen umzukehren. Das Projekt sollte wie im 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 zu lesen, um einen Überblick über Warteschlangen und Transaktionen zu erhalten, bevor Sie mit der Variable QueueItem 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 Function Object.Equals(obj As Object) As Boolean	Klicken Sie hier für Details.
GetHashCode Function Object.GetHashCode() As Integer	Klicken Sie hier für Details.
GetType Function Object.GetType() As Type	Klicken Sie hier für Details.
In Zeichenfolge umwandeln Function Object.ToString() As String	Klicken Sie hier für Details.

Unterstützte Eigenschaften

Name/Syntax	Beschreibung
Zugewiesen zu (AssignedTo) Property QueueItem.AssignedTo As String	Klicken Sie hier für Details.
Fälligkeitsdatum (DueDate) Property QueueItem.DueDate As Date?	Das aktuellste Datum mit Uhrzeit, an dem das Objekt verarbeitet werden soll. Ist das Objekt leer, kann es jederzeit bearbeitet werden.
Verschiebungsdatum (DeferDate) Property QueueItem.DueDate As 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 Property QueueItem.Id As Long?	Klicken Sie hier für Details.
Objektschlüssel (ItemKey) Property QueueItem.ItemKey As Guid	Der einmalige Identifier des Objekts. Zum Beispiel 1bf829e1-cd6b-4275-a364-19db3cfe09c7.
Priorität Property QueueItem.Priority As QueueItemPriority	Die Priorität des Warteschlangenobjekts, die bei Studio im Feld Priorität (Priority) im Abschnitt Eigenschaften (Properties) festgelegt wurde.
Verarbeitungsausnahme (ProcessingException) Property QueueItem.ProcessingException As ProcessingException	Die Verarbeitungsausnahme eines fehlgeschlagenen Objekts.
Fortschritt Property QueueItem.Progress As String	Benutzerdefinierte Fortschrittsinformationen über ein Warteschlangenobjekt mit dem Status (In Bearbeitung (InProgress).
ID Warteschlangendefinition (QueueDefinitionId) Property QueueItem.QueueDefinitionId As Long	Der einmalige Identifier der Warteschlange, unter dem ein Warteschlangenobjekt/eine Transaktion erstellt wurde.
Warteschlangenname (QueueName) Property QueueItem.QueueName As String	Der Name der Warteschlange, welche die bearbeiteten Objekte enthält.
Referenz (Reference) Property QueueItem.Reference As String	Ein benutzerdefinierter Wert zur einfacheren Erkennung des Warteschlangenobjekts.
Anzahl Wiederholungen (RetryNo) Property QueueItem.RetryNo As Integer	Wie oft das Objekt wiederholt wurde.
Status überprüfen (Review Status) Property QueueItem.ReviewStatus As String	Der Überprüfungsstatus des von Orchestrator abgerufenen Warteschlangenobjekts.
RowVersion Property QueueItem.RowVersion As 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) Property QueueItem.SpecificContent As 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) Property QueueItem.StartTransactionTime As Date?	Uhrzeit und Datum des Beginns der Transaktionsverarbeitung.
Status Property QueueItem.Status As 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

Um zu demonstrieren, wie Elemente in eine Warteschlange hinzugefügt werden, erstellen wir eine Automatisierung, die Einträge in einer Datei .xlsxprocesses.Angenommen, Sie stellen ein Bankinstitut dar und haben einen Einzahlungsbericht von 50 Clients. Sie möchten die Daten jedes Kunden, der zuvor einen On-Us Aktivieren unter 5000 USD hinterlegt hat, mithilfe einer Finanzanwendung eines Drittanbieters Prozess verarbeiten.Der Bericht enthält den Namen des Clients, den Wert On-Us Aktivieren und zwei weitere Werte, sagen wir Cash In und Not On-Us Aktivieren.Wir erstellen einen Workflow, in dem die Variable QueueItem die Informationen jedes Clients speichert. Jeder Eintrag, der von der Variable QueueItem gelesen wird, wird dann in einem Warteschlangenelement gespeichert und der angegebenen Warteschlange im Orchestrator hinzugefügt. Das Ergebnis dieses gesamten Prozesses ist eine Warteschlange, die die spezifischen Informationen jedes Clients enthält. Bevor Sie mit dem eigentlichen Workflow fortfahren, sollten Sie sich den Bericht der Clients hier ansehen. Wir werden mit dem Blatt „Juli-Berichte“ arbeiten.

Ohne weitere Umstände:

1. Erstellen Sie eine neue Sequence.

2. Add an Excel Application Scope activity inside the sequence, and define the location of the workbook in the Properties pane of the activity.

3. Inside the Do section, add a Read Range activity to read the desired range of values from the report and store them in a DataTable variable. In our case, type "A1-D51" or simply leave the default value, “”, which means the entire spreadsheet is read.

4. Geben Sie in das Feld Blattname den Namen des Blatts ein, “July Report”.

5. Drücken Sie im Feld Datentabelle (Data Table) Strg + K, um eine neue Datentabellen-Variable zu erstellen, in welcher der zuvor gelesene Datenbereich gespeichert wird. Nennen Sie sie DataTable1 oder ähnlich. Im Abschnitt Variablen (Variables) sollte die neu erstellte Variable überdies folgendermaßen erscheinen:

   

6. Next, add a For Each Row activity to the Designer panel and fill in the blank fields with “row” and the name of the DataTable variable, DataTable1, respectively. This activity performs the action defined in the Body section for each row in the data table. The Do section should look similar to the following screenshot so far:

   

7. Fügen Sie im Abschnitt Textkörper (Body) der Aktivität Für jede Zeile (For Each Row) eine Aktivität Warteschlangenobjekt hinzufügen (Add Queue Item) hinzu. Damit wird für jede Zeile im Arbeitsblatt ein Objekt zu einer (in Schritt 8 und 12 unten definierten) Warteschlange hinzugefügt.

8. Geben Sie im Abschnitt Eigenschaften im Feld QueueName den Namen der Warteschlange ein, in der Sie die Elemente speichern möchten, zum Beispiel ReportQueue.

9. Klicken Sie im Abschnitt Eingabe (Input) auf die Schaltfläche, die dem Feld Objektinformationen (ItemInformation) entspricht, um das Fenster Objektinformationen (ItemInformation) zu öffnen. Erstellen Sie 4 Argumente, die jeweils einer Berichtsspalte entsprechen. Definieren Sie diese folgendermaßen:

   • 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.
   • 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.
   • 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.

10. Das Fenster Objektinformationen (ItemInformation) sollte ähnlich dem folgenden Screenshot aussehen:

    

11. Verbinden Sie den Studio-Roboter mit Orchestrator.Weitere Informationen zur Vorgehensweise finden Sie hier.

12. Navigate to https://platform.uipath.com, log in using your credentials, and then create a queue, ReportQueue, to store the items. Make sure that, whatever name you used above (step 8), you use the same here.

13. 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).

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

    Hinweis:

    Berücksichtigen Sie, dass Warteschlangenobjekte nach Bearbeitung zu Transaktionen werden und als solche zu behandeln sind.

15. Navigate to https://platform.uipath.com again and display the transactions.

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. Add an Open Application activity to open the third-party dummy application. Connect it to the Start node.

3. Tragen Sie die erforderlichen Details (Anzeigename (Display Name), Dateiname (FileName), Selektor (Selector)) im Bereich Eigenschaften (Properties) ein und konfigurieren Sie die Aktivität zum Anmelden mit den entsprechenden Anmeldedaten. Verwenden Sie admin für das Feld Benutzername (Username) und password für das Feld Passwort (Password).

4. Tragen Sie im Feld Dateiname (FileName) 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 dem Designer-Bereich eine Aktivität Should Anhalten hinzu und verbinden Sie sie mit der Aktivität Anwendung öffnen.

7. Fügen Sie dem Designer-Bereich eine Flow Decision-Aktivität hinzu und verbinden Sie sie mit der Aktivität Should Anhalten.Diese letzten beiden Aktivitäten aktivieren, ob Sie den Auftrag angehalten haben, während er noch ausgeführt wurde.Dadurch haben Sie die Möglichkeit, den Workflow weiter zu konfigurieren, um verschiedene Sicherheitsroutinen auszuführen, nachdem das Anhalten ausgelöst wurde.Unten finden Sie ein Beispiel für eine solche Routine:

   • Fügen Sie eine Aktivität Meldung protokollieren (Log Message) hinzu und verbinden Sie diese mit der Verzweigung Wahr (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 Aktivität Schließen der Anwendung hinzu und verbinden Sie sie mit der zuvor hinzugefügten Aktivität Protokollmeldung.
   • 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 Aktivität Transaktionsobjekt abrufen (Get Transaction Item) zur Verzweigung Falsch (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 Warteschlangenobjekt-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 Transaktionsobjekt (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 dem Designer-Bereich eine Sequence-Aktivität hinzu und verbinden Sie sie mit dem True-Zweig der vorherigen Flow-Entscheidung (Schritt 13).Fügen Sie in der Sequence eine Try Catch-Aktivität hinzu und konfigurieren Sie sie so, dass alle potenziellen Fehler bei der Verarbeitung 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:

    • Into the previous Try Catch activity, add a Type Into activity.
    • Klicken Sie auf Auf dem Bildschirm anzeigen (Indicate on screen) und wählen Sie aus der UIDemo-Bedienoberfläche das leere Feld aus, das „Einzahlung“ entspricht.
    • Geben Sie im Abschnitt Eigenschaften transItem.SpecificContent("CashIn").ToString in das Feld Text ein. Jeder Begriff des Ausdrucks ist oben in Schritt 15 erläutert. Dieser Ausdruck konvertiert den Wert in jeder QueueItem-Variablen in eine String-Variable.
    • Make sure that the Simulate Type option is selected.

24. Klicken Sie auf der Registerkarte Design (Design) im Abschnitt Assistenten (Wizards) auf Bildschirm-Scraping (Screen Scraping) und zeigen Sie auf die Transaktionsnummer in der UIDemo-Anwendung.

    

25. Wählen Sie im Bildschirm-Scraper-Assistenten (Screen Scraper Wizard) eine Scraping-Methode aus und klicken Sie auf Fertigstellen (Finish). Dadurch wird in Ihren Workflow eine Aktivität Bildschirm-Scraping (Screen Scraping) eingefügt. Achten Sie darauf, diese hinter die vorherigen Aktivitäten Eingabe in (Type Into) zu stellen, und geben Sie eine neue Variable, zum Beispiel TransactionValue, im Feld Text (Text) an. Dadurch wird die Transaktionsnummer für jedes Warteschlangenobjekt abgerufen, das die anfängliche Bedingung erfüllt.

26. Fügen Sie eine Aktivität Transaktionsstatus festlegen (Set Transaction Status) hinter der Aktivität Bildschirm-Scraping (Screen Scraping) hinzu.

27. Achten Sie darauf, dass im Abschnitt Eigenschaften (Properties) das Feld Status (Status) auf Erfolgreich (Successful) und der Fehlertyp (ErrorType) auf Anwendung (Application) gesetzt ist. So wird der Transktionsstatus auf Erfolgreich (Successful) gesetzt, wenn der Wertesatz erfolgreich in die Anwendung aufgenommen wurde, oder als Anwendungsausnahme beschriftet.

28. Definieren Sie im Fenster Ausgabe ein neues Argument, und fügen Sie die zuvor erstellte Variable TransactionValue (Schritt 25) als Wert hinzu.

29. Fügen Sie die Variable TransItem in das Feld Transaktionselement (TransactionItem) ein.

30. Fügen Sie eine Klicken- (Click)Aktivität zur Sequence-Aktivität hinter den Aktivitäten Eingeben (Type Into) hinzu.

31. Klicken Sie auf Auf dem Bildschirm anzeigen (Indicate on screen) und wählen Sie die Schaltfläche Akzeptieren (Accept) der UIDemo-Bedienoberfläche aus. Stellen Sie sicher, dass die Option Typ simulieren (Simulate Type) ausgewählt ist.

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

    

33. 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.

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

    

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

36. After the execution has ended, you may navigate to https://platform.uipath.com and display the processed transactions with the corresponding processing details:

• Erfolgreiche Transaktion

  

• Fehlgeschlagene Transaktion

  

Beispiel herunterladen