Transaktionsobjekt erhalten (Get Transaction Item)

UiPath.Core.Activities.GetQueueItem

Beschreibung

Ruft ein Element aus der Orchestrator-Warteschlange ab, damit Sie es verarbeiten (starten) können und legt den Status auf In Bearbeitung fest. Wenn seine Verarbeitung gestartet wird, wird er zu einer Transaktion.

Bitte beachten Sie, dass die Roboterrolle über Berechtigungen zum Bearbeiten von Warteschlangen verfügen muss, um diese Aktivität auszuführen. Die Aktivität läuft unter dem Roboter, der sie ausführt.

Wenn die Warteschlange leer ist, wird der folgende Fehler beim Zugreifen auf das abgerufene TransactionItem ausgegeben: System.Exception: Object reference not set to an instance of an object.

Projektkompatibilität

Windows - Legacy | Windows | Plattformübergreifend

Plattformübergreifend, Windows-Konfiguration

• Orchestrator-Ordnerpfad – Der Pfad des Ordners, in dem sich die angegebene Warteschlange befindet, falls er sich vom Ordner unterscheidet, in dem der Prozess ausgeführt wird. Dieses Feld unterstützt nur String-Werte mit / als Trennzeichen zur Angabe von Unterordnern. Beispiel: "Finance/Accounts Payable".
  Hinweis:

  Der Orchestrator FolderPath -Parameter funktioniert nicht für Prozesse, die von Robotern in klassischen Ordnern ausgeführt werden. Nur Roboter in modernen Ordnern können Daten außerhalb ihres Ordners übergeben. Relative Ordnerpfade werden in einem X-UIPATH-FolderPath-Encoded -Header wie folgt unterstützt:

  • Pfad, der mit / beginnt – Beginnt im root-Ordner der Struktur, zu welcher der Umgebungsordner gehört.
  • Pfad, der mit / beginnt – Beginnt im root-Ordner der Struktur, zu welcher der Umgebungsordner gehört.
  • Pfad, der mit . beginnt – Beginnt im Umgebungsordner.
  • Pfad, der mit .. beginnt – Beginnt eine Ebene höher in der Hierarchie des Umgebungsordners für jedes .. im Pfad (z. B ../ für eine Ebene höher, ../../ für zwei Ebenen höher in der Hierarchie). Nachgestellte Schrägstriche werden nicht akzeptiert.
• Warteschlangenname – Die Warteschlange, der das QueueItem -Objekt hinzugefügt werden soll. Beim Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, also wenn er im Orchestrator als „MeineErsteWarteschlange“ festgelegt wurde, ist er mit „meineerstewarteschlange“ übereinstimmend. Um die Warteschlangen in Ihren Orchestrator-Ordnern zu verwalten, wählen Sie Warteschlangen verwalten aus.

¹Für plattformübergreifende Projekte, die in Studio Web als Teil einer Lösung erstellt wurden, ist das Feld Orchestrator-Ordnerpfad nicht verfügbar.

²Für plattformübergreifende Projekte, die in Studio Web als Teil einer Lösung erstellt wurden, bietet das Namensfeld Optionen zum Definieren neuer Orchestrator-Ressourcen, wie z. B. Warteschlangen, Assets oder Speicher-Buckets, während der Entwurfszeit oder zum Öffnen des Orchestrators für die Ressourcenverwaltung.

Erweiterte Optionen

Optionen

• FilterStrategie (FilterStrategy) - Die beim Filtern nach Referenzen zu verwendende Strategie. Folgende Optionen sind verfügbar:
  • BeginnenMit (StartWith) - Sucht nach Elementen, deren Referenzen mit dem angegebenem Wert im Feld Referenz (Reference) beginnen.
  • Übereinstimmungen (Equals) - Sucht nach Elementen, dessen Referenzen mit dem angegebenem Wert im Feld Referenz (Reference) übereinstimmen.
• Referenz (Reference) - Filtert Elemente entsprechend ihrer Referenz.
• Timeout (Millisekunden) (Timeout (milliseconds)) - Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).
• Bei Fehler fortsetzen – Gibt an, ob die Automatisierung fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (true, false). Der Standardwert ist „false“. Wenn das Feld also nicht konfiguriert ist und ein Fehler auftritt, wird die Ausführung des Projekts angehalten. Wenn der Wert auf „true“ gesetzt ist, wird die Ausführung des Projekts unabhängig von einem Fehler fortgesetzt.

Ausgabe

• Transaktionselement – Das abgerufene Transaktionsobjekt, das in einer QueueItem-Variablen gespeichert wird.
• Spezifische Daten – Diese Eigenschaft wird für Warteschlangen verfügbar, die eine Schemadefinition haben. Ermöglicht Ihnen den Zugriff auf die Eigenschaften über das Schema für den spezifischen Inhalt der Warteschlange. Wenn eine neue Schemaversion auf die Warteschlange angewendet wurde, klicken Sie auf Aktualisieren , um die neuesten Änderungen abzurufen.

Windows – Legacy-Konfiguration

Eigenschaften-Panel

Optionen

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• Timeout (Millisekunden) (Timeout (milliseconds)) - Gibt an, wie lange (in Millisekunden) die Aktivität laufen muss, bevor ein Fehler ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

Eingabe

• Warteschlangenname – Die Warteschlange, der das QueueItem-Objekt hinzugefügt werden soll. Beim Namen wird die Groß-/Kleinschreibung nicht berücksichtigt, also wenn er im Orchestrator als „MeineErsteWarteschlange“ festgelegt wurde, wird auch „meineerstewarteschlange“ gefunden.

Sonstiges

• Ordnerpfad – Der Pfad des Ordners, in dem sich die angegebene Warteschlange befindet, falls sie sich vom Ordner unterscheidet, in dem der Prozess ausgeführt wird. Dieses Feld unterstützt nur String-Werte mit / als Trennzeichen zur Angabe von Unterordnern. Beispiel: "Finance/Accounts Payable".
  Hinweis:

  Der FolderPath -Parameter funktioniert nicht für Prozesse, die von Robotern in klassischen Ordnern ausgeführt werden. Nur Roboter in modernen Ordnern können Daten außerhalb ihres Ordners übergeben. Relative Ordnerpfade werden in einem X-UIPATH-FolderPath-Encoded -Header wie folgt unterstützt:

  • Pfad, der mit / beginnt – Beginnt im root-Ordner der Struktur, zu welcher der Umgebungsordner gehört.
  • Pfad, der mit . beginnt – Beginnt im Umgebungsordner.
  • Pfad, der mit .. beginnt – Beginnt eine Ebene höher in der Hierarchie des Umgebungsordners für jedes .. im Pfad (z. B ../ für eine Ebene höher, ../../ für zwei Ebenen höher in der Hierarchie). Nachgestellte Schrägstriche werden nicht akzeptiert.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Transaktionselement – Das abgerufene Transaktionsobjekt, das in einer QueueItem-Variablen gespeichert wird.

Referenz (Reference)

• FilterStrategie (FilterStrategy) - Die beim Filtern nach Referenzen zu verwendende Strategie. Folgende Optionen sind verfügbar:
  • BeginnenMit (StartWith) - Sucht nach Elementen, deren Referenzen mit dem angegebenem Wert im Feld Referenz (Reference) beginnen.
  • Übereinstimmungen (Equals) - Sucht nach Elementen, dessen Referenzen mit dem angegebenem Wert im Feld Referenz (Reference) übereinstimmen.
• Referenz - Filtert Elemente entsprechend ihrer Referenz. Der Ausdruck darf nicht länger als 128 Zeichen und nicht das einfache Anführungszeichen ' enthalten.