sERPa súgó

 

Választható paraméter értékek

Leírás

Ez a paraméter szabályozza, hogy az aktuális menü funkcióiban, megjelenjen-e az ikonsorban egy új nyomógomb, amelyről a sERPán belüli menü, funkció, vagy külső (böngésző, vagy exe) programok elindítása történhet funkciófüggő paraméterátadással. A menüparaméter neve Nyomógomb1 ... Nyomógomb9 lehet, tehát egy funkcióba összesen maximum 9 belső funkcióindító / külső programindító ikon tehető ki.

 

Külső (böngésző, vagy exe) program indításakor a bevitelekből Felvétel üzemmódban (vagy módosító módban, ha belemódosítottunk a tételbe) a gomb megnyomására megjelenik egy kérdés, hogy elmentsük-e a változtatást, tehát felvételkor a rögzítés gomb megnyomása nélkül lehet a Nyomógomb1..9 segítségével az elmentésre kerülő tétel ID-jét átadni a külső programnak.

 

Az ikonleíró megadása nélkül megjelenő ikon(ok) az alábbi(ak):

...

Korábban ezek voltak:

..

Megkönnyíti a paraméterek megadását a Paraméter-varázsló, amit a Nyomógomb1..9 menüparaméter megadásakor a "Szöveges érték" mezőn nyomott kapcsolódó funkcióval lehet elindítani.

A menüparaméter szöveg mezőjének a szintaxisa az alábbi:

Érték = címke[,ikonleíró];internet;internetcím|címke;program;[dosablak];[könyvtár];program

Ahol:

címke        a gombon megjelenítendő felirat szövege. Gombnév, amely az ikonra közelítéskor kiírásra kerül, utána vesszővel megadható az ikonleíró, ami lehet az ikon belső sorszáma, vagy egy minden kliens számára elérhető ikonfájl elérési úttal megadva. Utána pontosvessző, majd szóköz nélkül következik a meghívott program php címe (www.xxx.hu), majd a többi átadandó paraméter.

internet        internet címet indítunk, program esetén pedig programot. sERPa-n belüli menüindításkor "menü"-t kell ebbe a szegmensbe írni.

internetcím        az internet oldal címe paraméterekkel

dosablak        0 | 1; ha 1, akkor látszik a dosablak

könyvtár        a parancs indítókönyvtára, üres is lehet

program        az elindítandó program paraméterekkel együtt

 

Az internetcím és a program a következő paramétereket is tartalmazhatja:

$SID$        generált session azonosító (FelhasznaloGuid táblába bekerülő azonosító, amelyet a másik alkalmazás kiolvashat titkos azonosítás céljából), ami a belépett felhasználóhoz köthető,

$YEAR$        a pénzügyi év, amelyben éppen tartózkodik a funkciót használó user (a pénzügyi év neve)

$DB$        adatbázis, amelyben éppen tartózkodik a felhasználó,

$ID$        kiválasztott rekord (amelyen áll a bevitel) jellemző ID-je, (Lekérdezésekben egy a lekérdezéstől függően meghatározott.)

$MODE$        a beviteli funkció milyen üzemmódban van (felvétel = "0", módosítás = "1", lekérdezés = "2")

 

A gomb megnyomásakor az átadott paraméterek a fentiek lehetnek - ha a szövegbe beírásra  kerülnek, azaz kéri őket az indítandó program -.

A paraméter változók $ jellel kezdődnek és $ jellel végződnek. A $...$ változókat a rendszer az értékükkel cseréli ki, és az így módosított szöveget adja tovább. Tehát a $MODE$ szöveget a hívó funkció üzemmódjának megfelelően 0-ra, 1-re vagy 2-re cseréli ki.

 

Külső programindítási példák:

Címke1;internet;http://Server/Akcio1.php?SID=$SID$&DataBase=$DB$&TszamID=$ID$

Címke2;program;0;c:\probakonyvtar;C:\PROGRA~1\MICROS~2\Office10\EXCEL.EXE proba.xls

Címke3;program;0;c:\ probakonyvtar;proba.xls

