Schnittstelle.co-met

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.
• Bei ->Person im Monteur muss bei Name "Nachname, Vorname" stehen, damit dieses Schema ergehalten wird

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
    • 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>