Abonnieren

UiPath Orchestrator

Die UiPath-Orchestrator-Anleitung

Massenupload von Warteschlangenelementen mithilfe einer CSV-Datei

Mit dieser Funktion können Sie Warteschlangenelemente per Massenupload in eine bestimmte Warteschlange im Orchestrator mithilfe einer CSV-Datei hochladen. Laden Sie dazu zuerst Ihre Datei in Ihre Orchestrator-Instanz für eine bestimmte Warteschlange hoch. Nachdem die Datei erfolgreich verarbeitet wurde, werden die enthaltenen Elemente gemäß der ausgewählten Strategie in die Warteschlange hochgeladen. Bitte beachten Sie, dass die Datei zuvor mit vordefinierten Formaten ausgefüllt werden muss, damit der Upload-Vorgang erfolgreich ist.

There is a series of predefined column headers that you can use when building your CSV file, but you can also use other custom headers. After successfully uploading the CSV file, information contained in columns with predefined headers is mapped to columns as found in Orchestrator. Information contained in columns with custom headers is placed under the Specific Data section of the corresponding item in Orchestrator. See detailed information about column mapping here and an example here.

📘

Hinweis

Das Hochladen ist auf 15.000 Elemente pro Datei begrenzt. Sie können den Grenzwert mithilfe der Upload.Queues.MaxNumberOfItems-App-Einstellung verringern.

Spaltenzuordnung


File Column HeaderOrchestrator Field
Reference
Mandatory for unique reference queues.
It supports all special characters, except double quotes - ".
Reference
Note: References are not compatible with v2016.2 or lower versions of Orchestrator or Robot.
Deadline
Must be populated with a date in one of the following formats:
YYYY-MM-DD
YYYY/MM/DD
YYYY MM DD
YYYY-MM-DD HH:mm
YYYY/MM/DD HH:mm
YYYY MM DD HH:mm
YYYY-MM-DD HH:mm:ss
YYYY/MM/DD HH:mm:ss
YYYY MM DD HH:mm:ss
Deadline
Postpone
Must be populated with a date in one of the following formats:
YYYY-MM-DD
YYYY/MM/DD
YYYY MM DD
YYYY-MM-DD HH:mm
YYYY/MM/DD HH:mm
YYYY MM DD HH:mm
YYYY-MM-DD HH:mm:ss
YYYY/MM/DD HH:mm:ss
YYYY MM DD HH:mm:ss
Postpone
Priority
Must be populated with one of the following values:
Low or 1
Normal or 2
High or 3
If the priority is not specified in the file, the items are uploaded with a high priority, by default.
Priority
Mapped to the following values, respectively:
Low
Normal
High
[Custom_Name]
The name can only be made of alphanumeric characters: 0-9, a-z, or underscores.
Specific Data
Mapped in JSON format.
For example:
On-Us Check: 5540

Please note that you cannot have empty column headers in your file. More details about field descriptions are available here.

📘

Wichtig!

Bei den vordefinierten Spaltenüberschriften muss die Groß-/Kleinschreibung beachtet werden. Beachten Sie die obigen Zuordnungsregeln. Eine Spalte in Ihrer CSV-Datei mit dem Namen reference wird dem Abschnitt „ Spezifische Daten “ anstelle der Spalte „ Referenz “ zugeordnet.

Upload-Strategien


Es gibt zwei Strategien zur Durchführung der Hochladeoperation:

  • ProcessAllIndependently (ProcessAllIndependently) – Verarbeitet alle Elemente einzeln und fügt sie bei Erfolg der Warteschlange hinzu. Wenn nicht, wird eine Liste derjenigen zurückgegeben, deren Verarbeitung fehlgeschlagen ist. Sie haben die Möglichkeit, die Liste in eine CSV-Datei herunterzuladen, die mit denselben Feldern gefüllt ist wie in der ursprünglich hochgeladenen Datei.
  • AllOrNothing – Fügt die Elemente nur dann hinzu, wenn alle von ihnen erfolgreich bearbeitet wurden. Andernfalls wird keines hinzugefügt.

Dynamische Eingabe


Beim Hochladen von Warteschlangenelementen in Warteschlangen mit Schemadefinitionen muss der Orchestrator String-Zeichen als Integer oder Boolean interpretieren, um die Schemadefinition zu erfüllen.
Die dynamische Typisierung ist eine Option, mit der Sie steuern können, wie der Orchestrator den Zeichenfolgenwert innerhalb der CSV-Datei analysiert Dateien, die zum Hochladen von Warteschlangenelementen verwendet werden.

Numeric data must conform to the definition of a decimal literal. Numerical values greater than 253 or less than -253 are not converted to Integer to preserve precision. Make sure to use the dot as a decimal separator and the comma as a thousand separator.

