Benachrichtigungen
Themen in diesem Dokument:
Um auf diesen Abschnitt in EV Charge zuzugreifen, wählen Sie im Menü, wählen Sie Systemkonfiguration und klicken Sie auf Notifications.
Benachrichtigungen
Um auf diesen Abschnitt zuzugreifen, klicken Sie auf Notifications. Eine paginierte Liste aller Benachrichtigungen wird in tabellarischer Form angezeigt.
Vier Aktionen/Unterseiten können in diesem Abschnitt durchgeführt/angesehen werden, nämlich:
- Benachrichtigung erstellen
- Details zur Benachrichtigungsseite
- Benachrichtigung aktualisieren
- Benachrichtigung löschen
Benachrichtigung erstellen
Unter Benachrichtigungen klicken Sie auf Erstellen, um eine Benachrichtigung zu erstellen. Geben Sie einen Namen und einen Code an.
Hinweis:
Der Code ist ein eindeutiger Identifikator eines Objekts. Er kann während der Integration mit der EV Charge API verwendet werden.Publishers wird verwendet, um zu konfigurieren, welche Art von Benachrichtigung gesendet wird: SMS, Push-Benachrichtigung, URL, E-Mail und Protokoll. Es wird auch verwendet, um zu konfigurieren, wohin die Benachrichtigung mit Receivers gesendet wird.
Liste der anwendbaren Receiver-Wertpaare für den Veröffentlichungstyp:
Base: Benachrichtigungen richten sich an einfache Zielkontaktinformationen, abhängig vom Publisher-Typ (E-Mail-Adresse, Telefonnummer oder URL).
Customer: Benachrichtigungen richten sich an das Ziel der primären Kontaktinformationen des Kunden, abhängig vom Publisher-Typ (E-Mail-Adresse, Telefonnummer, URL, Push-Benachrichtigung), wenn die Aktion mit dem spezifischen Kunden verbunden ist. Zusätzlich kann als Wert die Kundentypgruppe ausgewählt werden, was bedeutet, dass die Benachrichtigung nur gilt, wenn der Kunde zur spezifischen Kundengruppe gehört.
Um einen Publisher zu erstellen, klicken Sie unter Publishers auf Add publisher. Die Aktion und die Anzahl der Wiederholungen geben den Typ der Benachrichtigung an, die gesendet wird, und wie oft sie im Falle eines Fehlers erneut gesendet werden soll – zum Beispiel das Versenden einer E-Mail, die dreimal erneut gesendet wird, falls sie fehlschlägt.
Information:
Die Vorlage ist in EV Charge konfiguriert, unter Geschäftskonfiguration Vorlagen. Für weitere Informationen siehe Vorlagen.Hinweis:
Die URL-Aktion bedeutet, dass die Benachrichtigung als API-Anfrage an die URL gesendet wird, während die Log-Aktion bedeutet, dass der Logging-Dienst einen Logeintrag hinzufügt, wann immer die Benachrichtigung ausgelöst wird.Unter jedem Publisher befinden sich Receivers. Die Receivers beziehen sich darauf, wohin die Benachrichtigung gesendet wird. Es kann eine URL oder ein Kunde sein (wenn es sich um eine E-Mail oder SMS handelt).
Der Scope beschreibt, was die Benachrichtigung auslöst, was eine Änderung in der Ladeinfrastruktur oder eine Änderung in der Ladesitzung sein kann.
Sobald eine spezifische Aktion aus dem Scope auftritt, können Sie Filteroptionen hinzufügen. Um einen Filter hinzuzufügen, klicken Sie unter Filters auf Add filter.
Beispiel einer Benachrichtigung
- Scope: Ladevorgänge
- Action: Batteriestatus
- Filter: Batteriestatus gleich 80% (80% erreicht)
Information:
In diesem Fall wird eine Benachrichtigung gesendet, wenn das Fahrzeug 80% Ladezustand erreicht hat.Details zur Benachrichtigungsseite
Unter Benachrichtigung können Sie die vollständigen Details einer Benachrichtigung einsehen, indem Sie auf Details klicken. Es enthält die folgenden Informationen:
- Name
- Code
- Action
- Scope
- Publishers
- Filters (falls vorhanden)
Benachrichtigung aktualisieren
Unter Benachrichtigung können Sie eine Benachrichtigung aktualisieren, indem Sie zuerst auf Details klicken; dies zeigt die Details der Benachrichtigung an. Um zu aktualisieren, klicken Sie dann auf Aktualisieren.
Information:
Alle Informationen, die im Abschnitt Benachrichtigung erstellen ausgefüllt wurden, können aktualisiert werden, mit Ausnahme des Codes.Benachrichtigung löschen
Unter Benachrichtigung können Sie eine Benachrichtigung löschen, indem Sie auf Löschen klicken.
Benachrichtigungsumfang und Aktionen
Der Benachrichtigungsumfang definiert den Auslöseereignisumfang von EV-Lade-bezogenen Benachrichtigungen.
Es gibt derzeit zwei Bereiche von EV-Lade-bezogenen Benachrichtigungen:
- Ladeinfrastruktur: Benachrichtigung über ladeinfrastrukturbezogene Operationen. Siehe Tabelle 1 für anwendbare Aktionen im Bereich.
- Ladesitzungen: Benachrichtigung über ladesitzungssteuerungsbezogene Operationen. Siehe Tabelle 2 für anwendbare Aktionen im Bereich.
| Aktionsname | Beschreibung |
|---|---|
| Station connected | Gibt an, dass die Ladestation erfolgreich die Verbindung mit dem zentralen System von Tridens EV Charge hergestellt hat. |
| Station booted | Gibt an, dass die Ladestation das Boot-Ereignis gemeldet hat. Es bedeutet normalerweise, dass der erfolgreiche Boot nach dem Neustart erfolgt ist, aber das Boot-Ereignis kann auch auf Anfrage ausgelöst werden. |
| Station disconnected | Gibt an, dass sich die Ladestation vom zentralen System von Tridens EV Charge getrennt hat. |
| Station reset | Gibt an, dass das zentrale System von Tridens EV Charge die Ladestation zum Zurücksetzen aufgefordert hat. |
| Charger status changed | Gibt an, dass der Status des Ladegeräts geändert und an das zentrale System von Tridens EV Charge gemeldet wurde. Z.B. Status auf verfügbar, nicht verfügbar, gestört usw. umgeschaltet. Enthält auch zusätzliche gemeldete Statusinformationen, falls vom Ladegerätehersteller bereitgestellt. |
| Connector status changed | Gibt an, dass der Status des Anschlusses geändert und an das zentrale System von Tridens EV Charge gemeldet wurde. Z.B. Status auf verfügbar, vorbereitend, ladend, ausgesetzt, nicht verfügbar, gestört usw. umgeschaltet. Enthält auch zusätzliche gemeldete Statusinformationen, falls vom Ladegerätehersteller bereitgestellt. |
| Connector unlocking requested | Gibt an, dass das zentrale System von Tridens EV Charge den Anschluss aufgefordert hat, sich vom mechanischen elektromagnetischen Schloss zu entriegeln. |
| Connector unlocking result | Gibt das Ergebnis der Entriegelung des Anschlusses (mechanisches elektromagnetisches Schloss) an, das vom Ladegerät an das zentrale System von Tridens EV Charge gemeldet wurde. |
| Energy meter report | Stellt den allgemeinen Energiezählerbericht in kWh dar, der vom Ladegerät an das zentrale System von Tridens EV Charge gemeldet wurde. |
| Firmware update requested | Gibt an, dass das zentrale System von Tridens EV Charge das Firmware-Upgrade auf dem Ladegerät angefordert hat. |
| Firmware status | Gibt den Status des Firmware-Updates auf dem Ladegerät an, wie vom Ladegerät an das zentrale System von Tridens EV Charge gemeldet. Z.B. herunterladen, heruntergeladen, installieren, installiert, fehlgeschlagen usw. |
| Diagnostics requested | Gibt an, dass das zentrale System von Tridens EV Charge das Ladegerät zur Diagnose aufgefordert hat. |
| Diagnostic status | Gibt den Status der Diagnosemeldung durch das Ladegerät an. Vom Ladegerät an das zentrale System von Tridens EV Charge gemeldet. Z.B. hochladen, hochgeladen, fehlgeschlagen usw. |
| Display setup requested | Gibt an, dass das zentrale System von Tridens EV Charge die Station aufgefordert hat, die Displaynachricht einzurichten. |
| Display setup result | Gibt das Ergebnis der Anfrage zur Einrichtung des Stationsdisplays an. |
| Display clear requested | Gibt an, dass das zentrale System von Tridens EV Charge die Station aufgefordert hat, die Displaynachricht zu löschen. |
| Display clear result | Gibt das Ergebnis der Anfrage zur Löschung des Stationsdisplays an. |
| Display settings reported | Gibt an, dass die Ladestation die Einrichtung der Displaynachricht an das zentrale System von Tridens EV Charge gemeldet hat. |
Tabelle 1. Ladeinfrastrukturaktionen/-ereignisse.
| Aktionsname | Beschreibung |
|---|---|
| Authorization | Gibt an, dass der EV-Fahrer die Autorisierung der Ladesitzung durch ein Identifikationsgerät (z. B. Durchziehen einer RFID) auf der Ladegeräteseite versucht hat und der Versuch an das zentrale System von Tridens EV Charge weitergeleitet wurde. Nicht zu verwechseln mit den Bewertungsautorisierungen. |
| Authorized | Gibt an, dass sich der EV-Fahrer erfolgreich für die Ladesitzung auf der Ladegeräteseite mit einem Identifikationsgerät (z. B. Durchziehen einer RFID) autorisiert hat, indem die Autorisierung vom zentralen System von Tridens EV Charge akzeptiert wurde. Nicht zu verwechseln mit den Bewertungsautorisierungen. |
| Started | Gibt an, dass die Ladesitzung auf der Ladeinfrastruktur begonnen hat. |
| Ended | Gibt an, dass die Sitzung beendet und endgültig abgeschlossen wurde. Der Status geht in “geschlossen” über. Beinhaltet das Beenden im Parkzeit-Sitzungsbeendigungsmodus. |
| Reservation created | Gibt an, dass eine sofortige Reservierung der Ladeinfrastruktur für die Ladesitzung vorgenommen wurde. |
| Reservation canceled | Gibt an, dass die Reservierung der Ladeinfrastruktur storniert wurde. |
| Vehicle charged | Gibt an, dass das Fahrzeug vollständig aufgeladen wurde. Der Schwellenwert für die Erkennung des aufgeladenen Fahrzeugs beträgt 95%. Funktioniert bedingt, wenn das Ladegerät den prozentualen Ladezustand der EV-Batterie meldet. |
| Charging end | Stellt das Ende des Ladevorgangs im Rahmen der Sitzung dar, da das Ladegerät das Ladeendereignis an das zentrale System von Tridens EV Charge gemeldet hat. Die Sitzung kann in der endgültigen Parkzeit bis zum endgültigen Abschluss fortgesetzt werden. |
| Charging end by monetary limit | Gibt an, dass der Ladevorgang der Sitzung beendet wurde, da das zentrale System von Tridens EV Charge eine Überschreitung des monetären Limits festgestellt hat, basierend auf den Sitzungsbewertungseinstellungen. |
| Charging end by energy limit | Gibt an, dass der Ladevorgang der Sitzung beendet wurde, da das zentrale System von Tridens EV Charge eine Überschreitung des Energielimits festgestellt hat, basierend auf den Sitzungsbewertungseinstellungen. |
| Charging end by charge time limit | Gibt an, dass der Ladevorgang der Sitzung beendet wurde, da das zentrale System von Tridens EV Charge eine Überschreitung des Ladezeitlimits festgestellt hat, basierend auf den Sitzungsbewertungseinstellungen. |
| Charging end by payment auth. failure | Gibt an, dass der Ladevorgang der Sitzung beendet wurde, da eine zusätzliche Zahlungsautorisierung im zentralen System von Tridens EV Charge nicht erfolgreich war, basierend auf den Sitzungsbewertungseinstellungen. |
| Charging end by auth. failure | Gibt an, dass der Ladevorgang der Sitzung beendet wurde, da eine zusätzliche Kundenressourcenautorisierung im zentralen System von Tridens EV Charge nicht erfolgreich war, basierend auf den Sitzungsbewertungseinstellungen. |
| Battery percentage limit | Gibt an, dass der Prozentsatz der EV-Batterie das definierte Limit überschritten hat. Kann einmal pro Sitzung ausgelöst werden. Verpflichtend, den Benachrichtigungsfilter ‘State of charge limit’ anzugeben, z. B. 80%. Funktioniert bedingt, wenn das Ladegerät den prozentualen Ladezustand der EV-Batterie meldet. |
| Energy limit | Gibt an, dass das Benachrichtigungsenergielimit der Ladesitzung in kWh überschritten wurde. Verpflichtend, den Benachrichtigungsfilter ‘Energy limit’ anzugeben, z. B. 60kWh. |
| Charge time limit | Gibt an, dass das Benachrichtigungsladezeitlimit der Ladesitzung in Sekunden überschritten wurde. Verpflichtend, den Benachrichtigungsfilter ‘Charge time limit’ anzugeben, z. B. 3600 Sekunden (1 Stunde). |
| Park time limit | Gibt an, dass das Benachrichtigungsparkzeitlimit der Ladesitzung in Sekunden überschritten wurde. Nützlich, um Kunden zu benachrichtigen, dass ihr Fahrzeug nicht lädt. Verpflichtend, den Benachrichtigungsfilter ‘Park time limit’ anzugeben, z. B. 900 Sekunden (15 Minuten). |
| Park time rating threshold breached | Gibt an, dass der Bewertungsschwellenwert für die Parkzeitdauer der Sitzung überschritten wurde, basierend auf den Sitzungsbewertungseinstellungen. Ab diesem Zeitpunkt wird das Parken dem Fahrer in Rechnung gestellt. |
| Fault time limit | Gibt an, dass das Benachrichtigungsfehlerzeitlimit der Ladesitzung in Sekunden überschritten wurde. Verpflichtend, den Benachrichtigungsfilter ‘Fault time limit’ anzugeben, z. B. 300 Sekunden (5 Minuten). |
| Monetary limit | Gibt an, dass das monetäre Limit (in der Standardwährung des Standorts) für die Ladesitzung überschritten wurde. Kann einmal pro Sitzung ausgelöst werden. Verpflichtend, den Benachrichtigungsfilter ‘Monetary limit’ anzugeben, z. B. 40€. |
| Monetary limit interval | Gibt an, dass das Intervall des monetären Limits (in der Standardwährung der Standortumgebung) für die Ladesitzung überschritten wurde. Kann einmal pro Sitzung ausgelöst werden. Verpflichtend, den Benachrichtigungsfilter ‘Monetary limit’ anzugeben, z. B. 5€. Beispiel für ein Limit von 5 EUR: Benachrichtigung wird ausgelöst, wenn der genutzte Betrag der Sitzungsüberschreitung das erste Mal über 5 EUR, dann 10 EUR, dann 15 EUR usw. erfolgt. |
| Meter values reported | Gibt an, dass das Ladegerät Zählerwerte an das zentrale System von Tridens EV Charge gemeldet hat. Besteht normalerweise aus Energie- (kWh), Leistungs- (kW), Stromstärke- (A), Spannungs- (V) Berichten. |
| Session refused | Gibt an, dass die Sitzung abgelehnt wurde. Der Kunde ist dem zentralen System von Tridens EV Charge bekannt, aber die anfängliche Ressourcenautorisierung war nicht erfolgreich. |
Tabelle 2. Ereignisse/Aktionen zur Steuerung von Ladesitzungen.
Plattformen
Um auf diesen Abschnitt zuzugreifen, klicken Sie auf Platforms.
Plattformen beinhalten die Konfiguration von Drittanbieterdiensten zur Aktivierung von Benachrichtigungen. Dazu gehören Twilio für Textnachrichten und Firebase für Push-Benachrichtigungen.
Hinweis:
Sie müssen die Dienste einrichten, um sie in EV Charge zu verwenden.Um Firebase für Push-Benachrichtigungen in EV Charge zu aktivieren, siehe Firebase-Konfiguration.
Hinweis:
Um aufgetretene Ereignisse zu protokollieren und zu überprüfen, kann die Protokollbenachrichtigungsfunktion konfiguriert werden, indem Sie den Anweisungen unter Log Notifications Setup folgen.Firebase-Konfiguration
Anforderungen und Prozessübersicht
- Ein Google-Konto ist erforderlich, um Firebase einzurichten.
- Sie konfigurieren Firebase für EV Charge.
- Tridens stellt entweder bereit:
- App - Apple ID
- App - Android-Paketname
- Sie konfigurieren iOS- oder Android-Apps auf Firebase.
- Sie stellen entweder bereit:
- GoogleService-Info.plist-Datei (iOS-Plattform)
- google-services.json-Datei (Android-Plattform)
Information:
Die Pakete, die Tridens bereitstellt (Apple ID & Android-Paketname), sind normalerweise basierend auf Ihrem Markennamen benannt.Firebase-Konfiguration für EV Charge
Besuchen Sie Ihr Firebase-Portal unter https://firebase.google.com/ und klicken Sie auf Get started oder Go to console.
Abbildung 1: Firebase-Portal
Ein neues Projekt auf Firebase erstellen
Erstellen Sie ein neues Projekt, indem Sie auf Create a project klicken.
Abbildung 2: Projekt erstellen
Befolgen Sie die Schritte, um ein neues Projekt zu erstellen.
Abbildung 3: Projekt erstellen - Schritt 1
Abbildung 4: Projekt erstellen - Schritt 2
Abbildung 5: Projekt erstellen - Schritt 3
Firebase-Anmeldeinformationen in EV Charge konfigurieren
Nachdem Sie zum Projekt-Dashboard zurückgekehrt sind, klicken Sie auf Project settings.
Abbildung 6: Projekteinstellungen
Gehen Sie zu Service accounts und klicken Sie auf Generate new private key.
Abbildung 7: Neuen privaten Schlüssel generieren
Nach Bestätigung der Schlüsselgenerierung wird eine JSON-Datei auf Ihren Computer heruntergeladen.
Abbildung 8: Schlüsselgenerierung bestätigen
Die JSON-Datei aus dem vorherigen Schritt enthält Ihre privaten Firebase-Schlüsselanmeldeinformationen – sie kann in einem Texteditor geöffnet werden.
Abbildung 9: Inhalt der privaten Schlüssel-JSON-Datei
Besuchen Sie als Nächstes EV Charge, navigieren Sie zu Systemkonfiguration Notifications Platforms. Klicken Sie auf Firebase (FCM) und geben Sie dann die Anmeldeinformationen (das sind: Client-ID, Client-E-Mail, Projekt-ID, Private-Key-ID und privater Schlüssel) in das Formular ein. Schließen Sie ab, indem Sie auf Einreichen klicken.
Hinweis:
Die Anmeldeinformationen stammen aus der zuvor heruntergeladenen JSON-Datei.
Abbildung 10: Firebase-Konfiguration auf EV Charge
Sie haben Firebase erfolgreich für EV Charge konfiguriert.
Eine Firebase Mobile App-Konfiguration erstellen - iOS
Gehen Sie zum Projekt-Dashboard auf Firebase und rufen Sie die Projekteinstellungen auf.
Abbildung 11: Projekteinstellungen
Scrollen Sie unter dem Reiter Allgemein zu Your apps und wählen Sie die iOS-Plattform aus.
Abbildung 12: iOS-App-Konfiguration hinzufügen
Geben Sie im ersten Schritt die Apple ID ein (bereitgestellt von Tridens) und klicken Sie auf Register app.
Abbildung 13: iOS-App-Konfiguration - Schritt 1
Laden Sie im zweiten Schritt die Konfigurationsdatei GoogleService-Info.plist herunter und stellen Sie sie Tridens zur Verfügung, um sie in Ihren App-Build aufzunehmen, und klicken Sie dann auf Next.
Abbildung 14: iOS-App-Konfiguration - Schritt 2
Klicken Sie bei den Schritten 3 und 4 auf Next und dann bei Schritt 5 auf Continue. Dies bringt Sie zurück zur Seite Projekteinstellungen, wo Ihre iOS-App-Konfiguration sichtbar sein wird. Sie können die Datei GoogleServiceInfo.plist hier auch erneut herunterladen.
Abbildung 15: iOS-App-Konfiguration - fertig
Eine Firebase Mobile App-Konfiguration erstellen - Android
Gehen Sie zum Projekt-Dashboard auf Firebase und rufen Sie die Projekteinstellungen auf.
Abbildung 16: Projekteinstellungen
Scrollen Sie unter dem Reiter Allgemein zu Your apps und wählen Sie die Android-Plattform aus.
Abbildung 17: Android-App-Konfiguration hinzufügen
Geben Sie im ersten Schritt den Android-Paketnamen ein (bereitgestellt von Tridens) und klicken Sie auf Register app.
Abbildung 18: Android-App-Konfiguration - Schritt 1
Laden Sie im zweiten Schritt die Konfigurationsdatei google-services.json herunter und stellen Sie sie Tridens zur Verfügung, um sie in Ihren App-Build aufzunehmen, und klicken Sie dann auf Next.
Abbildung 19: Android-App-Konfiguration - Schritt 2
Klicken Sie bei Schritt 3 auf Next und bei Schritt 4 auf Continue. Dies bringt Sie zurück zur Seite Projekteinstellungen, wo Ihre Android-App-Konfiguration sichtbar sein wird. Sie können die Datei googleservices.json hier auch erneut herunterladen.
Abbildung 20: Android-App-Konfiguration - fertig
