Zur Sammlung hinzufügen

Nutze den Schritt Zur Sammlung hinzufügen, um ein Element an eine Sammlung anzuhängen, die zuvor durch einen Sammlung erstellen-Schritt im Flow angelegt wurde. Jede Ausführung von „Zur Sammlung hinzufügen" fügt genau einen Eintrag hinzu; platziere den Schritt in einer Schleife oder verwende mehrere Instanzen, um die Sammlung schrittweise aufzubauen.

Typische Einsatzszenarien sind:

• Einen Datensatzverweis aus einem vorherigen Schritt an eine Sammlung für spätere Stapelverarbeitung anhängen.
• Eine Liste formatierter Textwerte aufbauen, die später zu einem E-Mail-Text oder einer API-Payload zusammengesetzt wird.
• Ergebnisse aus mehreren Verzweigungen eines Flows in einer einzigen Sammlung sammeln.

Schritt konfigurieren

Öffne den Flow-Editor, füge Zur Sammlung hinzufügen hinzu und fülle die Konfigurationskarte aus.

Beschreibung

• Zweck: Erklärt, was dieser Hinzufügen-Schritt im Flow bewirkt.
• Wann ausfüllen: Immer. Die Beschreibung wird im Editor und in der Ausführungshistorie angezeigt.
• Tipp: Sei konkret, zum Beispiel Gefundenen Debitor zu Empfängern hinzufügen.

Sammlung

• Zweck: Wählt aus, an welche Sammlung angehängt werden soll. Muss ein SmartField-Platzhalter sein, der auf die Ausgabe eines „Sammlung erstellen"-Schritts zeigt (z. B. {{create-coll_test}}).
• Wann ausfüllen: Verpflichtend. Der Selektor darf keinen Punktpfad verwenden – Sammlungen sind immer Ausgaben auf oberster Ebene eines „Sammlung erstellen"-Schritts.
• Tipp: Nutze die Eingabehilfe (...) oder Alt+S, um den SmartField-Picker zu öffnen, und füge den Platzhalter unverändert ein.

Aufgelöster Typ

• Zweck: Schreibgeschützt. Zeigt den Elementtyp und (bei Referenz-Sammlungen) die verknüpfte Tabelle, die AutoFlow aus dem Sammlung-Platzhalter abgeleitet hat. Verwende ihn als Plausibilitätscheck, bevor du den Wert konfigurierst.
• Wann ausfüllen: Wird automatisch abgeleitet. Ist das Feld leer oder zeigt eine Warnung, lässt sich der Sammlung-Platzhalter nicht auflösen.

Wert

• Zweck: Das anzuhängende Element. Die erwartete Form hängt vom aufgelösten Sammlungstyp ab:
  • Wert-Sammlung — beliebiger Text. Unterstützt {{name}}-Platzhalter, die beim Ausführen des Schritts aufgelöst werden, sodass du Literaltext und SmartField-Verweise mischen kannst (z. B. Debitor {{customer.No}} – {{customer.Name}}).
  • Referenz-Sammlung — ein einzelner SmartField-Platzhalter, der auf ein Referenz-SmartField verweist, das auf dieselbe Tabelle wie die Sammlung verweist (z. B. {{find-records-in_results}} für eine Verkaufskopf-Sammlung, wenn FindRecords für Tabelle 36 konfiguriert ist).
• Wann ausfüllen: Verpflichtend.
• Tipp: Nutze die Eingabehilfe (...) oder Alt+S, um den SmartField-Picker zu öffnen. Die Konfigurationskarte warnt, wenn sich der Platzhalter nicht auflösen lässt, einen falschen Typ liefert (Wert statt Referenz oder umgekehrt) oder wenn die verknüpfte Tabelle nicht zur Sammlung passt.

Ausgaben

„Zur Sammlung hinzufügen" erzeugt keine eigenen Ausgaben. Der Schritt hängt Daten an die Sammlung an, die vom zugehörigen „Sammlung erstellen"-Schritt erzeugt wurde. Nachfolgende Schritte sollten auf die Ausgabe des „Sammlung erstellen"-Schritts verweisen, um auf die vollständige Sammlung zuzugreifen.

Best Practices

• Verlasse dich auf den aufgelösten Typ: AutoFlow leitet den Elementtyp aus dem Sammlung-Platzhalter ab. Versuche nicht, Werttext in eine Referenz-Sammlung einzufügen — die Konfigurationskarte zeigt eine Warnung an und der Flow lässt sich nicht veröffentlichen.
• Reihenfolge beachten: Elemente werden in der Ausführungsreihenfolge sequenziell indiziert (0, 1, 2, …). Gestalte deinen Flow entsprechend, wenn die Reihenfolge wichtig ist.
• In Schleifen verwenden: Wenn du eine Menge von Datensätzen verarbeitest, platziere „Zur Sammlung hinzufügen" im Schleifenkörper, um jedes Ergebnis automatisch zu sammeln.