Eingabe: Felder oder JSON

Operationen, die etwas anlegen oder ändern, brauchen einen Datensatz. Die Node bietet dafür zwei Wege, umschaltbar über einen Schalter im Dialog:

JSON-Eingabe nutzen aus → Sie füllen einzelne Felder aus. JSON-Eingabe nutzen ein → Sie übergeben den kompletten Datensatz als JSON.

Wann welche Variante?

	Einzelfelder	JSON
Einstieg	einfach, alles sichtbar	Struktur muss bekannt sein
Feldauswahl	die gebräuchlichen	alle, auch verschachtelte
Werte aus vorherigen Nodes	je Feld ein Ausdruck	ein Ausdruck für alles
Übersicht bei vielen Feldern	wird schnell lang	kompakt

Faustregel: Fangen Sie mit den Einzelfeldern an. Wechseln Sie auf JSON, sobald Sie ein Feld brauchen, das dort nicht angeboten wird, oder wenn die Daten ohnehin schon als Objekt aus einem Vorsystem kommen.

Variante 1: Einzelfelder

Die gebräuchlichen Felder stehen direkt im Dialog, oft ergänzt um einen Abschnitt Zusätzliche Felder für die selteneren. Jedes Feld nimmt einen festen Wert oder einen Ausdruck:

Firma:         {{ $json.company }}
Straße:        {{ $json.address.street }}
Postleitzahl:  {{ $json.address.zip }}

Nicht ausgefüllte Felder werden nicht mitgeschickt — SelectLine setzt dann seine eigenen Vorgaben ein.

Variante 2: JSON

Schalten Sie JSON-Eingabe nutzen ein, erscheint ein Textfeld, das bereits ein Gerüst mit den erwarteten Feldern enthält. Dieses Gerüst ist eine Vorlage: Passen Sie es an und löschen Sie, was Sie nicht brauchen.

{
  "Company": "Musterfirma GmbH",
  "Address": {
    "Street": "Musterweg 1",
    "ZipCode": "12345",
    "City": "Musterstadt"
  }
}

Die Feldnamen sind die der SelectLine-API — englisch und in Großschreibung, auch wenn die Oberfläche deutsch ist.

Das ganze Objekt aus einer vorherigen Node

Der eigentliche Vorteil der JSON-Variante: Der komplette Datensatz kann aus einem einzigen Ausdruck kommen.

{{ JSON.stringify($json.kunde) }}

Das ist der übliche Weg, wenn eine vorgelagerte Node (Shop, CRM, Tabelle) die Daten schon in der richtigen Form liefert oder Sie sie mit einer Code-Node passend umgebaut haben.

Anlegen und Ändern unterscheiden

Anlegen erzeugt einen neuen Datensatz. Die Nummer vergibt in der Regel SelectLine.
Aktualisieren braucht immer die Nummer bzw. den Schlüssel des vorhandenen Datensatzes in einem eigenen Feld — der Datensatz muss existieren.

Beim Aktualisieren übertragen Sie sinnvollerweise nur die Felder, die sich ändern sollen.

Prüfen, was tatsächlich ankommt

Nach dem Anlegen oder Ändern liefert die Operation den gespeicherten Datensatz zurück. Schauen Sie in der Ergebnisansicht unter JSON nach, ob alle Werte so übernommen wurden wie gedacht. Fehlende Werte deuten fast immer auf einen abweichend geschriebenen Feldnamen hin.