Auf dieser Seite

Einführung in Dynamic Expressions

Erstellen Sie personalisierte, datengestützte Inhalte mit Dynamic Expressions.

Mit Dynamic Expressions können Sie personalisierte und datengestützte Inhalte in Ihrem Workspace erstellen. Durch die Kombination von Datenvariablen, benutzerdefinierten Übersetzungen und Formeln können Sie Ihre Inhalte dynamischer gestalten und auf Ihre Zielgruppe zuschneiden.

Zum Beispiel können Sie eine personalisierte Nachricht anzeigen, indem Sie Folgendes eingeben:

"Willkommen zurück, {{ sessionUser.name }}!"

Dadurch wird der Name des Nutzers direkt in die Nachricht eingefügt.

Damit unser System die Daten einfügen kann und sie sich optisch von anderen Inhalten unterscheiden, stehen Dynamic Expressions immer in doppelten geschweiften Klammern: {{ ... }}.

Ihre erste Dynamic Expression schreiben

Ein Nutzernamen-Ausdruck, der in eine Beschreibung einer Ideensammlung eingefügt und als Name angezeigt wird
  1. Navigieren Sie zu einem Textfeld, in dem Ausdrücke zulässig sind (z. B. einer Frage in einer Ideensammlung).
  2. Geben Sie { ein, um eine Liste der verfügbaren Variablen und Funktionen aufzurufen.
  3. Wählen Sie einen Vorschlag aus oder schreiben Sie Ihren eigenen Ausdruck.
  4. Fügen Sie bei Bedarf Operatoren und Funktionen hinzu.
  5. Klicken Sie außerhalb des Feldes, um Ihre Dynamic Expression in Aktion zu sehen.

Viele Textfelder berechnen und zeigen das Ergebnis aller darin enthaltenen Dynamic Expressions sofort an, sobald sie den Fokus verlieren. Dabei werden Sie und Ihre eigenen Daten berücksichtigt. Prüfen Sie, ob das erwartete Ergebnis angezeigt wird. Und keine Sorge: Sie haben nichts von dem verloren, was Sie geschrieben haben. Wenn Sie erneut in das Textfeld klicken, werden Ihre Dynamic Expressions wieder angezeigt und Sie können sie weiter bearbeiten.

Arten von Dynamic Expressions

Dynamic Expressions bestehen aus verschiedenen Komponenten, die zusammenarbeiten, um personalisierte oder berechnete Ergebnisse anzuzeigen.

Datenvariablen

Datenvariablen stehen für Daten, die spezifisch für Ihren Workspace sind, etwa Nutzernamen, Ideenanzahlen oder Formularwerte.

  • Beispiel: {{sessionUser.name}} könnte als „John Doe“ angezeigt werden.

Benutzerdefinierte Übersetzungsvariablen

Benutzerdefinierte Übersetzungsvariablen sind anpassbare Lokalisierungsschlüssel, die Sie erstellen und plattformweit verwenden können, um Ihre Inhalte in verschiedenen Sprachen anzuzeigen. Je nach der in seinem Profil eingestellten Sprache werden dem besuchenden Nutzer die Inhalte in seiner Sprache angezeigt, sofern Sie eine Übersetzung dafür definiert haben.

  • Beispiel: {{translate:custom.greeting}} zeigt eine lokalisierte Version Ihres Begrüßungstextes an.

Funktionen

Funktionen führen Aktionen aus, etwa das Umwandeln von Daten oder Berechnungen. In der Liste wird die Signatur angezeigt, die angibt, welche Argumente übergeben werden müssen, sowie die erwarteten Datentypen. Beispielsweise erwartet die Funktion UPPERCASE() einen Text. Außerdem wird beschrieben, was die Funktion bewirkt, und ein Beispiel für ihre Verwendung angezeigt.

  • Beispiel: {{ UPPERCASE(sessionUser.name) }} wandelt den Namen eines Nutzers in Großbuchstaben um.

Operatoren

Operatoren werden für Berechnungen und Vergleiche verwendet.

  • Arithmetik: +, -, *, /
  • Logik: && (AND), || (OR)
  • Vergleich: ==, !=, >, <
  • Bedingt: ?
  • Beispiel: {{ sessionUser.stats.likes > 10 ? "Top Contributor" : "Newbie" }} zeigt „Top-Beitragender“ an, wenn die Anzahl der „Gefällt mir“-Angaben 10 übersteigt, andernfalls „Neuling“.

Literale

Literale oder „Rohwerte“ wie Zahlen, Text oder boolesche Werte können ebenfalls frei innerhalb eines dynamischen Ausdrucks verwendet werden.

  • Beispiel: {{ 5 }} oder {{ "Hello, world!" }} oder {{ true }}

Fehlerbehandlung

Da dynamische Ausdrücke sehr flexibel sind und Ihnen viel Freiheit bieten, können sie auch leicht fehlerhaft sein – manchmal auf eine Weise, die Sie vielleicht nicht erwarten. Zum Beispiel kann es passieren, dass Sie:

  • Eine Zahl durch null teilen.
  • Irgendwo in Ihrem Ausdruck eine schließende Klammer vergessen.
  • Auf eine nicht vorhandene (oder gelöschte) benutzerdefinierte Übersetzungsvariable verweisen.
  • Irrtümlich versuchen, einen Nicht-Textwert, etwa eine Zahl, in Großbuchstaben umzuwandeln.

Zum Glück sind dynamische Ausdrücke, die nicht korrekt berechnet werden konnten, in solchen Fällen leicht zu erkennen. Wenn Sie den Mauszeiger darüber bewegen, sehen Sie genau, wo und worin das Problem besteht.

Beachten Sie beim Erstellen dynamischer Ausdrücke die folgenden Hinweise, um die Wahrscheinlichkeit von Fehlern zu verringern:

  • Achten Sie darauf, die verwendeten Klammern zu zählen, insbesondere wenn Sie mehrere Funktionen kombinieren
  • Achten Sie bei Divisionen und insbesondere dann, wenn der Divisor auf einer Datenvariable basiert, auf Fälle, in denen der Divisor null sein könnte. Sie können die Funktion MAX() verwenden, um sicherzustellen, dass der Wert nie unter 1 fällt. Stellen Sie beispielsweise sicher, dass der Mindestwert 1 beträgt: {{ 2 / MAX(sessionUser.stats.likes, 1) }}.

Überprüfen Sie sorgfältig die erwarteten Argumenttypen der verwendeten Funktionen sowie die Reihenfolge, in der diese erwartet werden.

Zum Beispiel schlägt {{ UPPERCASE(2) }} fehl, da UPPERCASE() Text erwartet, aber eine Zahl übergeben wurde.

Einfache Beispiele für dynamische Ausdrücke

  • Einfache Berechnung: {{ 2 + 3 }} zeigt 5 an.
  • Personalisierte Nachricht: Hallo {{sessionUser.name }} zeigt eine individuelle Begrüßung.
  • Bedingte Anzeige: {{ ideaCollection.stats.ideas.total > 50 ? "We've reached our goal!" : "Needs more ideas!" }} passt sich an die Interaktion mit Ideen an.

Durch die Kombination dieser Komponenten können Sie leistungsstarke, personalisierte Erlebnisse für die Nutzer Ihres Workspace schaffen.