Service zur Datenbefüllung
Eine Möglichkeit zur Befüllung des Meldepunktindexes der Systemweiche ist die Übertragung der Daten aus einem oder mehreren WIM-Systemen.
Das Tool wird von WIM-Systemen per Post-Request angesprochen. Neben dem RequestBody (sieh unten) werden 2 Parameter (system, client) übergeben. Es werden keine Einträge aus dem Index entfernt, sondern nur neue hinzugefügt, sollten diese nicht bereits vorhanden sein.
Die Befüllung des Meldepunktindex per Tool kann mit Webservice und ReportingPointIndexAction parallel erfolgen.
Indizierung der übergebenen Daten
Zur tatsächlichen Indizierung ist ein Index Service notwendig.
Zählpunktdaten Beschreibung
Zählpunktdaten, die zur Indizierung geschickt werden:
Feld |
Inhalt |
Beschreibung |
ext_ui |
<Meldepunkt> |
Meldepunktbezeichner. Aus dem Request-Body : processOverview -> meteringPoint (Duplikatprüfung und Prüfung auf ownILN Übereinstimmung, die in der YAML konfiguriert wird) |
mandant |
<Mandant> |
Mandantennummer "client" wird beim Request übergeben |
sevice_ended |
<Zeitstempel> |
Vertragsende / wird in YAML als "validTo" definiert |
service_started |
<Zeitstempel> |
Vetragsbeginn / wird Auslieferungszeit/date genommen |
system |
<Systemname> |
Name des Backend-Systems kommt aus Request Parametr |
1. Duplikatcheck:
Der Duplikatcheck wird es durchgeführt, wenn die tatsächliche Anzahl des Indexes (INDEX_MANAGER B3P_METERINGPOINT_INDEX Anzahl Dokumenten) stimmt. In der YAML-File wird unter “api-url-get-size” die Anzahl der Meldepunkte, die aus dem MP-Index zur Prüfung geholt werden, gesetzt. Die Zahl soll größer, als die aktuelle Anzahl der Dokumente im MP-Index sein.
2. Check auf owniln(YAML)
In der YAML unter “owniln” werden die ILNs angegeben, die bearbeitet werden. Die Liste wird durch “;” getrennt.
Technical documentation
The external webservice is contacted over a HTTP POST request without authentication. The response is written into an extension.
Configuration
Configuration is done in a YAML-file.
Example:
server.port: 9000
server.address: 127.0.0.1
b2b:
api-url: http://localhost:8081/b2bbp-engine/api/reporting-points/list
api-url-get: http://localhost:8081/b2bbp-engine/api/reporting-points
api-url-get-size: 100000000
user: admin
password: b2bbp
wim:
owniln: 9978853000009;9904629000006
mlocation:
validTo: 9999-12-31 12:00:00
date:
of:
joining:
format: yyyy-MM-dd HH:mm:ss
YAML Beschreibung:
| server.port | Port, auf dem das Tool gestartet wird |
| server.address | IP-Adresse des Servers, auf dem das Tool gestartet wird |
| api-url | hier wird die API-URL des Tools definiert. |
| api-url-get | mit Hilfe diese API wird der bestehende Index abgefragt (für Duplikatcheck)( Get list of reporting points by search filter) |
| api-url-get-size | Size List für search reporting points |
| user | <user B2B > |
| password | <password b2bbp > |
Running
This application requires Java 11 or newer.
Beispiel für Execute: java -jar .\wim-meteringpoints-to-index-0.0.1-SNAPSHOT.jar –spring.config.location=”C:\path\application.yml” (under Windows) or C:"Program Files”\Java\jdk-11.0.4\bin\java.exe -jar .\wim-meteringpoints-to-index-0.0.1-SNAPSHOT.jar –spring.config.location=”D:\GIT\wim-meteringpoints-to-index\src\main\resources\application.yml”
Beispiel für aufruf(aufrufen könnte man z.B. in SOAPUI app): http://127.0.0.1:9000/add-mlocations?system=SYS&client=100
XML
Request content should be a XML file structured like the following:
<?xml version="1.0" encoding="UTF-8"?>
<BdewTemplateInit>
<WimProcessConfiguration>
<DatePattern>yyyy-MM-dd</DatePattern>
</WimProcessConfiguration>
<WimProcessList>
<WimProcessData>
<processData>
<processName>Beginn MSB</processName>
<processPart>123456</processPart>
<meteringPoint>DE123456789</meteringPoint>
<meteringNr>123456</meteringNr>
<terminationDate>2022-02-11</terminationDate>
<reason>E03</reason>
<contactPersonCompany>Z01</contactPersonCompany>
<firstname>example</firstname>
<name>example</name>
<street>street</street>
<housenumber>10</housenumber>
<plz>12345</plz>
<city>city</city>
</processData>
<processOverview>
<group>GroupName</group>
<processName>Beginn MSB</processName>
<processPart>12345</processPart>
<ownILN>123456789</ownILN>
<partnerILN>123456789</partnerILN>
<meteringPoint>123456789</meteringPoint>
<externalId>123456789</externalId>
</processOverview>
<additionalDataList>
<additionalData>
<position>/wim</position>
<key>installGateway</key>
<value>no</value>
</additionalData>
<additionalData>
<position>/wim</position>
<key>orderType</key>
<value>PERIODIC_REPLACEMENT</value>
</additionalData>
</additionalDataList>
</WimProcessData>
<WimProcessData>
<processData>
<processName>Beginn MSB</processName>
<processPart>123456</processPart>
<meteringPoint>DE123456789</meteringPoint>
<meteringNr>123456</meteringNr>
<terminationDate>2022-02-11</terminationDate>
<reason>E03</reason>
<contactPersonCompany>Z01</contactPersonCompany>
<firstname>example</firstname>
<name>example</name>
<street>street</street>
<housenumber>10</housenumber>
<plz>12345</plz>
<city>city</city>
</processData>
<processOverview>
<group>GroupName</group>
<processName>Beginn MSB</processName>
<processPart>12345</processPart>
<ownILN>123456789</ownILN>
<partnerILN>123456789</partnerILN>
<meteringPoint>123456789</meteringPoint>
<externalId>123456789</externalId>
</processOverview>
<additionalDataList>
<additionalData>
<position>/wim</position>
<key>installGateway</key>
<value>no</value>
</additionalData>
<additionalData>
<position>/wim</position>
<key>orderType</key>
<value>PERIODIC_REPLACEMENT</value>
</additionalData>
</additionalDataList>
</WimProcessData>
</WimProcessList>
</BdewTemplateInit>
Auslieferung
Dieser Service ist ein Tool, welches durch NLI bereitgestellt werden kann.
```
View Me Edit Me