45J.01 Schnittstellentyp 1 (Default)
Eigenschaften
  • Verzeichnis und Name der Schnittstellendatei müssen über den INI-Eintrag “Datei” in Sektion [AUF45J] konfiguriert werden. Eine Eingabe ist aber möglich.
    infra:NET löscht die Datei nach dem erfolgreichen Einlesen der Datensätze. Bei Fehlern bleibt die Datei erhalten.
    Die externe Software erzeugt die Datei bzw. hängt an eine vorhandene Datei an.
  • Die Synchronisation erfolgt über eine Semaphorendatei. Verzeichnis und Name der Datei müssen über den INI-Eintrag “SEM-Datei” in Sektion [AUF45J] konfiguriert werden.
    Das jeweils schreibende/lesende Programm legt die Datei an und löscht die Datei nachdem der Schreib-/Lesevorgang beendet ist.
  • Über eine Markierung kann im Echtlauf eine Poll-Funktion mit einstellbarem Rhythmus für das Lesen der Datei aktiviert werden, siehe INI-Eintrag “Pollzeit” in Sektion [AUF45J].
    Das Pollen wird abgebrochen, wenn ein schwerer Fehler entdeckt wird. Folgende Fehler werden aber nur protokolliert und das Pollen wird fortgesetzt:
  • Position schon vollgeliefert, es wird dennoch übernommen.
  • Position schon erledigt (Status „E“), Übernahme wird dann abgewiesen.
  • Überlieferung, es wird dennoch übernommen.
  • Nach der Anwahl kann im Selektionsdialog Probelauf, Pollmodus und Schnittstellendatei eingegeben werden.
  • Es wird ein Übergabeprotokoll in eine Datei geschrieben. Die Datei wird immer erweitert. In der Datei sind auch evtl. auftretende Fehler enthalten.
    Verzeichnis und Name der Protokolldatei müssen über den INI-Eintrag “PROT-Datei” in Sektion [AUF45J] konfiguriert werden.
  • Positionen können teilgeliefert aber nicht überliefert werden.
  • Durch das Einlesen der Auftragsposition wird der Status der Position auf 35 bei vollständiger Lieferung (Auslieferungsmenge = Auftragsmenge) gesetzt.
    Wird nur eine Teilmenge übergeben, wird der Status auf 32 gesetzt.
    Falls die Position schon teilgeliefert und/oder teilfakturiert ist, dann bleibt der Zustand unverändert.
  • Bei Fehlern wird abgebrochen und der Pollmodus wird ausgeschaltet. Die Übergabedatei bleibt erhalten!
    Folgende Fehler-Situationen werden in der Protokolldatei ausgewiesen (Zeilen mit ***Error***):
  • Fehler bei Datei- oder Datenbankzugriffen oder weitere schwere Fehler (z.B. Zahl zu groß für Feldformat)
  • Auftragsposition in infra:NET ist nicht vorhanden.
  • Es wird eine andere Teilenummer übergeben, als in der Kundenauftragsposition steht.
Aufbau der Schnittstellendatei
Die Felder werden ohne Trennzeichen an festen Positionen ausgegeben und müssen mit Zeilenvorschub (CR/LF) abgeschlossen sein.
Feld
Position
Länge
Beschreibung
Auftragsnummer
1
8
Max. 7-stellige Nummer. Infra-Format ist n7 und das Feld wird entsprechend formatiert
Position
9
5
Max. 5-stellige Positionsangabe. Infra-Format ist n5 und das Feld wird entsprechend formatiert
Unterposition
14
3
Max. 3-stellige Unterposition. Infra-Format ist C4. Leerzeichen werden entfernt und Unterposition wird rechtsbündig abgestellt
Teilenummer
17
15
Max. 15 Stellen. Infra-Format ist C15. Muss linksbündig übergeben werden
Auslieferungs-
menge
32
12
Infra-Format ist N7.3, das Feld wird entsprechend formatiert. Dezimaltrenner muss Komma oder Punkt sein.
Die Menge wird ab dem Zustand „Bestätigt“ (30) zum bisherigen Wert im Feld Auslieferungsmenge addiert und davor wird die bisherige Auslieferungsmenge überschrieben.
Hinweise:
  • Es muss in der Mengeneinheit der K-/S-Zeile übergeben werden.
  • Falls schon eine Auslieferungsmenge im Satz steht (bei Zustand < 30, also noch nicht bestätigt), wird eine Warnung in der Protokolldatei ausgegeben.
  • Die zu fakturierende Menge wird folgendermaßen angepasst:
    Bereits geliefert + Auslieferungsmenge - bereits berechnet
    Hinweis: Siehe aber INI-Einstellung „MngFakt“ in Sektion
    [AUF45J], um die zu fakturierende Menge bei jeder Übernahme auf 0 zu setzen bzw. die übergebene Menge unverändert zu lassen
Lieferbereit
44
1
1 =
Markierung «Ausliefern» wird aktiviert
Rest =
Markierung «Ausliefern» wird nicht aktiviert
Fakturierbereit
45
1
1 =
Markierung «Fakturieren» wird aktiviert
Rest =
Markierung «Fakturieren» wird nicht aktiviert
Name
46
C30
Wird in Protokolldatei übernommen und nicht in ein infra-Feld übertragen
Bemerkung
76
250
Wird in Protokolldatei übernommen und nicht in ein infra-Feld übertragen
Zeilenvorschub
326
2
CR/LF (Carriage return/Linefeed, Zeilenumbruch/Vorschub, 0D/0A, ASCII 13/10)