====== Specifikacija registracije Balans Dodataka ======

— //[[milan@melany.rs|Milan Oparnica]] 2015/08/27 00:32 —//

Datum izrade: 12.12.2007 Autor: Milan Oparnica

===== Balans (msbalans.exe) =====

Balans prepoznaje dodatne module na osnovu postojanja ključa **RegAddIns ** unutar registry putanje

**HKEY_LOCAL_MACHINE<nowiki>\</nowiki>SOFTWARE<nowiki>\</nowiki>MelanySoft<nowiki>\</nowiki>Balans<nowiki>\</nowiki>AddIn<nowiki>\</nowiki>Main<nowiki>\</nowiki>**

    * Prepoznavanje se radi u toku inicijalizacije programa tako da se mora izvršiti restart nakon instalacije dodatnog modula.
    * Dodatni modul je lokalno registrovan, što znači da se mora instalirati na svakom računaru na kom će raditi.
    * Dodatni moduli se ne unapređuju automatski.

===== Format podataka u ključu =====

Ključ **RegAddIns je string** tipa. Program koji želi da se prijavi mora u ovaj ključ da **doda ** tekstualni podatak u sledećem formatu:

**<font 16pt:normal/Courier New;;#000000;;inherit>#<čvorište>@<ključ definicije>#</font> **

Znaci # i @ su obavezni delimiteri.

Parametri:

</font>

==== Čvorište ====

U <//čvorište>// se unosi lokacija unutar programa u kojoj se **Balans Dodatak** prikazuje.

Moguće lokacije su unapred definisane prema sledećoj šemi:

^Vrednost ^Datum implementacije ^Lokacija |
|SklMan01 |  2007-10-01  |Glavni meni **Menadžera Skladišta** pod podmenijem **Servisi > Dodatni programi**  |
|DocManNew |  2007-11-20  |Meni dugmeta za izradu novih dokumenata u paleti alata **Menadžera Dokumenata.**  |
|ArtChoice1Call |  2013-01-23  |U sledećim modulima programa pojaviće se dodatni meni prilikom poziva forme za odabir artikala: 1. Modula za Poručivanje, **Porudžbenica ** kupca ili **Zahtev za nabavku** (//forma frOrder//) |
|KatMan01 |  2015-08-27  |Glavni meni **Menadžera Kataloga ** pod podmenijem **Katalozi > Dodatni programi**  |

\\

==== Ključ definicije ====

U <ključ definicije> se unosi naziv Registry key (registarskog ključa) unutar Main registra u kom su dodatni podaci o načinu na koji Balans komunicira sa Dodatkom. Pod ovim se podrazumevaju parametri koje će mu predati, režimi rada i tome slično.</font>

=== Ključevi komunikacije sa Balansom ===

Sledeći ključevi određuju parametre komunikacije sa Balansom.</font>

^Ključ^  Tip  ^Efekat|
|Caption|STRING|Opis koji će biti prikazan u meniju / kontroli unutar Balansa|
|Key|STRING|Unikatan string koji identifikuje poziv dodatnog modula|
|Constraint|STRING|Ograničavajući faktor za primenu dodatka, kao na primer Id firme, arhiva i slično. \\ Sastoji se od Key/Pair stavki razdvojenih delimiterom ";". \\   \\ Ključevi su sledeći: \\  \\ 1. Ograničenje po Id firme, fir_id = a,b,c,d,e…itd.  |
|PrgName|STRING|Ime programa odnosno klase ako je u pitanju ActiveX. Ova vrednost može da se zada u dva oblika: \\   \\ a.) Samo imenom ActiveX biblioteke (npr. "BLRDoc") a program će automatski podrazumevati da je u pitanju klasa **Veza** (CreateObject(BLRDoc.Veza)). \\ b.) Punim opisom, tj. imenom biblioteke + imenom klase po CreateObject sintaksi (npr. "BLRDoc.RezervacijeManager") \\ c.) Punim opisom i FQDN-om servera na kom se COM+ program izvršava (npr. "BLRDoc.RezervacijeManager@192.168.0.1")|
|PrgType|DWORD|Tip dodatnog programa : \\   \\ 0 - običan EXE (BAT) program \\ 1 - ActiveX DLL \\ 2 - ActiveX EXE \\ 3 - Interna kombinacija SQL upita xxGridw.ini|
|PrgCmdLine|STRING|Komandna linija koja se predaje (važi samo za Type=1)|
|PrgAppPath|STRING|Puna putanja do programa koji se pokreće (važi samo za Type=1)|
|RunMethod|STRING|Naziv metoda unutar klase koji se pokreće (samo za ActiveX)|
|RunParams|STRING|Spisak parametara koji se predaje metodu. U pitanju je formalni poziv metode, a imenovani parametri će biti zamenjeni varijablama iz Balansa na osnovu mapiranja navedenih u polju //Mapping//. Spisak se formira kao niz //parametar:vrednost// parova razdvojenih sa "/". Potrebno je da i prvi parametar počinje znakom "/" (npr: ''/parametar:vrednost/parametar:vrednost…/parametar:vrednost''). \\ Podatak '':vrednost'' može se izostavti što se tumači kao **Boolean True** vrednost. \\  \\ Parametri sistema za poručivanje: \\   **/dateinvent** Aktivira odabir datuma za presek stanja zaliha. Podrazumevano se radi sa presekom zaliha na tekući dan. \\ \\ **/datesales** Aktivira odabir datuma preseka izlaza robe (radi analize promena zaliha). \\ \\ **/dblrowhdr** Forsira dupliranje visine zaglavlja tablice izbornika artikala. \\ \\ **/refreshonchoice** Aktivira osvežavanje stanja spiska nađenih artikala nakon svake izmene poručene količine odabranog artikla. Na ovaj način korisnik stiče učestaliji uvid u rad ostalih korisnika u sistemu. Aktivacija ove opcije može značajno da utiče na usporavanje odzivnosti korisničkog interfejsa. \\ \\ **/savechoice** Aktivira snimanje aktivnosti na odabiru artikala i poručenih količina u //korisničku sesiju//. Ukoliko je aktivirana i opcija ''/refreshonchoice'' informacija se deli sa ostalim korisnicima sistema. Ukoliko dođe do prekida rada programa u toku poručivanja snimljeni podaci biće iskorišćeni za povratak podataka nakon restarta. \\ \\ **/speckolflt** Aktivacija primene dodatnog filtera stanja zaliha. Koristi se pri analizi artikala za poručivanje. Konkretna vrednost filtera postavlja se u samoj formi izbornika artikala. \\ \\ **/trplrowhdr** Forsira tripliranje visine zaglavlja tablice izbornika artikala. \\ \\ **/useccena** Indikator da se za cenu artikla koristi preporučena cena dobavljača (''ccena''). |
|Mapping|STRING \\   \\ (nije implementirano)|Mapiranje parametara sa podacima koji će biti predati iz Balansa. Format zapisa je : \\ <//parametar>// =<//balans var>// \\ <//parametar>// je naziv priveden u polju //Params// \\ <//balans var>// je nešto od sledećeg: \\   \\ **SklID**; predaće se ID odabranog skladišta|
|RunProperty|STRING \\   \\ (nije implementirano)|Spisak svojstava koja se setuju u klasi. Navedena svojstva će biti pozvana metodom ''CallByName vbLet.'' Parametri će biti predati prema u polju //Mapping//. \\   \\ Spisak se formira kao string u formatu: \\  \\ <//ime svojstva>=<balans var>,<ime svojstva>=<balans var>,…,<ime svojstva>=<balans var>//   |
|SQLCommand|STRING|Alternativni SQL upit koji će biti upotrebljen. Parametar važi za ''PrgType=3''   |
|GridName|STRNG|Naziv tablice iz **xxxGridW.ini** fajla|

