Datenvariablen

Mit Datenvariablen können Sie Workspace-spezifische Daten dynamisch referenzieren und anzeigen. So werden Ihre Inhalte für Nutzer relevanter und individueller. Ob Sie Nutzerinformationen, Ideendetails oder Statistiken zu Ideensammlungen anzeigen möchten – Datenvariablen ermöglichen Echtzeitaktualisierungen und maßgeschneiderte Inhalte.

Datenvariablen verwenden

Datenvariablen können in Textfelder in Ihrem Workspace eingefügt werden, beispielsweise in Formularbeschreibungen, Details zu Ideensammlungen und Automatisierungsnachrichten. Bei der Darstellung der Inhalte rufen diese Variablen automatisch die relevanten Daten ab und zeigen sie an.

• Beispiel: {{ sessionUser.name }} zeigt den Namen des aktuellen Nutzers an.
• Beispiel: {{ ideaCollection.stats.ideas.total }} zeigt die Gesamtzahl der in der aktuellen Ideensammlung eingereichten Ideen an.

Häufig verwendete Datenvariablen

Welche Arten von Datenvariablen Sie in Formeln verwenden können, die in den Inhalten Ihres Workspace verfügbar sind, hängt stark vom Kontext ab. In Automatisierungen beispielsweise richten sie sich sowohl nach der Art des Auslösers als auch nach der Aktion, mit der Sie arbeiten.

