Tech Notes

Erstellen der Konfigurationsdatei für Service

In diesem Kapitel sind die Argumente der Konfigurationsdatei für den Barcode-Leser-Einsatz im Service dokumentiert.
Allgemeine Informationen sind in der Einleitung zu finden.

Kontext / Sektion

Die Argumente (ausser jene für die Kommunikation und das Einlesen des Barcode) können je nach Anforderung in den jeweiligen BCs und WS unterschiedlich definiert werden.
Dabei bildet die Nummer des BC bzw. WS einen Kontext. Dieser Kontext wiederum, wird in der Konfigurationsdatei durch eine bestimmte Sektion abgebildet.
Alle Argumente die in der Konfigurationsdatei bei der jeweiligen Sektion definiert sind, gelten dann für den entsprechenden Kontext.
Falls ein Argument über einen Default-Wert verfügt, wird dieser durch den in einer Sektion hinterlegten Wert überschrieben.
Es stehen folgende Kontexte bzw. Sektionen zur Verfügung:
Kontext / Sektion
Beschreibung
1
/SERV-REP
BC 41001
  • Suchen von Kundenadressen
  • Servicerapporte erstellen
2
/SERV-POS
Workspace 41000
  • Rapportpositionen erfassen
  • Servicerapporte gezielt über die Interne Dokument-Nr. (BoId) öffnen
3
-
4
-
5
/ADR
Workspace 11000
  • Adressen suchen
6
/ART
Workspace 21000
  • Artikel suchen

Argumente der Konfigurationsdatei

Gruppe
Argument
Kontext
Beschreibung
Kommunikation
Diese Argumente sind zwingend!
PORT=
-
Unterstützte COM Ports: 1 bis 9
Default = 1
 
BAUD=
-
Baud-Rate: 1200 bis 115200
Default = 19200
 
PARITY=
-
N = NONE, E = EVEN, O = ODD
Default = N
 
DATABIT=
-
Databit: 7 oder 8
Default = 8
 
STOPBIT=
-
Stopbit: 0 bis 2
Default = 1
 
-
Einlesen des Barcode
Diese Argumente sind zwingend!
TRANS_FORMAT=
-
Online-Leser = 3
 
HEADER_LEN=
-
Länge des Headers (Nur Offline-Leser!)
Gemäss den Herstellerangaben des Barcode-Leser Programms.
 
RECORD_LEN=
-
Länge des eigentlichen Barcode-Records. (Nur Offline-Leser!)
 
RECORD_EOL=
-
EndOfLine Zeichen
LF = 10
CR = 13
Dieses Zeichen muss auf dem Online-Leser konfiguriert sein.
 
