Schnittstelle.co-met: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Zeile 44: Zeile 44:
  ##                                ##
  ##                                ##
  ##  Mappings für Comet 14.03.2016  ##
  ##  Mappings für Comet 14.03.2016  ##
##                                ##
##  1/2: "Auftrag"                ##
  ##                                ##
  ##                                ##
  #####################################  
  #####################################  

Version vom 8. Juli 2020, 12:19 Uhr

zurück

Abstimmungen im Vorfeld

Datenverzeichnis bestimmen

  • Man sollte sich einen treffenden Namen für das Datenverzeichnis überlegen, und das in die Datenbaustelle eintragen, als Beispiel
Verzeichnis=Musterstadt-Gas-2016

Monteurkennungen vereinbaren

 <monteur>SUBS_MCR</monteur>
  • Jeder beteiligte Monteur muss comet gemeldet werden, der Auftraggeber liefert im Gegenzug eine Kennung, diese muss in die Datei MonteurText.ini eingetragen werden


Filsinger, Andreas=SUBS_MAF
Mustermann, Peter=SUBS_MUP
=unmgl
  • Es darf unter einem Auftrag nur ein Monteur eingetragen werden. Und-, Odernennungen von Namen sind zu vermeiden. In der MonteurText.ini kann aber ein "oder" Text in einen Hauptmonteur umgesetzt werden.

Internet-Ablage

  • sollten Fotos gemacht werden ...
    • ist eine Internet-Ablage (als Beispiel "co-met-bilder") notwendig, auch wenn der Kunde hier keinen Einblick wünscht oder braucht, die Bilder werden ihm ja über die Schnittstelle geliefert
    • dann ist eine "+" Baustelle nötig, so dass automatisiert die Bilder geholt werden:
      • FTPServer=dein.server
        FTPBenutzer=co-met-bilder
        FTPPasswort=****
        ZIPpasswort=****
        Verzeichnis=Musterstadt-Gas-2016
    • ist im Reiter Ergebnis der Datenbaustelle (also nicht der Foto-Ladebaustelle) per "-Foto" die Zugangsdaten der eigenen Ablage anzugeben
      • FTPServer-Foto=dein.server
        FTPBenutzer-Foto=co-met-bilder
        FTPPasswort-Foto=****
        ZIPpasswort-Foto=****
    • bei FTPBenutzer usw. jedoch die Zugangsdaten die von Fa.. comet geliefert wurden

Comet liefert: Auftragsdatei

  • XML Auftragsdateien

Mapping.txt (fit für Doppeltarif-Zähler)

1) die Auftragsdatei wir zusammen mit folgender Mapping.txt ins selbe Verzeichnis gestellt: 

#####################################
##                                 ##
##  Mappings für Comet 14.03.2016  ##
##                                 ##
##  1/2: "Auftrag"                 ##
##                                 ##
##################################### 

ARGOS=JA
UTF8=JA
ZW_SAME_NAME_OK=JA
WRITE_AT=dispo.auftrag.losnr
ADD_ZW=dispo.auftrag.zw1.zwbez|dispo.auftrag.zw2.zwbez

dispo.auftrag.mandant;1
dispo.auftrag.akschl;1
dispo.auftrag.aknr;1
dispo.auftrag.kdnr;1
dispo.auftrag.name;1
dispo.auftrag.namezus;1
dispo.auftrag.strasse;1
dispo.auftrag.hausnr;1
#dispo.auftrag.hnrzs;1
dispo.auftrag.plz;1
dispo.auftrag.ort;1
dispo.auftrag.rname;1
dispo.auftrag.rstrasse;1
dispo.auftrag.rhausnr;1
dispo.auftrag.rplzort;1
dispo.auftrag.znr;1
dispo.auftrag.vsorgart;1
dispo.auftrag.bauklasse;1
dispo.auftrag.bgroesse;1
dispo.auftrag.matnr;1
dispo.auftrag.bglaubj;1
dispo.auftrag.gart;1
dispo.auftrag.zw1.zwbez;2
dispo.auftrag.zw1.zwstell;2
dispo.auftrag.zw1.stand;2
dispo.auftrag.zw1.abld;2
dispo.auftrag.zw2.zwbez;2
dispo.auftrag.zw2.zwstell;2
dispo.auftrag.zw2.stand;2
dispo.auftrag.zw2.abld;2
dispo.auftrag.meterid;1
dispo.auftrag.sperrzeit;1
dispo.auftrag.sperre_von;1
dispo.auftrag.sperre_bis;1
dispo.auftrag.hinweis1;1
dispo.auftrag.hinweis2;1
dispo.auftrag.termin;1
dispo.auftrag.sub;1
dispo.auftrag.losnr;1