\\


====== Primer reg fajla za Balans Posman Module ======

<code>
REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\AddIn]

[HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\AddIn\Main]

"RegAddIns"="#SklMan01@Posman01##SklMan01@Posman02#"

[HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\AddIn\Main\Posman01]

"Caption"="Izvoz cenovnika u POSMAN dbf"
"Key"="Posman_Omron01"
"Constraint"="fir_id=2,3,7"
"PrgName"="BEXPosman"
"PrgType"=dword:00000001
"PrgCmdLine"=""
"PrgAppPath"=""
"RunMethod"="ExportCene"
"RunParams"="outSklID"
"Mapping"="/outSklID=SklID/"
"RunProperty"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\MelanySoft\Balans\AddIn\Main\Posman02]

"Caption"="Prijem pazara iz POSMAN dbf tabele"
"Key"="Posman_Omron02"
"PrgName"="BEXPosman"
"PrgType"=dword:00000001
"PrgCmdLine"=""
"PrgAppPath"=""
"RunMethod"="GetPazar"
"RunParams"="outSklID"
"Mapping"="/outSklID=SklID/"
"RunProperty"=""
</code>


===== Ostali primeri =====

    - Uvoz šifarnika artikala za potrebe Balans EDI - 3PL MERCATOR šema – {{:kb:uputstva:addin:balans_edi_import_elementi_x86.reg|32bit   }}  – 64bit
    - Odabir artikala za poručivanje po YCA specifikaciji – {{:kb:uputstva:addin:porucivanje_po_specifikaciji_color_grupe.reg|32bit  }} – 64bit
    - Odabir artikala za poručivaenj po ALBO specifikaciji – 32bit – 64bit

~~COMPLEX_TABLES~~