Címke4;program;0;;c:\ probakonyvtar\proba.xls

Címke5;program;1;c:\ probakonyvtar;dir

Címke6;program;1;;dir

 

Másik példa:

Progen;internet;www.progen.hu$YEAR$$MODE$$DB$$ID$$SID$bármiszöveg

ahol:

Progen a gomb neve

 

Az eredmény a következő:

http://www.progen.hu5módosításnm_3_1021{10a22072-9e3c-4604-a24c-6586fd076d1a}

ahol:

 

www.progen.hu        az elindított alkalmazás,

5        az a pénzügyi év ID, amelyben éppen van a user,

1        az üzemmód, amely üzemmódban volt a funkció, amikor megnyomásra került a gomb módosítás = 1

nm3_10        az adatbázis neve az sql-en,

21        a funkció jellemző rekordjának ID-je

{10a22072-9e3c-4604-a24c-6586fd076d1a}        a FelhasznaloGuid táblába a gombnyomáskor berakott azonosító a felhasználó azonosítására.

bármiszöveg        Bármilyen szöveg.

 

A példa természetesen nem hajt végre semmit sem, mert a ProgEn honlapja nem vár még további paramétereket, amelyekkel tovább dolgozna.

 

Funkciók, amelyekből működik a menüparaméter az elindított funkciónak történő paraméterátadással:

Témaszám, Személy

 

Belső menüindítási példa:

G. E.,85;menü;Művelet\Gazdasági esemény...

Ezt beírva a bankkivonat funkcióba a megjelenő gomb neve ez lesz: "G. E."

Ikonleíró: A 85-ös belső sorszámú ikonka képe fog megjelenni. Kihagyható a leírásból. Kihagyása esetén a NyomógombX paraméter sorszámát jelképező ikonka fog megjelenni.

A Gazdasági esemény művelet indul el.

Pontosvessző a szeparátor, kivéve a gombnév és az ikonleíró között, ahol vessző.

Fontos, hogy a menü (és az útvonal) karakterhelyesen legyen írva!!!

 

A belső (sERPa) funkcióindítás adatátadással is történhet. Ennek a leírása a Funkcióindítás adatátadással fejezetben került részletezésre.

 

 

IKONLEÍRÓ

Az Ikonleíró lehet egy sorszám, amivel a programba beépített gyorsgombok közül lehet választani.

pl.:

Termék,85;menü;Funkciók\Készlet\Termék

 

A 85 például egy nagyító.

Az Ikonleíró lehet egy *.ICO vagy egy *.BMP fájl neve is.

 

Termék,Grafika\mainicon.ico;menü;Funkciók\Készlet\Termék

Persze a sERPa indítóikont minek is tennénk rá a termékindításra. Ez is csak egy példa.

 

Ajánlott a 16 színű, 16x16-os felbontású grafika.

Átlátszó színt csak az ICO fájlban lehet megadni, ez átveszi a gomb színét.

 

A fájl útvonalának az összes terminálról elérhetőnek kell lennie. Ha az útvonal nem elérhető, illetve hibás fájlra mutat, akkor az alapértelmezett, sorszámos grafika fog látszódni.

 

FUNKCIÓINDÍTÁS ADATÁTADÁSSAL

Funkcióindítás az indító funkcióból az indítottba adatátadással.

 

Szintaxis

címke [, ikonleíró ]  ; funkció ; belépési pont [; paraméterek]

belépési pont = a funkcióbevitelben megadott belépési pont, modul.funkció

paraméterek = név=érték párok pontosvesszővel elválasztva

A nyomógombos paramétereknél $ jelekkel határoljuk azt a részt, amit a rendszer kicserél valamilyen értékkel.

 

A $SID$, $YEAR$, $DB$, $ID$, $MODE$ mintájára új sztring-behelyettesítéseket is meg lehet adni:

 

$ID$ = Az aktuális adat ID-je. A kontroltól függetlenül a bevitel fő ID-jét adja át.

$CTRLID$ = az aktív kontrollban szereplő ID

$CTRLID:Kontrollnév$ = a megadott nevű kontrollban szereplő ID