Interpretation des Barcode-Records
DIRECT_SEARCH=
/SERV-REP
/SERV-POS
/ADR
/ART
Dieser Parameter entscheidet darüber, ob Adressen oder Artikel über den Barcode bzw. über die Barcode-ID oder direkt über die Nummer gesucht werden.
0 = Suche über Barcode (Adresse) bzw. Barcode-ID (Artikel)
1 = Suche direkt über Adress-Nummer bzw. Artikel-Nummer
Siehe Parameter:
ADRESS_START, ADRESS_LEN
BARCODE_START, BARCODE_LEN
NEW_DOCUMENT=
/SERV-REP
Steuert im BC 41001 Kundenrapport welches Dokument geöffnet wird.
0 = Kein Dokument öffnen.
1 = Neues Dokument öffnen.
Notiz
Notiz
Optional: Stufe und ShortCut
Folgt nach dem Wert 1 ein Komma und dann die Dokumentstufe gefolgt vom ShortCut, wird gezielt ein Dokument dieser Stufe und dieses ShortCuts erstellt.
Beispiel: NEW_DOCUMENT=1,3R erstellt einen Störfall-Rapport R .
Längenangabe der Argumente
Praktisch jeder Parameter wird mit einem START- und einem LEN- Wert erfasst. Aus Gründen der Übersichtlichkeit, werden die LEN- Werte nicht als separate Einträge ausgeführt, sondern jeweils zusammen mit dem START- Wert.
Sinngemäss sind in all diesen Fällen die LEN- Werte zu erfassen. Sie beschreiben jeweils die Anzahl Stellen innerhalb des Barcode-Records, welche den jeweiligen Parameter bilden.
ADDRESS_START=
ADDRESS_LEN=
/SERV-REP
/SERV-POS
/ADR
Startpunkt innerhalb des Barcode-Records für die Suche nach Adresse [Addr].
Die Suche erfolgt über den Barcode [Addr.Barcode]
Voraussetzung: Adress-Barcode aktiv im OpaccOXAS Studio BC 91100.
Die Adresse kann auch direkt über die Adress-Nummer [Addr.Number] gesucht werden. (Siehe Parameter DIRECT_SEARCH.)
Im Kontext /SERV-POS ist dies der Startpunkt innerhalb des Barcode-Records für den Mitarbeiter. Dieser Parameter kann bei Zuteilungen, Soll- und Ist-Zeilen verwendet werden.
BARCODE_START=
BARCODE_LEN
/SERV-POS
/ART
Startpunkt innerhalb des Barcode-Records für die Suche nach Artikel [Art].
Die Suche erfolgt gemäss den im OpaccOXAS Studio BC 92100 vorgenommenen Einstellungen betreffend Barcode.
Der Artikel kann auch direkt über die Artikel-Nummer [Art.Number] gesucht werden. (Siehe Parameter DIRECT_SEARCH.)
Im Kontext /SERV-POS:
Soll eine neue Zuteilung erfasst werden, hat der Parameter BARCODE je nach Zuteilungsart folgenden Inhalt:
  • Zuteilungsart: Artikel/Modell
    BARCODE = Barcode des Artikels.
  • Zuteilungsart: Archiv
    BARCODE = Nummer des Archiveintrags.
    Dazu kommt zwingend die Laufnummer des Archiveintrags. (SEQNO)
  • Zuteilungsart: Objektverwaltung
    BARCODE = BoId des Objekts.
  • Zuteilungsart: AdHoc
    BARCODE nicht verwenden!
BOID_START=
BOID_LEN=
/SERV-REP
/SERV-POS
/ADR
/ART
Startpunkt innerhalb des Barcode-Records für die Suche nach einem BO.
  • Adresse
  • Artikel
  • Servicerapport
