Logging in einer Desktop Extension oder einem Desktop Plugin
Das Logging in einer Desktop Extension oder einem Desktop Plugin läuft nicht wie normalerweise über den Helper, da der Helper die Reports nur ein eine Liste schreibt, welche normalerweise mit der Messages Liste aus einem Step verknüpft wird.
Stattdessen muss das Nuget-Paket Development.SDK.UI installiert werden.
Die DLL aus dem Paket darf nicht mit in das Modul, da der Client die DLL bereitstellt!
Aus dieser DLL können dann die folgenden Methoden verwendet werden:
SendMessage
void Development.SDK.Events.SendMessage(
string title,
string message,
string details,
Enums.ReportLevel level,
bool showToastr = false
)
Diese Methode sendet eine Nachricht an das Nachrichtencenter im Client.
Ist der ReportLevel höher als Debug (ist er also entweder Info, Success, Warning, Error oder Fatal), wird zusätzlich eine Message Box oder eine System-Notification angezeigt (je nach Nutzereinstellung). Wenn showToastr auf true gesetzt wird, wird eine Anzeige der System-Notification erzwungen.
Wenn der ReportLevel Trace, Debug oder Chat ist, wird das Flag ignoriert da in diesem Fall keine Meldung angezeigt wird.
ShowToastr
void Development.SDK.Events.ShowToastr(
string title,
string message,
Enums.ReportLevel level
)
Über diese Methode kann eine System-Benachrichtigung erzeugt werden. Der Report Level legt fest, welches Icon für die Benachrichtigung verwendet werden soll. Die Nachricht wird zusätzlich noch im Message-Center gespeichert.
Icons
ReportLevel | Icon |
---|---|
Info, Debug | Ein Informations-Icon (Blaues i) |
Warning | Ein Warn-Icon (Gelbes Dreieck) |
Error, Fatal | Ein Fehler-Icon (Rotes Kreuz) |
alles andere | Kein Icon |
ShowMessageBox
System.Windows.MessageBoxResult Development.SDK.Events.ShowMessageBox(
string caption,
string message,
System.Windows.MessageBoxButton buttons
)
Über diese Funktion kann eine Message Box im Client Design aufgerufen werden.