Both sides previous revision Previous revision Next revision | Previous revision |
kb:kb:dodatni_moduli_main [2025/04/25 12:43] – [Opis] milano | kb:kb:dodatni_moduli_main [2025/08/08 11:04] (current) – milano |
---|
Koristeći Balans infrastrukturu razrađeni su mnogi napredni moduli krojeni prema specifičnim zahtevima poslovnih procesa. Ovi moduli nisu deo standardnog paketa programa pa uglavnom zahtevaju dodatne postavke i posebnu pažnju pri implementaciji. | Koristeći Balans infrastrukturu razrađeni su mnogi napredni moduli krojeni prema specifičnim zahtevima poslovnih procesa. Ovi moduli nisu deo standardnog paketa programa pa uglavnom zahtevaju dodatne postavke i posebnu pažnju pri implementaciji. |
| |
Pogled sa osnovnim postavkama dodatnih modula zove se **FN_DodatniModuli**. \\ | Pogled sa osnovnim postavkama dodatnih modula zove se **FN_DodatniModuli**.\\ |
Posebne postavke svakog pojedinačnog modula čuvaju se u polju ''fn_dodatnimoduli.parametri'' i mogu biti organizovane na različite načine. \\ | Posebne postavke svakog pojedinačnog modula čuvaju se u polju ''fn_dodatnimoduli.parametri'' i mogu biti organizovane na različite načine.\\ |
Najčešća su dva: | Najčešća su dva: |
* Uređeni parovi odvojeni tačkazarezima (''key1=value1;key2=value2;...'') | |
* JSON objekat (''{"key1":"value1","key2":"value2",...}'') | |
| |
Prilikom učitavanja objekta **DodatniModuli** vrši se automatska detekcija oblika zapisa u ''fn_dodatnimoduli.parametri'': | * Uređeni parovi odvojeni tačkazarezima (''key1=value1;key2=value2;…'') |
* Ukoliko počinje sa ''{'' ili ''[{'' podrazumeva se da su parametri zadati kao JSON objekat. | * JSON objekat (''{"key1":"value1","key2":"value2",…}'') |
| |
| Prilikom učitavanja objekta **DodatniModuli** vrši se automatska detekcija oblika zapisa u ''fn_dodatnimoduli.parametri'': |
| |
| * Ukoliko počinje sa ''{'' ili ''[{'' podrazumeva se da su parametri zadati kao JSON objekat. |
===== Spisak dodatnih modula ===== | ===== Spisak dodatnih modula ===== |
| |
|11|Modul za izdradu transportnih maršruta|| | |11|Modul za izdradu transportnih maršruta|| |
|12|Modul za praćenje prodaje po prodavcima|| | |12|Modul za praćenje prodaje po prodavcima|| |
|13|Balans EDI modul (razmena elektronskih dokumenata)|| | |13|[[:kb:kb:dodatni_moduli:modul_13_main|Balans EDI modul (razmena elektronskih dokumenata)]]|Modul omogućava i definiše rad podsistema za elektronsku razmenu dokumenata sa drugim sistemima.| |
|14|Modul za izvoz na povlašćena tržišta|| | |14|Modul za izvoz na povlašćena tržišta|| |
|15|Serverska obrada srednjih cena i nivelacija|| | |15|Serverska obrada srednjih cena i nivelacija|| |
|18|Billing system - printing services|| | |18|Billing system - printing services|| |
|19|Billing system - lift maintenance|| | |19|Billing system - lift maintenance|| |
|20|[[:kb:kb:dodatni_moduli:modul_20_main|Billing system - PR & contracting services]]|Neophodno je podesiti parametre rada pre nego što se pokrene program.| | |20|[[:kb:kb:dodatni_moduli:modul_20_main|]]|Neophodno je podesiti parametre rada pre nego što se pokrene program.| |
|21|Billing system - software helpdesk services|| | |21|Billing system - software helpdesk services|| |
|22|Uvid u cene i količine na svim skladištima pri izradi dokumenata|| | |22|Uvid u cene i količine na svim skladištima pri izradi dokumenata|| |
|67|[[:kb:kb:dodatni_moduli:modul_67_main|Osnovni modul cenovnika, rabata i akcija]]|| | |67|[[:kb:kb:dodatni_moduli:modul_67_main|Osnovni modul cenovnika, rabata i akcija]]|| |
|68|Vremensko razgraničenje prihoda i rashoda (osiguranje,održavanje,itd.)|| | |68|Vremensko razgraničenje prihoda i rashoda (osiguranje,održavanje,itd.)|| |
|69|[[:kb:kb:dodatni_moduli:modul_69_main|Integracija sa Station 24 ugostiteljskom mobilnom aplikacijom.]]|Modul zahteva upotrebu RMQ servera za procesiranje zahteva. \\ Sinhronizaciju sa Station24 obavlja servis ''..\Balans3\PRG\CUS\Station24\Release\Balans.Bar.API.Server.exe''. \\ Ceo folder ''Release'' treba iskopirati u ''..\MelanySoft\Balans\Station24\Release'' folder i instalirati ''Balans.Bar.API.Server.exe'' kao sistemski servis \\ \\ <code>sc.exe create BarBalansToStation24 binPath= "c:\Program Files (x86)\MelanySoft\Balans\Station24\Release\Balans.Bar.API.Server.exe"</code> //Napomena! Razmak iza ''binPath='' i znaka navoda je obavezan.//.| | |69|[[:kb:kb:dodatni_moduli:modul_69_main|Integracija sa Station 24 ugostiteljskom mobilnom aplikacijom.]]|Modul zahteva upotrebu RMQ servera za procesiranje zahteva. \\ Sinhronizaciju sa Station24 obavlja servis ''..\Balans3\PRG\CUS\Station24\Release\Balans.Bar.API.Server.exe''. \\ Ceo folder ''Release'' treba iskopirati u ''..\MelanySoft\Balans\Station24\Release'' folder i instalirati ''Balans.Bar.API.Server.exe'' kao sistemski servis \\ |
|70|[[:kb:kb:dodatni_moduli:modul_70_main|POS Loyalty kartice (članske kartice)]]| | <code> |
|71|[[:kb:kb:dodatni_moduli:modul_71_main|Integracija sa WOLT API]]| | |
|72|[[:kb:kb:dodatni_moduli:modul_72_main|Oplemenjivanje proizvoda za ino-partnera]]| | sc.exe create BarBalansToStation24 binPath= "c:\Program Files (x86)\MelanySoft\Balans\Station24\Release\Balans.Bar.API.Server.exe" |
|73|[[:kb:kb:dodatni_moduli:modul_73_main|Automatsko ažuriranje kurseva valuta]]| | |
|74|[[:kb:kb:dodatni_moduli:modul_74_main|POS evidencija substitucije toplog obroka (užina)]]|Periodično fakturisanje toplog obroka ([[https://razvoj.melany.rs/issues/4376#change-25445|Projekat #4376 za Leburić]])| | </code> //Napomena! Razmak iza ''binPath='' i znaka navoda je obavezan.//. | |
| |70|[[:kb:kb:dodatni_moduli:modul_70_main|]]| | |
| |71|[[:kb:kb:dodatni_moduli:modul_71_main|]]| | |
| |72|[[:kb:kb:dodatni_moduli:modul_72_main|]]| | |
| |73|[[:kb:kb:dodatni_moduli:modul_73_main|Automatsko ažuriranje kurseva valuta]]| | |
| |74|[[:kb:kb:dodatni_moduli:modul_74_main|]]|Periodično fakturisanje toplog obroka ([[https://razvoj.melany.rs/issues/4376#change-25445|Projekat #4376 za Leburić]])| |
| |
===== Dodatni moduli za uvoz podataka iz spoljašnjih datoteka (BLRExcelImport) ===== | ===== Dodatni moduli za uvoz podataka iz spoljašnjih datoteka (BLRExcelImport) ===== |
| |
Od ovog datuma, sve postojeće COM instance su prebačene na tzv. //Late Binding//, a njihove reference de-referencirane u projektu. Potez suštinski čini ovaj paket dodatnih modula nezavisnim od verzija komponenata Balansa (tj. koristiće one koje su na datom računaru). Dodata je nova referenca iz Balans3\EXT direktorijuma, BLBrojacHelperVB.NET (non COM-visible, VB.NET v4.0), koji služi da se dobijaju unibroj vrednosti od BLBrojac kada se koristi late binding. Radi lakšeg razlikovanja, napravljen je MSI verzije 1.01.0001. | Od ovog datuma, sve postojeće COM instance su prebačene na tzv. //Late Binding//, a njihove reference de-referencirane u projektu. Potez suštinski čini ovaj paket dodatnih modula nezavisnim od verzija komponenata Balansa (tj. koristiće one koje su na datom računaru). Dodata je nova referenca iz Balans3\EXT direktorijuma, BLBrojacHelperVB.NET (non COM-visible, VB.NET v4.0), koji služi da se dobijaju unibroj vrednosti od BLBrojac kada se koristi late binding. Radi lakšeg razlikovanja, napravljen je MSI verzije 1.01.0001. |
| |
| |
==== Opis ==== | ==== Opis ==== |
| |
Ovi moduli su napisani korišćenjem .NET framework 4.5.1 i Visual C# jezika. \\ | Ovi moduli su napisani korišćenjem .NET framework 4.5.1 i Visual C# jezika. \\ Dostupi su iz **Balans 3/4** menija **Servis > Uvoz podataka**. \\ \\ Izborom opcije prikazuje se prozor za lansiranje aktivnih modula. \\ Postoji i način da se pojedinačni modul pokrene preskačući prozor //Lansera//. \\ \\ Moduli se instaliraju preko //Balans Dodatni Moduli - ExcelImport.msi// datoteke. \\ Osim instalacije msi paketa, modul može i ručno da se registruje preko administratorskog Command-Line Prompt . \\ Pošto je .NET COM-vidljiva biblioteka, komande registracije glase: |
Dostupi su iz **Balans 3/4** menija **Servis > Uvoz podataka**. \\ \\ | |
Izborom opcije prikazuje se prozor za lansiranje aktivnih modula. \\ | |
Postoji i način da se pojedinačni modul pokrene preskačući prozor //Lansera//. \\ \\ | |
Moduli se instaliraju preko //Balans Dodatni Moduli - ExcelImport.msi// datoteke. \\ | |
Osim instalacije msi paketa, modul može i ručno da se registruje preko administratorskog Command-Line Prompt . \\ | |
Pošto je .NET COM-vidljiva biblioteka, komande registracije glase: \\ | |
<code> | <code> |
| |
REM Izvršiti komande iz foldera u kojem su DLL i TLB | REM Izvršiti komande iz foldera u kojem su DLL i TLB |
"%WINDIR%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe" /codebase "BLRExcelImport.dll" | "%WINDIR%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe" /codebase "BLRExcelImport.dll" |
"%WINDIR%\Microsoft.NET\Framework\v4.0.30319\Regtlibv12.exe" "BLRExcelImport.tlb" | "%WINDIR%\Microsoft.NET\Framework\v4.0.30319\Regtlibv12.exe" "BLRExcelImport.tlb" |
| |
</code> | </code> |
| |
Po ugledu na gornju grupu dodatnih modula, tako je i ovde napravljen upit koji prikazuje osnovne postavke, **FN_DodatniMod_ExcImp**. \\ \\ | Po ugledu na gornju grupu dodatnih modula, tako je i ovde napravljen upit koji prikazuje osnovne postavke, **FN_DodatniMod_ExcImp**. |
| |
=== Aktivacija modula === | === Aktivacija modula === |
| |
Aktivacija može da se obavi putem izvršavanja ''UPDATE'' upita ili pomoću grafičkog interfejsa koji se pokreće tako što se //Lanser// pokrene dok se istovremeno drže pritisnuti tasteri ''Shift'' i ''Control'' (''Ctrl''). \\ Aktivacija se može obaviti putem **QueryFind** aplikacije, **Baza > Alati > Moduli Balansa**, gde je dovoljno štiklirati odgovarajuću vrednost ispred naziva modula, i pritisnuti dugme za snimanje podataka. | Aktivacija može da se obavi putem izvršavanja ''UPDATE'' upita ili pomoću grafičkog interfejsa koji se pokreće tako što se //Lanser// pokrene dok se istovremeno drže pritisnuti tasteri ''Shift'' i ''Control'' (''Ctrl''). Aktivacija se može obaviti putem **QueryFind** aplikacije, **Baza > Alati > Moduli Balansa**, gde je dovoljno štiklirati odgovarajuću vrednost ispred naziva modula, i pritisnuti dugme za snimanje podataka. |
| |
==== Spisak modula ==== | ==== Spisak modula ==== |
|1|Modul za izradu dokumenata (fakture, trebovanja,…) \\ u Balansu na osnovu podataka iz excel datoteka|Potreban MS Ace 2010 32bit za rad modula; \\ Modul ima podešavanja za dozvolu izrade potebnih dokumenata: U polje FN_DodatniMod_ExcImp.Podmoduli treba navesti vrednost polja defDocTip.DTID onih dokumenata koji treba da se uvoze, odvojenih zarezom. Za sada su dostupni: 9, 11, 18, 29; \\ Modul ima Test-režim (**Alt+F10**) u kojem ne proverava log u bazi podataka, tako da isti fajl može da se uvozi iznova i iznova;| | |1|Modul za izradu dokumenata (fakture, trebovanja,…) \\ u Balansu na osnovu podataka iz excel datoteka|Potreban MS Ace 2010 32bit za rad modula; \\ Modul ima podešavanja za dozvolu izrade potebnih dokumenata: U polje FN_DodatniMod_ExcImp.Podmoduli treba navesti vrednost polja defDocTip.DTID onih dokumenata koji treba da se uvoze, odvojenih zarezom. Za sada su dostupni: 9, 11, 18, 29; \\ Modul ima Test-režim (**Alt+F10**) u kojem ne proverava log u bazi podataka, tako da isti fajl može da se uvozi iznova i iznova;| |
|2|TimeTracking modul|Potreban MS Ace 2010 32bit; Modul ima dva režima rada (1. "Kleemann" i 2. "Mera") koji se biraju preko padajuće liste,a koja se zaključava. Poslednji izbor se pamti za sledeće pokretanje; Za 1. postoji podešavanje u naprednim podešavanjima Balansa, (Kadrovi i plate> Period tolerancije izmedju dva očitavanja…) koje treba podesiti pre korišćenja modula. \\ Za 2. postoji prateća Registar vrednost čija vrednost nula omogućava samo tekuću firmu, a <>0 sve firme u Blfpub.dat koje imaju GLN u svojoj bazi. \\ Ključ je: HKEY_LOCAL_MACHINE<nowiki>\</nowiki>SOFTWARE<nowiki>\</nowiki>(Wow6432Node<nowiki>\</nowiki>)MelanySoft<nowiki>\</nowiki>Balans<nowiki>\</nowiki>BLRExcelImport<nowiki>\</nowiki>TTJustCurFirmAllowed| | |2|TimeTracking modul|Potreban MS Ace 2010 32bit; Modul ima dva režima rada (1. "Kleemann" i 2. "Mera") koji se biraju preko padajuće liste,a koja se zaključava. Poslednji izbor se pamti za sledeće pokretanje; Za 1. postoji podešavanje u naprednim podešavanjima Balansa, (Kadrovi i plate> Period tolerancije izmedju dva očitavanja…) koje treba podesiti pre korišćenja modula. \\ Za 2. postoji prateća Registar vrednost čija vrednost nula omogućava samo tekuću firmu, a <>0 sve firme u Blfpub.dat koje imaju GLN u svojoj bazi. \\ Ključ je: HKEY_LOCAL_MACHINE<nowiki>\</nowiki>SOFTWARE<nowiki>\</nowiki>(Wow6432Node<nowiki>\</nowiki>)MelanySoft<nowiki>\</nowiki>Balans<nowiki>\</nowiki>BLRExcelImport<nowiki>\</nowiki>TTJustCurFirmAllowed| |
|3|AVIS CSV Import|Dve Registar vrednosti u HKCU<nowiki>\</nowiki>…<nowiki>\</nowiki>OkrKasa, //PIBPrefiks// i //ArtOstaliTroskovi//. Prva odredjuje da li je domaće pravno ili drugi tip lica (početak CVS polja Adr2 je jednak ovoj vrednosti). Druga je šifra Artikla "Ostali troškovi". Program zahteva ovu vrednost. Ili će se uneti ispravna i nastaviti rad, ili tri puta pogrešna (prazna se ne računa) i obustavlja se izvršavanje programa. Ova vrednost mora da se poklopi sa makar jednom Elementi.Artikal vrednoštću u bazi. \\ \\ Modul piše u prosti log fajl na bilo koji izuzetak (exception). Fajl je naziva "CVS_Import_log_[današnji_datum].txt" na lokaciji 1. Temp folder Windosa ili 2.<nowiki>\</nowiki>AppData<nowiki>\</nowiki>Local<nowiki>\</nowiki>Balans ili 3. C:<nowiki>\</nowiki>Temp, na osnovu dozvola za upis, gde prvo uspe. | | |3|AVIS CSV Import|Dve Registar vrednosti u HKCU<nowiki>\</nowiki>…<nowiki>\</nowiki>OkrKasa, //PIBPrefiks// i //ArtOstaliTroskovi//. Prva odredjuje da li je domaće pravno ili drugi tip lica (početak CVS polja Adr2 je jednak ovoj vrednosti). Druga je šifra Artikla "Ostali troškovi". Program zahteva ovu vrednost. Ili će se uneti ispravna i nastaviti rad, ili tri puta pogrešna (prazna se ne računa) i obustavlja se izvršavanje programa. Ova vrednost mora da se poklopi sa makar jednom Elementi.Artikal vrednoštću u bazi. \\ \\ Modul piše u prosti log fajl na bilo koji izuzetak (exception). Fajl je naziva "CVS_Import_log_[današnji_datum].txt" na lokaciji 1. Temp folder Windosa ili 2.<nowiki>\</nowiki>AppData<nowiki>\</nowiki>Local<nowiki>\</nowiki>Balans ili 3. C:<nowiki>\</nowiki>Temp, na osnovu dozvola za upis, gde prvo uspe. | |
| |
\\ | |
| |
| |