$CTRLTEXT$ = az aktív kontrollban szereplő szöveg

$CTRLTEXT:Kontrollnév$ = a megadott nevű kontrollban szereplő szöveg

$CTRLFORMULA$ = Az aktív kontrollban szereplő szöveg képletté alakítva.

$CTRLFORMULA:Kontrollnév$ = A megadott nevű kontrollban szereplő szöveg képletté alakítva. (Azért, hogy pl a Bevitelszűrés paraméternek ne adjunk át közvetlenül olyan kódot, ami képletkaraktert is tartalmaz.)

$SPEC:Azonosító$ = A megadott speciális azonosító alapján a hívó funkció által visszaadott szöveg. Pénztárnapló (lista) funkcióban kerül használatra.

$FILTEREDIDS$ = A bevitel szűrésének megfelelő ID-k XML-ben.

 

Az elindított funkció ugyanúgy megkapja a menüben megadott paramétereket, mint amikor kapcsolódó funkcióként indítottuk el. A rendszer a kacsolódó funkcióknál használt módon dönti el, hogy melyik menüpontból indítsa el a megadott funkciót.

 

A bevitelekben a Felvétel, Módosítás, Lekérdezés paramétereknek az egyik lehetséges értéke: Alapértelmezett. Ha az egyik üzemmódnál ez van beállítva, akkor nem az utoljára használt üzemmódban indul el az indított funkció, hanem a beállítottban. Így a nyomógombnál ezt kell beírni: Felvétel=Alapértelmezett

 

A keresőkontrolok kezdő értékének ID-t kell átadni, (Ezért nem jó a $CTRLTEXT$) azaz  $ID$ kell használni.

 

Példa1:

A vevő Folyószámla lekérdezés elindítása az scbUgyfelKod nevű kontrollból kiolvasott kóddal. (pl. Vevő rendelés funkcióból)

Folyószámla;funkció;szamla.folyoszamlalekerdezes;Analitika=Vevő;Ügyfélkód=$CTRLTEXT:scbUgyfelKod$

 

Példa2:

A Vevőszámla (bevitel) funkció elindítása felvétel üzemmódban az scbUgyfelKod nevű kontrollból kiolvasott kóddal. (pl. Vevő rendelés funkcióból)

Vevőszámla;funkció;szamla.vevosz;Számla fajta=Vevőszámla;Sorozatképlet=BV;Felvétel=Alapértelmezett;Ügyfélkód-képlet=$CTRLTEXT:scbUgyfelKod$

 

Példa3:

Pénztárbizonylat funkció elindítása vevő rendelés funkcióból ügyfél, dátum és pénztár átadással. Tegyük fel, hogy az ügynökeinknek saját pénztáruk van nálunk és az ügynökkód megegyezik az indítani szándékozott pénztár kódjával. A rendelés dátuma pedig adódjon át a felvétel üzemmódban induló pénztárbizonylatnak.

Beírandó paraméter érték:

Pénztár,145;funkció;penztar.penztarbiz;Felvétel=Alapértelmezett;Pénztárkód=$CTRLTEXT:scbUgynokKod$;Dátum=$CTRLTEXT:edDatum$;Ügyfélkód-képlet=$CTRLTEXT:scbUgyfelKod$

 

Útvonal

Az útvonal nagyon hasonlít a Menüponthoz, az útvonalnál is a grafikus menü útvonalát kell megadni. A menü nevét (sERPa\) el lehet hagyni. Annyiban különbözik a Menüpontban megadható beállítástól, hogy az útvonal paraméterezhető. Akkor hasznos, ha például egy automatikus listát szeretnénk elindítani nyomógombbal, és szeretnénk kezdő paramétert adni a listának.

 

Például: A szállítószámlából el szeretnénk indítani az Egyéb költség listát, és az alapbizonylatszám mezőt szeretnénk átadni, ilyenkor a beállítás a következő:

 

 

Kezdő érték adása más menüparaméterrel nem szabályozható mezőknek

