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
Function GenericValue.CompareTo(other As GenericValue) As Integer Function GenericValue.CompareTo(obj As Object) As Integer	Klicken Sie hier für Details.
Function GenericValue.Contains(other As String) As 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.Equals(other As GenericValue) As Boolean Function GenericValue.Equals(obj As Object) As Boolean	Klicken Sie hier für Details.
Function GenericValue.GetHashCode() As Integer	Klicken Sie hier für Details.
Function Object.GetType() As Type	Klicken Sie hier für Details.
Function GenericValue.GetTypeCode() As TypeCode	Klicken Sie hier für Details.
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. 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.
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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.Replace(oldValue As String, new value As String) As 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. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
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. 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.
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. 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.
Function GenericValue.ToBoolean(provider As IFormatProvider) As Boolean	Klicken Sie hier für Details.
Function GenericValue.ToByte(provider As IFormatProvider) As Byte	Klicken Sie hier für Details.
Function GenericValue.ToChar(provider As IFormatProvider) As Char	Klicken Sie hier für Details.
Function GenericValue.ToDecimal(provider As IFormatProvider) As Decimal Function GenericValue.ToDecimal(format As NumberStyles) As Decimal	Klicken Sie hier für Details.
Function GenericValue.ToDouble(provider As IFormatProvider) As Double Function GenericValue.ToDouble(format As NumberStyles) As Double	Klicken Sie hier für Details.
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.
Function GenericValue.ToInt16(provider As IFormatProvider) As Short	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToInt32(provider As IFormatProvider) As Integer	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToInt64(provider As IFormatProvider) As Long	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToLower() As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.ToLowerInvariant() As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.ToSByte(provider As IFormatProvider) As SByte	Klicken Sie hier für Details.
Function GenericValue.ToSingle(provider As IFormatProvider) As Single	Klicken Sie hier für Details.
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.
Function GenericValue.ToType(conversionType As Type, provider As IFormatProvider) As Object	Klicken Sie hier für Details.
Function GenericValue.ToUInt16(provider As IFormatProvider) As UShort	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToUInt32(provider As IFormatProvider) As UInteger	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToUInt64(provider As IFormatProvider) As Ulong	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Boolean werden die Werte "True" und "False" in 1 bzw. 0 konvertiert.
Function GenericValue.ToUpper() As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.ToUpperInvariant() As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.Trim(ParamArray trimChars As Char()) As String Function GenericValue.Trim() As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.TrimEnd(ParamArray trimChars As Char()) As String	Klicken Sie hier für Details. Bei Verwendung dieser Methode mit einer GenericValue-Variable vom Datentyp Int, Float oder Boolean werden die Daten automatisch in string konvertiert und entsprechend behandelt.
Function GenericValue.TrimStart(ParamArray trimChars As Char()) As String	Klicken Sie hier für Details. 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. 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. 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
Function Object.Equals(obj As Object) As Boolean	Klicken Sie hier für Details.
Function Object.GetHashCode() As Integer	Klicken Sie hier für Details.
Function Object.GetType() As Type	Klicken Sie hier für Details.
Function Object.ToString() As String	Klicken Sie hier für Details.

Unterstützte Eigenschaften

Name/Syntax	Beschreibung
Property QueueItem.AssignedTo As String	Klicken Sie hier für Details.
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.
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.
Property QueueItem.Id As Long?	Klicken Sie hier für Details.
Property QueueItem.ItemKey As Guid	Der einmalige Identifier des Objekts. Zum Beispiel 1bf829e1-cd6b-4275-a364-19db3cfe09c7.
Property QueueItem.Priority As QueueItemPriority	Die Priorität des Warteschlangenobjekts, die bei Studio im Feld Priorität (Priority) im Abschnitt Eigenschaften (Properties) festgelegt wurde.
Property QueueItem.ProcessingException As ProcessingException	Die Verarbeitungsausnahme eines fehlgeschlagenen Objekts.
Property QueueItem.Progress As String	Benutzerdefinierte Fortschrittsinformationen über ein Warteschlangenobjekt mit dem Status (In Bearbeitung (InProgress).
Property QueueItem.QueueDefinitionId As Long	Der einmalige Identifier der Warteschlange, unter dem ein Warteschlangenobjekt/eine Transaktion erstellt wurde.
Property QueueItem.QueueName As String	Der Name der Warteschlange, welche die bearbeiteten Objekte enthält.
Property QueueItem.Reference As String	Ein benutzerdefinierter Wert zur einfacheren Erkennung des Warteschlangenobjekts.
Property QueueItem.RetryNo As Integer	Wie oft das Objekt wiederholt wurde.
Property QueueItem.ReviewStatus As String	Der Überprüfungsstatus des von Orchestrator abgerufenen Warteschlangenobjekts.
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.
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.
Property QueueItem.StartTransactionTime As Date?	Uhrzeit und Datum des Beginns der Transaktionsverarbeitung.
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. Fügen Sie der Sequenz eine Excel Prozess Scope-Aktivität hinzu.

3. Fügen Sie eine Aktivität Verwenden von Excel-Dateien hinzu und definieren Sie den Speicherort der Arbeitsmappe im Feld Excel-Datei der Aktivität.

4. Fügen Sie eine Aktivität Bereich lesen hinzu, um den gewünschten Wertebereich aus dem Bericht zu lesen und sie in einer DataTable-Variable 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 dem Designer-Bereich als Nächstes eine Aktivität Für jede Zeile in der Datentabelle hinzu und füllen Sie die leeren Felder mit „Zeile“ und dem Namen der Variable DataTable dt_DataTable1aus.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.
    • 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.

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

    

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

13. Gehen Sie zu https://cloud.uipath.com, melden Sie sich mit Ihren Anmeldeinformationen an und erstellen Sie dann die 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. Um den Prozess auszuführen, klicken Sie auf Design > Ausführen. :::note Beachten Sie, dass Warteschlangenelemente nach der Verarbeitung zu Transaktionen werden und als solche behandelt werden. :::

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 Aktivität Anwendung/Browser verwenden hinzu, um die Dummy-Anwendung des Drittanbieters zu öffnen.Verbinden Sie es 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 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 Eigenschaftenbereich im Feld Typ cint(TransItem.SpecificContent("OnUSCheck").ToString) < 5000ein.Der Ausdruck konvertiert den OnUSCheck-Wert in jeder QueueItem-Variable in eine String-Variable, die dann weiter in einen Integer konvertiert wird.Der so erhaltene Wert wird auf Einhaltung der Bedingung überprüft.

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

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:

    • Fügen Sie in der vorherigen Aktivität Try Catch eine Aktivität Use Application/Browser 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 nach den vorherigen Typ-Aktivitäten eine Get Text-Aktivität hinzu und wählen Sie im Optionsmenü die Option „Ziel auf dem Bildschirm angeben“ 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 mit den entsprechenden Verarbeitungsdetails anzeigen:

• Erfolgreiche Transaktion

  

• Fehlgeschlagene Transaktion

  

Beispiel herunterladen