Stammdatenimport: Unterschied zwischen den Versionen

Aus FAKTURA-X Wiki
Zur Navigation springen Zur Suche springen
Zeile 38: Zeile 38:


=Einen Stamm importieren=
=Einen Stamm importieren=
[[File:stammdaten_import_einlesen.png|gerahmt|ohne|Der Dialog '''Stamm einlesen''' nach einem erfolgreichen Stammdatenimport|link=]]


[[File:stammdaten_import_einlesen.png|gerahmt|ohne|Der Dialog '''Stamm einlesen''' nach einem erfolgreichen Stammdatenimport|link=]]
Im Register „Stamm einlesen“ ist das Importieren von Stammdaten möglich.
 
==Vorlagendatei==
Die Vorlagendatei für das Erstellen des Stamm kann als [[wikipedia:de:CSV_%28Dateiformat%29|CSV-Datei]] durch die Anwendung generiert werden.
 
Um eine Vorlagendatei zu erstellen, gehen Sie wie folgt vor:
 
# Stellen Sie im Auswahlfeld '„Stammdatentyp“ die gewünschte Art des Datentyps ein.
# Erzeugen Sie mit [[File:disk.png|link=]] die Vorlagendatei.


Im Register „Stamm einlesen“ ist das Importieren von Waren und Kontakten möglich. Das Vorgehen ist dabei dasselbe wie beim Import von Artikeldaten. Um Stammdaten zu importieren, muss im Auswahlfeld „Stammdatentyp“ ausgewählt werden, welche Art von Stammdaten importieren werden soll. Mit [[File:Sichern.png|link=]] wird eine Vorlagendatei (CSV) im Vorlagenordner der Installation erstellt und anschließend automatisch zur Bearbeitung in einem Tabellenkalkulationsprogramm geöffnet. Die Feldvorgaben sind in der Vorlagendatei enthalten.
Die Vorlage wird im Vorlagenordner der Installation gespeichert und anschließend automatisch zur Bearbeitung geöffnet<ref>Dazu muss eine geeignete externe Anwendung, beispielsweise Microsoft Excel installiert sein</ref>.  


Als Datentypen sind möglich:
===Formatvorschriften===
Die Formatvorschriften für die Importdaten sind in der Vorlagendatei beschrieben. Folgende Datentypen sind definiert:
<!--    *    Tabelle ANFANG    *    -->
<!--    *    Tabelle ANFANG    *    -->
{| class="wikitable" style="text-align:left"
{| class="wikitable" style="text-align:left"
Zeile 50: Zeile 60:
|-
|-
|Zeichenkette
|Zeichenkette
|Buchstaben, Zahlen, Leerzeichen, Punkt und Komma. Keine Sonderzeichen (Hochkomma, Anführungszeichen, Semikolon und Zeilenwechsel)Die maximale Zeichenanzahl wird in der Klammer angegeben
|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
|Ganzzahl
|Positive oder negative Zahlen ohne Nachkommastellen
|Positive oder negative Zahlen ohne Nachkommastellen. Nicht erlaubt sind Kommazahlen, Buchstaben, Sonderzeichen, Tausendertrennzeichen oder Einheitsangaben.
|-
|-
|Fließkommazahl
|Fließkommazahl
|Positive oder negative Zahlen mit beliebig vielen Nachkommastellen
|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.
|}
|}
<!--    *    Tabelle ENDE    *    -->
<!--    *    Tabelle ENDE    *    -->


Bei einigen Feldern ist eine gültige Eingabe nur innerhalb eines angegebenen Wertebereichs erlaubt.
===Bearbeitung und Sichern===
Sobald Sie die notwendigen Daten in die Tabelle eingegeben haben, überschreiben Sie die Vorlage, indem Sie die Datei im CSV-Format im selben Ordner und unter demselben Namen speichern.
{{Achtung|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.}}
Die Exportoptionen müssen dabei in ihrem Tabellenkalkulationsprogramm wie folgte gewählt werden:
 
==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:


*Als Feldtrennzeichen muss das Semikolon (";") verwendet werden
* Vorhandene Datensätze werden beim Import übersprungen
*Als Texttrennzeichen darf kein Zeichen eingegeben sein.
* 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.


Nach Fertigstellen einer Vorlagendatei kann diese für den Import zugewiesen werden. Die Importdatei kann nun eingelesen werden. Die Importdaten werden angezeigt und können in der Tabelle bearbeitet werden. Optional kann ein bestehender Datenstamm mit {{Menü|Stamm leeren [[File:Loeschen.png|link=]]}} gelöscht werden<ref>Gelöschte Stammdaten können nicht wiederhergestellt werden!</ref>.
=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 <ref>Beispielsweise Apostroph oder Hochkomma</ref> angegeben werden.


Die eingelesenen Daten können nun gespeichert werden. Die Anwendung zeigt nach dem Sichern in der Liste unter {{Menü|Daten aufbereiten [[File:Start.png|link=]]}} eine Zusammenfassung an.
Die eingelesenen Daten können nun gespeichert werden. Die Anwendung zeigt nach dem Sichern in der Liste unter {{Menü|Daten aufbereiten [[File:Start.png|link=]]}} eine Zusammenfassung an.

Version vom 6. Januar 2019, 21:37 Uhr

(Administrationsfunktionen → Sie 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 Optionen → Start.png Administration → Durchfuehren.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.

(Administrationsfunktionen → Sie 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
Abgerufen von „https://wiki.fakturax.de/index.php?title=Stammdatenimport&oldid=8273“