kb:uputstva:korisnicka:integ:route_master_main

Route Master

Proizvođač: SonoIT (Hrvatska) Klijenti: MgMivela, Leburić

Sistem se sastoji od dva glavna dela: a) Back-office, upravljačka .Net aplikacija b) Xamarin mobilna aplikacija (namenjena telefonima).
Postavke integratora se nalaze u okviru postavki dodatnih modula Balansa.

Integrator je izveden kroz ActiveX COM komponentu BLCRouteMaster.dll koju pokreće servis koji periodično poziva metode iz dll-a za uvoz/izvoz podataka.
Uvoz/izvoz podataka se vrši kroz posredničku bazu (npr. SQL server) kojoj mogu da pristupaju ActiveX komponenta i Route Master.
Ako Balans koristi JET bazu podataka potrebno je napraviti linkove na tabele iz SQL servera, a ako Balans koristi PGS bazu potrebno je SQL server linkovati sa PGS bazom.

Instalacija RouteMaster servisa je opisana na https://rd.melany.rs/install/extras/RouteMaster/service/Readme.txt

Skladišta koja učestvuju u RouteMaster razmeni moraju imati kolonu RMPriceRef setovanu na True.

Uvoz porudžbina i izvoz šifarnika i lagera se periodično odrađuju prema postavkama u registry grani

HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\RouteMaster
KljučTipOpis
UvozDWORDInterval (sekundi) u kom se okida procedura sakupljanja podataka iz Route Mastera.
IzvozLageraDWORDInterval (sekundi) u kom se okida procedura slanja stanja lagara u Route Master.
IzvozStartTimeDWORDVreme u koje se izvoze matični podaci iz Balansa (reset Route Master tabela).
IzvozIntervalDWORDInterval u kom se ponavlja izvoz matičnih podataka (reset Route Master tabela).
IzvozOnNextCycleDWORDPostavka ovog parametra u 1 inicira započinjanje potpunog Reseta Route Master tabela pri prvom sledećem okidanju “IzvozLagera” događaja


Konfiguracioni fajl confrm.txt sadrži postavke kojima se utiče na rad ActiveX modula za uvoz/izvoz podataka.
Lokacija konfiguracionog fajla je proizvoljna i zadaje se u registry ključu ConfigPath grane

HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\RouteMaster

Konfiguracioni fajl sadrži sledeće parametre:

Linija1 - DEBUG MODE (“DEBUGON” | “DEBUGOFF”)
Linija2 - Definicija RM_Izvoz_OpenItems upita
Linija3 - Prezentacija u koju porudžbine ubacujemo (“<PreID>” | “LAST” što znači automatska pretraga)
Linija4 - Za povezivanje se koristi TRUSTED ODBC DSN (“TRUE” | “FALSE”)
Linija5 - DSN servera (npr. “RMDSN”)
Linija6 - Ime baze podataka za razmenu (npr. “MelanyRouteMaster”)
Linija7 - Prefix koji se stavlja ispred naziva tabele baze za razmenu podataka (npr. “TmpRM)
Linija8 - Indikator provere linkova pre poziva upita za obradu (“TRUE” | “FALSE”)
Linija9 - Indikator upotrebe DCOM-a (“USEDCOM” | “NODCOM”)
Linija10 - Definicija TmpRM_SalesRep upita zaduženog za izveštaj o prodaji
Linija11 - Definicija SQL upita za dobijanje rezultata prodaje (poručeno/prodato)
Linija12 - Definicija SQL upita za dobijanje registrovanih isporučnih mesta iz RM baze - koristi se za upit pri punjenju tabele SalesHistory, a ne za popunjavanje tabele Customers
Linija13 - Definicija SQL upita za dobijanje registrovanih artikala u RM bazi
Linija14 - Definicija RM_Izvoz_CustomerDiscountsByProductGroups upita za popunjavanje šeme popusta po kupcima i grupama proizvoda
Linija15 - Izbor ProductGroups (KAT,PKT,CAT,CSI,CPR)
Linija16 - Izbor ProductSubGroups (KAT,PKT,CAT,CSI,CPR)
Linija17 - Cenovnik i cenovna kolona koja se koristi umesto podrazumevane SkladKol.MCena cene (” “ | “Cenovnik::Kolona”, npr. “VP::CenaB”)
Linija18 - Putanja do proxy aplikacije za vezu PGS i MSSQL baza
Linija19 - Indikator test režima rada (“TESTINGON” | “TESTINGOFF”) - broj napravljenog dokumenta i ID za upis u bazu su hardkodovani na “TEST TEST” i -999999 ako je TESTINGON

