ValidationContent

Validation-Content herunterladen

Der Validation-Content kann von der Webseite https://www.next-level-help.org aus dem Bereich “Direct Support” heruntergeladen werden. Die detaillierte Beschreibung findet sich unter Download von Content-ABOs.

Nomenklatur der Version

siehe hier

Release-Notes

Die Änderungen in den Releases werden in Release-Notes festgehalten. Die Release-Notes sind auch im Direct Support zu finden, unter “Content ABO GPKE/GELI”, oder über diesen Direktlink: Content ABO GPKE/GELI

Einstellungsmöglichkeiten

Die hier aufgelisteten Einstellungen sind für den Validation-Content relevant. Sie werden für die ValidatorAction und für den EdiEditor benötigt.

Die Einstellungen sind mit Context überschreiben einzustellen.

Verstellen der Werte kann zu einer „zu lockeren“ Validierung führen.

Default-Werte sind fett dargestellt.

Rollenkürzel

Verschiedene Konfigurationen erwarten, dass eine Marktrolle angegeben wird.

Verwendung eigener und echter ILN Nummern

Es ist möglich, auch offizielle und eigene ILNs zu verwenden. Hierzu ist folgende Konfiguration vonnöten (an allen Validator Actions). Auch hier ist es wichtig, dass “Kontext überschreiben” ausgewählt wird.

VALIDATION_CHECK_MARKETPARTNERS_TYPE=MULTISOURCE_VALIDATOR
VALIDATION_USE_EXTENSION_FOR_MPID_CHECK=true
VALIDATION_USE_EXTENSION_NAME_FOR_MPID_CHECK=${loadextension(MARKETPARTNER_CHECK)}

wobei die Extension, entsprechend wie in VALIDATION_USE_EXTENSION_NAME_FOR_MPID_CHECK benannt sein und folgendes Format erfüllen muss:

"MSB";"E";"9912121212978";"interne Test-MPID des Messstellenbetreiberes"
"LIEF";"E";"9912121212978";"intern vergebene Lieferanten ID des alten Backends"
"NB";"E";"3123344334456";"intern vergebene Netzbetreiber ID des Abrechnungsbackend"
"MSB";"G";"98122456744";"intern vergebene Messstellenbetreiber Nummer des Zählers am Gastank"
...

Standardmäßig sind dabei folgende Rollen in der B2B hinterlegt und können entsprechend in der Extension genutzt werden:

Alle Rollen: "ANY"/"AF"/"AG",
Bilanzkreiskoordinator: "BKO"/"BIKO",
Bilanzkreisverantwortlicher: "BKV",
Dienstleister: "DL",
Einsatzverantwortlicher: "EV",
Erzeuger: "ERZ",
Fernleitungsnetzbetreiber: "FLNB",
Kapazitätsnutzer: "KN",
Letztverbraucher: "LV",
Lieferant:"LIEF"/"LF",
Marktgebietsverantwortlicher: "MGV",
Messdienstleister: "MDE"/"MDL",
Messstellenbetreiber: "MSB",
Netzanschlussnehmer: "NAN",
Netzbetreiber: "NB"/"VNB",
Umweltbundesamt: "UBA",
Übertragungsnetzbetreiber: "UNB",
Netznutzer: "NN",
Betreiber technischer Resource: "BTR"

Durch diese Konfiguration wird die eigene Liste an MPIDs zusätzlich zu der ausgelieferten verwendet.

Bei der Auswahl der internen Nummern ist zu beachten, dass falls diese aussehen, als wären sie vom BDEW bzw. DVGW ausgestellt (also mit 99 bzw. mit 98 beginnen) in den Feldern für Verantwortliche Stelle für die Codepflege, Code auch der Code für BDEW/DVGW in den Nachrichten verwendet werden muss. Gleiches gilt für die Angabe der Sparte, also E (Electricity/Strom) für quasi BDEW-Nummern, G (Gas) für quasi DVGW-Nummern bzw. das im konkreten Fall passende bei GS1-Nummern.

Um das Beispiel von oben aufzugreifen: NAD+MR+9912121212978:293' oder NAD+MS+3123344334456:9'. Dies gilt auch umgekehrt für Nummern, die nicht wie BDEW/DVGW Nummern aussehen.

Da es sich hierbei um gecachte Daten handelt, greift eine Änderung in diesem Bereich erst nach einem Neustart der B2B.

Prüfung der Marktrolle und Sparte

Es ist möglich Daten aus der B2B zur Prüfung der Marktrolle und des Marktsektors heranzuziehen und danach zu validieren. Hierzu müssen die Informationen der Rolle und des Sektors für jeden Marktpartner und für die eigenen ID’s in der B2B hinterlegt werden. Der Hinterlegungsort dieser Informationen kann je System unterschiedlich sein. Die Information für die eigenen ID’s sollten in der Extension SENDER_EMAIL hinterlegt werden. Diese Informationen können wie folgt aussehen:

