Übergabeschnittstelle UGS
Die Übergabeschnittstelle (UGS) wurde am 01.03.95 von der Syka-Soft definiert. Sie ist in der SHK Branche zum Standard geworden.
Diese Datenschnittstelle wird benötigt zur Übergabe von projektbezogenen Daten unterschiedlicher Programme, z.B. Bildkatalog-Verarbeitung, technischer Auslegungs-Programme, CAD-Programme an das sykasoft-Programm.
Beispiel: Technik-Daten von Dendrit über die erweiterte UGS
Nach Ausgabe einer Materialzusammenstellung mit Herstellernummern aus den Dendrit-Berechnungsprogrammen per UGS können – durch die erweiterte sykasoft UGS-Schnittstelle – den Herstellern die passenden Lieferantennummern zugeordnet werden. Einmal zugeordnete Nummern werden beim nächsten Mal wieder erkannt. Nach und nach füllt sich die UGS-Schnittstelle immer mehr mit Lieferanten-Zuordnungen und „lernt“ somit dazu.
UGS Schnittstellenbeschreibung (Info für Entwickler)
Allgemeine Datenformate:
numerisch: rechtsbündig mit Vornullen, ohne Punkt (Feld komplett gefüllt)
alphanumerisch: linksbündig
Die mit * gekennzeichneten Feldinhalte müssen zwingend übergeben werden.
”UGS” steht für Übergabeschnittstelle. Jede in sich abgeschlossene Übergabe wird in einer separaten Datei abgelegt im Pfad \UGS mit der Erweiterung .UGS.
Der Name der Datei ist auf 8 Stellen alphanumerisch (ohne Sonderzeichen) begrenzt; er kann frei vergeben werden, z.B. Projektnr. oder Kundenname. Durch die Speicherung in verschiedenen Dateien ist es leicht möglich, die jeweilige Übergabedatei über eine Tabelle auszuwählen und nach Verarbeitung zu löschen.
Die Sätze sind variabel lang und werden durch CR/LF getrennt (sequentielle Datei). Jeder Satz besitzt ein Satzkennzeichen:
V: Vorlaufsatz
A: Artikelsatz
Vorlaufsatz:
Der Kommentarsatz im Vorlaufsatz wird gebraucht, um z.B. einen Kommentar zum Projekt bei der Übergabe mitzugeben, um bei der Übergabe eine allgemeine Beschreibung der enthaltenen Artikel auszugeben, z.B. ”Waschtischanlage bestehend aus:”
Im Feld für Lohnminuten kann die Arbeitszeit für den Einbau der nachfolgenden Einzelartikel für die Kalkulation kompakt eingegeben werden (falls Lohnminuten im Vorlaufsatz angegeben, sind die Lohnminuten im Artikelsatz nicht relevant).
Der Pauschalpreis ist dazu gedacht, um für die Stückliste einen anderen Preis zu bilden als die Summe der Einzelpreise der nachfolgenden Artikel ergibt.
Artikelsatz:
Das Verarbeitungskennzeichen 1 wurde wie folgt definiert :
01 Alternativ-Artikel
02 Eventual-Artikel
03 Anfang Paket
04 Ende Paket
05 mit Beschreibung
06 ohne Preis
13 Anfang Paket Alternativ
14 Ende Paket Alternativ
23 Anfang Paket Eventual
24 Ende Paket Eventual
|
Satz |
Inhalt |
Stellen |
Satz |
Beschreibung |
|
Satz1 |
* |
V für Vorlaufsatz |
1-1 |
1 Stelle alphanumerisch |
|
frei (Blank auffüllen) |
2-2 |
1 Stelle alphanumerisch |
||
|
* |
Datum |
3-8 |
JJMMTT (6 Stellen numerisch) |
|
|
Kommentar |
9-88 |
2 x 40 Stellen alphanumerisch |
||
|
Lohnminuten |
89-94 |
5 Vorkomma-, 1 Nachkommastelle num. |
||
|
Pauschalpreis |
95-103 |
7 Vorkomma-, 2 Nachkommastellen num. |
||
|
ab Satz 2 |
* |
A für Artikel |
1-1 |
1 Stelle alphanumerisch |
|
frei (Blank auffüllen) |
2-2 |
1 Stelle alphanumerisch |
||
|
Händler-Kennzeichen |
3-6 |
4 Stellen alphanumerisch |
||
|
* |
Artikelnummer |
7-23 |
17 Stellen alphanumerisch |
|
|
* |
Menge |
24-31 |
5 Vorkomma-, 3 Nachkommastellen num. |
|
|
Verarbeitungs-Kennzeichen 1 |
32-33 |
2 Stellen numerisch |
||
|
Verarbeitungs-Kennzeichen 2 |
34-35 |
2 Stellen numerisch |
||
|
Lohnminuten |
36-41 |
5 Vorkomma-, 1 Nachkommastelle num. |
