BüroWARE Standardschnittstelle Was ist die BüroWARE

BüroWARE Standardschnittstelle
Was ist die BüroWARE Standardschnittstelle?
à Über die BüroWARE Standardschnittstelle können Daten importiert,
geändert oder gelöscht werden.
Wie Funktioniert die Standardschnittstelle?
Die Standardschnittstelle(Datei) ist immer nach dem gleichen Schema aufgebaut:
1. Angabe des Datenbereiches in welchen importiert werden soll (z.B. Adressen,
Artikel,...)
2. Angabe diverser Importparameter\ Befehle.
3. Angabe der zu importierenden Datenfelder (Indexfelder, weitere Datenfelder).
Die einzelnen Bereiche / Kennzeichen (Feldkennzeichnungen) werden durch einen
Feldtrenner vor und nach dem Kennzeichen getrennt.
Standardmäßig ist dies das Zeichen þ (ALT+231).
Der Wert der Felder welche importiert werden soll, bzw. der Importbefehl wird ohne
Feldtrenner angegeben.
Genaue Erklärung / Aufbau der Schnittstelle (Importdatensatz):
þSKZþBEL þUEBERþN þacþb þaeþ70000 þafþ17.05.2001
Leerzeichen
3. Angabe der einzelnen Datenfelder
2. Angabe der Importparameter\ Befehle
1. Angabe des Datenbereiches (Bsp.: BEL = Belegdaten)
1.Hier muss der Datenbereich angegeben werden, in welchem der Import
durchgeführt werden soll. Dies geschieht anhand eines Satzkennzeichens.
-> Im Anhang finden Sie eine Übersicht über die Aktuell gängigen Satzkennzeichen.
2.Es gibt diverse Importparameter\ Befehle die beim Import angegeben werden
sollten
und angegeben werden können.
Auflistung der Parameter:
þUEBERþ -> Dieser Parameter steuert, ob der Datensatz bereits Importiert wurde.
Dadurch wird ein mehrfaches importieren, wenn bspw. eine Datei
mehrmals
importiert wird, von Datensätzen verhindert.
Mögliche Werte von UEBER:
þUEBERþN -> Der Datensatz ist noch nicht übernommen (N)
þUEBERþJ -> Der Datensatz ist übernommen (J)
þVARTþ -> Über den Parameter VART kann gesteuert werden, wie der Datensatz
importiert werden soll.
þVARTþ0 -> 0 = Neuanlage/ Änderung
þVARTþ1 -> 1 = Nur Ändern
þVARTþ2 -> 2 = Nur Hinzufügen
þVARTþ3 -> 3 = Löschen
(weitere siehe Anhang 3)
3.Angabe der zu Importierenden Felder.
Hier sollten mindestens alle Indexfelder (Adressnummer, Artikelnummer, ...)
angegeben
werden, und alle weiteren benötigten Felder. Die Felder werden anhand eines
Feldkennzeichens (aa, ab, ac, ...) angegeben. Jedes einzelne Feld wird mit dem
Feldtrenner (þ) getrennt. (þaaþ10001 þabþxy...)
Zwischen den Feldkennzeichen und den Daten sollte immer ein Leerzeichen sein,
damit beim Import keine Fehler auftreten!!
INFO:
Eine Auflistung über alle Feldkennzeichen finden Sie in der Datei
Satzbeschreibung.xls auf dem FTP- Server unter BWDOKU\BWSATZ.
Beispiel für den Import von Kundendaten mit der Standardschnittselle:
þSKZþKDEþUEBERþNþaaþ11001þabþschmidtþacþSchmidtþadþHansþcaþHerr
þaeþBlumenst. 5þhaþ76846þafþHauenstein
Anhand dieses Datenimportsatzes wird ein Kunde Importiert mit der Kundennummer
11001, Name Hans Schmidt und Adressanschrift.
Genaue Erklärung:
þSKZþKDE
þUEBERþN
þaaþ11001
werden.
þabþschmidt
þacþSchmidt
þadþHans
þcaþHerr
þaeþBlumenst. 5
þhaþ76846
þafþHauenstein
-> Datenbereich Kunden
-> Datensatz noch nicht übernommen
-> In das Feld Adressnummer soll der Wert 11001 importiert
-> In Kurzname wird schmidt importiert.
-> In Name wird Schmidt importiert.
-> In Name2 wird Hans importiert.
-> In Anrede wird Herr importiert.
-> Als Straße wird Blumenstr. 5 importiert.
-> Als Postleitzahl wird 76846 importiert.
-> Als Ort wird Hauenstein importiert.
Import von Langtexten mit der Standardschnittselle:
Auch beim Import der Langtexte per Standardschnittselle, muss pro Langtextzeile
ein Datensatz mit Angabe des Indexes (wohin der Langtext importiert werden soll,
wie z.B. Artikellangtext -> Artikelnummer) und des Datenbereiches. Der
Datenbereich wird mit Hilfe eines Satzkennzeichens angegeben (Artikellangtext ->
ALT)
Prinzipiell ist jeder Import von Langtexten gleich aufgebaut. Als Indexfeld muss das
Feldkennzeichen aa (Artikelnummer) und für die Langtextzeile i.d.R. ab oder ac
verwendet werden.
Hier sollte jede Zeile des Langtextes auch nicht mehr wie 100 Zeichen haben, damit
dieser vollständig Importiert wird.
Beispiel:
þSKZþALT þUEBERþN þaaþ1001 þacþLangtext Zeile 1 Artikel 1001
þSKZþALT þUEBERþN þaaþ1001 þacþLangtext Zeile 2 Artikel 1001
...
Wo wird die Standardschnittstelle aufgerufen/aktiviert?
Die Standardschnittstelle wird unter dem Menüpunkt Tools -> Datenimport ->
Standardschnittstelle Wawi aufgerufen.
Maske der Standardschnittstelle:
Auf der Maske der Standardschnittselle gibt es die Möglichkeit diverse Kennzeichen
zu aktivieren, die beim Import u.a. diverse Formeln / Berechnungen ausführen.
Erklärung der Felder / Kennzeichen:
Dateiname, Konvertierung, Übernahmeart:
Über diese Felder wird die zu importierende Datei, Übernahme und
Konvertierungsart,
wie auch bei den Datenimportdefinitionen, angegeben.
Satzbeschreibungsabgleich:
Beim Import wird die Quelldatei nochmals auf die zuvor definierte Satzbeschreibung
und die Zielfelder geprüft und ggf. abgeglichen.
Standardberechnung ausführen:
Beim Import von Belegdaten kann mit diesem Kennzeichen die
Standardberechnungsformel angestoßen werden.
Stammdatenkalkulation ausführen:
Wird dieses Kennzeichen aktiviert, wird beim Import die Stammdatenkalkulation,
des Datenbereiches in welchen importiert wird, ausgeführt.
Positionsnummer überarbeiten:
Wird ein Import von Positionsdaten ausgeführt, kann mit diesem Kennzeichen die
Positionsnummer überarbeitet werden.
Alle Zielfelder alphanumerisch:
Wenn dieses Kennzeichen aktiv ist, werden alle Zielfelder als Alphanumerisch (String)
behandelt.
Änderungsvermerk setzen:
Ist dieses Kennzeichen aktiv, wird bereits beim Import der importierte Datensatz als
geändert markiert.
Positionsdaten vervollständigen:
Bei einem Import von Positionsdaten, werden alle benötigten Daten innerhalb einer
Position vervollständigt, wenn diese nicht im Datenimportsatz angegeben sind.
So können relativ einfach Bewegungen importiert werden.
Belegdaten beim Einlesen ergänzen:
Durch aktivierung dieses Kennzeichens, werden beim Import von Belegen die
fehlenden Felder/Angaben ergänzt.
Bei “
E“Titelsummen überarbeiten:
Wenn innerhalb von Positionen T –Titelzeilen (Steuerspalte in den Positionsdaten)
importiert werden, dann wird beim Ende -> E –Zeilen, die Titelzeile mit den
dazwischen befindlichen Positionen überarbeitet.
Protokollierung durchführen:
Dieses Kennzeichen sollte aktiv sein, damit die Protokollierung des Importes
durchgeführt wird.
Beleggesamtwerte auf Null setzen:
Werden Belege importiert, und dieses Kennzeichen ist aktiv, werden beim Import
die Gesamtwerte auf Null gesetzt.
Belegsummenbildung durchführen:
Wird dieses Kennzeichen aktiviert, wird beim Import von Belegen die
Belegsummenbildung durchgeführt.
INFO:
Bei z.B. einem Belegdaten / Positionsdatenimport sollten min. die Kennzeichen
Positionsdaten vervollständigen, Belegdaten beim Einlesen Ergänzen aktiviert sein.
Damit die Stammdatenkalkulation / Standardberechnung ausgeführt wird (und somit
die dort hinterlegten Kalkulationen ausgeführt werden) sollten die entsprechenden
Kennzeichen aktiviert sein.