Massenupload von Elementen 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.

Es gibt eine Reihe vordefinierter Spaltenüberschriften, die Sie beim Erstellen Ihrer CSV-Datei verwenden können, aber Sie können auch andere benutzerdefinierte Header verwenden. Nach dem erfolgreichen Hochladen der CSV-Datei werden die Informationen der Spalten mit vordefinierten Headern den Spalten zugeordnet, wie sie im Orchestrator gefunden wurden. Die Informationen in den Spalten mit benutzerdefinierten Headern werden im Abschnitt Spezifische Daten des entsprechenden Elements im Orchestrator platziert. Detaillierte Informationen zur Spaltenzuordnung finden Sie hier und ein Beispiel hier.

Hinweis:

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

Spaltenzuordnung

Dateispaltenüberschrift	Orchestrator-Feld
Referenz (Reference) Obligatorisch für Warteschlangen mit eindeutiger Referenz. Unterstützt alle Sonderzeichen, außer doppelte Anführungszeichen – ".	Referenz (Reference) Hinweis: Referenzen sind nicht kompatibel mit v2016.2 oder niedrigeren Versionen vom Orchestrator oder Robot.
Deadline Muss ggf. mit einem Datum in einem der folgenden Formate ausgefüllt werden: jjjj-MM-tt JJJJ/MM/TT JJJJ MM TT JJJJ-MM-TT HH:mm JJJJ/MM/TT HH:mm JJJJ MM TT HH:mm JJJJ-MM-TT HH:mm:ss JJJJ/MM/TT HH:mm:ss JJJJ MM TT HH:mm:ss	Deadline
Verschieben Muss ggf. mit einem Datum in einem der folgenden Formate ausgefüllt werden: jjjj-MM-tt JJJJ/MM/TT JJJJ MM TT JJJJ-MM-TT HH:mm JJJJ/MM/TT HH:mm JJJJ MM TT HH:mm JJJJ-MM-TT HH:mm:ss JJJJ/MM/TT HH:mm:ss JJJJ MM TT HH:mm:ss	Verschieben
Priorität Muss ggf. mit einem Datum in einem der folgenden Formate ausgefüllt werden: Low or 1 Normal or 2 Hoch oder 3 Wenn die Priorität nicht in der Datei angegeben ist, werden die Elemente per Standard mit hoher Priorität hochgeladen.	Priorität Jeweils den folgenden Werten zugeordnet: Niedrig Normal Hoch
[Custom_Name] Der Name darf nur aus alphanumerischen Zeichen bestehen: 0-9, a-z oder Unterstriche.	Spezielle Daten Zugeordnet im JSON-Format. Zum Beispiel: On-Us Check: 5540

Bitte beachten Sie, dass Sie in Ihrer Datei keine leeren Spaltenüberschriften haben dürfen.

Hinweis:

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.

Hochladestrategien

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.

Dynamische Eingabe ist eine neue Option, mit der Sie steuern können, wie der Orchestrator String-Werte in CSV-Dateien interpretiert, die zum Hochladen von Warteschlangenelementen verwendet werden.

Hinweis:

Numerische Daten müssen der Definition eines Dezimalliterals entsprechen. Numerische Werte größer als 2⁵³ bzw. kleiner als -2⁵³ werden nicht in Integer konvertiert, um die Genauigkeit beizubehalten. Stellen Sie sicher, dass Sie den Punkt als Dezimaltrennzeichen und das Komma als Tausendertrennzeichen verwenden.

Hochladen von Warteschlangenelementen mithilfe einer CSV-Datei

In diesem Abschnitt geht es um das Hinzufügen von Elementen zu einer Warteschlange mithilfe einer CSV-Datei vom Orchestrator.

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.

   Abbildung 1. Elemente hochladen

   

2. Wählen Sie Durchsuchen und dann die gewünschte CSV-Datei.

3. Wählen Sie Öffnen. Wenn Ihre Datei mit den unterstützten Formatierungsregeln übereinstimmt, ist die Hochladeoperation erfolgreich.

4. Wählen Sie die Hochladestrategie 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.

5. Aktivieren Sie das Kontrollkästchen Dynamische Eingabe, wenn der Orchestrator Stringzeichen 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 Eingabe. Lassen Sie die Auswahl deaktiviert, wenn Strings als Strings interpretiert werden sollen.

   Abbildung 2. Dynamische Eingabe

   

6. Klicken Sie auf Hochladen. Die Elemente werden gemäß der zuvor ausgewählten Strategie zu Ihrer Warteschlange hinzugefügt.

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

Nehmen wir an, Sie laden den Inhalt folgender CSV-Datei in eine Warteschlange hoch. Sie können eine solche Datei einfach erstellen, indem Sie die Daten zunächst in einer Excel-Datei ausfüllen und als CSV-Datei speichern.

Sie können auch eine CSV-Datei mit allen vorab ausgefüllten Spaltenüberschriften herunterladen und an Ihre Anforderungen anpassen.

Beachten Sie, dass diese Datei drei vordefinierte Spalten mit den gleichen Namen wie in Orchestrator (Verweis, Frist und Priorität, grün hervorgehoben) und zwei benutzerdefinierte Spalten (Kunde und Farbe, rot hervorgehoben) enthält.

Abbildung 3. CSV-Datei

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 wird jedes aus Ihrer Datei hochgeladene Element angezeigt. Die in den vordefinierten Spalten der Datei enthaltenen Informationen sind den Spalten mit den gleichen Namen in Orchestrator zugeordnet (Verweis, Frist und Priorität, grün hervorgehoben).

Abbildung 4. Seite Transaktionen

Die Informationen in den benutzerdefinierten Spalten sind im JSON-Format dem Abschnitt Spezifische Daten der einzelnen Elemente zugeordnet. Wählen Sie für das gewünschte Element Details anzeigen, um die Details zu überprüfen.

Abbildung 5. Registerkarte Details