Im Kontext /SERV-REP gilt:
Startpunkt innerhalb des Barcode-Records für die Suche nach der Projekt-/Vertragsnummer.
Im Kontext /SERV-POS gilt:
Wird die BOID angegeben, so wird der entsprechende Servicerapport gesucht und geladen, wird die BOID mit 0 angegeben, so wird die Position dem aktiven Dokument hinzugefügt.
ASSIGNTYPE_START=
ASSIGNTYPE_LEN=1
/SERV-REP
/SERV-POS
Startpunkt innerhalb des Barcode-Records für den Zuteilungstyp oder die Zuteilungsart.
Zuteilungstyp (Kontext /SERV-REP)
1 = Projekt
2 = Vertrag
3 = Keine Zuteilung
Zuteilungsart (Kontext /SERV-POS)
1 = Artikel
2 = Archivposition
5 = Objekt
6 = Strukturknoten
9 = Keine Zuteilung (AdHoc)
Die Länge dieses Arguments ist fix mit 1 zu definieren.
ITEMTYPE_START=
ITEMTYPE_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Rapportzeilenart.
1 = A (Zuteilung)
2 = N (Sollzeile)
3 = E (Istzeile)
4 = I (Interne Zeile)
9 = Dokument anzeigen
NUMBER_START=
NUMBER_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die interne Nummer der übergeordneten Rapportposition (z.B. Zuteilung oder Sollzeile) für das Hinzufügen von Rapportpositionen.
Überschreibt (falls vorhanden) Zuteilung (ASSIGNNO) und Sollzeile (NOMINALNO).
ASSIGNNO_START=
ASSIGNNO_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Nummer der Zuteilung zu welcher eine Rapportposition hinzugefügt werden soll.
NOMINALNO_START=
NOMINALNO_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Nummer der Sollzeile zu welcher eine Rapportposition hinzugefügt werden soll.
SEQNO_START=
SEQNO_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Laufnummer des Archiveintrags.
Dieser Parameter wird nur für das Neuerstellen von Zuteilungen mit der Zuteilungsart Archiv und in Kombination mit BARCODE = Archivnummer verwendet.
SERVRESNO_START=
SERVRESNO_LEN=
/SERV-POS
Bei Zuteilung:
Startpunkt innerhalb des Barcode-Records für den Service-Code auf der Zuteilung.
Bei Sollzeile:
Startpunkt innerhalb des Barcode-Records für die Ressourcennummer auf der Sollzeile.
SERVICETYPE_START=
SERVICETYPE_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Leistungsart.
Dieser Parameter kann bei Zuteilungen, Soll- und Istzeilen verwendet werden.
DATE_START=
DATE_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für das Beginn-Datum.
Dieser Parameter kann bei Zuteilungen, Soll- und Istzeilen verwendet werden.
Notiz
Notiz
Das Datum muss ohne Trennzeichen in folgendem Format angegeben werden: DDMMYYYY oder DDMMYY
Beispiel: 01062018
DATETO_START=
DATETO_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für das Ende-Datum.
Dieser Parameter kann bei Zuteilungen, Soll- und Istzeilen verwendet werden.
Notiz
Notiz
Das Datum muss ohne Trennzeichen in folgendem Format angegeben werden: DDMMYYYY oder DDMMYY
Beispiel: 01062018
TIME_START=
TIME_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Beginn-Zeit (TimeFrom).
Dieser Parameter kann bei Zuteilungen, Soll- und Istzeilen verwendet werden.
TIMETO_START=
TIMETO_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die Ende-Zeit (TimeTo).
Dieser Parameter kann bei Zuteilungen, Soll- und Istzeilen verwendet werden.
QUANTITY_START=
QUANTITY_LEN=
/SERV-POS
Bei Zuteilung:
Startpunkt innerhalb des Barcode-Records für den Zähler1 auf der Zuteilung.
Bei Sollzeile:
Startpunkt innerhalb des Barcode-Records für die eff. Menge auf der Sollzeile.
Bei Istzeile:
Startpunkt innerhalb des Barcode-Records für die eff. Menge auf der Istzeile.
QUANTITY2_START=
QUANTITY2_LEN=
/SERV-POS
Bei Zuteilung:
Startpunkt innerhalb des Barcode-Records für den Zähler2 auf der Zuteilung.
Bei Sollzeile:
Startpunkt innerhalb des Barcode-Records für die verr. Menge auf der Sollzeile.
Bei Istzeile:
Startpunkt innerhalb des Barcode-Records für die verr. Menge auf der Istzeile.
QUANTITY3_START=
QUANTITY3_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die eff. Menge auf der Istzeile. Dieser Parameter wird verwendet, wenn beim Erstellen einer Sollzeile gleichzeitig Istzeilen erstellt werden sollen. Die hier hinterlegte Menge wird dann bei der Istzeile verwendet.
QUANTITY4_START=
QUANTITY4_LEN=
/SERV-POS
Startpunkt innerhalb des Barcode-Records für die verr. Menge auf der Istzeile. Dieser Parameter wird verwendet, wenn beim Erstellen einer Sollzeile gleichzeitig Istzeilen erstellt werden sollen. Die hier hinterlegte Menge wird dann bei der Istzeile verwendet.
DEFITEMTYPE_START=
DEFITEMTYPE_LEN=
/SERV-POS
Der DEFITEMTYPE wird verwendet, wenn der ITEMTYPE = 0 oder gar nicht definiert ist.
0 = Die Rapportzeilenart welche im WS aktiv ist, wird verwendet
1 = Neue Zuteilung. Wird keine Zuteilungsart mitgegeben, so wird Artikel/Modell verwendet
2 = Neue Soll-Zeile
3 = Neue Ist-Zeile
4 = Neue interne Zeile
9 (Default) = Nur Dokument öffnen (Falls BOID der BoId eines Dokuments entspricht)
Ist weder ITEMTYPE noch DEFITEMTYPE definiert, dann wird als Default DEFITEMTYPE = 9 verwendet.
ERROR_BEEP=
/SERV-REP
/SERV-POS
Bei einem Fehler einen Warnton ertönen lassen?
0 = Nein
1 = Ja
Default = 0
SUCCESS_BEEP=
/SERV-REP
/SERV-POS
nach erfolgreicher Verarbeitung einen Warnton ertönen lassen?
0 = Nein
1 = Ja
Default = 0
AUTOEXEC=
/SERV-REP
/SERV-POS
Die Position sofort speichern?
0 = Die Position wird nicht gespeichert (Der Cursor steht auf der Dimension 1)
1 = Die Position wird sofort gespeichert (Menge gem. Vorgabe auf dem Artikel)
Default = 1
Ausführen von F-Scripts und starten von BCs
CALL_ARGUMENT_START=
/SERV-REP
/SERV-POS
Startpunkt innerhalb des Barcode-Records zur Ermittlung des Wertes (arg) für den Parameter CALL. Die Länge des Wertes wird dabei nicht angegeben. Die Übereinstimmung des Wertes wird ab diesem Startpunkt ermittelt.
CALL(arg)=
/SERV-REP
/SERV-POS
CALL(arg)=<F-Script-Name>,<BC-Nummer>
Die F-Script Input-Argumente können im Script via Clipboard «CB(n) » abgefragt werden und sind je nach Kontext verschieden:
/VER-POS, /EIN-POS, /EIN-POS2
CB(4) = arg plus weitere Zeichen des Records.
CB(5) = BoId des Dokuments.
CB(6) = BoId der Position.

