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 -> Datenbereich Kunden þueberþn -> Datensatz noch nicht übernommen þaaþ11001 -> In das Feld Adressnummer soll der Wert 11001 importiert werden. þabþschmidt -> In Kurzname wird schmidt importiert. þacþschmidt -> In Name wird Schmidt importiert. þadþhans -> In Name2 wird Hans importiert. þcaþherr -> In Anrede wird Herr importiert. þaeþblumenst. 5 -> Als Straße wird Blumenstr. 5 importiert. þhaþ76846 -> Als Postleitzahl wird 76846 importiert. þafþhauenstein -> 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.