ZA in Tag "<einbauort>"

Eingabe-Kürzel Monteur Bedeutung Text/Kürzel "Schnittstellenebene"
01 1. Etage 01
02 2. Etage 02
03 3. Etage 03
04 4. Etage 04
05 5. Etage 05
06 6. Etage 06
07 7. Etage 07
08 8. Etage 08
09 9. Etage 09
10 10. Etage 10
AR Abstellraum AR
BD Bad BD
BV Baustromverteiler BV
DA Dachboden DA
DG Dachgeschoss DG
DT Damentoilette DT
EG Erdgeschoss EG
FL Flur FL
GA Garage GA
GT Garten GT
HT Herrentoilette HT
HZ Heizungskeller HZ
KE Keller KE
KÜ Küche KÜ
LG Lager LG
OG Obergeschoss OG
SC Schacht SC
TR Treppenhaus TR
UN unbekannt UN
WG Wohnung WG
WK Waschküche WK
WS Werkstatt WS
ZR Zählerraum ZR

technisch notwendige Import-Felder

mandant=
akschl=
aknr=
kdnr=
bgroesse=
matnr=
meterid=
sub=
losnr=
zw1.zwbez=
zw1.zwstell=
zw1.stand=
zw1.abld=
zw2.zwbez=
zw2.zwstell=
zw2.stand=
zw2.abld=

comet liefert: Lagerdatei

Mapping.txt

#####################################
##                                 ##
## Mappings für Comet 26.04.2016   ##
##                                 ##
## 2/2: "Lager"                    ##
##                                 ##
#####################################

ARGOS=JA
UTF8=JA
WRITE_AT=lager.zaehler.meterid

lager.zaehler.mandant;1
lager.zaehler.zaenrein;Serialnummer
lager.zaehler.vsorgart;Sparte
lager.zaehler.matnr;MaterialNo
lager.zaehler.sap_bauform;1
lager.zaehler.hersteller;1
lager.zaehler.baujahr;1
lager.zaehler.eichjahr;1
lager.zaehler.zw1.zwnr;ZWrk
stand;Stand
lager.zaehler.zw1.zwbez;2
lager.zaehler.zw1.zwstell;2
lager.zaehler.zw2.zwnr;2
lager.zaehler.zw2.zwbez;2
lager.zaehler.zw2.zwstell;2
lager.zaehler.meterid;1


  • Lagerdatei speichern unter Aufträge - Co.MET - Ordner "Lagerdatei".
  • die Lagerdatei kann von Oc, wenn sie sehr gross ist, nicht verarbeitet werden. Mann muss zuerst im Notepad++ den Text "<mandant>" durch "\n<mandant>" ersetzen. Durch diesen Trick ist besteht die XML Datei nicht aus einer langen Zeile, sondern pro Lagergerät eine Zeile, was für den Oc besser verständlich ist. Dazu beim Notepad++ den Knödel bei "Suchmodus"->"Erweitert" setzen.
  • Konvertieren mit Oc Rev. 1.116 oder besser (rechter Mausklick)
  • nun in die entstandene csv gehen und die Überschriften anpassen:
Lager-Datei

-> zaenrein -> Serialnummer
-> MatNr -> MaterialNo
-> meterid -> Lager
-> Zaehlwerk -> Zwrk
(optional "Sparte")
  • Spalte "Stand" einfach nur hinten in der Titelzeile hinzugefügt werden
  • Geänderte Datei kopieren in J:\OrgaMon\SAP\sewa\co-met
  • Neuer Datei-Name in Baustelle->Reiter Ergebnis kopieren
