Import von Stammdaten

Das Fenster dient zum Importieren von Geschäftspartnern, mandantenspezifischen Geschäftspartnerdaten und Baustellen von einer Fremd-Anwendung in die Beton.NET-Datenbank. Als Voraussetzung hierfür muss die Datei mit Importformat-Definitionen im Programmverzeichnis des Beton.NET-Servers vorhanden sein und es muss in der Definitionsdatei ein Format enthalten sein, dass zum Format Ihrer Importdaten passt.

Hinter der Combo-Box zur Formatauswahl befindet sich ein Schalter zum Bearbeiten der Formatdefinitionen. Diese Aktion erfordert besondere Kenntnisse und ist in erster Linie für die Entwickler gedacht.

Bei der Gestaltung der Definitionen muss insbesondere bedacht werden, ob und in welcher Weise die importierten Kundennummern in die Nummernbereiche von Beton.NET transformiert werden müssen. Gegebenenfalls kann das Programm die Geschäftspartner selbständig nummerieren und eine Verknüpfung über die LS-Übergabe-Nr herstellen. Der Nummernbereich für die Geschäftspartnernummer ist für diesen Fall in den Optionen einstellbar.

Das Programm liest die einzelnen Datensätze ein und verarbeitet sie unter den unten beschriebenen Bedingungen. Unzutreffende Datensätze werden überlesen. Konsistenzfehler und übernommene Daten werden im Protokoll aufgeführt.

Mit dem Schalter früher verwendete Auswahl kann eine zuvor verwendete Benutzerauswahl vorbelegt werden. Das Programm speichert benutzerweise bis zu 9 Generationen von früheren Auswahlen. Diese Auswahl umfasst die Felder Format, Dateiname und Überschreib-Kennzeichen. Angezeigt wird zusätzlich das zugehörige Datum, an dem diese Auswahl erstmals verwendet wurde. Neu gespeichert wird jeweils dann, wenn minestens eines dieser Felder gegenüber der letztverwendeten Auswahl verändert wurde und ein Import vorgenommen wurde (auch dann, wenn keine zutreffenden Daten enthalten waren). Eine früher verwendete Auswahl kann durch Doppelklick oder durch Betätigen der Eingabetaste aus der Auswahlliste übernommen werden.

Das Häkchen Vorhandene Kunden überschreiben erlaubt es, auch in der Datenbank vorhandene Geschäftspartner/Kunden zu ändern. Wenn Sie das Häkchen nicht setzen, können nur neue Datensätze in der Datenbank aufgenommen werden.


Hinweise zur Gestaltung der Import.def-Datei

Es wird eine einheitliche Syntax zum Importieren von Lieferscheinen, Stammdaten und Zahlungseingängen verwendet. Außer den Sachverhalten, die im Fenster Bearbeiten der Formatdefinitionen beschrieben oder dort ersichtlich sind, gilt noch folgendes:

Es können alle Datenfelder der Tabellen GESCHAEFTSPARTNER, MndGESCHAEFTSPARTNER und BAUSTELLEN benutzt werden. Es kommen in diesen Tabellen jedoch gleichnamige Felder vor (Stand 2018: BEMERKUNG, DEBITORENNR, HAENDLERNR, KREDITVERSICHERUNGSBETRAG, KREDITVERSICHERUNGSDATUM, KREDITVERSICHERUNGSNR, LETZTELIEFERUNG, LSUEBERGABENR, MANDANT, MWST, NAME1, NAME2, NAME3, ORT, PLZ, PREISLISTE, STRASSE, USTID, ZAHLUNGSVERPUMPE, ZAHLUNGSVERPUMPEVERW, ZAHLUNGSVERPUMPWERK, ZUSTAENDIG) . Daher müssen für alle Datenbankfelder zwingend die Präfixe G_ / M_ / B_ verwendet werden. Andere Variable, die nicht in Datenbanktabellen vorkommen, brauchen kein Präfix.

Ein eingelesener Datensatz kann zum Erzeugen/Ändern eines Datensatzes in einer oder in mehreren der Ziel-Datenbanktabellen führen. Das können Sie durch die speziellen Variablen GPART_ZUTREFF, MNDGP_ZUTREFF und BAUST_ZUTREFF steuern, indem diese Variablen mit den Werten TRUE oder FALSE belegt werden. Je nach dem zugewiesenen Wert wird ein Datensatz verarbeitet oder nicht verarbeitet. Wenn diese Variablen nicht vorkommen, werden die Datenbank-Datensätze in der Regel erzeugt, wenn nicht andere Gründe entgegenstehen, zum Beispiel ein fehlender Schlüsselwert oder wenn ein Datensatz in der Datenbank schon vorhanden ist, der nur neu erzeugt werden darf.

Datenbankfelder, die einen Bezug auf andere Tabellen darstellen, werden nicht mit importiert sondern ignoriert, damit keine Datenintegritätsprobleme auftreten können. (Stand 2018: DEBITORBANKID, DEBITORZAHLUNGSVEREINBARUNG, FORMULAR, FRACHTGUTFORMULAR, FU_MWST, FU_PLISTE, HAENDLERNR, KREDITORBANKID, KREDITORZAHLUNGSVEREINBARUNG, LANDNR, LIEFERWERK, MWST, RECHNUNGSKOPFTEXT, RECHNUNGSFUSSTEXT, PREISLISTE, RAHMENREGION, RAHMENWERK, VERSAND_LANDNR, WAEHRUNG, ZAHLUNGSVER, ZAHLUNGSVERPUMPE, ZAHLUNGSVERPUMPWERK, ZUSTAENDIG) Einzige Ausnahme ist dabei das Feld TARIFZONE in Tabelle BAUSTELLEN. Dieses Feld wird vom Programmcode explizit geprüft und je nach Situation wird es mit importiert oder der Datensatz wird als fehlerhaft zurückgewiesen.
Bamberg