Beschreibung
Die Funktion SetField
dient dazu, den Wert eines bestimmten Feldes innerhalb eines Projektes oder einer Aufgabe programmgesteuert zu setzen. Sie wird häufig in Kombination mit Buttons (createButton
) verwendet, um dynamische Aktionen auszulösen.
SetField
ist besonders hilfreich, wenn automatisch Daten in ein benutzerdefiniertes Feld eingefügt oder aktualisiert werden sollen.
Syntax
SetField(feldName, feldWert)
Argumente
Argument | Beschreibung |
---|---|
feldName |
Der Name des Feldes, dessen Wert gesetzt werden soll. Dies kann ein Systemfeld oder ein benutzerdefiniertes Feld (Flavor) sein. |
feldWert |
Der Wert, der in das angegebene Feld geschrieben werden soll. Kann ein statischer Wert oder ein dynamisch berechneter Wert sein (z. B. durch eine andere Funktion). |
Rückgabetypen
Die Funktion hat keinen direkten Rückgabewert. Sie führt eine Aktion aus, indem sie den Wert des angegebenen Feldes setzt.
Beispiele
Beschreibung | Formel |
---|---|
Einfaches Setzen eines Feldwerts |
Process( SetField("Status", "In Bearbeitung") ) Setzt den Wert des Feldes |
Dynamischer Feldwert basierend auf einer Berechnung |
Process( SetField("Budget", sumAll("Kosten", true)) ) Setzt den Wert des Feldes |
Kombination mit einem Button |
createButton( 1, "Setze Status", "Klicken Sie, um den Status auf 'Abgeschlossen' zu setzen", "Process( SetField('Status', 'Abgeschlossen') )", "", "", "", "Der Status wurde erfolgreich auf 'Abgeschlossen' gesetzt.", "", "check-circle" ) Ein Button, der den Status auf "Abgeschlossen" setzt, wenn er gedrückt wird. |
Hinweise
- Feldnamen beachten: Der angegebene
feldName
muss genau mit dem Namen des Feldes in Smenso übereinstimmen. - Datentypen: Achte darauf, dass der Wert im richtigen Datentyp für das entsprechende Feld bereitgestellt wird (z. B. Zahl, Datum, Text).
- Verwendung mit der
Process()
-Funktion: Um Fehler wie"Can not execute async functions outside async context"
zu vermeiden, mussSetField
innerhalb derProcess()
-Funktion genutzt werden.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.