Beiträge in diesem Abschnitt

Weitere anzeigen

SetFlavor - Wert eines Flavor innerhalb eines Projekts oder einer Aufgabe programmgesteuert setzen

Albert Labermair
  • Aktualisiert
Folgen

Beschreibung

Die Funktion SetFlavor wird verwendet, um den Wert eines benutzerdefinierten Feldes (Flavor) innerhalb eines Projekts oder einer Aufgabe programmgesteuert zu setzen. Sie wird häufig in Workflows genutzt, um benutzerdefinierte Datenfelder dynamisch zu aktualisieren.

SetFlavor ist besonders hilfreich, wenn Werte, die in einem Workflow generiert oder berechnet werden, automatisch in ein Flavor geschrieben werden sollen.


Syntax

SetFlavor(flavorName: string, value: string, id: guid)


Argumente

Argument Beschreibung
flavorName Exakter Anzeigename des benutzerdefinierten Feldes (Flavor), das beschrieben werden soll.
value Wert, der in das Feld geschrieben wird. Immer als string übergeben, auch wenn das Feld intern z. B. eine Zahl oder ein Datum ist. Bei Bedarf kann die Funktion asType genutzt werden, um den Wert zu konvertieren.
id (optional) GUID des Zielobjekts (Projekt/Aufgabe). Wird sie nicht angegeben, wird das aktuelle Objekt verwendet.

 

Rückgabetypen

Kein Rückgabewert. SetFlavor schreibt den angegebenen value in das Ziel-Feld.


Beispiele

Beschreibung Formel
Einfaches Schreiben auf das aktuelle Objekt 
Process(
  SetFlavor("Projektstatus", "In Bearbeitung")
)

Setzt Projektstatus auf „In Bearbeitung“.
Dynamischer Wert (Berechnung als String) 
Process(
  SetFlavor("Kostenübersicht", asType("string", sumAll("Kosten", true)))
)

Die Summe aller Kosten wird in das Feld Kostenübersicht geschrieben.
Schreiben auf ein anderes Objekt per id 
Process(
  SetFlavor("Priorität", "Hoch", "01234567-89ab-cdef-0123-456789abcdef")
)

Aktualisiert Priorität auf dem Objekt mit der angegebenen GUID.
Verwendung in einem Button 
createButton(
  1,
  "Projektstatus auf 'Abgeschlossen'",
  "Setzt den Projektstatus",
  "Process(
    SetFlavor('Projektstatus', 'Abgeschlossen')
  )",
  "",
  "",
  "",
  "Der Projektstatus wurde aktualisiert.",
  "",
  "check-circle"
)

Button schreibt beim Klick „Abgeschlossen“ in Projektstatus.

 

Hinweise

  • Exakter Name: flavorName muss exakt dem in Smenso definierten Feldnamen entsprechen.
  • Kontext: Ohne id wirkt die Funktion auf das aktuelle Objekt (z. B. Projekt oder Task).
  • Kombination mit anderen Funktionen: SetFlavor kann mit anderen Funktionen wie if, sumAll oder format kombiniert werden, um dynamische Werte zu erstellen.
  • Nutzung der Process()-Funktion: Um Fehler wie "Can not execute async functions outside async context" zu vermeiden, muss SetFlavor innerhalb von Process() verwendet werden.

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.