Numeracja dokumentów: Różnice pomiędzy wersjami

Wersja z 10:58, 11 lut 2015

Numerowanie w Motławie można podzielić na trzy obszary:

• NUMDOK - stary, dotyczący wyłącznie dokumenty oparte na tabelach `opng` i `zmng`;
• NUMDOK/COUNTER - przejściowy, oparty na nowym numeratorze `erp_obj_counters` oraz
• COUNTER - zupełnie nowy oparty na systemie uniwersalnego numerowania.

OBSZARY NUMERACJI

NUMDOK

System numerujący dokumenty oparte na tabelach `opng` i `zmng`.

Licznikiem są

• dla numerów głównych (nrdokfin, nrdokmag, etc) tabela `numdok`
• dla numerów wewnętrznych (nrwewn) tabela `numwewn`.

Maska obu numeratorów oraz dodatkowe ustawienia znajdują się w tabeli `operdoc`.

UWAGA

Tabela `operdoc` pozwala ustawiać parametry z dokładnością do rodzaju dokumentu czyli nie uwzględnia podrodzaju.

NUMDOK/COUNTER

Ten system korzysta z nowych numeratorów jakim są `erp_obj_counters`, ale pozostałe ustawienia nadal są trzymane w tabeli `operdoc`. Niektóre algorytmy "pobierają" numer dla zdarzeń CRM inne tworzą numer z dokładnościa do miesiąca - nowy nuumerator `erp_obj_counters` ma większe możliwości grupowania numerów i dlatego jest używany (patrz liczniki w COUNTER).

Licznikiem jest tabela `erp_obj_counters` Maska numeratorów oraz dodatkowe ustawienia znajdują się w tabeli `operdoc`.

COUNTER

Całkiem nowy system numerowania.

Licznikiem jest tabela `erp_obj_counters` Maski oraz dodatkowe ustawienia znajdują się w tabeli `erp_obj_counters_masks` która nazywamy numeratorami. Każdy rekord to inny numerator który zawiera wszystkie konieczne ustawienia dotyczące numeracji. Nie ma zatem potrzeby wykorzystywania tabeli `operdoc` która dodatkowo ograniczała numerację tylko do dokumentów.

Nowe liczniki mogą grupować numery wg:

• zasobu 1 (np. magazyn)
• zasobu 2 (ustawialne)
• zasobu znakowego (np. RV_ID)
• roku
• miesiąca
• dnia (rok, miesiąc, dzień - podawany jest do procedury ale w automacie podawane jest konkretne pole daty)

Tabela numeratorów czyli ustawień `erp_obj_counters_masks`jest uniwersalna i pozwala zdefiniować dowolny numerator dla dowolnego pola z dowolnej tabeli. Nie ma tu ograniczenia do dwóch pól i dwóch tabel.

Numeratory dzielimy wg.:

