Synchronisiere einen Datensatz
Mit dem Schritt Synchronisiere einen Datensatz wird genau ein Datensatz einer Liste aus einem JSON-Objekt angelegt oder aktualisiert. Typischerweise ist das ein Datensatz, der über die REST-API V2 aus einem anderen Arbeitsbereich geladen wurde. Es kann aber jedes JSON verwendet werden, dessen Schlüssel den technischen Namen der Bausteine in der Ziel-Liste entsprechen.
Die Schlüssel im JSON werden automatisch den technischen Namen der Ziel-Liste zugeordnet. Eine manuelle Zuordnung einzelner Bausteine ist nicht nötig. Die Bausteinwerte des synchronisierten Datensatzes sind in folgenden Schritten über den technischen Namen des Schritts zugreifbar, wie bei Wähle Datensatz.
In den meisten Fällen sollte die Ziel-Liste einen eigenen Textfeld-Baustein für die Fremd-ID haben. Da Univelop Datensatz-IDs selbst vergibt und eine Kopie nie die ID ihres Originals tragen kann, speichert dieser Baustein die ID des Originals, damit der Schritt bei jedem weiteren Durchlauf denselben Datensatz wiederfindet (siehe Zuordnen über Fremd-ID).
Unterstützte Bausteine
| Wird synchronisiert | Wird nicht synchronisiert |
|---|---|
| Textfeld, Nummer, E-Mail, Telefon | Unterschrift, Zeichnung, Zeichnungsanmerkungen |
| Datum, Datumsspanne, Zeitspanne | PDF-Formular, PDF-Ausdruck |
| Abmessungen, Schalter, Farbauswahl | Editor (Rich Text) |
| Drop-Down, Mehrfach-Auswahl, Segmente, Status | Kommentare, Änderungsverlauf, Tabelle |
| Adresse, GPS Position | Buttons (z. B. Workflow-Button, Status Button) |
| Datensatz, Datensätze | Formelbausteine (berechnete Werte) |
| Laufende Nummer, Checkliste | Systemwerte (z. B. Erstellt am, Erstellt von) |
| Datei Upload und Bild Upload inklusive Dateien |
Bei Datei Upload und Bild Upload werden die Dateien selbst übertragen:
- Neue und geänderte Dateien werden hochgeladen.
- Unveränderte Dateien werden am Hash erkannt und nicht erneut übertragen.
- Dateien, die im JSON nicht mehr enthalten sind, werden aus dem Baustein im Ziel-Datensatz gelöscht.
Einstellungen
- Verknüpfung mit: Die Ziel-Liste, in der der Datensatz angelegt oder aktualisiert wird.
- Datensatz-JSON: Das JSON-Objekt des Datensatzes, meist eine Variable aus einem vorherigen Schritt (z. B.
params.item). Ein JSON-Text, der ein Objekt beschreibt, wird ebenfalls akzeptiert. - Zuordnen über: Wie der bestehende Datensatz gefunden wird: Fremd-ID oder Sekundärschlüssel. Siehe unten.
- Referenzen auflösen über: Titel (Standard) oder ID. Siehe unten.
- Fehler-Verhalten: Workflow abbrechen (Standard) oder Ignorieren. Siehe unten.
Zuordnen über Fremd-ID
Der Datensatz wird über einen Textfeld-Baustein der Ziel-Liste gefunden, in dem die ID des Quell-Datensatzes gespeichert ist.
- Schlüssel der Fremd-ID im JSON: Der Schlüssel, unter dem die ID im JSON steht (Standard:
id). - Baustein für die Fremd-ID: Der Textfeld-Baustein, in dem die Fremd-ID gespeichert wird.
Die Fremd-ID wird in diesem Modus immer gespeichert. Enthält das JSON keine oder eine leere Fremd-ID, bricht der Schritt mit einem Fehler ab.
Zuordnen über Sekundärschlüssel
Der Datensatz wird über die Sekundärschlüssel der Ziel-Liste gefunden. Die technischen Namen der Sekundärschlüssel-Bausteine müssen im JSON enthalten sein.
- Einzelne Schlüsselwerte dürfen leer sein. Ein leerer Wert passt nur zu Datensätzen, in denen dieser Baustein ebenfalls leer ist.
- Sind alle Schlüsselwerte leer, wird immer ein neuer Datensatz angelegt.
- Fremd-ID speichern: Optional. Speichert zusätzlich die Fremd-ID im gewählten Textfeld-Baustein. Enthält das JSON keine Fremd-ID, bleibt der gespeicherte Wert unverändert.
Referenzen auflösen über
Bestimmt, wie verknüpfte Datensätze und Auswahl-Optionen zugeordnet werden.
| Option | Datensatz / Datensätze | Drop-Down, Status u. ä. |
|---|---|---|
| Titel | Der Titel wird aus dem Titel-Schlüssel gelesen (z. B. kunde_title). Verknüpft wird der Datensatz mit diesem Titel in der Ziel-Liste. | Zuordnung über das Label der Option |
| ID | Die IDs werden unverändert übernommen. | Zuordnung über die ID der Option |
Titel eignet sich für die Synchronisation zwischen Arbeitsbereichen. ID ist nur sinnvoll innerhalb desselben Arbeitsbereichs oder wenn die IDs in beiden Systemen übereinstimmen.
Gibt es mehrere Datensätze mit demselben Titel, wird der erste Treffer verknüpft, wie beim regulären Import. Wird kein Datensatz gefunden, ist das ein Fehler.
Fehler-Verhalten
- Workflow abbrechen: Der Workflow wird mit einer Fehlermeldung beendet.
- Ignorieren: Es wird nichts gespeichert und der Schritt gibt keinen Datensatz zurück (die Variable ist leer). Der Workflow läuft weiter, der Fehler wird als Warnung im Protokoll vermerkt.
Typische Fehler sind eine fehlende Fremd-ID, ein verknüpfter Datensatz, der nicht gefunden wird, oder ein Wert, der nicht zum Baustein passt.
Verarbeitung der Werte
- Fehlt ein Schlüssel im JSON, bleibt der Baustein unverändert. Ein explizites
nullleert den Baustein. - Groß- und Kleinschreibung der Schlüssel wird ignoriert.
- Schlüssel ohne passenden technischen Namen werden nicht importiert und im Workflow-Protokoll als Unbekannte Schlüssel aufgeführt.
- Schreibgeschützte Werte (z. B. berechnete Werte oder Titel) und Bausteine, die nicht bearbeitet werden dürfen, werden ohne Meldung übersprungen.
- Bausteine mit mehreren Werten (z. B. Adresse mit Straße und Ort, Datumsspanne mit Start und Ende) können als Ganzes oder über die einzelnen technischen Namen angegeben werden. Beide Varianten aus der API sind gleichwertig.
- Dateien werden als Liste von Datei-Objekten angegeben, wie sie die API liefert (mit
name,urlundhash). - Hat sich nichts geändert, wird der Datensatz nicht erneut gespeichert.
Beispiel: Synchronisation per Web-Request
Datensätze aus einem anderen Arbeitsbereich sollen regelmäßig übernommen werden:
- Lade Datensätze aus anderem Univelop Arbeitsbereich: Schritt Sende Web-Request mit dem technischen Namen
web_request. Er lädt die Datensätze über die REST-API V2 des Quell-Arbeitsbereichs. - Iteriere über Datensatz-JSONs: Schritt Iteriere über Werte mit dem Ausdruck
parseJson(web_request.body). - Synchronisiere einzelnen Datensatz anhand von JSON: Schritt Synchronisiere einen Datensatz innerhalb der Schleife. Als Datensatz-JSON wird der aktuelle Wert der Iteration verwendet, also der technische Name des Schritts aus 2.