FreieZähler=Musterstadt-Gas-2016\sws_lager_200810233208.xml.csv

Rückmeldung

Reiter Ergebnis

# hier die Zugangsdaten von co-met
FTPServer=ftp.ablesen.com
FTPBenutzer=user
FTPPasswort=*********

# Setzen Sie unbedingt ein gut klingendes Verzeichnis
# ansonsten würde der default von oben (FTPBenutzer=) in diesem
# Fall "user" benutzt werden
Verzeichnis=Musterstadt-Gas-2016

SpaltenReihenfolge=aknr!;meterid!;Lager;FA!;Mandant!;sub!
InternInfos=JA
EineDatei=JA
AuchAlsXML=JA
QS_Mode=3

FreieZähler=Musterstadt-Gas-2016\lager-2016-05.10.xml.csv

# Hier die Zugangsdaten der eigenen Ablage, die nur zur Speicherung der 
# co-met Bilder dient
FTPServer-Foto=orgamon.net
FTPBenutzer-Foto=Musterstadt
FTPPasswort-Foto=*********
ZIPPasswort-Foto=*********
FotoBenennung=6
AuchMitFoto=FA;FN

Q23=kritisch
Q24=unkritisch
Q25=kritisch

Reiter Protokolle

Protokoll

FA
FN
FH
N1
NA
NB
NC
NN
NO
NP
V1
V2
V3
I3
I4
I5
I6
I7
I8
B1
B2
B3
B4
B5
B6
A1
A2
A3
A4
A5
A6
A7
A8
A9
ZA

Internfeld

  • Achtung: Das Feld "Quelle" darf nicht exportiert werden, dann kommt es dazu dass Oc den Original-Auftrag laden will
mandant
akschl
aknr
kdnr
bgroesse
matnr
meterid
sub
losnr
zw1.zwbez
zw1.zwstell
zw1.stand
zw1.abld
zw2.zwbez
zw2.zwstell
zw2.stand
zw2.abld

Reiter Foto

  • Im Reiter Ergebnis haben wir ja gesetzt:
    • FotoBenennung=6
    • AuchMitFoto=FA;FN
  • Hier die passende (Foto-) Vorlage.xls
  • die Dateinamenskonvention für das Ausbaubild ist:
    • <Mandant> "-" <aknr> "-" <ZählernummerAlt> ".jpg"
    • Beispiel: 130-2016080628-23129820.jpg
  • die Dateinamenskonvention für das Einbaubild ist:
    • <Mandant> "-" <aknr> "-" <ZählernummerAlt> "-" <ZählernummerNeu> ".jpg"
    • Beispiel: 130-2016080600-23129791-2912234.jpg

E.ml

  • Aus Wiki technischen Gründen muss nach dem kopieren "spitze Klammer Auf" "Stern" durch "spitze Klammer auf" "Ausrufezeichen" ersetzt werden. Dies stellt einen XML Kommentar dar, der in diesem Wiki leider nicht angezeigt werden kann


 <auftrag>
  <mandant>~Mandant~</mandant>
  <aknr>~aknr~</aknr>
  <zaenraus>
   <znr>~Zaehler_Nummer~</znr>
   <meterid>~meterid~</meterid>
<*-- INSERT AUSBAU -->
  </zaenraus>
  <zaenrein>
   <znr>~ZaehlerNummerNeu~</znr>
   <meterid>~Lager~</meterid>
<*-- INSERT EINBAU -->
  </zaenrein>
  ~sub~
  <monteur>~MonteurText~</monteur>
  <einbauort>~ZA~</einbauort>
  <datum>~WechselDatum_3~</datum>
  <sonder>
   <text1>[~A9~] Zählersteckklemme eingebaut</text1>
   <text2>[~A2~] Fehlanfahrt nach Terminvorgabe durch AG</text2>
   <text3>[~A4~] nachträgliches Plombieren</text3>
  </sonder>
  <bemerk>~I3~~I4~~I5~~I6~~I7~~I8~</bemerk>
 </auftrag>

