Editoren

Die Konfigurationsoberfläche von Syncler stellt mehrere Editoren bereit, die eine sichere und schnelle Eingabe unterstützen.
Sie werden in der Regel über „Bearbeiten“-Schaltflächen direkt an den betreffenden Feldern geöffnet.

Editor für Filter

Der Filter-Editor wird für Lese- und Such-Filter verwendet. Er bietet eine Auswahl von Spalten und Operatoren, unterstützt Platzhalter, und stellt – falls der jeweilige Konnektor dies anbietet – konnektorspezifische Filterparameter auf einer eigenen Registerkarte bereit.

Einsatzbereiche

• Quellfilter in Syncs
• Zielsuche (Übereinstimmungsregel mit Platzhaltern aus den Quelldaten)
• Transformationen

Funktionen

• Spaltenauswahl: Einfügen des Feldnamens in die Filteranweisung.
• Operatoren: Vorschlagsliste (z. B. =, <>, LIKE, IN, >, >=, …).
  Hinweis: Nicht jeder Operator wird von jedem System unterstützt.
• Platzhalter: Werden zur Laufzeit ersetzt (s. u.).
  Der Editor erkennt Datentypen und setzt Textwerte automatisch in einfachen Hochkommas. In Spezialfällen können diese manuell entfernt werden.
• Konnektor-Parameter: Zusätzliche Filteroptionen (z. B. Parameter, Beziehungen), sofern vom Konnektor bereitgestellt.

Beispiele (als Text)

-- SQL-Beispiel (Datum via Platzhalter)
IsActive = 1

-- OData-Beispiel
startswith(Name,'A')

Best Practices

• Nur unterstützte Operatoren verwenden; Dokumentation des Konnektors beachten.
• Platzhalter testen (Vorschau/Simulation), insbesondere bei Datumsformaten.

Editor für Bedingungen und Formeln

Der Formel-Editor unterstützt Bedingungen (Boolean: wahr/falsch) und Formeln (berechnete Werte).
Beide greifen nicht direkt auf Systemdatenmengen zu, sondern werten Platzhalter aus dem aktuellen Datensatz aus.

Unterschiede

• Bedingung: Liefert True/False (z. B. „Vorbedingung für Neuanlage“, „Erfolgsbedingung“).
• Formel: Liefert Werte (z. B. Text, Zahl, Datum) zur Weiterverarbeitung.

Platzhalter-Notation

• In Formeln/Bedingungen werden Felder i. d. R. als #Feldname# referenziert (je nach Kontext).

Häufig genutzte Funktionen (Auswahl)

• IIF(<Bedingung>, <WertWennWahr>, <WertWennFalsch>)
• LEN(<Text>), TRIM(<Text>)
• ISNULL(<Wert>, <Ersatz>)
• Datumsformatierung/-arithmetik in Kombination mit Transformationsschritten (z. B. „Datum & Uhrzeit“, „Typ formatieren“)

Beispiel (als Text)

IIF(#Status# = 'Active', 'SYNC', 'SKIP')

Prüfung

• Über „Prüfen“ wird der Ausdruck gegen Beispieldaten ausgewertet.
  Syntax-fehler werden frühzeitig erkannt.

Editor für reguläre Ausdrücke

Im Transformationsschritt „Suchen / Trennen mit regulärem Ausdruck“ ermöglicht der Regex-Editor die Eingabe, Validierung und Auswahl vordefinierter Muster.

Funktionen

• Katalog gebräuchlicher Ausdrücke (übernehmbar)
• Syntax-Prüfung des eingegebenen Musters

Muster-Beispiele (als Text)

-- E-Mail (vereinfacht)
^[^\s@]+@[^\s@]+\.[^\s@]+$

-- Telefonnummer (einfach)
^\+?[0-9\s\-/()]{6,}$

-- PLZ DE (5-stellig)
^\d{5}$

Tipp: Nutzen Sie Gruppen (...), um Teile (z. B. Vorwahl, Nummer) gezielt in neue Spalten zu übernehmen.

Editor für Schlüssel-Wert-Paare

Der Key-Value-Editor dient zur Definition von Listen aus Feldname → Wert.
Er wird u. a. beim Zurückschreiben oder in Abläufen verwendet.

Eigenschaften

• Schlüssel: Zielfeld (per Auswahl wählbar)
• Wert: statischer Text oder Platzhalter (Quelle abhängig vom Kontext, z. B. Zieldaten)

Beispiele (als Text)

Ziel.CustomerNo = ##Target.CustomerNo##
Ziel.SyncFlag   = ONE_TIME
Ziel.OwnerId    = ##Source.AccountManagerId##

Editor für Werte-Liste

Mit dem Werte-Listen-Editor können einfache Listen (z. B. CSV-artig) gepflegt werden – etwa für Feldlisten oder Tabellenlisten.

Einsatz

• Konnektor-Optionen
• Abfrage-Syncs (ID-Listen)

Editor für tabellarische Daten

In einigen Konnektoren (z. B. Datenbank) können Eingaben tabellarisch erfolgen – etwa Tabellendefinitionen oder Konfigurationsraster.

Funktionen

• Zeilen hinzufügen/entfernen