SendNotification@1

Der Node SendNotification@1 erstellt eine EDA-Benachrichtigung (CPNotification 01.13) und sendet sie über den HttpAdapter des Ponton X/P Messengers an einen Marktteilnehmer. Er wird verwendet, um auf eine empfangene Nachricht zu antworten, z. B. um Verbrauchsdaten mit ABLEHNUNG_CRMSG abzulehnen.

Adapter-Voraussetzungen

• EDA Adapter

Node-Konfiguration

Zu den Feldern path, targetPath, targetValueWriteMode und targetValueKind siehe Überblick.

  transformations:
    - type: SendNotification@1
      messageCode: ABLEHNUNG_CRMSG # EDA message code of the notification
      responseCode: 57 # response code of the notification
      senderAddressPath: $.message.Receiver # our market partner id (receiver of the original message)
      receiverAddressPath: $.message.Sender # sender of the original message
      originalMessageIdPath: $.message.MessageId # message id of the message that is answered
      conversationIdPath: $.message.ConversationId # optional: conversation of the original message
      targetPath: $.notification

Property	Typ	Erforderlich	Standard	Beschreibung
messageCode	string	Ja¹	-	EDA-Nachrichtencode der Benachrichtigung, z. B. ABLEHNUNG_CRMSG
responseCode	int	Nein	0	Antwortcode, der in die Antwortdaten der Benachrichtigung geschrieben wird
senderAddressPath	string	Ja¹	-	Pfad zur Marktpartner-Id des Absenders der Benachrichtigung
receiverAddressPath	string	Ja¹	-	Pfad zur Marktpartner-Id des Empfängers der Benachrichtigung
originalMessageIdPath	string	Ja¹	-	Pfad zur Nachrichten-Id der Nachricht, auf die geantwortet wird
conversationIdPath	string	Nein	-	Pfad zur Konversations-Id; ohne sie wird eine neue Konversations-Id erzeugt
targetPath	string	Nein	$	Pfad, an den die gesendete Benachrichtigung geschrieben wird
host	string	Nein	Adapter-Konfiguration	Überschreibt Host der Adapter-Konfiguration
user	string	Nein	Adapter-Konfiguration	Überschreibt User der Adapter-Konfiguration
password	string	Nein	Adapter-Konfiguration	Überschreibt Password der Adapter-Konfiguration
isSimulationMode	bool	Nein	Adapter-Konfiguration	Überschreibt IsSimulationMode; bei true wird die Benachrichtigung mit dem Dokumentmodus SIMU gesendet

¹ Im Schema nicht als erforderlich gekennzeichnet, aber zur Laufzeit erzwungen: Ist senderAddressPath, receiverAddressPath, originalMessageIdPath oder messageCode nicht konfiguriert, schlägt der Node mit Invalid configuration fehl. Können Absender, Empfänger oder ursprüngliche Nachrichten-Id im Datenkontext nicht gefunden werden, schlägt der Node mit Invalid input data fehl.

Verhalten

• Die Benachrichtigung wird immer für die Sparte Strom erstellt.
• Der Node schreibt das erstellte CPNotification-Objekt (mit MarketParticipantDirectory und ProcessDirectory) nach targetPath, nicht das HTTP-Ergebnis des HttpAdapters. Ein HTTP-Fehler des HttpAdapters lässt den Node nicht fehlschlagen.

Die Konfigurations-Properties sind in der API-Referenz dokumentiert.

Vollständiges Beispiel einer Pipeline-Konfiguration

Dieses Beispiel lehnt gespeicherte Verbrauchsdaten ab, die keinem Zählpunkt zugeordnet werden können.

  triggers:
    - type: FromPolling@1
      interval: 00:05:00
  transformations:
    - type: GetQueryById@1
      targetPath: $.query
      queryRtId: 000000000000000000000002 # unassigned DATEN_CRMSG messages
    - type: ForEach@1
      iterationPath: $.query.Rows
      targetPath: $.notifications
      transformations:
        - type: SendNotification@1
          messageCode: ABLEHNUNG_CRMSG
          responseCode: 57
          senderAddressPath: $.key.Values[0] # receiver of the original message
          receiverAddressPath: $.key.Values[1] # sender of the original message
          originalMessageIdPath: $.key.Values[2]
          conversationIdPath: $.key.Values[3]
          targetPath: $.notification