Zum Hauptinhalt springen

Sammlung erstellen

Nutze den Schritt Sammlung erstellen, um eine benannte Sammlung zu initialisieren, die nachfolgende Schritte befüllen können. Der Schritt selbst erzeugt eine leere Sammlung — kombiniere ihn mit einem oder mehreren Zur Sammlung hinzufügen-Schritten, um die Sammlung während der Ausführung aufzubauen.

Typische Einsatzszenarien sind:

  • Mehrere Datensatzverweise (z. B. ausgewählte Debitoren) für eine spätere Stapelverarbeitung im Flow sammeln.
  • Berechnete Werte über eine Schleife hinweg sammeln, damit ein späterer Schritt sie als Liste verwenden kann.
  • Eine dynamische Payload für einen HTTP-Anfrage- oder E-Mail-Schritt vorbereiten.

Schritt konfigurieren​

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

Beschreibung​

  • Zweck: Erklärt, wofür die Sammlung in diesem Flow verwendet wird.
  • Wann ausfüllen: Immer. Die Beschreibung wird im Editor und in der Ausführungshistorie angezeigt.
  • Tipp: Nenne den geschäftlichen Zweck, zum Beispiel Rechnungsreferenzen für E-Mail-Anhang sammeln.

Sammlungsname​

  • Zweck: Der eindeutige Bezeichner für die Sammlung innerhalb des Flows.
  • Wann ausfüllen: Verpflichtend. Nachfolgende „Zur Sammlung hinzufügen"-Schritte verweisen über diesen Namen auf die Sammlung.
  • Tipp: Verwende einen kurzen, aussagekräftigen Namen wie debitoren oder rechnungszeilen.

Sammlungstyp​

  • Zweck: Legt fest, welche Art von Elementen die Sammlung enthält.
  • Wann ausfüllen: Verpflichtend.
  • Optionen:
    • Wert — die Sammlung speichert Textwerte.
    • Referenz — die Sammlung speichert Datensatzverweise (Zeiger auf Business-Central-Tabellendatensätze).

Tabelle​

  • Zweck: Gibt an, auf welche Business-Central-Tabelle die Referenzen verweisen.
  • Wann ausfüllen: Verpflichtend, wenn der Sammlungstyp Referenz ist. Andernfalls ausgeblendet.
  • Tipp: Nutze die Suche, um die Zieltabelle auszuwählen (z. B. Debitor, Verkaufskopf).

Ausgaben​

Der Schritt registriert eine Ausgabe, auf die nachfolgende Schritte verweisen können:

  • <Sammlungsname> — typisiert als Wert oder Referenz je nach konfiguriertem Sammlungstyp. Bei Referenz-Sammlungen enthält die Ausgabe zusätzlich die Zieltabellennummer.
hinweis

Beim Ausführen des Flows schreibt der Schritt „Sammlung erstellen" keine Daten. Die Sammlung wird physisch erst erstellt, wenn das erste Element durch einen „Zur Sammlung hinzufügen"-Schritt hinzugefügt wird – bis dahin existiert die Sammlung im Ausführungskontext nicht. Die Ausgabe wird zur Entwurfszeit registriert, damit nachfolgende Schritte darauf verweisen können.

Liest ein nachgelagerter Schritt die Sammlung, bevor ein „Zur Sammlung hinzufügen"-Schritt ausgeführt wurde, sieht er das Feld als nicht vorhanden. Schalte solche Schritte hinter die Schleife, die die Sammlung befüllt, oder behandle den Fehlfall im Konsumenten.

Best Practices​

  • Sammlungen klar benennen: Andere Schritte referenzieren die Sammlung über den Namen — ein aussagekräftiger Name vermeidet Verwechslungen in komplexen Flows.
  • Mit „Zur Sammlung hinzufügen" kombinieren: Ein „Sammlung erstellen"-Schritt ohne mindestens einen „Zur Sammlung hinzufügen"-Schritt hat beim Ausführen keine Wirkung.
  • Typen konsistent halten: Lege den Sammlungstyp von Anfang an fest. Eine einzelne Sammlung kann nicht gleichzeitig Werte und Referenzen enthalten.