Datavariabler

Datavariabler giver dig mulighed for dynamisk at referere til og vise workspace-specifikke data, så dit indhold bliver mere relevant og personligt for brugerne. Uanset om du viser brugeroplysninger, idedetaljer eller statistikker for idesamlinger, muliggør datavariabler opdateringer i realtid og indhold, der er tilpasset den enkelte.

Brug af datavariabler

Datavariabler kan indsættes i tekstfelter på tværs af dit workspace, f.eks. i formularbeskrivelser, oplysninger om idesamlinger og automatiseringsmeddelelser. Variablerne henter og viser automatisk de relevante data, når indholdet vises.

• Eksempel: {{ sessionUser.name }} viser den aktuelle brugers navn.
• Eksempel: {{ ideaCollection.stats.ideas.total }} viser det samlede antal ideer, der er indsendt i den aktuelle idesamling.

Almindeligt anvendte datavariabler

Hvilke typer datavariabler du kan bruge i dine formler, og som er tilgængelige på tværs af indholdet i dit workspace, afhænger i høj grad af konteksten. I automatiseringer afhænger de for eksempel både af den type udløser og den type handling, du arbejder med.

Derfor foreslår vi, at du altid starter med at trykke på { på tastaturet i et af dine tekstfelter og derefter gennemgår listen med forslag. De variabler, du ser dér, er dem, du med sikkerhed kan bruge i den pågældende kontekst. Her er en oversigt over de vigtigste kategorier af datavariabler, du kan bruge.

En god tommelfingerregel er, at hvis du er i gang med at skrive en ide, begynder de fleste af de tilgængelige databindinger med ”idea”, og derfra kan du typisk finde alt det andet, du har brug for.

Når det er sagt, følger her et lille udvalg af eksempler på understøttede bindinger på tværs af ideer og idesamlinger, så du kan få en bedre forståelse af omfanget.

Brugerrelaterede data

• sessionUser.name: Viser den aktuelle brugers fulde navn.
• sessionUser.rank: Viser brugerens rang som en numerisk værdi, hvor Guest = 1000, et medlem = 2000, og Admin = 3000, mens en workspaceejer = 5000. Numeriske værdier gør det nemmere at oprette sammenligningsoperationer, f.eks. ved at sige {{IF(sessionUser.rank > 1000, "Welcome")}}
• sessionUser.stats.ideas: Returnerer det samlede antal ideer, som brugeren har indsendt.

Ideoplysninger

• idea.friendlyId: En kort, unik identifikator for ideen.
• idea.url.full: Den fulde URL til ideen.
• idea.status.title: Ideens aktuelle status (f.eks. Under review, Godkendt, Forsinket).
• ‍idea.phase.name: Navnet på ideens aktuelle fase (f.eks. Åben diskussion).‍
• idea.stats.comments: Antallet af kommentarer, som ideen har fået.‍
• idea.owner.name: Navnet på den bruger, der indsendte ideen.‍
• idea.status.title: Titlen på den status, ideen har i øjeblikket‍
• idea.submittedAt: Tidsstemplet for, hvornår ideen blev oprettet‍
• idea.stats.comments: Antallet af kommentarer, som ideen har‍
• idea.stats.likes.total: Det samlede antal likes, som ideen har‍
• idea.stats.totalAvgRating: Den samlede gennemsnitlige evaluering af ideen‍
• idea.field.<UUID>.value: Den værdi, brugeren har indsendt for formularfeltet med det tilsvarende UUID. Hvis du har et felt for "Estimeret omkostning" med UUID'et 123abc, kan du bruge {{ idea.field.123abc.value }} til at vise den indsendte værdi. Hvis du er i tvivl om UUID'et og vil være sikker, kan du kopiere ID'et for et hvilket som helst idefelt, når du redigerer formularen.

Data for idesamling

• ideaCollection.title: Titlen på idesamlingen.
• ideaCollection.question: Det styrende spørgsmål eller den udfordring, som idesamlingen omhandler.
• ideaCollection.stats.ideas.total: Det samlede antal ideer, der er indsendt i idesamlingen.
• ideaCollection.status: Samlingens aktuelle status (f.eks. AKTIV, AFSLUTTET.
• ideaCollection.url.full: Den fulde URL til idesamlingen
• ideaCollection.friendlyId: Et kort, enkelt ID for idesamlingen, der er unikt i workspacet
• ideaCollection.goal.title: Titlen på målet for idesamlingen
• ideaCollection.owner.name: Navnet på den bruger, der oprettede idesamlingen.

Workspace-data

• workspace.name: Titlen på idesamlingen.
• workspace.subdomain: Det styrende spørgsmål eller den udfordring, som idesamlingen omhandler.
• workspace.url.full: Den fulde webadresse, som personer kan bruge til at navigere til dit workspace. Hvis der er angivet et brugerdefineret underdomæne, svarer det til denne webadresse.

Brug af datavariabler i kontekst

Datavariabler kan tilpasses afhængigt af, hvor de bruges. For eksempel:

• I beskrivelser af idesamlinger: Brug f.eks. {{ ideaCollection.goal.title }} til at vise titlen på samlingens mål.
• I handlingstrinnet i en automatisering: Brug f.eks. {{ idea.owner.name }} til at bruge idéskaberens navn eller {{ action.receiver.name }} til at skrive navnet på den person, der modtager meddelelsen.
• På tværs af idefelter: Når du henviser til en tidligere feltværdi i en ideformular eller til et idefelt fra en formular til formularindtastning, kan du bruge {{context.field.<UUID>.value}} til at henvise til en anden feltværdi.

Formatering og tilpasning

Datavariabler kan kombineres med funktioner og operatorer for at formatere og tilpasse outputtet:

• Skriv brugerens navn med stort begyndelsesbogstav: {{ CAPITALIZE(sessionUser.name) }}
• Vis antal ideer med en reserveværdi: {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "No ideas yet" }}
• Afrund brugerens gennemsnitlige engagementscore: {{ ROUND(sessionUser.stats.engagementScore) }}

Eksempel på titel og beskrivelse til en omkostningsbesparende idesamling

Spørgsmål: Hvordan kan vi spare omkostninger i {{ sessionUser.country }}?

Beskrivelse: Hej {{ sessionUser.name }}, og velkommen til vores vigtige årlige {{ workspace.name }} omkostningsbesparende kampagne!

Vi glæder os til at høre dine kreative ideer til at reducere udgifterne. Indtil videre har vi sammen indsamlet {{ ideaCollection.stats.ideas.total }} ideer — lad også din stemme blive hørt!

Du kan altid se denne samlings rangliste over ideer ved at besøge:

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

Bedste praksis for datavariabler

• Brug beskrivende etiketter: Sørg for, at variabelnavne tydeligt henvises til i din dokumentation for at undgå forvirring.
• Test dynamisk indhold: Forhåndsvis sider for at sikre, at datavariabler viser de forventede oplysninger.
• Kombiner med brugerdefinerede oversættelsesvariabler: Brug variabler i oversættelser for at sikre lokalisering, samtidig med at indholdet forbliver dynamisk.
• Undgå tomme værdier: Når du bruger variabler, der ikke altid indeholder data (f.eks. tilpassede formularfelter), skal du inkludere reservetekst for at sikre en problemfri oplevelse, f.eks.: {{ idea.stats.comments > 0 ? idea.stats.comments + " comments" : "No comments yet" }}

Ved at udnytte datavariabler effektivt kan du skabe personligt, datadrevet indhold, der tilpasser sig brugerinput og forbedrer den samlede workspace-oplevelse.