• typu numeretora (string - pozwala zdefiniować dowolną liczbę numertorów (np. nrdokfin, nrdokmag, etc)
• rodzaju i
• podrodzaju

Każdy numerator może być "przekierowany" na inny typ/rodzaj/podrodzaj np. numerator magazynowy dla faktury zakupu może być "przekierowany" na analogiczny numerator o rodzaju WZ.

Ponadto w każdym numeratorze możemy:

• ustawić maskę,
• ustalić jak numerator będzie grupować numery (zasoby, rok, miesiąc, dzień)
• ustalić zachowanie algorytmów przy przepisywaniu numerów do końcowych pól w tabelach.
• ustalić czy numer (określone pole numeru) może być:
  • edytowane - EditedNum
  • można manualnie pobrać kolejny numer - ManualNum
  • program sam ma pobrać kolejny numer przy zapisie (gdy pole puste) - AutoNum czy automatyczna numeracja
• pola SQL_GetParams (SQL dla pobierania danych) oraz SQL_UpdateNum mają nieco szersze znaczenie - patrz ustawienia SQL_GetParams w DEFINICJA numeratorów.

DEFINICJA numeratorów

Każdy numerator określamy jako trójke atrybutów: typ, rodzaj i podrodzaj. Typ numeratora jest zdefiniowany w tabeli `erp_obj_counters_def` i nazywany jest definicja danego numeratora. Innymi słowy numeratory definiujemy w `erp_obj_counters_def` natomiast w `erp_obj_counters_masks` gromadzimy wszystkie możliwe wystąpienia rodzajowe danego numeratora (rodzaj, podrodzaj).

Co oprócz samej nazwy zawiera definicja numeratora?

Zawiera konieczne do automatycznego przetwarzania ustawienia:

• TableName - nazwa tabeli w której znajduje się pole numeru
• SQL_GetParams - SQL dla pobierania danych koniecznych do pobrania licznika i wypełnienia maski.
• SQL_UpdateNum - SQL dla wstawienie numeru do tabeli z pola TableName
• Disabled - określa czy definicja jest jeszcze używana.

SQL_GetParams

SQL-ka dla pobierania danych koniecznych do pobrania licznika i wypełnienia maski.

Przykładowa sql-ka dla definicji “opng.nrdokfin”:

 SELECT
 n.nrdokfin AS _Number,
 n.Rodzaj, 0 AS PodRodzaj, 
 IF(n.ZMagazynu != 0, n.ZMagazynu, n.DoMagazynu) AS _Res1,
 n.DoMagazynu AS _Res2,
  AS _ResGUID,
 YEAR(n.DataWystaw) AS _NumYear,
 MONTH(n.DataWystaw) AS _NumMonth,
 DAY(n.DataWystaw) AS _NumDay,
 n.RodzajDowodu AS _RodzajDowodu,
 n.RV_ID AS _Rv_id,
 n.UGrpGUID AS _UGrpGUID,
 IFNULL(m1.symbol, ) AS _MGS,
 IFNULL(m2.symbol, ) AS _MDS
 FROM `#TABLENAME#` n
 LEFT JOIN `Magazyny` m1_0 ON m1_0.IdnMagazynu = IF(n.ZMagazynu != 0, n.ZMagazynu, n.DoMagazynu)
 LEFT JOIN `Magazyny` m1 ON m1.IdnMagazynu = m1_0.grupa
 LEFT JOIN `Magazyny` m2_0 ON m2_0.IdnMagazynu = n.DoMagazynu
 LEFT JOIN `Magazyny` m2 ON m2.IdnMagazynu = m2_0.grupa
 WHERE
 GUID = '#ID#'
 INTO 
 @erp_obj_counters._Number,
 @erp_obj_counters._Rodzaj, 
 @erp_obj_counters._PodRodzaj, 
 @erp_obj_counters._Res1,
 @erp_obj_counters._Res2,
 @erp_obj_counters._ResGUID,
 @erp_obj_counters._NumYear,
 @erp_obj_counters._NumMonth,
 @erp_obj_counters._NumDay,
 @erp_obj_counters._RodzajDowodu,
 @erp_obj_counters._Rv_id,
 @erp_obj_counters._UGrpGUID,
 @erp_obj_counters._MGS,
 @erp_obj_counters._MDS
 ;

System automatycznie wykonuje to zapytanie aby otrzymać szereg zmiennych koniecznych do pobrania kolejnego numeru (dane do grupowania) oraz aby wypełnić maskę numeru.

UWAGA

W tabeli `erp_obj_counters_masks` również istnieje pole SQL_GetParams i jesli jest niepuste to jego zawartość jest wykonywana dla danego numeratora.

SQL_UpdateNum

Tę sql-ke system również wykonuje automatycznie. Ustawia ona pole w określonej tabeli. Parametry #TABLENAME#,#NUMBER# są wypałniane są również automatycznie ze zmiennych i z ustawień. PRZYKŁAD

 UPDATE `#TABLENAME#` 
 SET
 NrDokFin = '#NUMBER#'
 WHERE
 GUID = '#ID#'
 AND (NrDokFin =  OR #ALWAYS#)
 ;

UWAGA w tabeli `erp_obj_counters_masks` również istnieje pole SQL_UpdateNum i jesli jest niepuste to jego zawartość jest wykonywana dla danego numeratora.