ROLE_9999999999999=LF
SECTOR_9999999999999=E

Wichtig hierbei ist, dass die Validierung nur mit bestimmten Kürzeln zurecht kommt. Für die Rolle können LF, NB, MSB, MDL, UBA, BKV, BIKO, ERZ, BTR hinterlegt werden, für die Sparte E und G.

Die Informationen zur Rolle der Marktpartner werden im MPID-Editor in der Spalte SA-ID hinterlegt. Hier können die Standardabkürzungen wie oben genannt eingetragen werden. Ist das nicht der Fall und es werden individuelle Abkürzungen verwendet, so müssen diese auf die entsprechende Abkürzung gemappt werden. Das passiert über die Extension MPID_ROLE_MAPPING. Hier werden Key/Value Paare angegeben, wobei der Key auch ein Regex sein kann. Steht im MPID-Editor beispielsweise in der SA-ID Spalte LIEF, so wird in die Extension

LIEF=LF

eingetragen. Falls spezielle Rollen erlaubt sein sollen, die keinem offiziellen Kürzel zuzuordnen sind, so kann dies über

BLA=ANY

passieren. Falls alles erlaubt ist, kann dies über den Regex

.+=ANY
(Achtung: Damit werden potentiell nicht gepflegte Rollen und damit ein Fehler verschleiert.)

definiert werden. Sind die offiziellen Kürzel in der Spalte SA-ID hinterlegt wird in der MPID_ROLE_MAPPING Extension LF=LF bzw NB=NB usw. eingetragen

Falls die Marktpartner mit denen kommuniziert wird zu unterschiedlichen Sektoren gehören, muss das ebenfalls im MPID-Editor gepflegt werden. Angenommen es wird mit Marktpartnern aus dem Sektor Strom und Gas kommuniziert, dann kann diese Information auch in der SA-ID Spalte hinterlegt werden zum Beispiel über ENB, GNB, ELF, GLF usw. In diesem Fall muss dann natürlich die MPID_ROLE_MAPPING angepasst werden zu

ELF=LF
GLF=LF
ENB=NB
GNB=NB

usw.

Außerdem müssen an jeder (!) ValidatorAction müssen dann folgende drei Eigenschaften hinterlegt werden:

VALIDATION_CHECK_MARKETPARTNERS_TYPE=MPID_SYNC_VALIDATOR
VALIDATION_MARKETPARTNERS_ROLES=dynamischer Ausdruck zur Rolle der eigenen ID;dynamischer Ausdruck zur Rolle der Partner ID
VALIDATION_MARKETPARTNERS_SECTORS=dynamischer Ausdruck zum eigenen Sektor;dynamischer Ausdruck zum Sektor des Marktpartners

Als Beispiel nehmen wir an, die eigene Rolle ist wie oben beschrieben in der SENDER_EMAIL hinterlegt und die Marktpartnerrolle in der SA-ID Spalte des MPID Editors und wird über die Extension gemapped. Dann kann folgender dynamischer Ausdruck für die Eigenschaft VALIDATION_MARKETPARTNERS_ROLES verwendet werden:

${template(&(this.FORMAT.senderCode))}
=
${loadExtensionProperty(SENDER_EMAIL,${template(ROLE_&(this.FORMAT.senderCode))},true)};
${template(&(this.FORMAT.partnerCode))}
=
${elpwithregex(MPID_ROLE_MAPPING,${getmpidsid(${template(&(this.FORMAT.senderCode))},${template(&(this.FORMAT.partnerCode))})})}

(einzeiliger Ausdruck)

Wird die Sparte für den Marktpartner als erster Buchstabe an die Rolle in die SA-ID gehängt dann lautet der zweite dynamische Ausdruck wie folgt

${template(&(this.FORMAT.senderCode))}
=
${loadExtensionProperty(SENDER_EMAIL,${template(SECTOR_&(this.FORMAT.senderCode))},true)};
${template(&(this.FORMAT.partnerCode))}
=
${substring(${getmpidsid(,${template(&(this.FORMAT.partnerCode))})},0,1)}

(einzeiliger Ausdruck)

Natürlich kann die Information für die Marktpartnersparte auch in der Spalte Name des MpidEditors hinterlegt werden, dann muss der dynamische Ausdruck die Funktion getmpidname benutzen. Gibt es nur eine Sparte von der und mit der kommuniziert wird, dann kann die Eigenschaft so aussehen:

VALIDATION_MARKETPARTNERS_SECTORS=
${template(&(this.FORMAT.senderCode))}=E;${template(&(this.FORMAT.partnerCode))}=E