Eigenes Feld schreiben

Wie du mit einer Automatisierung ein eigenes Feld am Gerät oder Kunden setzt, in welchem Format der Wert stehen muss und wann der Schritt fehlschlägt.

Mit dieser Aktion setzt oder leerst du ein eigenes Feld – entweder am Gerät des Laufs oder an dessen Kunden. So hältst du etwa ein Ergebnis aus einem früheren Schritt direkt am Gerät fest. Das Gerät muss dafür nicht online sein.

Konfigurationsfelder

Feld	Typ	Pflicht	Standard	Beschreibung
Eigenes Feld	Auswahl	Ja	—	Das Feld, das du schreiben willst. Die Liste teilt die Felder in Eigene Felder (Gerät) und Eigene Felder (Kunde) auf. Ein Gerätefeld landet am Gerät des Laufs, ein Kundenfeld am Kunden dieses Geräts.
Wert	Text	Nein	leer	Der Wert, den du schreiben willst. Unterstützt Variablen `${{ … }}`. Lass das Feld leer, um den Wert zu löschen. octoja prüft den Wert erst bei der Ausführung gegen den Feldtyp.

Ohne ausgewähltes Feld kannst du die Automatisierung nicht speichern. octoja meldet dann Für den Schritt zum Schreiben eines benutzerdefinierten Feldes ist ein Feld erforderlich.

Gib den Wert im Format des Feldtyps ein:

Feldtyp	Wertformat
Text, Mehrzeiliger Text, Formatierter Text (Markdown)	Beliebiger Text mit bis zu 1.000, 10.000 bzw. 20.000 Zeichen. Leerzeichen am Anfang und Ende fallen weg.
Ganzzahl	Eine ganze Zahl, zum Beispiel `42` oder `-7`.
Dezimalzahl	Eine Zahl mit Punkt als Dezimaltrennzeichen, zum Beispiel `3.5`.
Ja / Nein	`true` oder `false`.
Auswahlliste	Genau eine der festgelegten Optionen, exakt so geschrieben.
Mehrfach-Auswahlliste	Eine festgelegte Option oder mehrere als JSON-Liste, etwa `["Berlin","Hamburg"]`. Die bisherige Auswahl wird komplett ersetzt.
Datum	Ein Datum als `YYYY-MM-DD`, zum Beispiel `2026-12-31`.

Plattformunterstützung

Die Aktion läuft in octoja und funktioniert auf allen Plattformen gleich.

Ausgaben

Ausgabe	Beschreibung
`action`	Aktion: `set`, wenn sich der Wert geändert hat, `cleared`, wenn das Feld geleert wurde, `unchanged`, wenn das Feld schon diesen Wert hatte oder bereits leer war.
`value`	Wert: Der geschriebene Wert so, wie octoja ihn speichert, zum Beispiel einen Ja-/Nein-Wert als `true`. Leer, wenn das Feld geleert wurde.

Bei einem Feld vom Typ Mehrfach-Auswahlliste gelten zwei Besonderheiten: action meldet beim Schreiben einer Auswahl immer set, auch wenn sich nichts geändert hat. Und value enthält nicht die gewählten Optionen – verwende diese Ausgabe dort nicht in späteren Schritten.

Ergebnisverhalten

Situation	Ergebnis
Der Wert passt zum Feldtyp oder ist leer	Erfolgreich. `action` zeigt, ob sich etwas geändert hat.
Der Wert passt nicht zum Feldtyp, etwa Text in einer Ganzzahl oder eine unbekannte Option	Fehlgeschlagen: Der aufgelöste Wert ist für das eigene Feld ungültig. Den Grund findest du in den Schrittdetails. Das Feld behält seinen alten Wert.
Das ausgewählte Feld wurde gelöscht	Fehlgeschlagen: Das ausgewählte eigene Feld existiert nicht mehr.
Ein Kundenfeld ist ausgewählt, aber das Gerät hat keinen Kunden	Fehlgeschlagen: Das Gerät hat keinen Kunden oder der Kunde wurde nicht gefunden.

Ein Kundenfeld teilen sich alle Geräte dieses Kunden. Läuft die Automatisierung auf mehreren Geräten desselben Kunden, schreibt jeder Lauf in dasselbe Feld. Am Ende steht der Wert des letzten Laufs.

Liefert eine Variable einen leeren Wert, wird das Feld geleert. Kann octoja eine Variable nicht auflösen, bleibt sie als wörtlicher Text stehen. Ein Textfeld speichert diesen Text, alle anderen Feldtypen lehnen ihn ab.

Siehe auch: Eine Automatisierung erstellen · Eigene Felder

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen