Skripte des Typs News
Mit Skripten des Typs News wird festgelegt, welche News auf dem Dashboard des Web Clients bzw. der Startseite von CM/Track angezeigt werden. Die vom Skript zurückgegebenen News können aus verschiedenen Quellen abgerufen werden, zum Beispiel aus Vorgangskommentaren oder RSS-Feeds, oder direkt im Skript erstellt werden.
Das News-Skript gibt eine Liste mit News-Einträgen zurück, die im Web Client bzw. CM/Track angezeigt werden. Diese Liste kann auf zwei Wegen erstellt werden:
- Erstellen Sie eine Liste mit Objekten der Klasse NewsItem.
- Verwenden Sie die Convenience-Methode getNewsFromTicketEntries der Klasse NewsService, um News direkt aus Vorgangskommentaren abzurufen.
Falls Sie getNewsFromTicketEntries verwenden, müssen Sie im News-Skript Folgendes definieren:
- Queues, die die News-Vorgänge enthalten
- Bereiche, in denen sich die Vorgänge befinden müssen
- Textklassen, mit denen die Kommentare markiert sein müssen
Aus jedem Vorgang wird der neueste Kommentar, der mit einer der Textklassen markiert ist, in den News angezeigt. In News-Skripten können nur Protokolleinträge des Typs Kommentar verwendet werden. Wenn ein anderer Eintrag, zum Beispiel eine E-Mail, mit der konfigurierten Textklasse markiert ist, wird der Eintrag ignoriert.
Die Standardwerte für News-Einträge aus Vorgangskommentaren sind:
- subject: Der Name und Betreff des Vorgangs, zu dem der Kommentar gehört.
- author: Der Benutzer oder Kontakt, der den Kommentar hinzugefügt hat.
- content: Der neuste Kommentar im Vorgang, der die angegebene Textklasse hat. Inline-Bilder und Formatierungen werden übernommen.
- creation date: Das Datum, an dem der Kommentar hinzugefügt wurde.
- update date: Das Datum, an dem der Kommentar aktualisiert wurde.
- color: Die Hintergrundfarbe der Textklasse.
Schritte zur Verwendung eines News-Skripts:
- Schreiben Sie auf der Seite Skripte ein Skript des Typs News.
- Weisen Sie das Skript in der News-Konfiguration zu:
- Web Client: Weisen Sie das Skript dem News-Widget in der Seitenanpassung zu (siehe News-Widgets).
- CM/Track: Referenzieren Sie das Skript in der Client-Konfiguration der Startseite (siehe Konfigurieren der News)
- Passen Sie die Standardwerte zum Anzeigen von News in der News-Konfiguration an (optional).
Programmierbeispiel 1: Pseudocode zum Abrufen von News
Das folgende Pseudocode-Beispiel zeigt, wie eine Liste von NewsItems aus einem RSS-Channel erstellt wird.
def newsList = []
def url = "myurl"
Locale.setDefault(Locale.US)
try{
def rss = new XmlSlurper().parseText(url)
rss.channel.item.each {
def date = new Date().parse("EEE, dd MMM yy HH:mm:ss", "${it.pubDate}".substring(0, 23))
newsList.add(new NewsItem("${it.title}" as String, null, "${it.description}", date, null, null))
}
}catch(Exception e){
newsList.add(new NewsItem("No response from server" as String, ""))
}
return newsList
Code-Beispiel 7: Pseudocode zum Erstellen von News-Einträgen aus einem RSS-Channel
Programmierbeispiel 2: Abrufen von News aus Vorgangskommentaren
Das folgende Beispiel zeigt ein Skript des Typs News, mit dem News aus Vorgangskommentaren abgerufen werden:
Set queues = ["ServiceDesk"]
Set scopes = ["defaultScope/Service_Desk/Work_in_progress"]
Set textClasses = ["Solution"]
return newsService.getNewsFromTicketEntries(queues, scopes, textClasses)
Code-Beispiel 8: Skript zum Abrufen von News aus Vorgangseinträgen
Das Skript ruft die Einträge als Objekte der Klasse TicketEntryNewsItem ab. Die Daten können aus den abgerufenen Einträgen extrahiert und nach Bedarf aktualisiert werden.