Variablen

Einleitung

Variablen ermöglichen das Einfügen von Platzhaltern in Textfeldern, die später vom System durch reale Daten ersetzt werden. Diese Funktion verbessert die Automatisierung und Konsistenz.

Aktivierung von Variablen

Bevor Variablen verwendet werden können, muss die Funktion auf Unternehmensebene aktiviert werden. Gehe dazu wie folgt vor:

1. Wählen Sie Meine Firma aus dem Seitenmenü.
2. Wählen Sie den Tab Einstellungen.
3. Suchen Sie den Abschnitt Variablen.
4. Aktivieren Sie die Option Variablen an Textfeldern vorschlagen. (Bild)

Wo können Variablen verwendet werden?

Nach der Aktivierung können Variablen in Templates und Geräten genutzt werden, insbesondere in deren Beschreibungen und Modulen (z. B. Text Assistent, Begrüßung, Erstellungsabläufe, Text Bausteine). Wenn der Einsatz von Variablen unterstützt wird, zeigt das System an entsprechenden Stelle ein Variablen-Symbol in den Text Tools an. (Bild)

Verwendung von Variablen in Textfeldern

Variablen in der Plattform folgen der Mustache-Syntax. Sobald {{ (zwei geschweifte Klammern) in einem passenden Textfeld eingegeben wird, bietet das System Vorschläge für verfügbare Datenfelder an. (Bild)

Beispiel:

Ein Unternehmen möchte automatische Gerätebeschreibungen mit Variablen generieren. Statt jede Information manuell einzugeben, kann folgender Text in das Beschreibungsfeld des Templates eingefügt werden:

• {{taggedObject.serialNumber}} – Zeigt die Seriennummer des Geräts an
• {{customer.name}} – Fügt den Namen des zugewiesenen Kunden ein

"Dieses Gerät (Seriennummer: {{taggedObject.serialNumber}}) ist {{customer.name}} zugewiesen."

Bei jedem Anzeigen des Geräts ersetzt das System die Platzhalter durch die tatsächlichen Daten. So wird sichergestellt, dass immer die aktuellesten Daten angezeigt werden. (Bild)(Bild)

Wichtige Einschränkung bei der Verwendung von Variablen

Es ist wichtig zu beachten, dass Variablen keine anderen Variablen referenzieren können. Wenn eine Variable auf ein Textfeld verweist, das eine andere Variable enthält, wird die innere Variable nicht verarbeitet. Stattdessen wird sie als einfacher Text angezeigt.

Beispiel:
Wenn Sie eine Variable wie {{taggedObject.description}} verwenden und die Gerätebeschreibung den Text „Seriennummer: {{taggedObject.serialNumber}}“ enthält, wird bei der Anzeige nicht die tatsächliche Seriennummer des Geräts angezeigt. Stattdessen wird der Text wörtlich als „Seriennummer: {{taggedObject.serialNumber}}“ dargestellt.

Um dieses Problem zu vermeiden, stellen Sie sicher, dass Ihre Variablen direkt auf vorhandene Daten verweisen und nicht auf Textfelder, die andere Variablen enthalten.

If-Abschnitte (Bedingte Logik)

Mustache ermöglicht einfache bedingte Logik mit Abschnitten (#) und invertierten Abschnitten (^). Damit können Fallback-Werte festgelegt werden, falls bestimmte Daten fehlen.

Beispiel:

{{#customer}}{{#user}}{{firstName}}{{/user}}{{^user}}{{name}}{{/user}}'s{{/customer}}{{^customer}}Ihr{{/customer}} Lieblingsauto

Funktionsweise:

1. Prüfe, ob ein Kunde existiert: {{#customer}}
   • Falls ein Kunde vorhanden ist, wird der Block ausgeführt.
   • Falls nicht, wird zu {{^customer}}Ihr{{/customer}} gesprungen (Fallback zu "Ihr").
2. Prüfe, ob der Kunde einen Nutzer hat: {{#user}}
   • Falls ja, wird {{firstName}} angezeigt.
   • Falls nicht, wird zur nächsten Bedingung übergegangen.
3. Falls kein Nutzer existiert, zeige den Firmennamen: {{^user}}{{name}}{{/user}}
   • Falls ein Kunde existiert, aber keinen Nutzer hat (also kein Privatkunde ist), wird der Name des Firmenkunden angezeigt.
4. Falls kein Kunde existiert, nutze "Ihr": {{^customer}}Ihr{{/customer}}
   • Stellt sicher, dass bei fehlendem Kunden "Ihr" als Standardwert genutzt wird.

Beispielausgaben:

Szenario	Ausgabe
Kunde existiert mit Nutzer (John) → Privatkunde	"Emily's Lieblingsauto" (Bild)
Kunde existiert ohne Nutzer (Acme Corp) → Firmenkunde	"ThunderPeak GmbH's Lieblingsauto" (Bild)
Kein Kunde existiert	"Ihr Lieblingsauto" (Bild)

Liste der verfügbaren Variablen

Kategorie	Variablenpfad	Beschreibung
Ticket
	{{ticket.id}}	ID des Tickets
	{{ticket.creationDate}}	Erstellungsdatum des Tickets
	{{ticket.lastUpdate}}	Datum der letzten Aktualisierung des Tickets
	{{ticket.title}}	Titel des Tickets
	{{ticket.description}}	Beschreibung des Tickets
	{{ticket.reporter}}	Ersteller des Tickets
	{{ticket.author}}	Autor des Tickets
	{{ticket.dueDate}}	Wunschtermin des Tickets
	{{ticket.location}}	Standort des Tickets
	{{ticket.location.validated}}	Wahr oder falsch
	{{ticket.location.latitude}}	Breitengrad des Standorts des Tickets
	{{ticket.location.longitude}}	Längengrad des Standorts des Tickets
	{{ticket.location.country}}	Land des Standorts des Tickets
	{{ticket.location.state}}	Bundesland des Standorts des Tickets
	{{ticket.location.city}}	Stadt des Standorts des Tickets
	{{ticket.location.zipCode}}	Postleitzahl des Standorts des Tickets
	{{ticket.location.street}}	Straßenname des Standorts des Tickets
	{{ticket.location.streetNumber}}	Hausnummer des Standorts des Tickets
	{{ticket.location.floor}}	Stockwerk des Standorts des Tickets
	{{ticket.location.room}}	Raum des Standorts des Tickets
Gerät (Tagged Object)
	{{taggedObject.id}}	ID des Geräts
	{{taggedObject.creationDate}}	Erstellungsdatum des Geräts
	{{taggedObject.lastUpdate}}	Datum der letzten Aktualisierung des Geräts
	{{taggedObject.template}}	Name des Templates des Geräts
	{{taggedObject.customer}}	Kunde der dem Gerät zugewiesen ist
	{{taggedObject.customer.id}}	ID des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.creationDate}}	Erstellungsdatum des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.lastUpdate}}	Datum der letzten Aktualisierung des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.customerId}}	Kunden-ID des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.name}}	Name des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.info}}	Zusätzliche Informationen es Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address}}	Komplette Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.validated}}	Wahr oder falsch
	{{taggedObject.customer.address.latitude}}	Breitengrad der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.longitude}}	Längengrad der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.country}}	Land der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.state}}	Bundesland der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.city}}	Stadt der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.zipCode}}	Postleitzahl der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.street}}	Straßenname der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.streetNumber}}	Hausnummer der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.floor}}	Stockwerk der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.address.room}}	Raum der Adresse des Kunden der dem Gerät zugewiesen ist
	{{taggedObject.serialNumber}}	Seriennummer des Geräts
	{{taggedObject.serviceContract}}	Servicevertragsnummer des Geräts
	{{taggedObject.title}}	Titel des Geräts
	{{taggedObject.manufacturer}}	Hersteller des Geräts
	{{taggedObject.model}}	Modell / Typ des Geräts
	{{taggedObject.description}}	Beschreibung des Geräts
	{{taggedObject.additionalData}}	Zusätzliche Informationen des Geräts
	{{taggedObject.customer.user}}	Kompletter Name des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.firstName}}	Vorname des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.lastName}}	Nachname des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address}}	Komplette Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.validated}}	Wahr oder falsch
	{{taggedObject.customer.user.address.latitude}}	Breitengrad der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.longitude}}	Längengrad der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.country}}	Land der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.state}}	Bundesland der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.city}}	Stadt der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.zipCode}}	Postleitzahl der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.street}}	Straßenname der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.streetNumber}}	Hausnummer der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.floor}}	Stockwerk der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.address.room}}	Raum der Adresse des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.phone}}	Telefonnummer des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.user.dateOfBirth}}	Geburtsdatum des Privatkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization}}	Name des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address}}	Komplette Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.validated}}	Wahr oder falsch
	{{taggedObject.customer.organization.address.latitude}}	Breitengrad der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.longitude}}	Längengrad der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.country}}	Land der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.state}}	Bundesland der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.city}}	Stadt der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.zipCode}}	Postleitzahl der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.street}}	Straßenname der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.streetNumber}}	Hausnummer der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.floor}}	Stockwerk der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.address.room}}	Raum der Adresse des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.name}}	Name des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.phone}}	Telefonnummer des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.email}}	E-Mail des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.website}}	Website des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.customer.organization.info}}	Notizen des Firmenkunden der dem Gerät zugewiesen ist
	{{taggedObject.objectTag}}	ID des Codes der mit dem Gerät verknüpft ist
	{{taggedObject.location}}	Standort des Geräts
	{{taggedObject.location.validated}}	Wahr oder falsch
	{{taggedObject.location.latitude}}	Breitengrad des Standorts des Geräts
	{{taggedObject.location.longitude}}	Längengrad des Standorts des Geräts
	{{taggedObject.location.country}}	Land des Standorts des Geräts
	{{taggedObject.location.state}}	Bundesland des Standorts des Geräts
	{{taggedObject.location.city}}	Stadt des Standorts des Geräts
	{{taggedObject.location.zipCode}}	Postleitzahl des Standorts des Geräts
	{{taggedObject.location.street}}	Straßenname des Standorts des Geräts
	{{taggedObject.location.streetNumber}}	Hausnummer des Standorts des Geräts
	{{taggedObject.location.floor}}	Stockwerk des Standorts des Geräts
	{{taggedObject.location.room}}	Raum des Standorts des Geräts
	{{taggedObject.serialNumber}}	Seriennummer des Geräts
	{{taggedObject.serviceContract}}	Servicevertragsnummer des Geräts
	{{taggedObject.title}}	Titel des Geräts
	{{taggedObject.manufacturer}}	Hersteller des Geräts
	{{taggedObject.model}}	Modell / Typ des Geräts
	{{taggedObject.description}}	Beschreibung des Geräts
	{{taggedObject.additionalData}}	Zusätzliche Informationen des Geräts