Credits und Protokoll
Der Schritt verbraucht 1 Credit pro Datensatz. Hinzu kommen 20 Credits pro Megabyte übertragener Dateien (mindestens 1 Credit pro Datei) und 0,1 Credits pro gelöschter Datei.
Im Workflow-Protokoll wird pro Datensatz vermerkt, ob er angelegt, aktualisiert (mit den geänderten Bausteinen und übertragenen Dateien) oder bereits aktuell war. Unbekannte Schlüssel werden zusätzlich aufgeführt.
Einschränkungen
Bei der Zuordnung über Sekundärschlüssel können Duplikate entstehen, wenn die Quelle einen Sekundärschlüssel erst nachträglich füllt: Im Ziel-Datensatz ist der Schlüssel noch leer, der nächste Sync findet ihn daher nicht und legt einen neuen Datensatz an. Die Zuordnung über Fremd-ID vermeidet das.
Hinweise
- Verfügbar in: Client-Automatisierung, Server-Automatisierung.
Verwandte Schritte
- Sende Web-Request: Zum Laden der Datensätze aus einem anderen System
- Ändere einen Datensatz: Zum gezielten Ändern einzelner Bausteinwerte
- Erstelle einen neuen Datensatz: Zum Anlegen von Datensätzen mit manueller Zuordnung