Ha az indított funkció valamely mezőjének kezdő értékének szabályozására nincs bemenő menüparaméter, akkor ezeknek a mezőknek a Kezdő érték menüparaméter-en keresztül a Kezdő érték=... szintaxissal lehet akár adatot átadva kezdő értéket adni itt a Nyomógomb menüparaméterben.

Példák:

Vevő rendelésből indított Pénztárbizonylat fejléc összeg mezőjének adjuk át a vevő rendelés bruttó összeg mezőjének értékét:

Pénztár;funkció;penztar.penztarbiz;Kezdőérték=Vegosszeg=$CTRLTEXT:AruforgBizOsszesitoForm.edBrutto$

Ha lenne a rendelés fejlécében BruttoOsszeg mező, akkor nem kellene a bizonylatösszesítő form ablaknevét elé írni itt a szintaxisban.

 

Példa:

Pénztárnapló (lista) funkció elindítása a pénztárbizonylat funkcióból a bizonylatdátum alapján a dátumtartomány kitöltésével, valamint a pénztárkód átadásával:

Napló nyomtatás;funkció;penztar.penztarnaplo;Kezdőérték=ebDatumTol=$CTRLTEXT:Datum$;Kezdőérték=ebDatumIg=$CTRLTEXT:Datum$;Pénztárkód=$SPEC:Pénztárkód$

 

 

A nyomógomb paraméterezése kiegészítésre került úgy, hogy a paraméterekben érték mellett szöveges értéket is meg lehet adni. Az értéket és a szöveges értéket kettőspont ":" választja el. Így a lehetőségek a következők: név=érték, név=szöveges_érték vagy név=érték:szöveges_érték.

 

Példa:

Pénztár;funkció;penztar.penztarbiz;Kezdőérték=Vegosszeg=$CTRLTEXT:BruttoErtek$;Mező-engedélyezés=Nem írható:Vegosszeg

A „Nem írható” értéknek „Vegosszeg” szöveges értéket állít be. Tehát a kezdő érték beállításán kívül a mezőt módosíthatatlanná is tesszük.

 

Sajnos ez a megoldás nem működik teljesen általánosan. A pénztárbizonylatban le kellett tiltani a végösszeg ajánlását, ha be van rá állítva Kezdő érték paraméter.

 

Ha a nyomógombnál több kezdő értéket is fel akarunk sorolni, akkor a Kezdő érték paramétert többször ki kell írni és nem használhatjuk a fent leírt pontosvesszős elválasztást.

 

Helyes:

Pénztár;funkció;penztar.penztarbiz;Kezdőérték=Vegosszeg=$CTRLTEXT:BruttoErtek$;Kezdőérték=Datum=$CTRLTEXT:SzamlaDatum$;Mező-engedélyezés=Nem írható:Vegosszeg,Datum

 

Helytelen:

Pénztár;funkció;penztar.penztarbiz;Kezdőérték=Vegosszeg=$CTRLTEXT:BruttoErtek$;Datum=$CTRLTEXT:SzamlaDatum$;Mező-engedélyezés=Nem írható:Vegosszeg,Datum

 

Ez azért van, mert pontosvesszővel választjuk el az egyes paramétereket is.

Ez itt most nem okoz kikerülhetetlen akadályt, mert megoldásra került, hogy a Kezdő értékből több paramétert is meg lehessen adni. De más paraméternél, ahol szintén pontosvesszős elválasztást használunk, ez gondot okozhat. Ahhoz, hogy a pontosvesszős felsorolást megengedjük, a nyomógombos paraméterek között ki kell cserélni a pontosvesszőt valami másra, mondjuk # jelre:

 

Pénztár;funkció;penztar.penztarbiz;Kezdőérték=Vegosszeg=$CTRLTEXT:BruttoErtek$;Datum=$CTRLTEXT:SzamlaDatum$#Mező-engedélyezés=Nem írható:Vegosszeg,Datum

 

Példa:

Ezt bemásolva a pénztárbizonylat tétel típus és az irány is kezdő értéket fog kapni:

