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. 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 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. 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.][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. 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) 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. 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 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. 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 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“. 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 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. 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.][20] [20]: https://msdn.microsoft.com/en-us/library/bb293091(v=vs.110).aspx 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.][21] [21]: https://msdn.microsoft.com/en-us/library/bb300452(v=vs.110).aspx 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.][22] [22]: https://msdn.microsoft.com/en-us/library/bb359566(v=vs.110).aspx 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.][23] [23]: https://msdn.microsoft.com/en-us/library/system.string.tolower(v=vs.110).aspx 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.][24] [24]: https://msdn.microsoft.com/en-us/library/system.string.tolowerinvariant(v=vs.110).aspx 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 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 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 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 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 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 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.][33] [33]: https://msdn.microsoft.com/de-de/library/system.string.toupper(v=vs.110).aspx 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.][34] [34]: https://msdn.microsoft.com/en-us/library/system.string.toupperinvariant(v=vs.110).aspx 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 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 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 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 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.][37] [37]: https://msdn.microsoft.com/en-us/library/system.string.trimstart(v=vs.110).aspx 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. 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. 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 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

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 Application Scope-Aktivität in die Sequence ein, und definieren Sie die Position der Arbeitsmappe im Abschnitt Eigenschaften der Aktivität.
3. Fügen Sie im Abschnitt Ausführen eine Read Range-Aktivität ein, um den gewünschten Wertebereich des Berichts zu lesen und die Werte in einer DataTable-Variablen zu speichern. In unserem Fall geben Sie "A1-D51" ein oder lassen Sie einfach den Standardwert “” stehen, wodurch die gesamte Kalkulationstabelle gelesen wird.
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 Variablen-Bereich sollte die neu erstellte Variable auch wie folgt angezeigt werden:
   
   

   

   
   
6. Dann fügen Sie eine Aktivität Für jede Zeile zum Panel Designer hinzu und tragen in die leeren Felder „Zeile“ und den Namen der Datentabellen-Variablen, DataTable1, ein. Diese Aktivität führt die im Abschnitt Textkörper für jede Zeile der Datentabelle angegebene Aktion aus. Der Abschnitt Ausführen sollte jetzt wie auf dem folgenden Screenshot aussehen:
   
   

   

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

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

    
    

    

    
    
11. Verbinden Sie den Studio-Roboter mit Orchestrator. Die Vorgehensweise ist hier beschrieben.
12. 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.
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: TBerücksichtigen Sie, dass Warteschlangenobjekte nach Bearbeitung zu Transaktionen werden und als solche zu behandeln sind.
15. Navigieren Sie wieder zu https://paltform.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 Open Application-Aktivität hinzu, um die Dummy-Anwendung eines Drittanbieters zu öffnen. Verbinden Sie diese mit dem Knoten Start.
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 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 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 die vorherige Aktivität Abfangen versuchen (Try Catch) eine Aktivität Eingabe in (Type Into) ein.
    • 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 im Ausdruck wird oben erläutert (Schritt 15). Dieser Ausdruck wandelt den Wert in jeder „QueueItem“-Variablen in eine String-Variable um.
    • Stellen Sie sicher, dass die Option Eingabe simulieren (Simulate Type) ausgewählt ist.

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 Warteschlangenelement abgerufen, das die ursprü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. Nachdem die Ausführung beendet ist, können Sie zu https://platform.uipath.com navigieren und die bearbeitete Transaktion anzeigen, mit den entsprechenden Bearbeitungsdetails:

• Erfolgreiche Transaktion

  
  

  

  
  

• Fehlgeschlagene Transaktion

  
  

  

  
  

Beispiel herunterladen