Stammdatenimport

Aus FAKTURA-X Wiki
Zur Navigation springen Zur Suche springen

(AdministrationsfunktionenSie sind auf der Seite: Stammdatenimport)

Der integrierte Stammdatenimport ermöglicht das rationelle Einlesen von vorhandenen Datenstämmen und hilft bei der sogenannten Erstdatenübernahme. Der Stammdatenimport kann mit dem Menüpunkt OptionenStart.png AdministrationDurchfuehren.png Stammdatenimport gestartet werden.

Einen Artikelstamm generieren

Im Register Artikelstamm generieren ist das effiziente Erstellen eines vollständigen Artikelstamms mit zugehörigen Hilfstabellen möglich.

Der Dialog Artikelstamm generieren nach einem erfolgreichen Stammdatenimport

Vorlagendatei

Die Vorlagendatei für das Erstellen des Sortiments kann als CSV-Datei durch die Anwendung generiert werden oder als Excel-Tabelle mit weitergehenden Funktionen hier heruntergeladen werden.

Um eine Vorlagendatei zu erstellen, gehen Sie wie folgt vor:

  1. Stellen Sie im Auswahlfeld Preisgruppen angeben die Anzahl der gewünschten Preisgruppen ein.
  2. Stellen Sie im Auswahlfeld Maximum Lieferanten angeben die Höchstanzahl von Lieferanten für einen Artikel ein.
  3. Erzeugen Sie mit Sichern.png die Vorlagendatei.

Die Vorlage wird im Vorlagenordner der Installation gespeichert und anschließend automatisch zur Bearbeitung geöffnet[1].

Eigenschaften und Nutzung der Vorlagendatei werden auf der Seite Importvorlage erläutert. Nach Fertigstellen einer Vorlagendatei kann diese für den Import genutzt werden.

Import

Beim Import werden Nummernkreise für Artikelnummern werden wie folgt unterteilt:

  • Warengruppe: Sortierung nach Produktart, beispielsweise „1“ für “Biere“
  • Hersteller: Sortierung nach Hersteller, beispielsweise „15“ für „Becks“
  • Artikel: Sortierung nach Artikel, beispielsweise „01“ für „Pils“

Die Packungsgröße in Form der Gebindeendziffern wird durch die Anzahl der Flaschen in einem Kasten oder die Literzahl von Flaschen und Fässern generiert. Informationen zum Endziffernsystem finden sich unter Stammdaten strukturieren. Die Importdatei wird eingelesen und die Importdaten angezeigt. Daten können direkt in der Tabelle bearbeitet werden. Ein bestehender Artikelstamm kann optional mit Artikelstamm leeren Loeschen.png gelöscht werden[2]. Dies kann genutzt werden, um Demodaten aus der Installation zu entfernen. Die eingelesenen Daten können nun mit Daten aufbereiten Start.png im Artikelstamm gespeichert werden. Die Anwendung zeigt nach dem Übernehmen eine Zusammenfassung an.

Einen Stamm importieren

Der Dialog Stamm einlesen nach einem erfolgreichen Stammdatenimport

Im Register „Stamm einlesen“ ist das Importieren von Stammdaten möglich.

Vorlagendatei

Die Vorlagendatei für das Erstellen des Stamm kann als CSV-Datei durch die Anwendung generiert werden.

Um eine Vorlagendatei zu erstellen, gehen Sie wie folgt vor:

  1. Stellen Sie im Auswahlfeld '„Stammdatentyp“ die gewünschte Art des Datentyps ein.
  2. Erzeugen Sie mit Sichern.png die Vorlagendatei.

Die Vorlage wird im Vorlagenordner der Installation gespeichert und anschließend automatisch zur Bearbeitung geöffnet[3].

Formatvorschriften

Die Formatvorschriften für die Importdaten sind in der Vorlagendatei beschrieben. Folgende Datentypen sind definiert:

