Community Bot - Ergebnisse zusammenfassen

Üblicherweise wird für jedes Ergebnis einer Bot-Aktion eine Benachrichtigung gesendet. Ist z.B. ein Geburtstags-Bot eingerichtet, wird für jedes Mitglied, das Geburtstag hat, eine eigene Benachrichtigung versendet. Haben an einem Tag 10 Mitglieder Geburtstag, fallen also 10 Benachrichtigungen an. Durch das Zusammenfassen der Ergebnisse besteht nun die Möglichkeit, alle Geburtstage in nur einer Benachrichtigung darzustellen.

Aktionen

Ergebnisse lassen sich vornehmlich bei benutzerbezogenen Aktionen, wie z.B. Geburtstagen und Gruppenzuordnungen, zusammenfassen. Wenn immer das Zusammenfassen möglich ist, wird eine entsprechende Konfigurationsoption bei der Aktion eingeblendet und es steht auf der Benachrichtigungsseite ein zusätzliches Textfeld "Zusammenfassung" zur Verfügung. In diesem Textfeld muss dann eine Kombination von Platzhaltern und Text eingegeben werden, in die dann durch den Bot jedes Ergebnis eingetragen wird.

Platzhalter

Bei der Zusammenfassung von Ergebnissen können insbesondere benutzerbezogene Platzhalter nicht mehr im normalen Text genutzt werden. Dazu fehlt die eindeutige Zuordnung, weil ja eben z.B. mehrere Benutzernamen für einen Platzhalter [user-name] vorliegen. Um diese Platzhalter trotzdem in der Benachrichtigung nutzen zu können, müssen sie in das Textfeld "Zusammenfassung" eingetragen werden. Im Textfeld können einfache HTML-Befehle zur weiteren Formatierung genutzt werden; z.B. <strong> für Fettschrift oder <br> für einen Zeilenumbruch.


Der Bot füllt nun alle Platzhalter mit den ermittelten Ergebnissen, formatiert sie, fasst sie intern zusammen und fügt sie in die Benachrichtigung ein. Hierzu dienen die Platzhalter [condense-list] oder [condense-comma], von denen aber immer nur einer genutzt werden darf. [condense-list] fasst die Ergebnisse in einer unformatierten Liste zusammen und [condense-comma] stellt die Ergebnisse kommagetrennt in einer Zeile dar.


Es bietet sich an, zunächst den Test-Modus zu nutzen, um sich ein Bild von der Benachrichtigung machen zu können.

Beispiel

Mit dem Beispiel einer Gruppenzuordnung soll die Konfiguration und Nutzung der Zusammenfassung veranschaulicht werden.



Mit dem Text [user-name] ist jetzt Mitglied der Gruppen <strong>[user-groups]</strong> werden die Namen aller betroffenen Benutzer und deren Gruppenzugehörigkeit zusammengefasst. Dabei wird die Gruppenzugehörigkeit fett formatiert.


Dieser Text wird mit dem Platzhalter [condense-list] in die Benachrichtigung eingefügt und führt zu folgendem Ergebnis:



Wird der Platzhalter [condense-comma] in der Benachrichtigung genutzt, sieht das Ergebnis so aus: