Warning: Diese Dokumentation befindet sich aktuell im Aufbau und ist nicht final. Sollten Sie Fragen oder Anmerkungen zur Dokumentation besitzen, wenden Sie sich bitte an Ihren Ansprechpartner bei uns.
XML-Upload Prozess - Rollout
Rollout mit Geschäftsdatenanfrage
Zusätzliche Pflichtfelder
Bei den Rolloutprozessen muss unterschieden werden zwischen einem Rollout mit einer Geschäftsdatenanfrage und ohne. Bei einem Rollout mit Geschäftsdatenanfrage werden innerhalb des Prozesses alle relevanten Stammdatendaten über die Anfrage abgeholt. Für die Geschäftsdatenanfrage muss die Global Property SET_BDR_DECISION_ROLLOUT=declined in der WiM gesetzt werden.
Des Weiteren muss darauf geachtet werden, unter welchen Voraussetzungen der Prozess gestartet werden soll. Ausschlaggebend ist, in welcher Rolle (processOverview.ownILN) wMSB oder gMSB der Prozess ausgeführt werden soll. Dabei ergeben sich auch die processOverview.partnerILN.
Es gibt Szenarien im Zusammenhang mit den von uns angebotenen MBSE-Modulen NDM (New Device Management) und WFM (Workforce Management), die im Rollout die Besonderheit haben zusätzliche generische Inhalte mitzuliefern. Dies wird in dem Abschnitt additionalData behandelt.
<?xml version="1.0" encoding="UTF-8"?>
<BdewTemplateInit>
<WimProcessConfiguration>
<DatePattern>yyyy-MM-dd</DatePattern>
</WimProcessConfiguration>
<WimProcessList>
<WimProcessData>
<processData>
<processName>Rollout</processName> <!-- Required -->
<processPart>NLIROL030</processPart> <!-- Required -->
<msbIln>990000000gMSB</msbIln> <!-- Required -->
<terminationDate>2020-01-02</terminationDate> <!-- Required -->
<meteringPoint>DE0000000000000000000000000000000</meteringPoint> <!-- Required -->
<additional>iMS</additional> <!-- Dependent -->
<contactPerson>Herr Mustermann</contactPerson> <!-- Required -->
<contactType>EM</contactType> <!-- Required -->
<contactText>mustermann@testcompany.de</contactText> <!-- Required -->
</processData>
<processOverview>
<group>GroupName</group> <!-- Required -->
<processName>Rollout</processName> <!-- Required -->
<processPart>NLIROL030</processPart> <!-- Required -->
<ownILN>990000000gMSB</ownILN> <!-- Required -->
<partnerILN>9900000000VNB</partnerILN> <!-- Required -->
<meteringPoint>DE0000000000000000000000000000000</meteringPoint> <!-- Required -->
</processOverview>
</WimProcessData>
</WimProcessList>
</BdewTemplateInit>
| Parameter | Required / Dependent | Beschreibung | Festwert oder Beispiel |
|---|---|---|---|
| [processOverview|processData].processName | Required | Der Name des Prozesses | Rollout |
| [processOverview|processData].processPart | Required | Technischer Name des Prozesses in der WiM, der gestartet werden soll | siehe folgende Tabelle |
| processData.msbIln | Required | gMSB oder wMSB ILN Nummer. | 9900000000gMSB | 9900000000wMSB |
| processData.terminationDate | Required | Datum des geplanten Rollout. Im Format von WimProcessConfiguration.DatePattern | 2020-01-02 |
| processData.contactPerson | Required | Kontakt-Ansprechpartner für Geschäftsdatenanfrage | Herr Mustermann |
| processData.contactType | Required | Kontakt-Typ für Geschäftsdatenanfrage | EM |
| processData.contactText | Required | Kontaktinformation für Geschäftsdatenanfrage | mustermann@testcompany.de |
| processData.additional | Dependent | Bei der Verwendung von NLIROL010, NLIROL020, NLIROL030 und NLIROL040 muss die Art der Messeinrichtung hier eingetragen werden. iMS (intelligentes Messsystem) | mME (moderne Messeinrichtung) |
iMS |
| processPart | Relevante Prozessbeschreibung |
|---|---|
| NLIROL010 | Start Rolloutprozess aus Sicht des gMSB. Wenn ein wMSB vorhanden ist incl. IFTSTA-Versand (Vorabinformation Gerätewechsel). Sollte kein wMSB gesetzt sein bzw. processData.msbIln der eigene gMSB sein, erfolgt eine Weiterleitung an Prozess NLIROL030. |
| NLIROL020 | Start Rolloutprozess aus Sicht des wMSB. |
| NLIROL030 | Start des Rolloutprozess wenn es keinen wMSB gibt. |
| NLIROL040 | Prozess für Migration / Rollout ohne Marktkommunikation. Der Rolloutprozess wurde vom Backend abgeschlossen. masterDataVo (siehe unten) muss vollständig befüllt sein. Achtung: Dieser Prozess besitzt keine Geschäftsdatenanfrage und bedingt ein vollständig gefülltes MasterDataVo. Er ist nur der Vollständigkeit halber hier aufgeführt. |
| NLIROLIMS | Er startet den Rolloutprozess, wenn ein wMSB vorhanden und die Messstelle ein iMS ist. Start von NLIROL010 ohne additional |
| NLIROLMME | Rolloutprozess wenn ein wMSB vorhanden und die Messstelle ein mME ist. Start von NLIROL010 ohne additional. |
Optionale Felder Übersicht für Geschäftsdatenanfrage
Im Umfeld der Geschäftsdatenanfrage sind viele Felder mit sogenannten Kann- bzw. Soll-Bedingungen verknüpft. Die oben beschriebenen Felder stellen das Minimalset dar. Im Folgenden beschreiben wir die Befüllung der zusätzlichen Kann- und Soll-Felder für die Geschäftsdatenanfrage in der XML.
| Parameter | Beschreibung | Festwert oder Beispiel |
|---|---|---|
| processData.nbIln | Aktueller VNB am Zählpunkt. Es wird empfohlen auch zur besseren Übersicht diesen Parameter zu setzen. Die alternative Ermittlung erfolgt über die VNB-Referenz in der Marktpartnerübersicht. | 9900000000VNB |
| processData.city | Stadt der Lokationsanschrift | Musterhausen |
| processData.plz | Postleitzahl der Lokationsanschrift. Alternativbestimmung erfolgt über die Melo. | 04668 |
| processData.street | Straße der Lokationsanschrift | Musterstraße |
| processData.housenumber | Hausnummer der Lokationsanschrift | 10a |
| processData.meteringNr | Gerätenummer für die Geschäftsdatenanfrage | 123456789 |
Optionales Feld für automatisierten Versand der Vorabinformation an den Lieferanten (IFTSTA 21029)
Damit die Vorabinformation an den Lieferanten (IFTSTA 21029) korrekt versendet werden kann, müssen in dieser Nachricht die Marktlokation und der Preisschlüsselstamm angegeben werden. Die ILN des Lieferanten und die Marktlokation werden über die Geschäftsdatenanfrage ermittelt (siehe vorheriger Abschnitt), der Preisschlüsselstamm ist darin jedoch nicht enthalten.Der Preisschlüsselstamm entspricht dem Wert aus der IFTSTA 21029 SG15 RFF 1154 (Code des Preisschlüsselstamms), dies ist der Wert aus der PRICAT 27002 SG36 PIA 7140. Damit eine manuelle Eingabe im Prozess umgangen werden kann, ist es möglich diesen Wert ebenfalls in der init.xml zu übergeben. Dies geschieht über einen additionalData-Eintrag. Infos zu AdditionalData finden Sie in der entsprechenden Dokumentation.
<?xml version="1.0" encoding="UTF-8"?>
<BdewTemplateInit>
...
<WimProcessData>
<processData>
...
</processData>
<processOverview>
...
</processOverview>
<additionalDataList>
<additionalData>
<key>priceKeyRoot</key>
<value>ZC0</value>
</additionalData>
</additionalDataList>
</WimProcessData>
</WimProcessList>
</BdewTemplateInit>
Beispiel einer Empfohlene Befüllung bei Rollout mit Geschäftsdatenanfrage
<?xml version="1.0" encoding="UTF-8"?>
<BdewTemplateInit>
<WimProcessConfiguration>
<DatePattern>yyyy-MM-dd</DatePattern>
</WimProcessConfiguration>
<WimProcessList>
<WimProcessData>
<processData>
<processName>Rollout</processName>
<processPart>NLIROL010</processPart>
<msbIln>990000000gMSB</msbIln>
<nbIln>9900000000VNB</nbIln>
<terminationDate>2020-01-02</terminationDate>
<meteringPoint>DE0000000000000000000000000000000</meteringPoint>
<meteringNr>123456789</meteringNr>
<street>Musterstraße</street>
<housenumber>10a</housenumber>
<plz>04668</plz>
<city>Musterhausen</city>
<!-- additional kann zurch setzen des processPart NLIROLIMS eingespart werden. -->
<additional>iMS</additional>
<contactPerson>Herr Mustermann</contactPerson> <!-- Required -->
<contactType>EM</contactType> <!-- Required -->
<contactText>mustermann@testcompany.de</contactText> <!-- Required -->
</processData>
<processOverview>
<group>GroupName</group>
<processName>Rollout</processName>
<processPart>NLIROL010</processPart>
<ownILN>990000000gMSB</ownILN>
<partnerILN>9900000000VNB</partnerILN>
<meteringPoint>DE0000000000000000000000000000000</meteringPoint>
</processOverview>
<additionalDataList>
<additionalData>
<key>priceKeyRoot</key>
<value>ZC6</value>
</additionalData>
</additionalDataList>
</WimProcessData>
</WimProcessList>
</BdewTemplateInit>
Hinweis: Die XML kann je nach Szenario in den additionalData zusätzliche Daten mitgeben. Dokumentation