Quelltext der Seite Schnittstelle.Argos.2007

[[Import#Auftrags-Schnittstellen|zurück]]


* Die Firma Mainova gab Firma Bittner und Krull den Auftrag zum Argos System
* Oc Rev. 1.244 oder besser erforderlich


== Import ==

* es wird eine .xml Datei geliefert, die in eine csv-Datei konvertiert werden muss

=== Mapping.txt ===


 #########################
 ##                     ##
 ##  ARGOS  09.05.2016  ##
 ##                     ##
 #########################
 
 ARGOS=JA
 
 TOUR.KUNDE.GERAETEPLATZ.GERAET.TAET.ID;ARGOS
 TOUR.KUNDE.HOSTTYP;2
 TOUR.KUNDE.AUFTRAGSART;2
 TOUR.KUNDE.AUFTRAGSNUMMER;2
 TOUR.KUNDE.ARBEITSPLATZ;2
 TOUR.KUNDE.FREITEXT;2
 TOUR.KUNDE.STARTTERMIN;2
 TOUR.KUNDE.ENDTERMIN;2
 TOUR.KUNDE.VERSSICHERHEITKURZ;2
 TOUR.KUNDE.VERSSICHERHEITLANG;2
 TOUR.KUNDE.STANDORTWERK;2
 TOUR.KUNDE.ABLESEGRUND;2
 TOUR.KUNDE.ABLESEGRUNDTXT;2
 TOUR.KUNDE.ABLESEEINHEIT;2
 TOUR.KUNDE.SOLLABLESEDATUM;2
 TOUR.KUNDE.VERSANLAGE;2
 TOUR.KUNDE.ANSPRECHPARTNER;2
 TOUR.KUNDE.OBERKUNDE;2
 TOUR.KUNDE.SERVICEANBIETER;2
 TOUR.KUNDE.INSTANDLEISTART;2
 TOUR.KUNDE.ERFASSUNGSDATUM;2
 TOUR.KUNDE.ANSCHOBJEKTNR;2
 TOUR.KUNDE.AOORTSTEIL;2
 TOUR.KUNDE.AOSTRASSE;2
 TOUR.KUNDE.AOHSNR;2
 TOUR.KUNDE.AOPLZ;2
 TOUR.KUNDE.AOORT;2
 TOUR.KUNDE.VERBRSTELLE;2
 TOUR.KUNDE.LAGEVERBRSTELLE;2
 TOUR.KUNDE.KUNDENNR;2
 TOUR.KUNDE.GPNAME;2
 TOUR.KUNDE.GPVORNAME;2
 TOUR.KUNDE.GPSTRASSE;2
 TOUR.KUNDE.GPHSNR;2
 TOUR.KUNDE.GPPLZ;2
 TOUR.KUNDE.GPORT;2
 TOUR.KUNDE.GPORTSTEIL;2
 TOUR.KUNDE.GPTEL;2
 TOUR.KUNDE.GPFAX;2
 TOUR.KUNDE.ETNAME;2
 TOUR.KUNDE.ETVORNAME;2
 TOUR.KUNDE.ETSTRASSE;2
 TOUR.KUNDE.ETHSNR;2
 TOUR.KUNDE.ETPLZ;2
 TOUR.KUNDE.ETORT;2
 TOUR.KUNDE.ETORTSTEIL;2
 TOUR.KUNDE.ETTEL;2
 TOUR.KUNDE.ETFAX;2
 TOUR.KUNDE.SCHLBUND;2
 TOUR.KUNDE.SCHLNR;2
 TOUR.KUNDE.SCHLVER;2
 TOUR.KUNDE.ERSTERVORGANG;2
 TOUR.KUNDE.HAERTE;2
 TOUR.KUNDE.GERAETEPLATZ.GERAETEPLATZNR;2
 TOUR.KUNDE.GERAETEPLATZ.STANDORT;2
 TOUR.KUNDE.GERAETEPLATZ.STANDORTZUS;2
 TOUR.KUNDE.GERAETEPLATZ.MOTAGEART;2
 TOUR.KUNDE.GERAETEPLATZ.MOTAGEKENN;2
 TOUR.KUNDE.GERAETEPLATZ.SPERRM;2
 TOUR.KUNDE.GERAETEPLATZ.SPERRMKENN;2
 TOUR.KUNDE.GERAETEPLATZ.SCHACHT;2
 TOUR.KUNDE.GERAETEPLATZ.DAUER;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SPARTE;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SPARTETXT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.TYPALT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.MATERIALALT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SERIALALT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ZAEHLERNRMECHALT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ZAEHLERNRELEKALT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.TYPNEU;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.MATERIALNEU;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.WECHSELJAHR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.BGLJAHR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.BGLART;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.PRUEFSTATUS;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.PRUEFNR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.PRUEFREL;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.PRUEFRELTXT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SPERRSTAT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SPERRSTATTXT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.SPERRGEGNR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ZIELLAGER;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ZWGRUPPE;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.PMEQUIPNR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.WERK;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ILOA;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.STATUS;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.EINGEBEG;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.GERAETEGRPNR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.ANWENDERSTAT;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.KFR;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.LOS;2
 TOUR.KUNDE.GERAETEPLATZ.GERAET.KZSCHAETZUNG;2
 TOUR.KUNDE.GERAETEPLATZ.ANZAHL_GERAETE;2
 0=<?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?>


* Beim Konvertieren mit Oc entsteht eine XML.BLA, diese Datei muss ins Baustellenverzeichnis kopiert werden

=== technisch notwendige Felder ===

* ein einziges Intern-Feld ist technisch notwendig

 ARGOS

=== optionale Felder ===

* in der Ergebnis.csv können optionale Spalten hinzugenommen werden um so Schnittstellen-Eigenschaften zu steuern

==== ARGOS-Optionen ====

* der Eintarif wird ohne diese Spalte im "NT" gemeldet
* Ist die Spalte einfach nur vorhanden, dann wird bereits
** im Eintarif der Zählerstand in der Hülse "NT" gemeldet (sonst "HT")
* Folgende Inhalte können als Konstanten exportiert werden:
** 'x' bewirkt, dass bei einem Eintarif-Zähler der Zählerstand im NT gemeldet wird.

== Protokoll ==

* Argos liefert Datenhülsen die befüllt werden können, dabei gibt es folgende Konvention
**  kurz('Stand', x(r, 'ZaehlerStandAlt'), r);
**      kurz('Stand neu', x(r, 'ZaehlerStandNeu'), r);
**    taet('Serial-Nr. neu', x(r, 'ZaehlerNummerNeu'), r);
**    taet('Vorgangsgrund', '11', r);
**    taet('Gerät ausgebaut', 'ja', r);
**    OptTaet('1. gescheiterter Versuch', x(r, 'V1'), r);
**    OptTaet('2. gescheiterter Versuch', x(r, 'V2'), r);
**    taet('Unterschrift Monteur', x(r, 'MonteurText') + '(' + x(r, 'MonteurHandy') + ')', r);
**    OptTaet('Bemerkung', cutblank(x(r, 'I1') + ' ' + x(r, 'I2') + ' ' + x(r, 'I3')), r);
**    OptDiff('MOTAGEKENN', 'Korr. MontagekennzeichenNr', x_optional(r, 'SA'), r);
**    OptTaet('PlombierungOK', x_optional_X(r, 'SB'), r);
**    OptTaet('Mangel sichtbar', x_optional_X(r, 'SC'), r);
**    OptDiff('SPERRMKENN', 'Korr. Sperrmöglichkeitnr.', x_optional(r, 'A1'), r);
**    OptTaet('Korr. Verbrauchsstelle', x_optional(r, 'A2'), r);
**    OptTaet('Korr. Standortnr', x_optional(r, 'A3'), r);
**    OptTaet('Korr. Standortzusatz', x_optional(r, 'A4'), r);
**    OptTaet('Korr. Standortzusatz Freitext', x_optional(r, 'A5'), r);
**    Opttaet('Mängelkarte',x_optional_X(r,'A6'),r);
**    Opttaet('Mängelart',x_optional(r,'A7'),r);
**    OptTaet('Spannungsunterbrechung', x_optional(r, 'SD'), r);
**    OptTaet('Dauer Spannungsausfall', x_optional(r, 'N1'), r);
**    // Opttaet('TRE Einbau',x_optional(r,'N2'),r);
**    OptTaet('Rundsteuerempfänger Ausbau', x_optional(r, 'N2'), r);
**    // Opttaet('TRE-Huckepack neu',x_optional(r,'TA'),r);
**    OptTaet('Huckepack-TRE', x_optional(r, 'TA'), r);
**    // Opttaet('TRE-Kommando Einzeln neu',x_optional(r,'TB'),r);
**    OptTaet('TRE-Kommando Einzeln', x_optional(r, 'TB'), r);
**      if x_optional_upper(r, 'B1') = 'X' then        taet('KFR-Ventile', 'RVN', r);
**      if x_optional_upper(r, 'B2') = 'X' then        taet('KFR-Ventile', 'RVD', r);
**      if x_optional_upper(r, 'B3') = 'J' then        taet('KFR-Ventile', 'RVP', r);
**      if x_optional_upper(r, 'B3') = 'N' then        taet('KFR-Ventile', 'RVO', r);
** //      OptTaet('Korr. Verbrauchsstelle',x_optional(r,'I1'),r);
** //     OptTaet('Korr. Standortzusatz Freitext',      cutblank(      x_optional(r,'I2')+' '+      x_optional(r,'I3') ),r);      OptTaet('Anschlussobjekthinweis',x_optional(r,'I4'),r);
**//      taet('Korr. Standort TXT',      cutblank(      x(r, 'I3') + '|' +      x(r, 'I4') + '|' +      x(r, 'N5') + ' ' + x(r, 'I6')      ), r);

=== Wechsel eines Eintarif-Zählers ===

==== ohne das Feld "ARGOS-Optionen" ====

** im Eintarif :       kurz('StandNT', x(r, 'ZaehlerStandAlt'), r);
** im Eintarif :        kurz('StandNT neu', x(r, 'ZaehlerStandNeu'), r);

==== mit dem Feld "ARGOS-Optionen" ====

+++ nicht verwenden, dies ist nur ein Ansetzpunkt für zulünftige Erweiterungen der Schnittstelle +++


** im Eintarif :       kurz('StandHT', x(r, 'ZaehlerStandAlt'), r);
** im Eintarif :        kurz('StandHTneu', x(r, 'ZaehlerStandNeu'), r);

=== Wechsel eines Doppeltarif-Zählers ===

** im Doppeltarif:        kurz('StandHT', x(r, 'ZaehlerStandAlt'), r);
**  im Doppeltarif:        kurz('StandNT', x(r, 'NA'), r);
**  im Doppeltarif:        kurz('StandHTneu', x(r, 'ZaehlerStandNeu'), r);
**  im Doppeltarif:        kurz('StandNT neu', x(r, 'NN'), r);

== Ergebnis ==

=== Reiter Ergebnis (der Eintarif im NT) ===

 SpaltenReihenfolge=Quelle;ARGOS!;ZaehlerStandAlt!;ZaehlerNummerNeu!;ZaehlerStandNeu!
 AuchAlsXML=JA
 ZählerNummerNeuAusN1=NEIN

=== Reiter Ergebnis (der Eintarif im HT) ===

+++ nicht verwenden, dies ist nur ein Ansetzpunkt für zulünftige Erweiterungen der Schnittstelle +++


 SpaltenReihenfolge=Quelle;ARGOS!;ZaehlerStandAlt!;ZaehlerNummerNeu!;ZaehlerStandNeu!;ARGOS-Optionen
 AuchAlsXML=JA
 ZählerNummerNeuAusN1=NEIN