Mapowania

Mapowanie mówi, czym jest wartość odczytana z kolumny: numerem produktu, ilością, ceną zakupu czy datą przydatności.

Podstawowe pola

• Label — nazwa opisująca rodzaj danych.
• Type — rodzaj danych (poniżej).
• Entity i Field — gdzie szukać wartości przy rozpoznawaniu produktu.
• Columns — kolumny, w których wartość ma być szukana.
• Priority — kolejność szukania; niższa liczba oznacza wcześniej. Przy kilku pasujących wynikach używany jest pierwszy znaleziony.
• Regular expression i Capture group — wzorzec walidujący wartość i fragment, który ma zostać wycięty.
• Required — czy wartość jest niezbędna do uznania pozycji za rozpoznaną.

Rodzaje mapowań

Identifier — jednoznaczny identyfikator produktu. Wymaga wskazania Entity i Field:

Pole	Znaczenie
Product.productNumber	wewnętrzny numer produktu
Product.manufacturerNumber	numer producenta
Product.ean	kod EAN
Product.translations.name	nazwa produktu

Produkty znalezione po numerze, numerze producenta albo kodzie EAN dostają status Recognized. Produkty znalezione po nazwie dostają Ambiguous, ponieważ nazwa nie jest jednoznaczna.

Uwaga

Szukanie po nazwie na dużej bazie produktów jest kosztowne. Używaj go tylko wtedy, gdy sklep ma Elasticsearch; inaczej analiza dokumentu potrafi trwać bardzo długo.

Stock — mapowanie obowiązkowe, czyta ilość z faktury. Wymaga Change type:

• Add — dostawa zwiększa stan,
• Subtract — zwrot albo korekta zmniejsza stan,
• Overwrite — ustawia stan na odczytaną wartość.

Supplier identifier — własny identyfikator dostawcy. Pozwala kupować ten sam produkt u kilku dostawców, z których każdy używa innego numeru artykułu.

Value — wartość, która musi zostać rozpoznana, żeby wiersz uznać za kompletny. Podnosi trafność rozpoznawania wierszy z pozycjami.

Ordinal number — numeracja pozycji. Jeśli tabela ją zawiera, warto ją zmapować: poprawia odczytanie granic wierszy.

Product name, Purchase price, Batch code, Batch quantity — dodatkowe dane pozycji.

Expiry date — data przydatności. Trafia na partię tworzoną przy przyjęciu, więc dopiero dzięki niej działa wydawanie według terminu. Rozpoznawane formaty to Y-m-d, d.m.Y, d-m-Y, d/m/Y oraz ich warianty z dwucyfrowym rokiem.

Znaczniki układu strony

Trzy typy działają na całym wierszu, a nie na pojedynczej kolumnie. Używają wyłącznie pól Label, Regular expression i Priority:

Page marker — oznacza wiersz nagłówka strony. Dzięki niemu moduł wie, że zaczęła się nowa strona. Rozwiązuje najczęstszy błąd odczytu wielostronicowych faktur: doklejanie wierszy z drugiej strony do ostatniej pozycji z pierwszej.

Column header marker — oznacza wiersz powtarzający nagłówki kolumn na każdej stronie. Sam wiersz jest pomijany, ale kolejne nie.

Item starter — oznacza wiersz rozpoczynający nową pozycję, nawet gdy numeracja porządkowa nie została rozpoznana. Przydaje się, gdy pozycje da się rozpoznać po strukturze wiersza, a kolumna z numeracją jest niewiarygodna.

Minimalny komplet

Struktura potrzebuje przynajmniej jednego Identifier albo Supplier identifier oraz Stock. Bez identyfikatora nie wiadomo, o jaki produkt chodzi; bez ilości nie ma czego zaimportować.