Datensätze lesen und ändern
Datensatzaktionen arbeiten mit einem ausdrücklich gewählten Objekt und ausgewählten Feldern. Sie durchsuchen nicht alle Objekte und leiten keinen Zugriff auf verknüpfte Datensätze ab. Wählen Sie zuerst das Objekt und konfigurieren Sie dann die Auswahl sowie die lesbaren oder änderbaren Daten.
Datensatz lesen
Wählen Sie eine Datensatz-ID als festen Wert oder aus einem unterstützten vorherigen Feld und bestimmen Sie die lesbaren Attribute. Bei einem datensatzbezogenen Workflow bietet sich die Datensatz-ID des Auslösers an.
Das Ergebnis enthält Identität, Anzeigenamen und ausgewählte Daten. Die ausgewählten Datenschlüssel sind vorhanden; fehlende Werte werden als null dargestellt. Ein Leseschritt nach einer Wartezeit erfasst den Stand zu diesem späteren Zeitpunkt. Sein angenommenes Ergebnis bleibt erhalten: Eine erneute Zustellung verwendet es wieder, auch wenn sich der Datensatz inzwischen ändert.
Datensatz aktualisieren
Wählen Sie eine Datensatz-ID und die zu schreibenden Attribute. Jeder Wert kann fest oder zugeordnet sein. Weggelassene Attribute bleiben unverändert. Ein ausdrückliches null leert ein Attribut, das null erlaubt; es bedeutet nicht „unverändert lassen“. Jedes Attribut darf nur einmal vorkommen.
Bei Auswahl- und Statusattributen verwenden Sie die tatsächlich konfigurierte Optionsidentität, nicht deren sichtbare Beschriftung als Wert. Beziehungsziele und nachverfolgte Standorte benötigen ausdrücklich deklarierten Lesezugriff auf die zugehörigen Datensätze.
Beispiel: Aktualisieren Sie die Prüfnotiz einer Anfrage aus einem vorherigen Skriptergebnis und lassen Sie die übrigen Felder unverändert. Das angenommene Datensatzergebnis steht Folgeschritten zur Verfügung.
Datensatz erstellen oder aktualisieren (Upsert)
Verwenden Sie Upsert, wenn ein stabiler fachlicher Schlüssel einen Datensatz identifiziert. Der Schlüssel muss ein beschreibbares, eindeutiges Textattribut mit einem nicht-null Textwert sein. Groß- und Kleinschreibung werden unterschieden. Ein vorhandener Treffer wird aktualisiert; andernfalls wird ein Datensatz angelegt.
Konfigurieren Sie den Schlüssel in der Schlüsselauswahl und nicht zusätzlich unter den Schreibwerten. Wenn ein neuer Datensatz entstehen kann, müssen die für eine gültige Erstellung erforderlichen Felder vorliegen. Upsert benötigt neben Lesezugriff sowohl Erstellungs- als auch Änderungsrechte.
Zugriff, Schemaänderungen und Ergebnisse
Die Veröffentlichung fixiert Objekt sowie lesbare und beschreibbare Felder. Spätere Änderungen am Objektschema können diesen Vertrag ungültig machen. Prüfen und veröffentlichen Sie den betroffenen Workflow erneut, statt von einer automatischen Aktualisierung der Feldauswahl auszugehen. Objekte, deren Datensätze über ein übergeordnetes Objekt verwaltet werden, sowie Schreibzugriffe auf systemverwaltete Felder werden nicht unterstützt.
Datensatzoperationen behalten ihre gespeicherten Ergebnisse. Frühere Änderungen bleiben bei späterem Fehler oder Abbruch bestehen. Normale Datensatzereignisse und Webhooks entstehen weiterhin, doch workflowbedingte Änderungen starten nicht automatisch weitere Workflows.
Die Vorschau führt diese Operationen nicht aus und liefert keine tatsächlichen Ergebnisse. Prüfen Sie die Auswirkungen in einem echten Lauf. Die API-Referenz für Datensatzaktionen (Englisch) beschreibt Auswahl, Werttypen und Zugriffsdeklarationen.