Textbausteine mit Makros erweitern

Textbausteine sind ein mächtiges Mittel in todo4teams um häufig gestellte Anfragen schnell beantworten zu können. In todo4teams können Textbausteine nicht nur Text, sonderan auch Bilder, Tabellen und alle weiteren in HTM zugänglichen Formatierungselemente enthalten. Darüberhinaus kann man die Textbausteine in todo4teams noch durch eine Makrosprache erweitern, um dynamisch Inhalte einzufügen. Die Makros in Textbausteinen werden in Mengenklammern eingebettet.

Auf die folgenden Objekte können Sie aus einem Textbaustein heraus zugreifen:

  • user (der aktuelle Benutzer)
  • mailboxes (die Liste der E-Mail-Eingänge, die mit todo4teams verbunden sind)
  • workgroups (die Liste der Gruppen, die in todo4teams konfiguriert sind)
  • task (das aktuell bearbeitete ToDo) 

Eigenschaften des Benutzers

So kann man in einen Textbaustein den Vor- und Zunamen des Bearbeiters einfügen indem man folgendes Makro einfügt:

{user.firstname} {user.lastname}

E-Mail-Eingänge und Gruppen

Fügen Sie Footer der Mailbox mit der Id 2 ein, indem Sie folgendes Makro in einen Textbaustein einbetten:

{mailboxes.2.footer}

Ein weiteres Beispiel ist das Einfügen des Verantwortlichen für die Gruppe mit der Id 7:

{workgroups.7.responsible}

Zugriff auf Ticket-Eigenschaften und Formularfelder

Wenn Sie die Nummer des gerade bearbeiteten Tickets in den Text einfügen möchten, verwenden Sie den Platzhalter {task.id}:

Bei Rückfragen nennen Sie uns bitte die Bearbeitungsnummer dieses Vorgangs: {task.id}

Wenn Sie diese Zeile in einer Textvorlage bei der Beantwortung einer E-Mail verwenden, wird der eingefügte Text z.B. so aussehen:

Bei Rückfragen nennen Sie uns bitte die Bearbeitungsnummer dieses Vorgangs: 4320112

Ab todo4teams Version 5.3 sind auch die folgenden Zugriffe auf Formularwerte und Ticket-Eigenschaften (Task-Properties) möglich:

Der Wert eines angehängten Formulares (intern MetaData genannt) kann unter Verwendung des Formularnamens oder dessen Nummer ermittelt werden:
Dear Mr./Mrs. {task.metadata.CustomerForm.LastName}
Hier wird auf das Formular mit dem Namen "CustomerForm" und den Feldnamen "LastName" Bezug genommen. Enthält das Formular des bearbeiteten Tickets in diesem Feld den Wert "Smith", dann wir bei Verwendung des Textbausteins der Text
Dear Mr./Mrs. Smith
eingefügt.

Wenn Sie lieber die Nummer des Formulars verwenden möchten, schreiben Sie das Makro so:

Dear Mr./Mrs. {task.metadata.23.LastName}
 
Wenn Sie in Ihren Skripten Task-Properties verwenden, indem Sie z.B. folgenden Code schreiben

task.addProperty("customerId", "2938485");

 dann können Sie in einem Textbaustein mit der folgenden Zeile auf diesen Wert wieder zugreifen:

Your customer id: {task.property.customerId}
 
Damit erzeugen Sie den Text

Your customer id: 2938485

Falls ein Task-Property, auf das Sie hier Bezug nehmen, nicht gesetzt ist, wird einfach kein Text eingefügt! Sie müssen also keine Angst haben, mit einem dieser Makros Fehler zu erzeugen!

Beispiel:

Your customer id: {task.property.NoPropertyWithThisName}
 
erzeugt den Text

Your customer id: 

     

Schnelleinstieg

Unterseiten