Datentyp Erläuterungen
Zeichenkette Buchstaben, Zahlen, Leerzeichen, Punkt und Komma. Die maximale Zeichenanzahl wird in der Klammer angegeben. Nicht erlaubt sind Sonderzeichen (Hochkomma, Anführungszeichen, Semikolon und Zeilenwechsel)
Ganzzahl Positive oder negative Zahlen ohne Nachkommastellen. Nicht erlaubt sind Kommazahlen, Buchstaben, Sonderzeichen, Tausendertrennzeichen oder Einheitsangaben.
Fließkommazahl Positive oder negative Zahlen mit bis zu fünf Nachkommastellen. Der Dezimaltrenner ist das Komma. Nicht erlaubt sind Buchstaben, Sonderzeichen, Tausendertrennzeichen oder Einheitsangaben.
Logische Werte Diese Felder können nur die logischen Ausdrücke "Ja" oder "Nein" aufnehmen. Es sind keinerlei andere Eingaben erlaubt.
Wertebereiche Diese Felder können nur speziell definierte, erlaubte Eingaben, wie ("Voll", Halb", "0") für Mehrwertsteuersätze aufnehmen. Es sind keinerlei andere Eingaben erlaubt.

Bearbeitung und Sichern

Bei der Konvertierung von CSV- Dateien in Excel- Tabellen werden Barcodes als längere Zifferngruppen angesehen und in der wissenschaftlichen Notation als Exponentialzahl, beispielsweise "1,2354E+20" dargestellt. Beim Speichern gehen dabei jedoch Teile der Information verloren. Das Format der betroffenen Spalten muss daher vor JEDEM Speichern als Zahl mit 0 Dezimalstellen definiert werden. Es ist daher ratsam, nur im nativen Excel-Tabellenformat zu arbeiten.

Fehlerquellen

Der Import schlägt fehl, wenn:

  • die Importvorlage nicht den Formatvorschriften entspricht
  • ein Importdatensatz falsche Formate enthält
  • ein Importdatensatz nicht die korrekte Anzahl der Felder enthält
  • in einem Feld ein Semikolon enthalten ist
  • in einem Feld ein ungültiger Werte enthalten ist

Formatvorschriften

Folgende Regeln gelten für den Import:

  • Vorhandene Datensätze werden beim Import übersprungen
  • Der Zeichensatz muss dem ANSI- Standard entsprechen
  • Als Trennzeichen für Felder muss das Semikolon ; verwendet werden
  • Unstrukturierte Binärwerte (Grafiken und Memofelder) können nicht importiert werden
  • Zeilenumbrüche können zu Fehlern führen
  • Eingabe außerhalb des Wertebereichs können falsch interpretiert werden.
  • Zahlen dürfen keine Tausender-Trennzeichen enthalten, Dezimaltrenner muss das Komma sein.

Tabelle konvertieren

Wenn alle Daten in die Tabelle eingegeben wurden, muss die Importdatei im CSV-Format gespeichert werden. Als Trennzeichen für Felder muss das Semikolon ; verwendet werden, als Trennzeichen darf kein anderes Zeichen [4] angegeben werden.

Die eingelesenen Daten können nun gespeichert werden. Die Anwendung zeigt nach dem Sichern in der Liste unter Daten aufbereiten Start.png eine Zusammenfassung an.

Probleme beim Import

Grundsätzlich gelten für Importdateien folgende Vorschriften:

  • Vorhandene Datensätze werden beim Import übersprungen
  • Entspricht die Importvorlage nicht den Formatvorschriften, wird der Import abgebrochen
  • Ist ein Importdatensatz fehlerhaft, wird der Import abgebrochen
  • Der verwendete Zeichensatz der Importdatei muss dem ANSI- Standard entsprechen, ASCII- Formate müssen zuvor konvertiert werden.
  • Feldinhalte dürfen nicht durch Anführungszeichen oder andere Delimiter[5] eingeschlossen werden und dürfen auch keine solchen enthalten und müssen durch ein Semikolon, nicht aber durch ein Komma, getrennt werden
  • Bei doppelt vorhandenen Primärindizes, also identischen Artikelnummern oder Kundennummern in der Importdatei, wird der Import abgebrochen
  • Wenn Primärindizes Sonderzeichen enthalten, wird der Import abgebrochen
  • Wenn alphanumerische Felder mit mehrdimensionalen Zeichenketten gefüllt werden sollen, welche Zeilenvorschübe oder Steuerzeichen enthalten, wird der Import abgebrochen
  • Wenn ein Feld mit Sonderzeichen, insbesondere Prozentzeichen oder Anführungszeichen, beginnt, wird der Import abgebrochen
  • Wenn sich ein Feldwert nicht innerhalb des Wertebereichs des Zielfeldes befindet, wird der Import abgebrochen. Integerfelder dürfen nicht mit Fließkommawerten gefüllt werden, Nachkommastellen von Fließkommawerten müssen durch ein Komma getrennt werden. Boolesche Felder dürfen nur mit den Werten „WAHR“ oder „FALSCH“ gefüllt werden. Feldwerte vom Typ Integer oder Float dürfen nur mit Zahlwerten gefüllt werden
  • Unstrukturierte Binärwerte (Grafiken und Memofelder) können nicht importiert werden
  • Bei einigen Feldern ist eine gültige Eingabe nur innerhalb eines angegebenen Wertebereichs erlaubt. Der Import wird bei Werten außerhalb der Definition nicht abgebrochen, jedoch können die Daten falsch interpretiert oder nicht verarbeitet werden. Dies betrifft insbesondere Datenfelder, die nur mit dem Inhalt „Ja“ oder „Nein“ gefüllt werden dürfen
  • Wenn die Anzahl der Felder pro Datensatz nicht mit den Feldern der Importdatei übereinstimmen, wird der Import abgebrochen
  • Der Importvorgang wird mit einer Fehlermeldung abgeschlossen, wenn die Importdatei nach dem letzten Importdatensatz einen Zeilenumbruch enthält. Ist die Zahl der importierten Datensätze mit den Datensätzen der Importdatei identisch, kann die Fehlermeldung ignoriert werden

Bei einem Abbruch werden die Anzahl der importierten Datensätze und die Abbruchstelle des Imports ausgegeben. Diese Angaben können zum Auffinden der Fehlerstelle in der Datei verwendet werden. Bei anhaltenden Problemen mit Importdateien empfiehlt es sich, Kontakt mit dem Hersteller aufzunehmen. Dieser kann in der Regel Fehlerquellen lokalisieren und korrigieren. Insbesondere wenn aus älteren Systemen ohne entsprechende Dateiausgabe Daten extrahiert werden sollen, ist die Kontaktaufnahme zum Hersteller unumgänglich. Dieser kann dann eine Einschätzung abgeben, ob und wenn, mit welchem Aufwand eine Datenaufbereitung möglich ist.


(AdministrationsfunktionenSie sind auf der Seite: Stammdatenimport)

Fußnoten:

  1. Dazu muss eine geeignete externe Anwendung, beispielsweise Microsoft Excel installiert sein
  2. Gelöschte Artikelstämme können nicht wiederhergestellt werden!
  3. Dazu muss eine geeignete externe Anwendung, beispielsweise Microsoft Excel installiert sein
  4. Beispielsweise Apostroph oder Hochkomma
  5. Beispielsweise Apostroph oder Hochkomma