Funktionen

Dynamische Ausdrücke werden durch die Verwendung von Funktionen noch leistungsfähiger. Diese integrierten Tools helfen Ihnen dabei, Berechnungen durchzuführen, Text umzuwandeln und Daten zu formatieren, sodass Sie dynamischere und personalisierte Inhalte erstellen können.

Was sind Funktionen?

Funktionen in dynamischen Ausdrücken sind spezielle Befehle, die Eingabewerte (Argumente genannt) entgegennehmen und ein Ergebnis zurückgeben. Sie können für mathematische Operationen, die Bearbeitung von Text und logikbasierte Entscheidungen verwendet werden.

Funktionen werden in geschweifte Klammern geschrieben {{ ... }} und können mit Datenvariablen, Literalen und Operatoren kombiniert werden.

Beispiel: {{ ROUND(AVERAGE(sessionUser.stats.likes, 10)) }} – dieses Beispiel berechnet den Durchschnitt aus der Gesamtzahl der „Gefällt mir“-Angaben des Nutzers und der Zahl 10 und rundet das Ergebnis auf die nächste ganze Zahl.

Funktionen zur Textbearbeitung

• UPPERCASE(text): Wandelt den Text in Großbuchstaben um.
  • Beispiel: {{ UPPERCASE("hello world") }} → "HELLO WORLD" (Text)
• LOWERCASE(text): Wandelt den Text in Kleinbuchstaben um.
  • Beispiel: {{ LOWERCASE("HELLO") }} → "hello" (Text)
• CAPITALIZE(text): Schreibt den ersten Buchstaben der Zeichenfolge groß.
  • Beispiel: {{ CAPITALIZE("ideanote") }} → "Ideanote" (Text)
• TRIM(text): Entfernt Leerzeichen am Anfang und Ende der Zeichenfolge.
  • Beispiel: {{ TRIM(" idea collection ") }} → "idea collection" (Text)
• REPLACE(text, search, replace): Ersetzt einen Teil einer Zeichenfolge durch eine andere Zeichenfolge.
  • Beispiel: {{ REPLACE("Innovation Hub", "Hub", "Center") }} → "Innovation Center" (Text)
• TRUNCATE(text, length): Kürzt eine Zeichenfolge auf eine bestimmte Länge.
  • Beispiel: {{ TRUNCATE("Welcome to the innovation program!", 10) }} → "Welcome to..." (Text)
• CONCAT(...strings): Fügt mehrere Textzeichenfolgen zu einer zusammen.
  • Beispiel: {{ CONCAT("Hello, ", "world") }} → "Hello, world" (Text)
• REPEAT(text, count): Wiederholt eine Zeichenfolge eine bestimmte Anzahl von Malen.
  • Beispiel: {{ REPEAT("Hi! ", 3) }} → "Hi! Hi! Hi!" (Text)
• APPEND(text, suffix): Fügt am Ende einer Zeichenfolge ein Suffix hinzu.
  • Beispiel: {{ APPEND("hello", ", world") }} → "hello, world" (Text)
• PREPEND(text, prefix): Fügt am Anfang einer Zeichenfolge ein Präfix hinzu.
  • Beispiel: {{ PREPEND("world", "hello, ") }} → "hello, world" (Text)
• STARTS_WITH(text, search): Gibt zurück, ob eine Zeichenfolge mit einer anderen Zeichenfolge beginnt.
  • Beispiel: {{ STARTS_WITH("hello", "he") }} → true (boolean)
• ENDS_WITH(text, search): Gibt zurück, ob eine Zeichenfolge mit einer anderen Zeichenfolge endet.
  • Beispiel: {{ ENDS_WITH("hello", "lo") }} → true (boolean)
• INCLUDES(text, search): Prüft, ob eine Zeichenfolge eine andere Zeichenfolge enthält.
  • Beispiel: {{ INCLUDES("hello", "ell") }} → true (boolean)
• LENGTH(text): Gibt die Länge des Textes zurück.
  • Beispiel: {{ LENGTH("Ideas") }} → 5 (Zahl)

Mathematische Funktionen