Code (Object Tag)
	{{objectTag.id}}	ID des Codes
	{{objectTag.creationDate}}	Erstellungsdatum des Codes
	{{objectTag.lastUpdate}}	Letzte Aktualisierung des Codes
	{{objectTag.shortId}}	Short-ID des Codes
	{{objectTag.lastLogin}}	Letzter Login des Codes
Kunde
	{{customer.id}}	ID des Kunden
	{{customer.creationDate}}	Erstellungsdatum des Kunden
	{{customer.lastUpdate}}	Letzte Aktualisierung des Kunden
	{{customer.customerId}}	Kunden-ID des Kunden
	{{customer.name}}	Name des Privatkunden
	{{customer.info}}	Zusätzliche Informationen des Kunden
	{{customer.address.latitude}}	Breitengrad der Adresse des Kunden
	{{customer.address.longitude}}	Längengrad der Adresse des Kunden
	{{customer.address.country}}	Adresse des Kunden
	{{customer.address.state}}	Bundesland der Adresse des Kunden
	{{customer.address.city}}	Stadt der Adresse des Kunden
	{{customer.address.zipCode}}	Postleitzahl der Adresse des Kunden
	{{customer.address.street}}	Straßenname der Adresse des Kunden
	{{customer.address.streetNumber}}	Hausnummer der Adresse des Kunden
	{{customer.user.firstName}}	Vorname des Privatkunden
	{{customer.user.lastName}}	Nachname des Privatkunden
	{{customer.user.phone}}	Telefonnummer des Privatkunden
	{{customer.user.dateOfBirth}}	Geburtsdatum des Privatkunden
	{{customer.organization.name}}	Name des Firmenkunden
	{{customer.organization.phone}}	Telefonnummer des Firmenkunden
	{{customer.organization.email}}	E-Mail des Firmenkunden
	{{customer.organization.website}}	Website des Firmenkunden

Shortcuts

Variablenpfad	Beschreibung
{{user}}	Kompletter Name
{{author}}	Kompletter Name / "Code Nutzer"
{{customer}}	Kompletter Name / Firmenname
{{address}}	Kompletter Adresse
{{location}}	Kompletter Adresse

Best Practices

• Verfügbare Variablen prüfen, indem {{ in einem unterstützten Feld eingegeben wird.
• Sicherstellen, dass Platzhalter mit vorhandenen Datenfeldern übereinstimmen, um leere Ergebnisse zu vermeiden.
• Variablen vor dem Einsatz in Live-Umgebungen testen.

Weitere Details zur Mustache-Syntax: Mustache Dokumentation.