/VER-KADR
CB(4) = arg plus weitere Zeichen des Records.
CB(5) = BoId des Dokuments.
CB(6) = BoId der Position.
CB(7) = BoId der Adresse.
Nach der Ausführung des F-Scripts wird das unter <BC-Nummer> aufgeführte BC gestartet.
<F-Script-Name> und <BC-Nummer> können auch einzeln verwendet werden.
Identifizieren von unterschiedlichen Barcodes
CODE_ID_MARK_START=
alle
Startpunkt innerhalb des Barcode-Records zur Ermittlung des Wertes (ID) für den Parameter CODE_ID_MARK. Die Länge des Wertes wird dabei nicht angegeben. Die Übereinstimmung des Wertes wird ab diesem Startpunkt ermittelt.
Notiz
Notiz
Beachten Sie, dass der Barcode-Leser entsprechend konfiguriert sein muss damit die Barcode-ID (oft auch Präfix genannt) ausgelesen werden kann.
:CODE_ID_MARK=
alle
:CODE_ID_MARK=(id)
Durch Angabe einer id kann spezifisch auf verschiedene Typen von Barcodes eingegangen werden.
Beispiel eines Typ-A Barcode (id/Präfix A): 7 310780 025517
Beispiel eines Typ-B Barcode (id/Präfix B): 7610 7207
Innerhalb einer Sektion wird nach der :CODE_ID_MARK gesucht, welche der durch den Barcode-Record gelieferten id entspricht.
Beispiel:
...
...
/EIN-POS
CODE_ID_MARK_START=1
--EAN 13
:CODE_ID_MARK=A
--Suche nach Barcode
DIRECT_SEARCH=0
BARCODE_START=2
BARCODE_LEN=13
AUTOEXEC=1
--Code mit Prefix B
:CODE_ID_MARK=B
--Suche nach Barcode
DIRECT_SEARCH=0
BARCODE_START=2
BARCODE_LEN=15
AUTOEXEC=1
--Dokument suchen
:CODE_ID_MARK=M
--Suche nach BoId des Dokumentes
BOID_START=2
BOID_LEN=10

Beispiele von Konfigurationsdateien

Falls Sie einen Update von einer früheren Version von OpaccOne auf die aktuelle Version von OpaccERP durchführen oder durchgeführt haben, kann es vorkommen, dass die Konfigurationsdateien angepasst werden müssen. So war beispielsweise der Parameter PARITY in älteren Versionen in " eingeschlossen. (Bsp. PARITY = "N") Diese " sind ab der Version 12 von OpaccOne nicht mehr notwendig.