Pénztár,145;funkció;penztar.penztarbiz;Felvétel=Alapértelmezett;Pénztárkód=$CTRLTEXT:scbUgynokKod$;Dátum=$CTRLTEXT:edDatum$;Ügyfélkód-képlet=$CTRLTEXT:scbUgyfelKod$;Kezdőérték=Tipus1=Egyszerű számla;Kezdőérték=Vegosszeg=$CTRLTEXT:AruforgBizOsszesitoForm.edBrutto$;Kezdőérték=Irany=Bevétel

 

Ha pedig ezt másoljuk be, akkor az irány és a Tételtípus nem is lesz módosítható:

Pénztár,145;funkció;penztar.penztarbiz;Felvétel=Alapértelmezett;Pénztárkód=$CTRLTEXT:scbUgynokKod$;Dátum=$CTRLTEXT:edDatum$;Ügyfélkód-képlet=$CTRLTEXT:scbUgyfelKod$;Kezdőérték=Tipus1=Egyszerű számla;Kezdőérték=Vegosszeg=$CTRLTEXT:AruforgBizOsszesitoForm.edBrutto$;Kezdőérték=Irany=Bevétel;Mező-engedélyezés=Nem írható:Irany,Tipus1

 

Példa:

Akta funkcióból Esemény és bizonylatlekérdezés funkció elindítása az ügyfél átadásával a párbeszédablakra:

Eseménylekérdezés;funkció;esemenykezeles.esemenybizonylatlek;Bevitelszűrés=Ügyfélkód:$CTRLFORMULA:scbUgyfelKod$

 

Példa:

Vevőrendelés funkcióból az adatbázisba lementett script megnyitása és termék átadása a párbeszédablakra:

;funkció;Rendszer.SQLSzkriptFuttatas;Paraméterváltozat=111026;Kezdőérték=SQLSzkriptFuttatasForm.scbTermekKod1=$CTRLID:VevoRendForm.scbTermekKod$

 

Példa:

Irat funkcióból Eseménykezelés Akta funkcióba egy bizonylatra szűrés, iratban található pozíciószám szerint.

Nyomógomb1 [Érték] text = ;funkció;esemenykezeles.akta;Bizonylatszám=$CTRLTEXT:scbPSzamKod$

 

Példa:

Ügyféltörzsből indítani a Google Maps internetes útvonaltervezőt, beírni az ügyfél általános fülén levő cím adatát a B ponthoz:

http://www.google.com/maps?f=d&source=s_d&saddr=&daddr=$CTRLTEXT:Iranyitoszam$+,+$CTRLTEXT:Helyseg$+,+$CTRLTEXT:edCim$+,+$CTRLTEXT:Orszag$

ha csak keresni akarunk akkor elég: http://maps.google.hu/?q=$CTRLTEXT:Iranyitoszam$+,+$CTRLTEXT:Helyseg$+,+$CTRLTEXT:edCim$+,+$CTRLTEXT:Orszag$

Példa:

Vevőszámla bevitelből az Adatexport funkció elindítása a számla dátumának átadásával az exportálási tól / ig dátumtartományba:

Számla exportálás;funkció;rendszer.adatexport;Kezdőérték=EdDatumTol=$CTRLTEXT:SzamlaDatum$;Kezdőérték=EdDatumIg=$CTRLTEXT:SzamlaDatum$

Ha közben az Adatexport funkcióban paramétermentéssel elmentettük a Számla listaként történő exportálási lehetőséget és ezt a Paraméter változat menüparaméterrel befixáltuk, majd a Paraméter változatban módosítható mezők menüparaméterrel megengedtük a dátumtartomány kézi kitöltését, akkor a következő működést tudjuk elérni:

A sERPába felvett vevőszámlákat a felvétel után kitehetjük XML-be egy fix helyre, ahonnan egy másik program tovább használhatja az adatokat. Az egyszer számla bizonylat típussal kiexportált vevőszámlák nyomtatott státust kapnak, így a legközelebbi aznapi exportáláskor már nem fognak átadásra kerülni.

Példa (Művelet nyomógombbal indítására a funkción belül)

