Mobilný skladník - programátorská príručka

Z SPIN2-wiki
Prejsť na: navigácia, hľadanie

Úprava položiek menu

Dynamické generovanie menu dovoľuje nastaviť u zákazníka rôznu konfiguráciu menu, podľa jeho požiadaviek a potrieb. Je možné premenovať položky menu, upraviť poradie a tiež nastaviť stromovú štruktúru ako si zákazník požiada. Všetko toto nastavenie, sa robí v konfiguračnom súbore na aplikačnom serveri, takže nie je potrebný zásah programátora do kódu. Súbor sa nachádza v ../wwwroot/SklPohyby/config.xml

Skl1.PNG

Základná štruktúra súboru

Základný párový tag je <config>. Vrámci tohto tagu sa definuje párový tag <menu>. Vrámci tohto tagu už môžme priamo definovať stromovú štruktúru (viac je možné vidieť v konkrétnom príklade). Tag <menuItem> je základným tagom pre definíciu položky menu. Je tu možné zadefinovať text, kód, pozíciu položky menu poprípade index obrázku, ktorý je zadefinovaný v tagu <image>.

Príklad súboru

 <?xml version="1.0" encoding="UTF-8"?>
 <config>
 <menu>
       <menuItem text="Príjem" position="1" imageIndex="3" code="PRIJEM">
               <menuItem text="Hromadný príjem z OV" code="PRIJ_HROMAD_OV" position="1"/>
               <menuItem text="Príjem materiálu z OV" code="PRIJ_MATOV" position="2"/>
               <menuItem text="Príjem" code="PRIJ_PR" position="3"/>
               <menuItem text="Príjem na HRSN" code="PRIJ_DOKLAD320" position="4"/>
               <menuItem text="Hromadný príjem" code="PRIJ_HROMAD" position="5"/>
       </menuItem>
       <menuItem text="Výdaj" position="2" imageIndex="4" code="VYDAJ">
               <menuItem text="Výdaj DL z PO  (F4)" code="VYD_DLOD" position="1"/>
               <menuItem text="Výdaj materiálu zo ZIA  (F5)" code="VYD_MATZIA" position="2"/>
               <menuItem text="Výdaj na HrSn" code="VYD_DOKLAD330" position="3"/>
               <menuItem text="Výdaj dod. listu na HrSn" code="VYD_DOKLAD340" position="4"/>
               <menuItem text="Potvrdenie dod. listu" code="VYDZDL" position="5"/>
               <menuItem text="Dodací list" code="DL" position="6"/>
               <menuItem text="Výdajka" code="VD" position="7"/>
               <menuItem text="Inventúra" code="INV" position="8"/>
               <menuItem text="Zmena umiestnenia" code="ZMENAUMIESTNENIA" position="9"/>
               <menuItem text="Inventúra majetku" code="INVENTURAMAJETKU" position="10"/>
               <menuItem text="Výdaj materiálu z OD" code="VYD_MATOD" position="11"/>
               <menuItem text="Výdaj DL z PO s výberom série" code="VYD_DLODSERIA" position="12"/>
               <menuItem text="Výdaj AL do výroby" code="SCH_VD_AL" position="12"/>
               <menuItem text="Dodanie hotového výrobku" code="SCH_DL" position="13"/>
               <menuItem text="Vydaj Expedicia" code="SCH_VD_EXP" position="14"/>
               <menuItem text="Offline Inventúra" position="15" imageIndex="12" code="OFFINV"/>
               <menuItem text="Sledovanie výdaja materiálu" position="16" imageIndex="4" code="SLEDVYDMAT"/>
               <menuItem text="Výdaj cez žiadanky" code="VYD_MATZIA_CHRIEN" position="17"/>
       </menuItem>
       <menuItem text="Objednávka" position="3" imageIndex="2" code="OBJ">
               <menuItem text="Nákup cez EAN" code="OBJ_NAKUPEAN" position="1"/>
               <menuItem text="Položky objednávky" code="OBJ_POLOZKY" position="2" />
       </menuItem>
       <menuItem text="Číselníky" position="4" imageIndex="9" code="CIS">
               <menuItem text="Priradenie EAN k produktu" code="PRODEAN" position="1"/>
       </menuItem>
       <menuItem text="Prehľady" position="5" imageIndex="10" code="PREHLADY">
               <menuItem text="Info o SN" code="INFOOSN" position="1"/>
               <menuItem text="Prehľad stavu produktu cez EAN" code="PREHEAN" position="2"/>
               <menuItem text="Prehľad stavu produktu cez kód produktu" code="PREHKOD" position="3"/>
               <menuItem text="Prehľad cien cez EAN" code="PREHCIEN" position="3"/>
       </menuItem>
       <menuItem text="Neprihl. uživ." position="6" code="LOGUSER" imageIndex="8">
       </menuItem>
       <menuItem text="Nastavenia" position="8" code="SETTINGSFRM" imageIndex="11">
       </menuItem>
       <menuItem text="O aplikacii" position="9" code="ABOUTUS">
       </menuItem>
       <menuItem text="Koniec" position="10" code="EXITAPP" imageIndex="6">
       </menuItem>
       <imageList>
       <image index="0">res/resource.ico</image>
       <image index="1">res/resource1.ico</image>
       <image index="2">res/resource2.bmp</image>
       <image index="3">res/resource3.bmp</image>
       <image index="4">res/resource4.bmp</image>
       <image index="5">res/resource5.ico</image>
       <image index="6">res/close.ico</image>
       <image index="7">res/Settings.ico</image>
       <image index="8">res/user.ico</image>
       <image index="9">res/ciselnicek.ico</image>
       <image index="10">res/prehlad.ico</image>
       <image index="11">res/preferences-system.png</image>
       <image index="12">res/Book.png</image>
       </imageList>
 </menu>