Hochladen von Warteschlangenelementen mithilfe einer CSV-Datei


This section concerns adding items to a queue using a CSV file from Orchestrator. For details on how to add items through automation projects aka workflow design in Studio, see Managing queues in Studio.

  1. Klicken Sie auf der Seite Warteschlangen auf die entsprechende Schaltfläche Weitere Aktionen für die gewünschte Warteschlange und dann auf Elemente hochladen . Das Fenster Elemente hochladen wird angezeigt.
655
  1. Klicken Sie auf Durchsuchen und wählen Sie die gewünschte CSV-Datei aus.

📘

Hinweis

Sie können die CSV-Transaktionsdatei nicht verwenden, um Elemente in eine Warteschlange hochzuladen.

  1. Klicken Sie auf Öffnen . Wenn Ihre Datei den unterstützten Formatierungsregeln entspricht, ist der Uploadvorgang erfolgreich.
  2. Wählen Sie die Upload-Strategie aus :
    • Alle unabhängig verarbeiten – Verarbeitet alle Elemente einzeln und fügt sie der Warteschlange hinzu, wenn sie erfolgreich sind. Wenn nicht, wird eine Liste derjenigen zurückgegeben, deren Verarbeitung fehlgeschlagen ist. Sie haben die Möglichkeit, die Liste in eine CSV-Datei herunterzuladen, die mit denselben Feldern gefüllt ist wie in der ursprünglich hochgeladenen Datei
    • Alle oder nichts – Fügt die Elemente nur hinzu, wenn alle erfolgreich verarbeitet wurden. Andernfalls werden keine hinzugefügt.
  3. Aktivieren Sie das Kontrollkästchen Dynamische Eingabe , wenn der Orchestrator Zeichenfolgenzeichen in den CSV-Dateien als Integer oder Boolean interpretieren soll. Dies wird beim Hochladen von Warteschlangenelementen in Warteschlangen mit Schemadefinitionen empfohlen, wenn dies mit der Schemadefinition übereinstimmen muss. Lesen Sie mehr über dynamische Typisierung . Lassen Sie die Auswahl deaktiviert, wenn Zeichenfolgen als Zeichenfolgen interpretiert werden sollen.
638
  1. Klicken Sie auf Hochladen. Die Elemente werden gemäß der zuvor ausgewählten Strategie zu Ihrer Warteschlange hinzugefügt.
  2. Wenn Sie die Option Alle unabhängig verarbeiten verwendet haben und unverarbeitete Elemente vorhanden sind, wird die Schaltfläche Hochladen zu Herunterladen und ermöglicht Ihnen das Herunterladen einer CSV-Datei mit den unverarbeiteten Elementen.

Beispiel


Angenommen, Sie laden den Inhalt der folgenden CSV-Datei in eine Warteschlange hoch. Eine einfache Möglichkeit, eine solche Datei zu erstellen, besteht darin, die Daten in eine Excel-Datei zu füllen und sie als CSV-Datei zu speichern:  

1605

Or you can download a CSV file with all the pre-filled column headers and customize it to your needs.

Beachten Sie, dass diese Datei 3 vordefinierte Spalten mit demselben Namen wie im Orchestrator ( Reference , Deadline und Priority , grün hervorgehoben) und 2 benutzerdefinierte Spalten ( Customer und Color , rot hervorgehoben) enthält.

533
  1. Klicken Sie für die gewünschte Warteschlange auf Elemente hochladen, und wählen Sie die CSV-Datei aus. Der Orchestrator analysiert die Datei, um zu bestätigen, dass sie die Formatierungsregeln erfüllt.
  2. Wählen Sie die gewünschte Hochladestrategie aus und klicken Sie auf Hochladen, um den Vorgang abzuschließen.
  3. Wählen Sie Weitere Aktionen > Transaktionen anzeigen, um die hochgeladenen Warteschlangenelemente anzuzeigen.

Auf der Seite Transaktionen werden alle Elemente angezeigt, die aus Ihrer Datei hochgeladen wurden. Die in den vordefinierten Spalten der Datei enthaltenen Informationen werden den Spalten mit dem gleichen Namen im Orchestrator zugeordnet (Referenz, Frist und Priorität, mit grüner Hervorhebung):

1251

Die Informationen in den benutzerdefinierten Spalten werden im JSON-Format dem Abschnitt Spezifische Daten jedes Elements zugeordnet. Klicken Sie auf Details anzeigen für das gewünschte Element, um es anzuzeigen:

898

Vor etwa einem Monat aktualisiert


Massenupload von Warteschlangenelementen mithilfe einer CSV-Datei


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.