Deshalb empfehlen wir, in einem Textfeld zunächst die Taste { auf Ihrer Tastatur zu drücken und anschließend die angezeigten Vorschläge zu prüfen. Die dort angezeigten Variablen können Sie in diesem Kontext zuverlässig verwenden. Im Folgenden finden Sie eine Übersicht der wichtigsten Kategorien von Datenvariablen.

Als Faustregel gilt: Wenn Sie gerade eine Idee verfassen, beginnen die meisten verfügbaren Datenbindungen mit „idea“. Von dort aus können Sie in der Regel auf alles Weitere zugreifen, was Sie benötigen.

Im Folgenden finden Sie eine kleine Auswahl unterstützter Datenbindungen für Ideen und Ideensammlungen, die Ihnen einen besseren Überblick über den Umfang geben soll.

Nutzerbezogene Daten

• sessionUser.name: Zeigt den vollständigen Namen des aktuellen Nutzers an.
• sessionUser.rank: Zeigt den Rang des Nutzers als numerischen Wert an, wobei Gast = 1000, ein Mitglied = 2000, Admin = 3000 und ein Arbeitsbereichseigentümer = 5000 ist. Numerische Werte erleichtern Vergleichsoperationen, z. B. mit der Aussage {{IF(sessionUser.rank > 1000, "Welcome")}}
• sessionUser.stats.ideas: Gibt die Gesamtzahl der vom Nutzer eingereichten Ideen zurück.

Ideendaten

• idea.friendlyId: Eine kurze, eindeutige Kennung für die Idee.
• idea.url.full: Die vollständige URL zur Idee.
• idea.status.title: Der aktuelle Status der Idee (z. B. In Überprüfung, Genehmigt, Verzögert).
• ‍idea.phase.name: Der Name der aktuellen Phase der Idee (z. B. Offene Diskussion).‍
• idea.stats.comments: Die Anzahl der Kommentare, die eine Idee erhalten hat.‍
• idea.owner.name: Der Name des Nutzers, der die Idee eingereicht hat.‍
• idea.status.title: Der Titel des Status, den die Idee derzeit hat‍
• idea.submittedAt: Der Zeitstempel, zu dem die Idee erstellt wurde‍
• idea.stats.comments: Die Anzahl der Kommentare zur Idee‍
• idea.stats.likes.total: Die Gesamtzahl der Likes für die Idee‍
• idea.stats.totalAvgRating: Die durchschnittliche Gesamtbewertung der Idee‍
• idea.field.<UUID>.value: Der vom Nutzer übermittelte Wert für das Formularfeld mit der entsprechenden UUID. Wenn Sie ein Feld für „Geschätzte Kosten“ mit der UUID 123abc haben, können Sie {{ idea.field.123abc.value }} verwenden, um den übermittelten Wert anzuzeigen. Wenn Sie sich bezüglich der UUID unsicher sind und sichergehen möchten, können Sie beim Bearbeiten des Formulars die ID eines beliebigen Ideenfelds kopieren.

Daten der Ideensammlung

• ideaCollection.title: Der Titel der Ideensammlung.
• ideaCollection.question: Die Leitfrage oder Beschreibung der Herausforderung der Sammlung.
• ideaCollection.stats.ideas.total: Die Gesamtzahl der innerhalb der Sammlung eingereichten Ideen.
• ideaCollection.status: Der aktuelle Status der Sammlung (z. B. ACTIVE, ENDED.
• ideaCollection.url.full: Die vollständige URL zur Ideensammlung
• ideaCollection.friendlyId: Eine kurze, einfache ID für die Ideensammlung, die innerhalb des Workspace eindeutig ist
• ideaCollection.goal.title: Der Titel des Ziels der Ideensammlung
• ideaCollection.owner.name: Der Name des Nutzers, der die Ideensammlung erstellt hat.

Workspace-Daten

• workspace.name: Der Titel der Ideensammlung.
• workspace.subdomain: Die Leitfrage oder Beschreibung der Herausforderung der Sammlung.
• workspace.url.full: Die vollständige Website-URL, über die Personen zu Ihrem Workspace navigieren können. Wenn eine benutzerdefinierte Subdomain eingerichtet ist, entspricht sie dieser URL.

Datenvariablen im Kontext verwenden

Datenvariablen können sich je nachdem, wo sie verwendet werden, anpassen. Zum Beispiel:

• In Beschreibungen von Ideensammlungen: Verwenden Sie z. B. {{ ideaCollection.goal.title }}, um den Titel des Ziels der Sammlung anzuzeigen.
• Im Aktionsschritt einer Automatisierung: Verwenden Sie z. B. {{ idea.owner.name }}, um den Namen des Ideenerstellers zu verwenden, oder {{ action.receiver.name }}, um den Namen der Person einzufügen, die die Nachricht erhält.
• In Ideenfeldern: Wenn Sie in einem Ideenformular auf einen früheren Feldwert oder in einem Formulareintragsformular auf ein Ideenfeld verweisen möchten, können Sie {{context.field.<UUID>.value}} verwenden, um auf einen anderen Feldwert zu verweisen.

Formatierung und Anpassung

Datenvariablen können mit Funktionen und Operatoren kombiniert werden, um die Ausgabe zu formatieren und anzupassen:

• Den Namen des Nutzers großschreiben: {{ CAPITALIZE(sessionUser.name) }}
• Ideenanzahl mit einem Fallback anzeigen: {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "No ideas yet" }}
• Durchschnittlichen Engagement-Score des Nutzers runden: {{ ROUND(sessionUser.stats.engagementScore) }}

Beispieltitel und -beschreibung für eine Ideensammlung zum Kostensparen

Frage: Wie könnten wir in {{ sessionUser.country }} Kosten sparen?

Beschreibung: Hallo {{ sessionUser.name }}, willkommen zu unserer wichtigen jährlichen {{ workspace.name }} Kampagne zum Kostensparen!

Wir freuen uns auf Ihre kreativen Ideen zur Kostensenkung. Bislang haben wir gemeinsam {{ ideaCollection.stats.ideas.total }} Ideen gesammelt – bringen auch Sie Ihre Stimme ein!

Die Rangliste der Ideen in dieser Sammlung können Sie jederzeit hier aufrufen:

‍{{ ideaCollection.url.full }}/leaderboard.

Best Practices für Datenvariablen

• Verwenden Sie aussagekräftige Bezeichnungen: Stellen Sie sicher, dass die Variablennamen in Ihrer Dokumentation eindeutig referenziert werden, um Verwechslungen zu vermeiden.
• Dynamische Inhalte testen: Zeigen Sie eine Vorschau der Seiten an, um sicherzustellen, dass die Datenvariablen die erwarteten Informationen anzeigen.
• Mit benutzerdefinierten Übersetzungsvariablen kombinieren: Verwenden Sie Variablen in Übersetzungen, um die Lokalisierung sicherzustellen und Inhalte gleichzeitig dynamisch zu halten.
• Leere Werte vermeiden: Wenn Sie Variablen verwenden, die nicht immer Daten enthalten (z. B. benutzerdefinierte Formularfelder), fügen Sie einen Fallback-Text hinzu, um eine nahtlose Nutzung sicherzustellen, zum Beispiel: {{ idea.stats.comments > 0 ? idea.stats.comments + " comments" : "No comments yet" }}

Durch den effektiven Einsatz von Datenvariablen können Sie personalisierte, datengestützte Inhalte erstellen, die sich an Nutzereingaben anpassen und das Workspace-Erlebnis insgesamt verbessern.