Beispiel einer Konfigurationsdatei für das Suchen einer Adresse im BC 41001

--/SERV-REP wird nur im BC 41001 abgearbeitet.
/SERV-REP
CODE_ID_MARK_START=1
--Code mit Prefix B
  :CODE_ID_MARK=B
  --Suche Adresse nach Barcode in BC 41001.
  --Hier wird nur die Adresse gesucht, die weiteren Schritte erfolgen manuell.
  DIRECT_SEARCH=0
  DEFITEMTYPE=0
  ADDRESS_START=2
  ADDRESS_LEN=8
AUTOEXEC=0

Beispiel einer Konfigurationsdatei für das Neuerstellen eines Servicerapports

--/SERV-REP wird nur im BC 41001 abgearbeitet.
/SERV-REP
CODE_ID_MARK_START=1
--Code mit Prefix K
  :CODE_ID_MARK=K
  --Neuerstellen eines Servicerapport.
  --Der Barcode enthält die Adresse, die Zuteilungsart und die Projekt-/Vertragsnummer.
  --Suche Adresse
  DIRECT_SEARCH=0
  ADDRESS_START=2
  ADDRESS_LEN=8
  --Zuteilungsart (Projekt/Vertrag)
  ASSIGNTYPE_START=10
  ASSIGNTYPE_LEN=1
  --Projekt-/Vertragsnummer
  BOID_START=11
  BOID_LEN=8
  --Dokumentstufe und Shortcut des zu erstellenden Servicerapports.
  NEW_DOCUMENT=1,4F
AUTOEXEC=1

Beispiel einer Konfigurationsdatei das Erfassen einer neuen Soll-Zeile auf einem bestehenden Servicerapport

--/SERV-POS wird im WS 41000 abgearbeitet.
/SERV-POS
 CODE_ID_MARK_START=1
--Code mit Prefix K
  :CODE_ID_MARK=K
  --Neue Sollzeile auf bestehenden Rapport und bestehende Zuteilung erfassen.
  DIRECT_SEARCH=0
  --Itemtype: 2 = Sollzeile, 3 = Istzeile etc.
  ITEMTYPE_START=2
  ITEMTYPE_LEN=1
  --BoId des Rapportes (Hier mit sechs Stellen, normal sollte mit zehn Stellen gearbeitet werden.)
  BOID_START=3
  BOID_LEN=6
  --Interne Nummer der übergeordneten Rapportzeile (Zuteilung / Soll-Zeile)
  NUMBER_START=9
  NUMBER_LEN=3
  --Nummer der Zuteilung (z.B. 01 = Zuteilung 1)
  ASSIGNNO_START=12
  ASSIGNNO_LEN=2
  --Barcode des Artikels (hier EAN-13 mit 13 Stellen)
  BARCODE_START=17
  BARCODE_LEN=13
  --Servicetyp (z.B. 10 = Regie)
  SERVICETYPE_START=36
  SERVICETYPE_LEN=2
  --Address-Barcode des Mitarbeiters (nicht Ressource) der auf der Zeile hinterlegt wird.
  ADDRESS_START=38
  ADDRESS_LEN=4
  QUANTITY_START=62
  QUANTITY_LEN=4

Beispiel einer Konfigurationsdatei: Artikel suchen für das Neuerstellen von Soll- und Ist-Zeilen

--/SERV-POS wird im WS 41000 abgearbeitet.
/SERV-POS
CODE_ID_MARK_START=1
--Code mit Prefix A
  :CODE_ID_MARK=A
  --Suche nach Barcode
  DIRECT_SEARCH=0
  --Itemtype des WS verwenden.
  DEFITEMTYPE=0
  BARCODE_START=2
  BARCODE_LEN=13
AUTOEXEC=1
--Code mit Prefix B
  :CODE_ID_MARK=B
  --Suche nach Barcode
  DIRECT_SEARCH=0
  --Itemtype des WS verwenden.
  DEFITEMTYPE=0
  BARCODE_START=2
  BARCODE_LEN=13
AUTOEXEC=0