Schnittstelle.Wilken: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
 
(18 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:


* Wilken / Neutrasoft ist eine csv Schnittstelle die in allen Sparten eingesetzt wird. Sie ist Mehrtarif-Zähler fähig.
* Wilken / Neutrasoft ist eine csv Schnittstelle die in allen Sparten eingesetzt wird. Sie ist Mehrtarif-Zähler fähig.
* Erst wird der Ausbau gemeldet, pro Zählwerk eine Zeile, <code>tgw_altzaehlerflag</code> muss dabei <code>0</code> sein
* Danach wird der Einbau gemeldet, pro Zählwerk eine Zeile, <code>tgw_altzaehlerflag</code> muss dabei <code>1</code> sein
* Unmögliche werden als XLS gemeldet und laufen nicht über die Wilken-Schnittstelle
* Unmögliche werden als XLS gemeldet und laufen nicht über die Wilken-Schnittstelle
* Im [[Mehrtarif]]-Bereich kennt die Schnittstelle folgende OBIS-Kennziffern und verwendet entsprechend folgende OrgaMon-Eingaben:
* Im [[Mehrtarif]]-Bereich kennt die Schnittstelle folgende OBIS-Kennziffern und verwendet entsprechend folgende OrgaMon-Eingaben:
Zeile 27: Zeile 29:
** Ein- und Ausbau wird in eigenen Zeilen gemeldet, ein Wechsel hat somit mindestens 2 Zeilen, ein 2 Tarif Wechsel z.B. immer 4 Zeilen.
** Ein- und Ausbau wird in eigenen Zeilen gemeldet, ein Wechsel hat somit mindestens 2 Zeilen, ein 2 Tarif Wechsel z.B. immer 4 Zeilen.
** Die Mehrzeiligkeit muss bei der Ausgabe in die XLS noch nicht sichergestellt werden, dies wird über Oc xls->csv mit Fixed-Formats.ini mit Wilken=JA sichergestellt
** Die Mehrzeiligkeit muss bei der Ausgabe in die XLS noch nicht sichergestellt werden, dies wird über Oc xls->csv mit Fixed-Formats.ini mit Wilken=JA sichergestellt
** OBIS-Kennziffern aus der Lager Datei werden mit den Eintragungen in ZAEHLWERKE_EINBAU abgeglichen, wenn es nicht passt werden problematische Aufträge zunächst nicht gemeldet
* Fehler der Versorger
** In der Lagerdatei sind möglicherweise andere OBIS Ziffern als im Auftrag, also obwohl ein 1:1-Wechsel beauftragt ist, wird im Ausbau z.B. "1-<u>1</u>:1.8.0" gefordert, im Einbau "1-<u>0</u>:1.8.0"
** In der Lagerdatei sind u.U. mehr Zählwerke angegeben als übertragen werden dürfen. z.B. sind Einspeise-Zählwerke zwar vorhanden, aber dürfen ev. nicht übermittelt werden.


== Import ==
== Import ==
Zeile 36: Zeile 42:
  SAP_Info_#_#(tgw_obiscode,60)
  SAP_Info_#_#(tgw_obiscode,60)
  Intern_Info_#_#(gtw_id=,03)
  Intern_Info_#_#(gtw_id=,03)
  intern_Info_#_#(tgw_id=,04)
  Intern_Info_#_#(tgw_id=,04)
Transaktion(FK1)


* Beispielhaft weiterer Import
* Beispielhaft weiterer Import
Zeile 65: Zeile 72:


[[Datei:Wilken-Lager-Header.png]]
[[Datei:Wilken-Lager-Header.png]]
* Funktionsweise
** Die Einbauzählernummer wird gesucht
** Obis, Lager, Werk werden an die Ergebnisdatei eingefügt (im Mehrtarif-Bereich ggf. auch Obis.2, Lager.2, Werk.2, ...)
** In Zaehlwerke_Lager werden alle Einbau Obis aufgezählt
** Bleibt Zaehlwerke_Lager leer wird ZAEHLWERKE_EINBAU benutzt


=== ohne Lager-Datei ===
=== ohne Lager-Datei ===
Zeile 79: Zeile 92:


* Nach dem Import muss einmalig die Transaktion [[Transaktionen#FK1]] durchgeführt werden
* Nach dem Import muss einmalig die Transaktion [[Transaktionen#FK1]] durchgeführt werden
* Das ist nur notwendig wenn in Ihrem Importschema <code>Transaktion(FK1)</code> nicht angegeben ist
* Die Transaktion füllt einfach nur die Felder "Zählwerke Ausbau" und "Zählwerke Einbau" die im Auftrag im Reiter "Intern" zu sehen ist


{|class="wikitable"
{|class="wikitable"
Zeile 123: Zeile 138:
* danach die Zählerarten ändern mit dem blauen Pfeil auf alle anwenden
* danach die Zählerarten ändern mit dem blauen Pfeil auf alle anwenden
* In unserem Beispiel sind das "E" Zähler
* In unserem Beispiel sind das "E" Zähler
=== Anpassen von ZAEHLWERKE_EINBAU ===
* Wird mit einer Lagerdatei gearbeitet, kann es passieren, dass die Zählwerke anders lauten als im Einbau
* Anstelle von 1-1:1.8.0 kann 1-0:1.8.0 oder auch 1-1:1.8.0 gefordert sein, die Lagerdatei ist ausschlaggebend
* Diese Flexibilität erreicht man, indem man Platzhalter (? oder % oder *) an den unterschiedlichen Stellen angibt
* Dadurch wird OrgaMon bei der Ergebnismeldung das passende Zählwerk aus dem Lager erkennen können, es wird dann wie im Lager angegeben gemeldet
==== ? im Zählwerk ====
* Beispiel
1-?:1.8.1,1-?:1.8.2
==== % im Zählwerk ====
* Stichwort "Automatische Null"
* wie "?" jedoch wird das gefundene Zählwerk auch ohne Monteureingabe gemeldet, es wird dann "0" gemeldet
1-?:1.8.1,1-?:1.8.2,1-%:2.8.0
==== * im Zählwerk ====
* Stichwort "Eingabe nicht zwingend", Meldung gelingt dennoch, "optionale" Eingabe
* wie "?" jedoch unterbleibt stillschweigend die Meldung dieses Zählwerkes, wenn der Monteur keine Eingabe macht, das lößt keinen Fehler aus
1-?:1.8.1,1-?:1.8.2,1-*:1.8.0,1-*:1.8.1,1-*:1.8.2


=== Anpassen der Protokolle ===       
=== Anpassen der Protokolle ===       


* da wir nun für jede Wechsel-KOnstellation verschiedene Arten haben können wir den Monteuren auf verschiedene Protokolle anbieten
* da wir nun für jede Wechsel-Konstellation verschiedene Arten haben, können wir den Monteuren verschiedene Protokolle anbieten
* In den individuellen Protokollen kann nun entweder
* In den individuellen Protokollen kann nun entweder
** unnötige Eingabefelder gelöscht werden
** unnötige Eingabefelder gelöscht werden

Aktuelle Version vom 18. Februar 2022, 12:00 Uhr

zurück


  • Wilken / Neutrasoft ist eine csv Schnittstelle die in allen Sparten eingesetzt wird. Sie ist Mehrtarif-Zähler fähig.
  • Erst wird der Ausbau gemeldet, pro Zählwerk eine Zeile, tgw_altzaehlerflag muss dabei 0 sein
  • Danach wird der Einbau gemeldet, pro Zählwerk eine Zeile, tgw_altzaehlerflag muss dabei 1 sein
  • Unmögliche werden als XLS gemeldet und laufen nicht über die Wilken-Schnittstelle
  • Im Mehrtarif-Bereich kennt die Schnittstelle folgende OBIS-Kennziffern und verwendet entsprechend folgende OrgaMon-Eingaben:
Wilken-OBIS OrgaMon-Ausbau OrgaMon-Einbau
1-1:1.8.0 ZaehlerstandAlt
Verbrauch im Eintarif
Summenlaufwerk im Mehrtarif
ZaehlerStandNeu
1-1:1.8.1 A181
Haupttarif im Mehrtarifbereich
E181
1-1:1.8.2 NA
Nebentarif im Mehrtarifbereich
NN
1-1:2.8.0 A280 E280
1-1:2.8.1 A281 E281
1-1:2.8.2 A282 E282
  • Besonderheiten
    • Ein- und Ausbau wird in eigenen Zeilen gemeldet, ein Wechsel hat somit mindestens 2 Zeilen, ein 2 Tarif Wechsel z.B. immer 4 Zeilen.
    • Die Mehrzeiligkeit muss bei der Ausgabe in die XLS noch nicht sichergestellt werden, dies wird über Oc xls->csv mit Fixed-Formats.ini mit Wilken=JA sichergestellt
    • OBIS-Kennziffern aus der Lager Datei werden mit den Eintragungen in ZAEHLWERKE_EINBAU abgeglichen, wenn es nicht passt werden problematische Aufträge zunächst nicht gemeldet
  • Fehler der Versorger
    • In der Lagerdatei sind möglicherweise andere OBIS Ziffern als im Auftrag, also obwohl ein 1:1-Wechsel beauftragt ist, wird im Ausbau z.B. "1-1:1.8.0" gefordert, im Einbau "1-0:1.8.0"
    • In der Lagerdatei sind u.U. mehr Zählwerke angegeben als übertragen werden dürfen. z.B. sind Einspeise-Zählwerke zwar vorhanden, aber dürfen ev. nicht übermittelt werden.

Import

  • technisch notwendige Importfelder:
Zähler_Nummer(39)
SAP_Art_#_#(41,59)
SAP_Info_#_#(tgw_obiscode,60)
Intern_Info_#_#(gtw_id=,03)
Intern_Info_#_#(tgw_id=,04)
Transaktion(FK1)
  • Beispielhaft weiterer Import
Kunde_Brief_Nummer(10)
Zähler_Ort_Name1(11)
Zähler_Ort_Name2(12)
Zähler_Ort_Strasse_#_#_#(13,14,15)
Zähler_Ort_Ort_#_#(16,17)
Kunde_Brief_Name1_#_#(19,20)
Kunde_Brief_Strasse_#_#_#(21,22,23)
Kunde_Brief_Ort_#_#(24,25)
Zähler_Info_#_#(,28)
Zähler_Info_#_#(,41)
Zähler_Info_#_#(Z-Gr.,69)

mit Lager-Datei

  • Die Lager-Liste ist optional
  • So sieht die Original Lager Liste aus


  • Die Kopfzeile (Zeile 1) der Lagerliste muss bearbeitet werden: Nur die Spaltenüberschriften der gelb markierten Spalten ändern! Folgende Kopfzeile muss verwendet werden:
    • Hier die Kopfzeile zum rauskopieren und ersetzten:
    • mnd_id;ene_id;datum;Serialnummer;zae_identnr;zae_hersteller;ztp_nr;ztp_elektronik;MaterialNo;ztp_rueckstellart;ztp_rueckstellzeitpunkt;ztp_smartmeter;zae_megid;zae_hardwareversion;zae_lagerort;ZWrk;Obis;ztz_zveinr;Werk;Lager;vba_einheit_gemessen;Stand

  • Funktionsweise
    • Die Einbauzählernummer wird gesucht
    • Obis, Lager, Werk werden an die Ergebnisdatei eingefügt (im Mehrtarif-Bereich ggf. auch Obis.2, Lager.2, Werk.2, ...)
    • In Zaehlwerke_Lager werden alle Einbau Obis aufgezählt
    • Bleibt Zaehlwerke_Lager leer wird ZAEHLWERKE_EINBAU benutzt

ohne Lager-Datei

  • in dem Fall ist im Ergebnis Lager,Werk,Obis mit dabei (technisch notwendig) aber leer
  • in diesem Fall wird die Obis Kennung für den Einbau aus dem Ausbau kopiert
  • in diesem Fall sollte man beim Ergebnis auf die beiden Spalten "tgw_nachkomma" und "tgw_vorkomma" verzichten

Protokolle

  • Im Elektrobereich sollte das Hermesdorf-Protokoll verwendet werden

Transaktion FK1

  • Nach dem Import muss einmalig die Transaktion Transaktionen#FK1 durchgeführt werden
  • Das ist nur notwendig wenn in Ihrem Importschema Transaktion(FK1) nicht angegeben ist
  • Die Transaktion füllt einfach nur die Felder "Zählwerke Ausbau" und "Zählwerke Einbau" die im Auftrag im Reiter "Intern" zu sehen ist
Zählwerke-Ausbau Zähler-Art
(Vorschlag)
Bedeutung
1-1:1.8.0 E normaler Eintarif Verbrauchszähler
1-1:1.8.1, 1-1:1.8.2 E2 Mehrtarifzähler
1-1:2.8.0 V Voltaikzähler
1-1:1.8.0, 1-1:2.8.0 Z Zweirichtungszäher
1-1:1.8.1 E1 hm
1-1:1.8.0, 1-1:1.8.1, 1-1:1.8.2, 1-1:2.8.0 Q hm
1-1:1.8.2 E3 hm
1-1:1.8.1, 1-1:2.8.0 Z2 hm
  • Die Werte in der Spalte "Zählerart" ist keine Pflicht, nur eine Konvention und kann bei Ihnen anders gewählt werden
  • im Diagnose-Verzeichnis die FK1.txt öffnen und die vorkommenden Zählerarten anschauen, z.B. :
RID2596789:1-1:1.8.0
RID2596851:1-1:1.8.1, 1-1:1.8.2
RID2596546:1-1:1.8.2
     
  • In diesem Fall haben wir 3 verschiedene "Konstellationen" oder "Kombinationen" was beauftragt wurde
  • der RID vorne ist der erste vorkommende RID dieser Konstellation, es gibt im Auftrag aber noch mehrere davon

Anpassen der Zählerart (optional)

  • Ziel ist es, für jede Art von Wechselvorgang vor Ort eine eigene Zählerart zu haben
  • Das hat Vorteile für die Abrechnung UND für die Individualisierung der Protokolle
  • Erstellen Sie sich ein Selektion (in der Lupe) Name "Zählwerke", SQL ist z.B.
(ZAEHLWERKE_AUSBAU='1-1:1.8.0') and 
(ZAEHLWERKE_EINBAU='1-1:1.8.0')
  • danach die Zählerarten ändern mit dem blauen Pfeil auf alle anwenden
  • In unserem Beispiel sind das "E" Zähler

Anpassen von ZAEHLWERKE_EINBAU

  • Wird mit einer Lagerdatei gearbeitet, kann es passieren, dass die Zählwerke anders lauten als im Einbau
  • Anstelle von 1-1:1.8.0 kann 1-0:1.8.0 oder auch 1-1:1.8.0 gefordert sein, die Lagerdatei ist ausschlaggebend
  • Diese Flexibilität erreicht man, indem man Platzhalter (? oder % oder *) an den unterschiedlichen Stellen angibt
  • Dadurch wird OrgaMon bei der Ergebnismeldung das passende Zählwerk aus dem Lager erkennen können, es wird dann wie im Lager angegeben gemeldet

? im Zählwerk

  • Beispiel
1-?:1.8.1,1-?:1.8.2

% im Zählwerk

  • Stichwort "Automatische Null"
  • wie "?" jedoch wird das gefundene Zählwerk auch ohne Monteureingabe gemeldet, es wird dann "0" gemeldet
1-?:1.8.1,1-?:1.8.2,1-%:2.8.0

* im Zählwerk

  • Stichwort "Eingabe nicht zwingend", Meldung gelingt dennoch, "optionale" Eingabe
  • wie "?" jedoch unterbleibt stillschweigend die Meldung dieses Zählwerkes, wenn der Monteur keine Eingabe macht, das lößt keinen Fehler aus
1-?:1.8.1,1-?:1.8.2,1-*:1.8.0,1-*:1.8.1,1-*:1.8.2

Anpassen der Protokolle

  • da wir nun für jede Wechsel-Konstellation verschiedene Arten haben, können wir den Monteuren verschiedene Protokolle anbieten
  • In den individuellen Protokollen kann nun entweder
    • unnötige Eingabefelder gelöscht werden
    • die "richtigen" Eingabefelder z.B. mit "***" optisch hervorgehoben werden
  • Beispiel, die Baustelle heist WLK, und man hat E, E2 und Z als legitime vorkommende Zählerarten ermittelt
    • erstellen Sie 3 Kopieen des WLK.txt- Protokoll (ein Hermesdorf- Protokoll)
    • 1. Kopie: WLKE.txt
    • 2. Kopie: WLKE2.txt
    • 3. Kopie: WLKZ.txt
  • Ändern Sie nun alle 3 Bezeichnungen in den protokollen von "# WLK 2020 .." auf "# WLKE 2021 ..." damit der Monteur im Problemfall vorlesen kann in welchem Protokoll er gerade ist
  • Löschen Sie jetzt aus den 3 neuen Protokollen alles heraus, was der Monteur gar nicht eingeben muss oder alternativ: Markieren sie die wichtigen EIngabestellen, dann hat der Monteur immer noch alle Möglichkeiten vor Ort.

Ergebnis

  • Oc konvertiert von xls nach csv in einem besonderen "Wilken=JA" Modus bei dem Einbau- und Ausbau- abhängig Feldinhalte umgeschaltet werden
  • Die Text-Datei Fixed-Formats.ini muss im Ergebnis-Verzeichnis (->Baustelle->Reiter Ergebnis->"gelber Ordner") liegen
tgw_wandlerfaktor='1
mwt_edicode='220
ahk_edicode='VNB
gtw_lagerort_alt='310
Alternative_gtw_auftragsdatum_neu=WechselDatum
Alternative_tgws_ablesedatum=WechselDatum
Alternative_zae_nr_neu=ZaehlerNummerNeu
Alternative_tgws_ablesestand=ZaehlerStandAlt
Wilken=JA
MaxColumn=17
  • die ersten 4 Zeilen können natürlich nach dem Hochkomma auf den Kundenwunsch angepasst werden


Eintarif

Mehrtarif


  • Die beiden Spalten "tgw_nachkomma" und "tgw_vorkomma" sind optional

Baustelle->Reiter "Ergebnis"

SpaltenReihenfolge=gtw_id!;tgw_id!;tgw_altzaehlerflag;zae_nr_neu;gtw_auftragsdatum_neu;gtw_lagerort_alt;tgw_teilgeraetenr;tgw_obiscode!;tgw_nachkomma;tgw_vorkomma;tgw_wandlerfaktor;tgws_ablesedatum;tgws_ablesestand;mwt_edicode;ahk_edicode;tgws_ableseinfo;tgws_zeitpunkt;Zaehlwerke_Ausbau;Zaehlwerke_Einbau;NA;NN;FA!;FN!
AuchAlsCSV=JA
AuchAlsCSV_Unmöglich=NEIN
InternInfos=JA
FreieZähler=...\...csv

Baustelle->Reiter "Protokolle"

  • Es muss angekreuzt werden
    • [x] zusätzliche Spalten ausgeben
  • Liste unterhalb von "Interninfo"
gtw_id
tgw_id
tgw_obiscode
Obis
Werk
Lager
Zaehlwerke_Lager
  • Liste unterhalb von "Protokoll" (Für Elektro)
A181
NA
A280
A281
A282
E181
NN
E280
E281
E282

Besonderheiten

KD wünscht Buchstabe "W" für Wasser vor der Zählernumme

Wir richten unter Reiter Ergebnis ein:

ZählerNummerNeuMitA1=JA 

Im JondaProtokoll A1=W runter kopieren für alle Wasserzähler, damit das automatisch dazugefügt wird.