Például a Számlaösszesítő ablak nyomógombbal történő ki-be kapcsolgatása a vevőszámla bevitelben.

Művelet keretben válasszuk a Menüpont (radio gombot), Írjuk be karakterhelyesen, hogy Műveletek\Számlaösszesítő

(+A Felirat mezőben adjunk a gombnak nevet.)

 

Vevőrendelésből Kiskereskedelmi-számlázás funkciónak átadni a rendelésszámot a megjelenítés sávba, és az ügyfelet átadni, mint kezdő érték az ablaknak:

Nyomógomb1 [Érték] text = ;funkció;kiskerszamla.kiskersz;Kezdőérték=KiskerSzParbeszedForm.scbRendeles=$ID$;Kezdőérték=KiskerSzParbeszedForm.scbUgyfelKod=$CTRLID:scbUgyfelKod$

 

Vevőrendelésből Pozíciószám funkcióba felvétel üzemmódba indítva, és a kód, név mezőbe a rendelésszám átadva:

Nyomógomb1 [Érték] text = Pszam;funkció;struktura.pszam;Felvétel=Alapértelmezett;Kezdőérték=Kod=$CTRLTEXT:edIktatoszam$;Kezdőérték=Nev=$CTRLTEXT:edIktatoszam$

 

pl: Szállítólevél, Vevő rendelés, Szállító rendelés funkcióban négy hasznos nyomógomb, termékkód átadással (Készlet, Karton, Bővített készlet, Bővített karton).

Szállítólevél funkcióra:

Készlet;funkció;keszlet.keszletlekerdezes;Kezdőérték=KeszletLekerdezesParForm.scbTermekKod=$CTRLID:SzLevelForm.scbTermekKod$

Karton;funkció;keszlet.keszletkartonlekerdezes;Kezdőérték=KeszletKartonLekerdezesParForm.scbTermekKod=$CTRLID:SzLevelForm.scbTermekKod$

Bővített karton;funkció;aruforgalom.bovitettkartonlekerdezes;Kezdőérték=bovitettkartonlekerdezesParForm.scbTermekKod=$CTRLID:SzLevelForm.scbTermekKod$

Bővített készlet;funkció;aruforgalom.bovitettkeszletlekerdezes;Kezdőérték=bovitettkeszletlekerdezesParForm.scbTermekKod=$CTRLID:SzLevelForm.scbTermekKod$

 

Ajánlat, Vevő rendelés, Szállító rendelés funkciókra:

Készlet;funkció;keszlet.keszletlekerdezes;Kezdőérték=KeszletLekerdezesParForm.scbTermekKod=$CTRLID:scbTermekKod$

(

Ha a készlet lekérdezés párbeszédablakát meg sem szeretnénk jeleníteni, akkor építsük bele a "Párbeszédablak megjelenítése" menüparaméter átadását is:

Készlet;funkció;keszlet.keszletlekerdezes;Kezdőérték=KeszletLekerdezesParForm.scbTermekKod=$CTRLID:scbTermekKod$;Párbeszédablak megjelenítése = Tiltott

)

Bővített karton;funkció;aruforgalom.bovitettkartonlekerdezes;Kezdőérték=BovitettKartonLekerdezesParForm.scbTermekKod=$CTRLID:scbTermekKod$

Karton;funkció;keszlet.keszletkartonlekerdezes;Kezdőérték=KeszletKartonLekerdezesParForm.scbTermekKod=$CTRLID:scbTermekKod$

Bővített készlet;funkció;aruforgalom.bovitettkeszletlekerdezes;Kezdőérték=BovitettKeszletLekerdezesParForm.scbTermekKod=$CTRLID:scbTermekKod$

 

Script futtatóban paraméterben lementett KiszallitasTuratervCim.sql script meghívása és a turaterv ID átadása:

;funkció;Rendszer.SQLSzkriptFuttatas;Paraméterváltozat=CIM2;Paraméterváltozatban módosítható mezők=Összes, kivéve;Kezdőérték=SQLSzkriptFuttatasForm.ed1=$ID$

Ahol a paraméter mentés neve a CIM2.

Alkalmazó funkciók