logo EZ Notification Forwarder
Entwickelt von → matas consulting 		Englisch Deutsch
[Überblick] [Screenshots] [Download] [Dokumentation] [Support] [Datenschutz] [Impressum]

Dokumentation

Voraussetzungen

Windows Benachrichtigungscenter
Grundsätzlich verarbeitet EZ Notification Forwarder alle Benachrichtigungen von den Apps, die im Windows Benachrichtigungscenter registriert und entsprechend der individuellen Bedürfnisse konfiguriert wurden.

Leider gibt es einige Apps, die ein eigenes Sandbox-Benachrichtigungssystem verwenden. Nur wenige dieser Apps bieten eine Option an, um die Nachrichten wahlweise an das Windows Benachrichtigungscenter zu senden.

Prüfen Sie in den Windows-Einstellungen unter System -> Benachrichtigungen in den aufgeführten Apps ob die Apps enthalten sind, die Sie überwachen möchten. Überprüfen Sie die jeweilige Konfiguration, denn der EZ Notification Forwarder verarbeitet nur Benachrichtigungen, die so konfiguriert sind, dass sie an das Windows Benachrichtigungscenter weitergeleitet werden.

E-Mail Konfiguration
Die meisten modernen SMTP-Server akzeptieren die Authentifizierung auf Port 587 mit SSL. Alternative Kombinationen sind:
  • Port 25: Standard, unverschlüsselter SMTP-Port (SSL-Checkbox deaktivieren)
  • Port 465: Mit SSL/TLS gilt als veraltet

Konfiguration json Beispiele

Notification Body json Beispiele

Target URL

Syntax
  • http[s]://servername[:port][/path[?params]]
Beispiel (ohne Pfad und ohne Parameter)
  • http://acme.com/toasts

Variablenersetzung
Generell können alle Elemente aus dem fest definierten JSON als 'Variablen' in
der URL, dem Header und dem benutzerdefinierten JSON eingefügt werden.
Die Liste der fest definierten Variablen lautet:
  • $AppDisplayName
  • $AppId
  • $ClientVersion
  • $Content
  • $HostName
  • $TimeStamp
  • $Title
Beispiel (mit einigen der verfügbaren Variablen als Parameter)
  • http://acme.com/toasts?t=$Title&c=$Content&h=$HostName
Zusätzlich zu den fest definierten Variablen können auch die benutzerdefinierten Variablen
aus den "UserPropertries" in den unterstützten Stellen verwendet werden.

Beispiel mit 'UserProperties'
{
 ...
 "UserProperties": [
  { "Name": "Foo", "Value": "Doo" } ,
  { "Name": "Woo", "Value": "Zoo" } ]
 ...
}

Einfach den Namen der Property mit vorangestelltem Dollarzeichen ('$') an den unterstützten
Stellen hinzufüen. Bei der Weiterleitung wird der Platzhalter dann mit dem Wert
der jeweiligen Property ersetzt.

Beispiel (mit 'UserProperties' Namen)
  • http://acme.com/toasts?t=$Title&c=$Content&h=$HostName&p1=$Foo&p2=$Woo

Zusätzliche http-Header

Ab Version 25.4.0.0 von EZ Notification Forwarder können zusätzliche http-Header
angegeben werden. Die http-Header können dabei mit einer durch Kommas getrennte Liste
von "Name: Wert"-Elementen angegeben werden. Zum Beispiel erfordert die API
`https://api.pushbullet.com/v2/pushes` zur Authentifizierung die Angabe eines Access-Tokens
im http-Header, zum Beispiel: "Access-Token: PrivatesToken".
Um eventuell vorhandene Kommas (",") in Tokens oder starken Passwörtern zu maskieren,
muss der CSS-Entitätscode "\002C" als Ersatz für die Kommas verwendet werden.
Der Eintrag "Access-Token: Vor\002CNach" generiert zum Beispiel den Eintrag "Access-Token: Vor,Nach".

Benutzerdefiniertes JSON

Ab Version 25.4.0.0 von EZ Notification Forwarder wird die Angabe von
benutzerdefiniertem JSON unterstützt.

Beispiel JSON für die PushBullet API:
{
  "type": "note",
  "title": "$Title",
  "body": "$Content"
}

Filterung nach Applikationsname und Nachrichtentext

In den Dialogen "Ziel hinzufügen" und "Ziel anpassen"
können in den entsprechenden Eingabefeldern jeweils mehrere
durch Komma getrennte Werte angegeben werden. Es werden dann nur
die Nachrichten an die konfigurierte URL weitergeleitet, die
im Applikationsnamen oder dem Nachrichtentext einen der definierten
Werte enthalten. Der Vergleich erfolgt dabei "case insensitive".
Wenn die Felder keinen Wert beinhalten, werden alle Nachrichten
an die konfigurierte URL weitergeleitet.

'JsonSerializationConfig'

Ab Version 24.1.0.0 von EZ Notification Forwarder kann das Konfigurationselement
'JsonSerializationConfig' verwendet werden, um angepasste json Daten zu erzeugen.
In 'PropertiesToExclude' kann eine Liste von Elementnamen angegebnen werden,
die dann _NICHT_ in die json Daton serialisiert werden sollen.

Beispiel Konfiguration mit 'JsonSerializationConfig':
{
 ...
 "JsonSerializationConfig": {
  "Indent": true,
  "PropertiesToExclude": "ClientVersion, HostName, UserID, Id, App, TimeStamp, UserProperties"
 }
 ...
}

Resultat
{
 "Notifications": [
  {
   "Title": "Notification Title Text",
   "Content": "Notification Body Text"
  }
 ]
}

Log-Datei "application.log"

Ab der Version 25.2.1.0 (2025/02/20) von EZ Notification Forwarder werden Fehler in die Log-Datei "application.log" im Verzeichnis
"%LocalAppData%\Packages\414matasconsulting.EZNotificationForwarder_
h1qcp5dzdzafj\LocalCache" protokolliert.

Hinweise

  • Aufgrund von Einschränkungen im UWP Framework können keine Nachrichten
    an "localhost" weitergeleitet werden.

  • Einige http RESTful API Endpunkte, wie zum Beispiel → notifymydevice.com,
    die mit Parametern in der URL aufgerufen werden, erfordern die Verwendung der
    http Methode GET anstelle, damit der Request akzeptiert und verarbeitet werden kann.

[top]

[Überblick] [Screenshots] [Download] [Dokumentation] [Support] [Datenschutz] [Impressum]
Letzte Änderung 2025/12/20