Zusammenführen

Interne ID: agorum.array.concat

Sie können mit diesem Knoten mehrere Arrays mit Objekten zu einem kompletten Array zusammenfassen. Handelt es sich bei den übergebenen Objekten nicht um Arrays, wandelt das System diese Objekte automatisch in Arrays um.

Verhaltensweise

---

Erreicht das System den Knoten im Workflow, prüft das System die gesetzten Eingangsvariablen und die dort enthaltenen Objekte. Anschließend verarbeitet das System die Objekte und fügt diese zu einem kompletten Array zusammen. Dieses Array liegt anschließend in der angegebenen Ausgangsvariable vor und kann von weiteren Knoten verarbeitet werden.

Anwendung

---

Beispiel 1

Sie möchten Objekte, die in mehreren Ergebnisvariablen enthalten sind, alle gleich behandeln. Sie möchten etwa, dass alle Objekte in den gleichen Ordner abgelegt werden. Alle Objekte müssen daher in einer Variable vorhanden sein, hier also in der Ausgangsvariable.

Beispiel 2

In einer Variable ist kein Array mit Objekten vorhanden, sondern nur ein einzelnes Objekt oder sogar gar kein Wert. Mit diesem Knoten kann dieser Wert initialisiert und in ein Array kopiert werden.

Sollen etwa durch den Knoten Iterieren mehrere Ergebnisse nacheinander zusammengefügt werden, so geben Sie etwa Folgendes an:

• Eingangsvariablen:
  • result_unwrapped
  • unwrapped_1
• Ausgangsvariable:
  • result_unwrapped

Die Ausgangsvariable result_unwrapped enthält dabei immer das komplette Ergebnis der Eingangsvariable unwrapped_1 des aktuellen Durchlaufs. Mit der Ausgangsvariable result_unwrapped können Sie somit eine Ablage o. Ä. realisieren und es werden alle entpackten Dateien berücksichtigt.

Endpoints

---

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	ja, beliebig viele
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

---

Parameter	Beschreibung	Beispiel
Eingangsvariablen (Arrays): Angabe von mehreren Eingangsobjekten	Definiert, von welchen Variablen die Objekt-Arrays geladen werden. Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments. Pro Zeile können Sie eine Variable angeben.	Eingangsvariable
Ausgangsvariable für das Ergebnis (Objekt-Array)	Definiert, in welche Variable das Ergebnis als komplettes Array geschrieben wird. Der Aufbau einer Ausgangsvariable ist identisch zu dem Aufbau einer Eingangsvariable.	–

Eingangsvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ausgangsvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Beispiel 1 (einfach)

Dem Knoten werden über die Eingangsvariablen insgesamt drei Variablen übergeben. Die drei Variablen geben Sie pro Zeile an:

Diese drei Eingangsvariablen werden in folgender Ausgangsvariable zusammengefasst:

Das System stellt die drei Eingangsvariablen in der angegebenen Ausgangsvariable als Array dar.

Beispiel 2 (komplexer)

Der erste Knoten Iterieren (Name: jedesElement) nimmt die Anhänge eines anderen Knoten entgegen (da die Eingangsvariable nicht gefüllt ist) und führt diese in der Ausgangsvariable aktuelle_datei weiter:

Der zweite Knoten Entpacken (Name: entpacken) nimmt diese Datei in der Eingangsvariable aktuelle_datei entgegen und entpackt das dort enthaltene ZIP-Archiv. Die entpackte Datei (das Ergebnis) speichert das System in die Ausgangsvariable entpacktes_ergebnis:

Der dritte Knoten Zusammenführen (Name: zusammenfuehren) nimmt die Eingangsvariable entpacktes_ergebnis entgegen. Da anschließend das gleiche Prozedere für jede andere Datei durch den Knoten Iterieren wiederholt wird, wird eine weitere Eingangsvariable benötigt: die angegebene Ausgangsvariable komplettes_ergebnis: