Funktion BscSelectlineImporter¶

• importiert neue Datensätze aus Excel- oder CSV-Dateien (Quelldatei) in Selectline.
• in der Quelldatei entspricht eine Zeile immer einem Datensatz.
• Eine Spalte aus der Quelldatei kann immer einem oder mehreren Feldern für den Import nach Selectline zugeordnet werden.
• Zielspalten können wahlweise mit konstanten Werten vorbelegt werden. (z.B. für Artikelgruppe, Steuerschlüsse, ...).
• Zielspalten können mit Grundrechenarten berechnet werden. Beispiel: {EkPreis} * 1,19.
• Pro Quelldatei werden alle Informationen in einem Profil erstellt, in welchem alle Zuordnungen gespeichert werden.
• Die Spalten der Quelldatei müssen also immer mit dem Profil übereinstimmen, damit ein Import erfolgreich durchgeführt werden kann.
• Langtexte können verarbeitet werden. Dies ist jedoch nur in Exceltabellen sinnvoll.

Einschränkungen¶

Preisimport

• es werden keine Mengenstaffeln importiert
• es wird keine Datumsdifferenzierung vorgenommen

Artikelimport

• Update eines Artikels setzt voraus, dass das verwendete Schlüsselfeld immer korrekt und unverändert geliefert wird.
• Schlüsselfelder sind Spalten wie EAN-Nummer, Artikelnummer, ...

Profilauswahl¶

Im ersten Fenster nach dem Programmstart erscheint ein Fenster, in welchem man ein bestehendes Profil auswählen kann oder mit "Neues Profil" eine neues Profil anlegen kann.

Button "Profil Löschen"¶

Mit dem Button "Profil löschen" kann das aktuell ausgewählte Profil gelöscht werden. Ist als Profil "Neues Profil" oder kein Profil ausgewählt, kann der Button nicht angeklickt werden.

Button "Weiter"¶

Mit dem Button "Weiter" öffnet sich ein weiteres Fenster, indem die Eigenschaften des ausgewählten Profils festgelegt werden können.
Ist kein Profil ausgewählt, kann der Button nicht angeklickt werden.

Import-Einstellungen¶

Jedes gespeicherte Profil enthält Eigenschaften, die angegeben werden müssen.
Diese können bei jedem Import angepasst werden.

Profilbeschreibung¶

Profilname¶

Der Name des Profils. Ungültige Namen sind "Neues Profi", "" und alle bereits vorhandenen Profilnamen

Kurzbeschreibung¶

Eine kurze Beschreibung des Profils, einzeilig

Langbeschreibung¶

Eine detaillierte Beschreibung des Profils, mehrzeilig

Lieferantennummer¶

Die Nummer des Lieferanten, dessen Daten importiert werden. Kann auch leer gelassen werden.
Diese Nummer wird automatisch als Zuordnung in das Feld Lieferant in den Tabellen Art und Artlief geschrieben, sofern keine andere Zuordnung vorhanden ist.

Nur bestehende Datenätze updaten¶

Gibt an, ob nur bereits bestehende Datensätze aktualisiert werden oder auch neue Datensätze angelegt werden sollen.

ImportDatei-Eigenschaften¶

Format¶

Gibt an welches Format die Quelldatei hat.
Auswahlmöglichkeiten sind Excel und CSV.

Trennzeichen in CSV-Datei¶

Kann nur angegeben werden, wenn das Dateiformat CSC ist.
Gibt an durch welches Zeichen die Spalten in der CSV-Datei getrennt sind. Auswahlmöglichkeiten sind ; . und |

Anführungszeichen in CSV-Datei¶

Kann nur angegeben werden, wenn das Dateiformat CSC ist.
Gibt an, ob die Werte in der CSV-Datei in Anführungszeichen stehen oder nicht

Importdatei¶

Pfad + Dateiname der Excel- oder CSV-Datei, die importiert werden soll.
Mögliche Dateiformate für Exceldateien sind .xlsx, .xls und .ods
Mögliche Dateiformate für CSV-Dateien sind .csv

Spaltenzuordnung¶

Quelldaten¶

In der oberen Tabelle wird die Quelldatei dargestellt. Zeilen, bei denen die Key-Spalte leer ist werden nicht angezeigt, da sie später beim Import übersprungen werden.
Die Anzahl der Datensätze, die mit dem aktuell gesetzten Key importiert würden, wird unten links angezeigt.

Spaltenzuordnung¶

Für die Zuordnung der Spalten aus der Quelldatei in das passende Selectline-Feld werden zentral verfügbaren Selectline-Felder in Tabellen angezeigt.
Insgesamt gibt es 4 Tabellen: Art, Artlief, Texte und Preise.

Die Tabellen sind folgendermaßen aufgebaut:

• In der Spalte 'Feld' werden alle Felder der jeweiligen Tabelle aufgelistet. In der Tabelle Preise heißt diese Spalte Preisgruppe.
• In der Spalte 'Datentyp' steht der Datentyp des dieses Feldes. (Nur in Art und Artlief)
• In der Spalte 'Feldlänge' wird die maximale Zeichenlänge dieses Selectline-Feldes angezeigt. (Nur in Art und Artlief)
• In der Spalte 'Zuordnung' soll der Wert geschrieben werden, der in dieses Selectline-Feld geschrieben werden soll.
• In der Spalte 'KeinUpdate' wird angegeben, ob bei bereits bestehenden Datensätzen dieses Feld nicht geupdatet werden soll. Ist die Checkbox bei einem Feld gesetzt, so werden die Zuordnungen für dieses
  Feld nur bei Datensätzen verwendet, die neu angelegt werden müssen.
• In der Spalte 'Key' wird angegeben, ob das Feld beim Import als Key dienen soll. (Nur in Art). Es muss immer genau ein Key ausgewählt sein, bei welchem dann die Zuordnung nicht leer bleiben darf.
  Mögliche Keys sind Artikelnummer, EANNummer und Matchcode
• In der Spalte 'Beispielwert' wird durch den einen Datensatz aus der Excel-/Csv-Tabelle veranschaulicht, was bei einem Import in die Datenbank geschrieben werden würde. Wenn in der obigen Tabelle die
  Zeile gewechselt wird, so ändern sich auch die Beispielwerte

Alle Spaltennamen der übergebenen Quelldatei werden in einer Auflistung links angezeigt.
Neben den Spaltennamen befindet sich ein Button. Wird dieser gedrückt, so wird der gewählte Spaltenname in das aktuell ausgewählte Feld in die Spalte Zuordnung geschrieben.

Zuordnungsspalte¶

In der Spalte Zuordnung wird angegeben, was in das entsprechende Selectline-Feld geschrieben werden soll.

• Ein Wert in geschweiften Klammern verweist auf die gleichnamige Spalte aus der Quelldatei.
  Bsp: {ean} verweist auf die Spalte ean aus der Quelldatei.

• Ein Wert in Anführungszeichen dient als Konstante.
  Bsp: "Euro" wird als Euro in Selectline geschrieben

• konstante Zahlen benötigen keine Anführungszeichen. Als Dezimaltrennzeichen kann ein Komma oder ein Punkt angegeben werden.
  Bsp: 7,99 wird als 7,99 in Selectline geschrieben.

Des Weiteren sind folgende Operatoren möglich:

• "&" verbindet zwei Werte miteinander
  Bsp: {Vorname} & " " & {Nachname} wäre bsw. Max Mustermann {Gewicht} & "g." wäre bsw. 1580g. {Artikel} & "999" wäre bsw. 100417999 {Artikel} & " 999" wäre bsw. 100417 999

"&" kann pro Zuordnung beliebig oft verwendet werden

• "+" addiert zwei Werte miteinander. Ist nur mit zwei gültigen Zahlenwerten möglich.
  Bsp: {Gewicht} + 20 wäre bsw. 1600

• "-" subtrahiert zwei Werte miteinander. Ist nur mit zwei gültigen Zahlenwerte möglich.
  Bsp: {Gewicht} - 80 wäre bsw. 1500

• "*" multipliziert zwei Werte miteinander. Ist nur mit zwei gültigen Zahlenwerten möglich.
  Bsp: {Gewicht} * 10 wäre bsw. 15800

• "/" dividiert zwei Werte miteinander. Ist nur mit zwei gültigen Zahlenwerte möglich.
  Bsp: {Gewicht} / 1000 wäre bsw. 1,58

Pro Zuordnung kann immer nur ein Rechenoperator (+ - * /) verwendet werden. {Gewicht} + 100 + 45 wäre also okay, {Gewicht} / 1000 + 100 aber nicht.

Wenn ein mathematischer Operator (+ - * /) in einer Zuordnung verwendet wurde kann kein "&" darin mehr verwendet werden.

Enthält eine Zuordnung eine Variable die in der Quelldatei nicht als Spaltenheader existiert, so wird diese Zuordnung beim Öffnen des Fenster entfernt.
Endgültig gelöscht wird die Zuordnung dann beim Speichern oder bei einem Import.

Menüleiste¶

Schließen¶

Mit dem Button "Schließen" kehren Sie zurück zu den Profileinstellungen und verwerfen jegliche Änderungen an den Zuordnungen.

Speichern¶

Mit dem Button "Speichern" können Sie die ihr Profil speichern, vorausgesetzt die Zuordnungen enthalten keine profilrelevanten Fehler.

Profilrelevante Fehler sind:

1. Es wurde kein Key ausgewählt.

2. Dem Key wurde nichts zugeordnet.

3. Die Lieferantennummer in Artlief ist leer, obwohl andere Zuordnungen in Artlief existieren.

4. Die Lieferantennummer in Art existiert nicht, sofern eine vorhanden ist

5. Die Lieferantennummer in Artliwef existiert nicht, sofern eine vorhanden ist

6. Es wurden pro Zuordnung mehrere unterschiedliche mathematische Operatoren verwendet.

7. Der EAN-Nummer wurde ein konstanter Wert zugeordnet, der nicht aus 13 Zahlen besteht.

8. Es existieren konstante Zuordnungen zu numerischen Feldern, die nicht als Zahl erkannt wurden.

9. Es existieren konstante Zuordnungen zu Datums-Feldern, die nicht als Datum erkannt wurden.

10. Es existieren konstante Zuordnungen zu Boolean-Feldern, die nicht als gültiger Boolean-Wert erkannt wurden.

Prüfen¶

Bevor ein Import stattfinden kann muss zuerst geprüft werden, ob keine fehlerhaften Daten vorliegen.
Dazu gibt es den Button prüfen.

Folgende Voraussetzungen werden geprüft und sperren den Import, falls sie zutreffen.

1. Es wird geprüft, ob ein Key gesetzt wurde und ob diesem etwas zugeordnet wurde.

2. Es wird überprüft, ob pro Zuordnung nur einer der vier mathematischen Operatoren (+ - * /) verwendet wurde.

3. Es wird überprüft, ob die EAN-Nummer genau 13 Zeichen enthält und ob sie nur aus Zahlen besteht. Nachstehende Leerzeichen werden entfernt.

4. Es wird überprüft, ob die beiden Lieferantennummern in den Tabs Art und Artlief existieren, sofern sie eine Zuordnung enthalten.

Folgende Voraussetzungen werden geprüft, sperren den Import aber nicht:

1. Es wird geprüft in wie vielen Datensätzen der Key leer ist. Diese Datensätze werden übersprungen.

2. Es wird geprüft wie oft die maximale Feldlänge überschritten wurde. Zu lange Werte werden abgeschnitten.

3. Es wird überprüft, ob in alle numerischen Felder (z.B. Gewicht oder Rabatt) nur numerische Werte geschrieben wurden. Fehlerhafte numerische Werte werden als null in die Datenbank geschrieben.

4. Es wird überprüft, ob in alle Datumsfelder (z.B. Auslaufdatum) nur korrekte Daten geschrieben wurden. Fehlerhafte Datumswerte werden als null in die Datenbank geschrieben.

5. Es wird überprüft, ob in alle Booleanfelder(z.B. Lagerartikel) nur korrekte Boolean-Werte geschrieben wurden. Fehlerhafte Boolean-Werte werden als False in die Datenbank geschrieben.

6. Es wird überprüft, bei wie vielen Berechnungen (Zuordnungen mit + - * /) ein Fehler aufgetreten ist, weil keine gültigen Zahlenwerte vorlagen.
Bei fehlerhaften Berechnungen wird null in die Datenbank geschrieben.

Import¶

Bei erfolgreicher Prüfung kann importiert werden. Nach jeder Änderung der Zuordnungen muss erneut geprüft werden, sonst ist der Button "Import" gesperrt.
Bei einem Import wird anhand des Keys überprüft, ob der Datensatz bereits existiert.
Ist dies der Fall, so wird dieser bestehende Datensatz aktualisiert. Ansonsten wird ein neuer Datensatz angelegt.
Zahlenwerte werden immer auf zwei Nachkommastellen gerundet.

Protokoll¶

Das Live-Protokoll des aktuellen Profils wird in dem Fenster unten angezeigt und ständig aktualisiert.