Pridanie nového tabu

Prvým krokom pri pridávaní nového tabu je určenie unikátneho kódu záložky. Tento kód sa použije v definícii menu a následne je možné ho implementovať do kódu. v súbore SklPohyby.Main.cs v metóde ActivateMenuItem sa implementuje tento kód. Najskôr je však potrebné vytvoriť triedu, ktorá je podedená z triedy TabPage a implementuje interfacy IBarcodeReader a ITabPage. Viac o tvorbe obsahu záložky je v časti obsah záložky.

Keď máme pripravenú potrebnú triedu, môžme pridať do metódy ActivateMenuItem kód: 

if (tagItemu.Equals("KOD_ZALOZKY"))
{
   this.AddTab(new TriedaPodedenaZTabPage((string)tagItemu));
}

Obsah záložky

V zásade môže byť obsahom záložky čokoľvek, čo tam programátor naprogramuje vrámci .NET frameworku. Existujú však prispôsobené kontroly, ktoré je možné použiť a tiež aj grid, ktorý sa volá DataGridEx. Je možné použiť rovnaký koncept ako je v SPINe, čiže pokiaľ poznáme všetky vsupné parametre, alebo žiadne nie sú, tak zobrazíme grid s tým, že je programátorsky možné zadefinovať editačný formulár, na ktorom sa dajú upravovať všetky, alebo iba niektoré polia (samozrejme, že tieto polia sa musia namapovať na stĺpce gridu ... )

Ďalším prípadom može byť taký, že na zobrazenie gridu potrebujeme zozbierať od užívateľa vstupné parametre, použijeme teda triedu GenrateView, pomocou ktorej sa generuje pohlad, ale použijeme ju na zobrazenie pohladu na zozbieranie vstupných dát.

Tento mechanizmus sa môže zdať komplikovaný po prvom prezretí zdrojového kódu, ale po preštudovaní a debugovaní to dáva zmzsel a je to v podstate veľmi jednoduché.

Príklady komponentov

  • Dátumový vyberač
this.paramPrijGeneratedView.AddControlDateTimePicker("datum", "Dátum: ", DateTime.Now, true);

CtrlDatum.png

  • Vyberač hodnôt
this.paramPrijGeneratedView.AddControlCombobox(
                    "sklad",
                    "Sklad: ",
                    "LBSKL",
                    new Dictionary<string, string>
                        {
                            { "datum", DateTime.Now.ToString("dd.MM.yyyy") }
                    },
                    true);

CtrlCombo.png

  • Vyberač hodnôt so zadávaním hodnôt
var lparams = new Dictionary<string, string>
{
   { "skladid", "0" }, 
   { "datum", DateTime.Now.ToString("dd.MM.yyyy") }
};
this.paramPrijGeneratedView.AddAdvControlCombobox("dodavatel", "Dodávateľ: ", "LBFIRMAD", lparams, true);

CtrlCombo2.png

  • Textové pole
this.paramPrijGeneratedView.AddControlTextBox("cislofadl", "Č. FA/DL:", true);

CtrlText.png

  • Checkbox
this.paramPrijGeneratedView.AddControlCheckBox("kontrola", "Mat. na kon.: ", true);

CtrlCheck.png

Princíp fungovania pkVyrCck balíkov

Na prvý pohľad sa môže zdať princíp fungovanie pkVyrCck balíkov zbytočne zložitý, ale vo svojej podstate je geniálny a umožňuje robiť akúkoľvek funkcionalitu, bez toho aby bolo potrebné čokoľvek meniť na aplikačnom serveri.

Základom je definovať si unikátny kód, ktorým bude select alebo akcia, ktorá sa má vykonať definovaná. Zadefinujeme balík s názvom pkVyrCckKOD, ktorý môže mať metódy spracuj a init.

  • Spracuj

Metóda spracuj môže vykonať čokoľvek, napríklad príjem a pod. Metóda má vstupné a výstupné parametre definované ako XML, čo zasa umožňuje univerzálnosť množstva a typov vstupných a výstupných parametrov.

  • init

Metóda init v zásade funguje ako "napĺňač" temp tabuliek, s ktorými pracuje mobilný skladník. Tento princíp si viac priblížime nižšie.

V momente keď máme napísaný balík môžme pokračovať k dalšiemu kroku a to zadefinovaniu tohto kódu nad DB. Dá sa to spraviť dvoma spôsobmi:

  • Nastavením v SPINe - Návod je tu
  • Vztvorením a spustením skriptu - Skript je možné vytvoriť a spustiť na DB. Všetky známe definície sú (alebo by aspoň mali byť) v SVN vo VYR\database\stare_CVS\DefinicieCK\CEKody\
Zdroj: „https://wiki.helios.eu/sk/spin2/index.php?title=Mobilný_skladník_-_programátorská_príručka&oldid=11798“