Wenn Sie in todo4teams schon einmal ein kleines Skript erstellt haben, haben Sie gesehen, dass Sie darin auf bestimmte "Objekte", zum Beispeil das aktuelle Ticket, Zugriff haben. Das heißt, Sie können dort Eigenschaften des Tickets, sogenannte Attribute, auslesen oder verändern.
Das aktuelle Ticket heißt in jedem Skript task.
Um zum Beispiel auf den Titel des Tickets zuzugreifen, schreiben Sie im Skript
task.title
also zum Beispiel die Zeile
println(task.title);
Aber wie können Sie wissen, welche Attribute es zu einem bestimmten Objekt gibt, wie sie genau heißen und welcher Variablentyp, Zahl, Zeichenkette oder Datum, darin gespeichert wird?
Hier hilft Ihnen die todo4teams-Klassendokumentation weiter.
Sie dokumentiert die wichtigsten Klassen des in Java programmierten Helpdesk-Systems, so dass Sie daraus leicht Code für Ihr Skript ableiten können.
Dass die Skripte in Javascript und nicht in Java geschrieben werden, stellt hier kaum kein Problem dar, da die Methoden und Attribute der Objekte in Javascript unter gleichem Namen verfügbar sind (mehr zur Javascript-Programmierung in todo4teams finden Sie hier).
Nehmen wir zum Beispiel die Dokumentation einer ausgehenden E-Mail in todo4teams, ToDoOutgoingMail, oder wie man in der Java-Welt unter Einbeziehung des Paketnamens schreiben würde com.proxemo.todo4.bom.ToDoOutgoingMail (siehe hier):
| Modifier and Type | Method | Description |
|---|---|---|
| java.util.Set<ToDoMailAttachment> | getAttachments() | |
| java.lang.String | getBcc() | |
| java.lang.String | getCc() | |
| java.lang.String | getFrom() | |
| java.lang.Long | getId() | Method returning a canonical id of the object. |
| ToDoMailbox | getMailbox() | |
| java.util.Set<ToDoMailAttachment> | getReplyAttachments() | |
| java.lang.String | getReplyTo() | |
| int | getSendCounter() | |
| java.util.Date | getSendDate() | |
| java.lang.String | getSendErrorMessage() | |
| java.lang.String | getStateAsString() | |
| int | getStatus() | |
| java.lang.String | getSubject() | |
| ToDoTask | getTask() |
Wenn Sie also z.B. in einem Skript die "ReplyTo"-Adresse einer vom System zu versendenden E-Mail auswerten möchten, schreiben Sie im Skript
var replyAddress = outgoingMail.getReplyTo();
Wenn eine Methode einen komplexen Type zurückgibt, wie hier z.B. getReplyAttachments(), dann können Sie über den Typ ToDoMailAttachment direkt weiternavigieren.
Und falls Sie doch einmal keine Lösung finden, sprechen Sie uns einfach an!