Beschreibung
Die Funktion SetField dient dazu, den Wert eines bestimmten Feldes innerhalb eines Projekts oder einer Aufgabe programmgesteuert zu setzen. Typische Einsätze sind Buttons (createButton) oder Workflows, die Felder automatisch aktualisieren.
SetField ist besonders hilfreich, wenn automatisch Daten in ein benutzerdefiniertes Feld eingefügt oder aktualisiert werden sollen.
Syntax
SetField(id: guid, fieldName: string, value: string)
Argumente
| Argument | Beschreibung |
|---|---|
id |
GUID des Zielobjekts (Projekt/Aufgabe), auf das geschrieben werden soll. |
fieldName |
Name des Feldes, dessen Wert gesetzt werden soll. Dies kann ein Systemfeld oder ein Flavor sein. |
value |
Wert, der in das Feld geschrieben wird. Immer als string übergeben. Falls ein anderer Datentyp benötigt wird (z. B. Zahl, Datum), kann die Funktion asType("string", ...) verwendet werden. |
Rückgabetypen
Kein Rückgabewert. Die Funktion schreibt den angegebenen value in das Feld.
Beispiele
| Beschreibung | Formel |
|---|---|
| Einfaches Setzen eines Feldwerts |
Process(
SetField("01234567-89ab-cdef-0123-456789abcdef", "Status", "In Bearbeitung")
)
Setzt den Wert des Feldes |
| Dynamischer Wert (Berechnung als String) |
Process(
SetField("01234567-89ab-cdef-0123-456789abcdef", "Budget", asType("string", sumAll("Kosten", true)))
)
Schreibt die Summe aller Kosten als String in das Feld |
| Kombination mit einem Button |
createButton(
1,
"Status auf 'Abgeschlossen'",
"Klick setzt den Status",
"Process(
SetField('01234567-89ab-cdef-0123-456789abcdef', 'Status', 'Abgeschlossen')
)",
"",
"",
"",
"Der Status wurde erfolgreich auf 'Abgeschlossen' gesetzt.",
"",
"check-circle"
)
Ein Button, der beim Klick den Status auf „Abgeschlossen“ setzt. |
Hinweise
- Exakter Name:
fieldNamemuss exakt mit dem in Smenso definierten Feldnamen übereinstimmen. - Strings: Alle Werte müssen als
stringübergeben werden. Falls nötig, mitasType("string", ...)konvertieren. - Verwendung in
Process(): Immer innerhalb vonProcess()verwenden, sonst erscheint „Can not execute async functions outside async context“.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.