Document toolboxDocument toolbox

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

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.