Za podešavanje Route Master servisa koristi se sledeći ključevi registry grane

HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\RouteMaster
KljučVrstaOpis
ConfigPathSTRINGApsolutna putanja do konfiguracionog fajla
Primer: “d:\BALANS 20\BLNSPROGRAMS\PRG\CUS\ExportJamnica\files\confrm.txt”
FirIDDWORDIdentifikacioni broj firme
Primer:00000004
UvozDWORDInterval (sekundi) u kom se okida procedura sakupljanja podataka iz Route Mastera
Primer:00000080 (120s)
IzvozLageraDWORDInterval (sekundi) i kom se okida procedura slanja stanja lagara u Route Master
Primer:0000012C (300s)
IzvozStartTimeDWORDVreme u koje se izvoze svi podaci iz Balansa (reset Route Master tabela). Broj odgovara funkciji Delphi:
IzvozStartTime = Frac(<željeno vreme izraženo kao decimalni broj>)*86400
Primer1:00000000(0) znači u ponoć
Primer2:00014370(82800) znači u 23:00.
Decimalni izraz vremena se može dobiti upitom SELECT CDBL(TIMESERIAL(hh,mm,ss))
IzvozIntervalDWORDInterval u kom se ponavlja izvoz svih šifarnika (reset Route Master tabela). Nula znači da se radi samo jednom, u “IzvozStartTime” trenutku.
Primer: 00000000 (Izvoz se radi samo jednom, u IzvozStartTime trenutku)
DebugOnDWORDIndikator (0|1) koji uključuje intenzivno logovanje svih operacija u cilju debagovanja
Primer: 00000000 (isključeno)
IzvozOnNextCycleDWORDPostavka ovog parametra u 1 inicira započinjanje potpunog reseta Route Master tabela pri prvom sledećem okidanju “IzvozLagera” događaja.
Primer: 1 (uključeno). Prvi put kada servis ovo pročita, postaviće vrednost u 0 kako bi zahtev obuhvatio samo jedan ciklus.

Sigurniji način za reset Route Master tabela je da se u folderu sa fajlom confrm.txt napravi prazan fajl reset (bez ekstenzije) koji će automatski biti obrisan nakon reseta Route Master tabela. Sačekati jedno 20-ak minuta dok se izvrši razmena podataka.

Nalaze se u koloni Parametri upita FN_DodatniModuli za vrednost kolone Funkcija=33. Parametri su parovi Key=Value odvojeni sa tačkazarezom.
Za napredne popuste koriste se parametri sa ključevima: discount, seconddiscount, paymentdiscount, promotiondiscount čije vrednosti moraju biti iz kolone CusID tabele defCustData.

Za potrebe Stevan Still uvoza porudžbina iz Route Master-a koriste se i parametri unifycustomers, unifyitems, expitems, expstocks, expcustomers, a njihovi opisi i funkcije su
opisani na https://help.melany.rs/sr/home/modules/additional_modules/module_33_main

Tokom uvoza/izvoza podataka upisuju se info/debug poruke u fajl dnevnika događaja. Fajl se zove BalansRMImpEx.log i nalazi se u direktorijumu zajedničkom za sve korisnike, u podfolderu Balans npr.

C:\ProgramData\Balans\BalansRMImpEx.log

  • kb/uputstva/korisnicka/integ/route_master_main.txt
  • Last modified: 2023/12/12 11:57
  • by nessa