Vorlage.ml

  • Aus Wiki technischen Gründen muss nach dem kopieren "spitze Klammer Auf" "Stern" durch "spitze Klammer auf" "Ausrufezeichen" ersetzt werden. Dies stellt einen XML Kommentar dar, der in diesem Wiki leider nicht angezeigt werden kann


<?xml version="1.0" encoding="UTF-8"?>
<ergebnis>
<*-- OHNE ROHDATEN -->
<*-- BEGIN AUSBAU_1 -->
    <zw1>
     <stand>~ZaehlerStandAlt~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
<*-- END AUSBAU_1 -->
<*-- BEGIN AUSBAU_2 -->
    <zw1>
     <stand>~ZaehlerStandAlt~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NA~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
<*-- END AUSBAU_2 -->
<*-- BEGIN AUSBAU_3 -->
    <zw1>
     <stand>~ZaehlerStandAlt~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NA~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
    <zw3>
     <stand>~NB~</stand>
     <pruefzahl>183</pruefzahl>
    </zw3>
<*-- END AUSBAU_3 -->
<*-- BEGIN AUSBAU_4 -->
    <zw4>
     <stand>~ZaehlerStandAlt~</stand>
     <pruefzahl>180</pruefzahl>
    </zw4>
    <zw1>
     <stand>~NA~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NB~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
    <zw3>
     <stand>~NC~</stand>
     <pruefzahl>183</pruefzahl>
    </zw3>
<*-- END AUSBAU_4 -->
<*-- BEGIN EINBAU_1 -->
    <zw1>
     <stand>~ZaehlerStandNeu~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
<*-- END EINBAU_1 -->
<*-- BEGIN EINBAU_2 -->
    <zw1>
     <stand>~ZaehlerStandNeu~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NN~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
<*-- END EINBAU_2 -->
<*-- BEGIN EINBAU_3 -->
    <zw1>
     <stand>~ZaehlerStandNeu~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NN~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
    <zw3>
     <stand>~NO~</stand>
     <pruefzahl>183</pruefzahl>
    </zw3>
<*-- END EINBAU_3 -->
<*-- BEGIN EINBAU_4 -->
    <zw4>
     <stand>~ZaehlerStandNeu~</stand>
     <pruefzahl>180</pruefzahl>
    </zw4>
    <zw1>
     <stand>~NN~</stand>
     <pruefzahl>181</pruefzahl>
    </zw1>
    <zw2>
     <stand>~NO~</stand>
     <pruefzahl>182</pruefzahl>
    </zw2>
    <zw3>
     <stand>~NP~</stand>
     <pruefzahl>183</pruefzahl>
    </zw3>
<*-- END EINBAU_4 -->
<*-- BEGIN E -->
<*-- INCLUDE E.ml -->
<*-- END E -->
<*-- BEGIN E2 -->
<*-- INCLUDE E.ml -->
<*-- END E2 -->
<*-- BEGIN E3 -->
<*-- INCLUDE E.ml -->
<*-- END E3 -->
<*-- BEGIN E4 -->
<*-- INCLUDE E.ml -->
<*-- END E4 -->
<*-- BEGIN WA -->
 <auftrag>
  <mandant>~Mandant~</mandant>
  <aknr>~aknr~</aknr>
   <zaenraus>
     <znr>~Zaehler_Nummer~</znr>
  <meterid>~meterid~</meterid>
  <zw1>
    <stand>~ZaehlerStandAlt~</stand>
  </zw1>
   </zaenraus>
   <zaenrein>
     <znr>~ZaehlerNummerNeu~</znr>
  <meterid>~Lager~</meterid>
  <zw1>
    <stand>~ZaehlerStandNeu~</stand>
    <pruefzahl>~N1~</pruefzahl>
  </zw1>
   </zaenrein>
   ~sub~
   <monteur>~MonteurText~</monteur>
   <einbauort>~ZA~</einbauort>
   <datum>~WechselDatum_3~</datum>
   <sonder>
     <text1>[~B1~] nachträgliches Plombieren</text1>
     <text2>[~B2~] Absperrung am Gehweg geöffnet</text2>
     <text3>[~B3~] Schachtzähler</text3>
     <text4>[~B4~] Ventiloberteil gewechselt</text4>
     <text5>[~B5~] Hausanschluss saniert</text5>
     <text6>[~B6~] Fehlanfahrt nach Terminvorgabe durch AG</text6>
   </sonder>
   <bemerk>~I3~~I4~~I5~~I6~~I7~~I8~</bemerk>
  </auftrag>
