Zuordnungen

Eine Zuordnung sagt, was ein aus einer Spalte gelesener Wert ist: eine Produktnummer, eine Menge, ein Einkaufspreis oder ein Ablaufdatum.

Kernfelder

Bezeichnung — ein Name, der die Art der Daten beschreibt.
Art — die Art der Daten (unten).
Entität und Feld — wo der Wert beim Erkennen des Produkts zu suchen ist.
Spalten — die Spalten, in denen der Wert gesucht wird.
Priorität — die Suchreihenfolge; eine niedrigere Zahl heißt früher. Sind mehrere Treffer möglich, wird der erste gefundene verwendet.
Regulärer Ausdruck und Erfassungsgruppe — das Muster, das den Wert prüft, und der zu entnehmende Teil.
Erforderlich — ob der Wert nötig ist, damit eine Position als erkannt gilt.

Arten von Zuordnungen

Kennung — eine eindeutige Produktkennung. Sie braucht Entität und Feld:

Feld	Bedeutung
`Product.productNumber`	die interne Produktnummer
`Product.manufacturerNumber`	die Nummer des Herstellers
`Product.ean`	der EAN-Code
`Product.translations.name`	der Produktname

Über Nummer, Herstellernummer oder EAN gefundene Produkte bekommen den Status Erkannt. Über den Namen gefundene Produkte bekommen Mehrdeutig, denn ein Name ist nicht eindeutig.

Bestand — eine Pflichtzuordnung, die die Menge von der Rechnung liest. Sie braucht einen Änderungstyp:

Hinzufügen — eine Lieferung erhöht den Bestand,
Subtrahieren — eine Rücksendung oder Korrektur verringert ihn,
Überschreiben — setzt den Bestand auf den gelesenen Wert.

Lieferantenkennung — die eigene Kennung des Lieferanten. Sie erlaubt es, dasselbe Produkt bei mehreren Lieferanten einzukaufen, von denen jeder eine andere Nummer verwendet.

Wert — ein Wert, der erkannt werden muss, damit eine Zeile als vollständig gilt. Er erhöht die Genauigkeit beim Erkennen von Positionszeilen.

Ordnungsnummer — die Positionsnummerierung. Hat die Tabelle sie, lohnt es sich, sie zuzuordnen: Sie verbessert das Erkennen der Zeilengrenzen.

Produktname, Einkaufspreis, Chargennummer, Chargenmenge — zusätzliche Positionsdaten.

Verfallsdatum — das Ablaufdatum. Es landet auf der beim Wareneingang erzeugten Charge, die Entnahme nach Ablaufdatum funktioniert also erst, wenn es zugeordnet ist. Erkannte Formate sind Y-m-d, d.m.Y, d-m-Y, d/m/Y und ihre Varianten mit zweistelliger Jahreszahl.

Marker für das Seitenlayout

Drei Arten wirken auf die ganze Zeile statt auf eine einzelne Spalte. Sie verwenden nur Bezeichnung, Regulärer Ausdruck und Priorität:

Seiten-Marker — kennzeichnet eine Zeile mit dem Seitenkopf, sodass das Modul weiß, dass eine neue Seite begonnen hat. Er behebt den häufigsten Lesefehler bei mehreren Seiten: Zeilen von Seite zwei, die in die letzte Position von Seite eins gemischt werden.

Spaltenkopf-Marker — kennzeichnet eine Zeile, die die Spaltenköpfe auf jeder Seite wiederholt. Die Zeile selbst wird übersprungen, folgende Zeilen aber nicht.

Positionsbeginn — kennzeichnet eine Zeile, die eine neue Position beginnt, auch wenn das Muster der Ordnungsnummer nicht getroffen hat. Nützlich, wenn Positionen an ihrem Aufbau erkennbar sind, während die Nummernspalte unzuverlässig ist.

Der Mindestsatz

Ein Struct braucht mindestens eine Kennung oder Lieferantenkennung und einen Bestand. Ohne eine Kennung lässt sich nicht sagen, welches Produkt es ist; ohne eine Menge gibt es nichts zu importieren.