• ABS(number): Gibt den absoluten (nicht negativen) Wert einer Zahl zurück.
  • Beispiel: {{ ABS(-15) }} → 15 (Zahl)
• ADD(...numbers): Gibt die Summe einer Liste von Zahlen zurück.
  • Beispiel: {{ ADD(1, 2, 3) }} → 6 (Zahl)
• SUBTRACT(number, subtrahend): Gibt das Ergebnis der Subtraktion zweier Zahlen zurück.
  • Beispiel: {{ SUBTRACT(10, 2) }} → 8 (Zahl)
• MULTIPLY(number, multiplier): Gibt das Ergebnis der Multiplikation zweier Zahlen zurück.
  • Beispiel: {{ MULTIPLY(2, 3) }} → 6 (Zahl)
• DIVIDE(number, divisor): Dividiert eine Zahl durch eine andere.
  • Beispiel: {{ DIVIDE(10, 2) }} → 5 (Zahl)
• MOD(number, divisor): Gibt den Rest der Division zweier Zahlen zurück.
  • Beispiel: {{ MOD(10, 3) }} → 1 (Zahl)
• ROUND(number): Rundet eine Zahl auf die nächste ganze Zahl.
  • Beispiel: {{ ROUND(4.7) }} → 5 (Zahl)
• CEIL(number): Gibt die kleinste Ganzzahl zurück, die größer oder gleich einer Zahl ist.
  • Beispiel: {{ CEIL(1.5) }} → 2 (Zahl)
• FLOOR(number): Gibt die größte Ganzzahl zurück, die kleiner oder gleich einer Zahl ist.
  • Beispiel: {{ FLOOR(1.5) }} → 1 (Zahl)
• MAX(...numbers): Gibt die größte Zahl aus der Liste zurück.
  • Beispiel: {{ MAX(10, 20, 5) }} → 20 (Zahl)
• MIN(...numbers): Gibt die kleinste Zahl aus der Liste zurück.
  • Beispiel: {{ MIN(10, 20, 5) }} → 5 (Zahl)
• POW(number, exponent): Gibt das Ergebnis zurück, wenn eine Zahl mit einer anderen Zahl potenziert wird.
  • Beispiel: {{ POW(2, 3) }} → 8 (Zahl)
• AVERAGE(...numbers): Gibt den Durchschnitt einer Liste von Zahlen zurück.
  • Beispiel: {{ AVERAGE(1, 2, 3) }} → 2 (Zahl)

Formatierungs- und Hilfsfunktionen

• FORMAT(value): Formatiert einen Wert (z. B. eine Zahl oder ein Datum) gemäß den Nutzereinstellungen.
  • Beispiel: {{ FORMAT(10000) }} → "10,000" (Text)
• PREFIX(text, prefix): Fügt am Anfang einer Zeichenfolge ein Präfix hinzu.
  • Beispiel: {{ PREFIX("world", "hello, ") }} → "hello, world" (Text)
• SUFFIX(text, suffix): Fügt am Ende einer Zeichenfolge ein Suffix hinzu.
  • Beispiel: {{ SUFFIX("hello", ", world") }} → "hello, world" (Text)

Tipps zur Fehlerbehandlung

1. Auf Nullwerte prüfen: Stellen Sie sicher, dass die verwendeten Variablen existieren.
2. Division durch null vermeiden: Verwenden Sie MAX, um sicherzustellen, dass Divisoren niemals null sind, zum Beispiel indem Sie {{ DIVIDE(10, MAX(value, 1)) }} schreiben.
3. Klammern abgleichen: Stellen Sie sicher, dass alle Funktionen und Bedingungen passende Klammern haben.
4. Fehlermeldungen überprüfen: Wenn Sie in Ihrem Workspace mit dem Mauszeiger auf einen Wert „Not Calculated“ zeigen, erhalten Sie möglicherweise Hinweise auf die zugrunde liegende Ursache.

Indem Sie diese Funktionen beherrschen, können Sie Ihren Workspace in eine vollständig dynamische, personalisierte und effiziente Umgebung verwandeln, die sich an Nutzereingaben und Daten anpasst.