<*-- END WA -->
<*-- BEGIN G -->
  <auftrag>
   <mandant>~Mandant~</mandant>
   <aknr>~aknr~</aknr>
   <zaenraus>
     <znr>~Zaehler_Nummer~</znr>
  <meterid>~meterid~</meterid>
  <zw1>
    <stand>~ZaehlerStandAlt~</stand>
  </zw1>
   </zaenraus>
   <zaenrein>
     <znr>~ZaehlerNummerNeu~</znr>
  <meterid>~Lager~</meterid>
  <zw1>
    <stand>~ZaehlerStandNeu~</stand>
    <pruefzahl>~N1~</pruefzahl>
  </zw1>
   </zaenrein>
   ~sub~
   <monteur>~MonteurText~</monteur>
   <einbauort>~ZA~</einbauort>
   <datum>~WechselDatum_3~</datum>
   <sonder>
     <text1>[~A1~] Gasinnenleitung geprüft mit Protokoll</text1>
     <text2>[~A2~] Fehlanfahrt nach Terminvorgabe durch AG</text2>
     <text3>[~A3~] Gashausanschluss überprüft</text3>
     <text4>[~A4~] nachträgliches Plombieren</text4>
     <text5>[~A5~] Beiwohnen bei der Hauptprüfung</text5>
     <text6>[~A6~] Demontage eines Sicherungsstopfens</text6>
     <text7>[~A7~] Setzen einer Verschraubungssicherung nach DVGW</text7>
     <text8>[~A8~] Ein-, Ausbau oder Wechsel eines Zaehlerreglers</text8>
   </sonder>
   <bemerk>~I3~~I4~~I5~~I6~~I7~~I8~</bemerk>
  </auftrag>
<*-- END G -->
<*-- BEGIN UNMOEGLICH -->
 <auftrag>
  <mandant>~Mandant~</mandant>
  ~sub~
  <aknr>~aknr~</aknr>
  <status>nichtmachbar</status>
  <monteur>~MonteurText~</monteur>
  <einbauort>~ZA~</einbauort>
  <datum>~WechselDatum_3~</datum>
  <bemerk>Unmöglich: ~V1~ ~V2~ ~V3~ ~I3~~I4~~I5~~I6~~I7~~I8~</bemerk>
</auftrag>
<*-- END UNMOEGLICH -->
<*-- BEGIN VORGEZOGEN -->
 <auftrag>
  <mandant>~Mandant~</mandant>
  ~sub~
  <aknr>~aknr~</aknr>
  <status>nichtmachbar</status>
  <monteur>~MonteurText~</monteur>
  <einbauort>~ZA~</einbauort>
  <datum>~WechselDatum_3~</datum>
  <bemerk>Vorgezogen: ~V1~ ~V2~ ~V3~ ~I3~~I4~~I5~~I6~~I7~~I8~</bemerk>
 </auftrag>
<*-- END VORGEZOGEN -->
<*-- INSERT AUSBAU_1 -->
<*-- INSERT AUSBAU_2 -->
<*-- INSERT AUSBAU_3 -->
<*-- INSERT AUSBAU_4 -->
<*-- INSERT EINBAU_1 -->
<*-- INSERT EINBAU_2 -->
<*-- INSERT EINBAU_3 -->
<*-- INSERT EINBAU_4 -->
<*-- INSERT E -->
<*-- INSERT E2 -->
<*-- INSERT E3 -->
<*-- INSERT E4 -->
<*-- INSERT WA -->
<*-- INSERT G -->
<*-- INSERT UNMOEGLICH -->
<*-- INSERT VORGEZOGEN -->
</ergebnis>

Abgerufen von „https://wiki.orgamon.org/index.php?title=Schnittstelle.co-met&oldid=29561“