Kapcsolódó információk:
Paraméterezési útmutatók

Összehasonlított verziók

Kulcs

  • Beillesztett sor.
  • Törölt sor.
  • Formázás megváltoztatva.

...

Tartalomjegyzék

Qsboxfigyelem

A függvénycsomag a Firebird SQL adatbázis eléréshez használt provider komponens miatt csak a 32 bites Excel verziókat támogatjaAz SUPXlsFunc.NET függvénycsomag bővítményként hozzáadható 32 és 64 bites Excel verzióhoz is. Csatolás előtt ellenőrizni szükséges, hogy az adott gépen az Excel mely verziója van feltelepítve. Az Excel verziója az Excelben a  File | Fiók | Excel névjegye menüpontban felugró ablak első sorában található. Rossz verzió hozzáadása esetén érvényességi hibaüzenet jelenik meg.

A SUP® Integrált Számviteli Rendszerhez készített Excel kiegészítő függvénycsomag az Excel 2000 (9.0) verziótól kezdve használható. Segítségével szinte mindenre lehetőség van, amelyhez a SUP® rendszerből kapott számadatok szolgáltatják, adják az alapinformációt.

Példa:
Lehetőség van több, külön álló adatbázisból, - azaz könyvelt cégből - egy táblázatba az adatokat kigyűjteni, így több év, több hónap adatait egymáshoz viszonyítani, - bázis-terv-tény adatok összevetésére alkalmazható, ezáltal grafikonok, diagrammok is készíthetők.

A SUP függvénycsomag telepítését hálózatos környezet esetén is azon a számítógépen (kliens) kell elvégezni, ahol az Microsoft Excel telepítve van. A SUP_XLS_NET_Setup.exe-t (az Excelhez hasonlóan) minden kliensre fel kell telepíteni, ahol a későbbiekben a függvénycsomag használatba kerül.Több gép esetén figyelni kell arra, hogy - telepítés során - a könyvtár hivatkozások ugyanazok legyenek!sem szabad hálózati meghajtóra telepíteni és onnan használni a bővítményt.

Az Excelhez készült kiegészítő függvények egységesen a SUPxxxx(....) előtaggal kezdődnek és az Excelben a Felhasználói függvények SUP Excel függvénycsomag (.NET) függvénykategória függvényei között találhatók meg.

A függvények minden esetben egy cellányi információt adnak vissza!!!

 

Függvényeknél megadható paraméterek általános értelmezése

MezőMező magyarázata

<AsCegKod>

Meghatározza, hogy melyik adatbázisból kell az adatokat lekérdezni. A cégkódok a SUP rendszer Szerviz | Könyvelt cégek menüpontjából olvasható ki.
Az Excel táblában egy cellahivatkozást érdemes átadni paraméterként, így ha a cella értékét átírjuk egy másik cégre, nem kell az egész táblázatot végigjavítani a cégkód miatt.
Megadása MINDIG kötelező.

<AiRecalc>

A paraméter az újraszámítást vezérli. Egy táblázat elkészítését-szerkesztését esetenként nagyon lelassítaná, ha minden beírt függvény azonnal kiszámításra kerülne, ezért célszerű alkalmazni. (A régebbi Excel verziókban ki lehetett kapcsolni az automatikus újraszámítást.)
Az Excel táblában egy cellahivatkozást érdemes átadni paraméterként, mellyel az újraszámítást vezérelhetjük.
Ha a paraméter értéke 0, nem számol újra, ha a paraméter értéke 1, újraszámol.
Megadása MINDIG kötelező.

<AsFokszam>
[AsFokszam]

 

A paraméterben meghatározott főkönyvi szám valamilyen adatát kell lekérdezni. Az értékkel visszatérő függvényeknél joker (*,%) karakter is használható.
Ha a paraméterlistában a főkönyvi szám < > jelek között van, megadása kötelező, ha [ ] jelek között van üres string ( ”” ) is megadható.

<AsGyCsop>
[AsGyCsop]

Gyűjtő csoport kódja. A paraméterben meghatározott gyűjtőcsoport valamilyen adatát kell lekérdezni. Ha a paraméterlistában a gyűjtőcsoport <> jelek között van, megadása kötelező, ha [ ] jelek között van üres string ( ”” ) is megadható. A gyűjtőcsoport kódjában nem alkalmazható joker karakter.

<AsGyazon>
[AsGyazon]

Gyűjtő azonosító kódja. A paraméterben meghatározott gyűjtőazonosító valamilyen adatát kell lekérdezni. Ha a paraméterlistában a gyűjtőazonosító <> jelek között van, megadása kötelező, ha   jelek között van üres string ( ”” ) is megadható. A gyűjtőazonosító kódjában nem alkalmazható joker karakter.

<AsIdoszakTol>

<AsIdoszakIg>

A lekérdezés könyvelési időszaka ”éééé.hh.nn.” formátumban.
Megadása MINDIG kötelező!

<AsKartonSzam>

Tárgyi eszköz karton száma. A paraméterben meghatározott tárgyi eszköz karton valamilyen adatát kell lekérdezni. A kartonszámban nem alkalmazható joker karakter.
Megadása mindig kötelező.

<AsSzemlelet>

Tárgyi eszköz ÉCS leírásának szemlélete.
Lehetséges értékei:
                ”SZ” – Számviteli
                ”AT” – Adótörvény szerinti
                ”E1” – Egyéb 1
                ”E2” – Egyéb 2
Megadása mindig kötelező.

<AsBEN>

Tárgyi eszköz Bruttó / ÉCS / Nettó értékének lekérdezése.
Lehetséges értékei:
                ”B” – Bruttó
                ”E” – ÉCS
                ”N” – Nettó
Megadása mindig kötelező.

<AiIrany>

A tárgyi eszköz mozgásneme által meghatározott mozgási irányt jelenti.
Lehetséges értékei:
                  1 – mozgásnem jellegétől függően pozitív irányú mozgások, pl. aktiválás
                 -1 – mozgásnem jellegétől függően negatív irányú mozgások, pl. értékesítés, selejtezés
                  0 – Nincs korlátozás, a mozgásnem jellegétől függetlenül minden mozgást figyelembe vesz. (A mozgások értékének egyenlegét adja vissza.)
A paraméter elhagyható, ilyenkor értéke 0.

Qsboxmegjegyz

A könyvelési egyenleg kiszámítása a 0-4 számlaosztályban T-K, az 5-9 számlaosztályban K-T módon történik.

 

Főkönyvi modul függvényei

Rögzítés
SUPFokszMegnev
SUPFokszMegnev

  • SUPFokszMegnev - <AsCegKod>, <AiRecalc>, <AsFokszam>, [AsNyelv]
    A paraméterként átadott főkönyvi szám megnevezését adja vissza. Ha a főkönyvi szám joker karaktert tartalmaz, akkor a joker karakter nélküli főkönyvi szám nevét adja vissza. Pl.: 51* esetén 51 - Anyagjellegű ráfordítások

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    [AsNyelv]

    A paraméter megadása opcionális. A paramétert megadva a következő értékeket adja vissza:

                    0 – magyar nyelvű megnevezést

                    1 – az első idegen nyelvű megnevezést

                    2 – a második idegen nyelvű megnevezést adja vissza

    Példa

    SUPFokszMegnev( ”DEMO”; 1; ”911” )

    A DEMO cég 911-es főkönyvi számának magyar nyelvű megnevezését adja vissza.



    Rögzítés
    SUPFokszIdg
    SUPFokszIdg

  • SUPFokszIdg - <AsCegKod>, <AiRecalc>, <AsFokszam>
    A paraméterként átadott (MAGYAR) főkönyvi szám idegen struktúra szerinti számlatükör főkönyvi számát adja vissza. Ha a A főkönyvi szám joker karaktert tartalmaz, a program ezt nem veszi figyelembenem tartalmazhat.

    Példa

    SUPFokszIdg( ”DEMO”; 1; ”522” )

    A DEMO cég 522-es (magyar) főkönyvi szám idegen struktúra szerinti főkönyvi számát adja vissza.

    Rögzítés
    SUPFokszIdgMegnev
    SUPFokszIdgMegnev

  • SUPFokszIdgMegnev - <AsCegKod>, <AiRecalc>, <AsIdgFokszam>
    A paraméterként átadott idegen struktúra szerinti számlatükörben tárolt főkönyvi szám megnevezését adja vissza. Ha a A főkönyvi szám joker karaktert tartalmaz, a program ezt nem veszi figyelembenem tartalmazhat.

    Példa

    SUPFokszIdgMegnev( ”DEMO”; 1; ”6210” )

    A DEMO cég 6210-es idegen struktúra szerinti főkönyvi számának megnevezését adja vissza.

     

    Rögzítés
    SUPFokszEgy
    SUPFokszEgy

  • SUPFokszEgy - <AsCegKod>, <AiRecalc>, <AsFokszamList>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterként átadott főkönyvi szám lista egyenlegének előjeles értékét adja vissza, a paraméterként átadott időszak szerint. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat. A könyvelési egyenleg kiszámítása a 0-4 számlaosztályban T-K, az 5-9 számlaosztályban K-T módon történik.

    Példa

    SUPFokszEgy(”DEMO”; 1, ”91*”; ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 91 kezdetű főkönyvi számainak egyenlegét adja.

     

    Rögzítés
    SUPFokszEgyDev
    SUPFokszEgyDev

  • SUPFokszEgyDev - <AsCegKod>, <AiRecalc>, <AsFokszamList>, <AsDevnem>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterként átadott főkönyvi szám lista egyenlegének előjeles értéket adja vissza, a paraméterként átadott időszak szerint. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat.
    A könyvelési egyenleg kiszámítása a 0-4 számlaosztályban T-K, az 5-9 számlaosztályban K-T módon történik.

    Példa

    SUPFokszEgy(”DEMO”; 1, ”91*”; ””; ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 91 kezdetű főkönyvi számainak egyenlegét adja.

     

    Rögzítés
    SUPFokszForg
    SUPFokszForg

  • SUPFokszForg - <AsCegKod>, <AiRecalc>, <AsFokszamList>, <AsTK>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterként átadott főkönyvi szám lista tartozik ill. követel forgalmának értéket adja vissza a paraméterként átadott időszak szerint. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsTK>

    ”T” – a tartozik forgalmi értéket ad vissza

    ”K” – a követel forgalmi értéket ad vissza

    A paraméter megadása kötelező!

    Példa

    SUPFokszForg(”DEMO”; 1, ”91*”; ”T” ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 91 kezdetű főkönyvi számainak tartozik összesen forgalmi értékét adja.

     

    Rögzítés
    SUPFokszForgDev
    SUPFokszForgDev

  • SUPFokszForgDev - <AsCegKod>, <AiRecalc>, <AsFokszamList>, <AsDevnem>, <AsTK>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterként átadott főkönyvi szám lista tartozik ill. követel deviza forgalmának értéket adja vissza a paraméterként átadott időszak szerint. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsTK>

    ”T” – a tartozik forgalmi értéket ad vissza

    ”K” – a követel forgalmi értéket ad vissza

    A paraméter megadása kötelező!

    Példa

    SUPFokszForgDev(”DEMO”; 1, ”91*”; ”EUR”; ”T” ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 91 kezdetű főkönyvi számainak tartozik összesen forgalmi értékét adja

     

    Rögzítés
    SUPEgyenlegT
    SUPEgyenlegT

  • SUPEgyenlegT - <AdTert>, <AdKert>

    A paraméterként megadott értékek tartozik egyenlegét adja. A visszakapott érték, tartozik egyenleg esetén T-K érték, követel egyenleg esetén üres cella (nem nulla!).

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AdTert>Tartozik érték
    <AdKert>Követel érték
    Példa - <AdTert>

    SUPEgyenlegT(152369;150123)

    A visszaadott érték 2246, mert Tartozik az egyenleg.

    Példa - <AdKert>

    SUPEgyenlegT(150123;152369)

    A visszaadott érték üres cella, mert Követel az egyenleg.

     

    Rögzítés
    SUPEgyenlegK
    SUPEgyenlegK

  • SUPEgyenlegK - <AdTert>, <AdKert>

    A paraméterként megadott érték követel egyenlegét adja. A visszakapott érték, követel egyenleg esetén K-T érték, tartozik egyenleg esetén üres cella (nem nulla!).

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AdTert>Tartozik érték
    <AdKert>Követel érték
    Példa - <AdTert>

    SUPEgyenlegT(152369;150123)

    A visszaadott érték 2246, mert Tartozik az egyenleg.

    Példa - <AdKert>

    SUPEgyenlegT(150123;152369)

    A visszaadott érték üres cella, mert Követel az egyenleg.

     

    Rögzítés
    SUPAFAEgy
    SUPAFAEgy

  • SUPAFAEgy - <AsCegKod>, <AiRecalc>, <AsFokszam>, <AsAFAKod>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterben meghatározott ÁFA főkönyvi szám adott ÁFA kódú tételeinek előjeles egyenlegét adja vissza a paraméterként átadott időszak szerint. Az ÁFA főkönyvi szám és az ÁFA kód utolsó jegye joker karaktert (*,%) is tartalmazhat.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsAFAKod>

    A SUP-ban meghatározott ÁFA kód. Pl.:2 – 27%-os ÁFA.

    A paraméter megadása kötelező. A paraméter joker karakter (*) is lehet, ez az összes ÁFA kódot jelenti.

    Példa

    SUPAFAEgy(”DEMO”; 1, ”467*”;”2”; ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 467*-es főkönyvi szám 27%-os ÁFA kódú tételek adott időszaki ÁFA egyenlegét adja.

     

    Rögzítés
    SUPAFAForg
    SUPAFAForg

  • SUPAFAForg - <AsCegKod>, <AiRecalc>, <AsFokszam>, <AsAFAKod>, <AsIdoszakTol>, <AsIdoszakIg>, <AsT_K>
    A paraméterben meghatározott ÁFA főkönyvi szám adott ÁFA kódú tételeinek előjeles tartozik, ill. követel összesen forgalmi értékét adja vissza a paraméterként átadott időszak szerint. Az ÁFA főkönyvi szám és az ÁFA kód utolsó jegye joker karaktert (*,%) is tartalmazhat.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsAFAKod>

    A SUP-ban meghatározott ÁFA kód. Pl.:2 – 27%-os ÁFA.

    A paraméter megadása kötelező. A paraméter joker karakter (*) is lehet, ez az összes ÁFA kódot jelenti.

    <AsT_K>

    ”T” – a tartozik forgalmi értéket ad vissza

    ”K” – a követel forgalmi értéket ad vissza

    A paraméter megadása kötelező.

    Példa

    SUPAFAForg(”DEMO”; 1, ”467*”;”*”; ”2013.01.01.”; ”2013.12.31.”; ”T”)

    A DEMO cég 467*-es főkönyvi szám adott időszaki ÁFA értékek tartozik összesen forgalmi értékét adja.

     

    Rögzítés
    SUPGyCsopMegnev
    SUPGyCsopMegnev

  • SUPGyCsopMegnev - <AsCegkod>, <AiRecalc>, <AsGyCsop>
    A paraméterben meghatározott kódú gyűjtőcsoport megnevezését adja vissza.

    Példa

    SUPGyCsopMegnev(”DEMO”; 1, ”0010”)

    A DEMO cég ”0010”-es gyűjtőcsoportjának nevét adja vissza, pl.: Költséghely

     

    Rögzítés
    SUPGyujtoMegnev
    SUPGyujtoMegnev

  • SUPGyujtoMegnev - <AsCegKod>, <AiRecalc>, <AsGyCsop>, <AsGyazon>
    A paraméterben meghatározott kódú gyűjtő azonosító megnevezését adja vissza.

    Példa

    SUPGyujtoMegnev(”DEMO”; 1, ”0010”; ”01”)

    A DEMO cég ”0010”-es gyűjtőcsoportjába tartozó ”01” kódú gyűjtő azonosító nevét adja vissza, pl.: Szerviz

     

    Rögzítés
    SUPGyujtoEgy
    SUPGyujtoEgy

  • SUPGyujtoEgy - <AsCegKod>, <AiRecalc>, <AsGyCsop>, <AsGyazon>, [AsFokszam], <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterben meghatározott gyűjtőcsoport, gyűjtőazonosítójához tartozó, a megadott időszakra vonatkozó előjeles egyenlegét adja vissza. Lehetőség van főkönyvi számra is szűkíteni. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat.

    Példa

    SUPGyujtoEgy(”DEMO”; 1, ”0010”; ”01”; ”5211”; ”2013.01.01”; ”2013.12.31”)

    A DEMO cég ”0001”-es gyűjtőcsoport, ”01”-es gyűjtőazonosító ”5211” főkönyvi számának előjeles egyenlegét adja vissza.

     

    Rögzítés
    SUPGyujtoForg
    SUPGyujtoForg

  • SUPGyujtoForg - <AsCegKod>, <AiRecalc>, <AsGyCsop>, <AsGyazon>, [AsFokszam], <AsT_K>, <AsIdoszakTol>, <AsIdoszakIg>
    A paraméterben meghatározott gyűjtőcsoport, gyűjtőazonosítójához tartozó, a megadott időszakra vonatkozó előjeles tartozik, ill. követel forgalmi értéket adja vissza. Lehetőség van főkönyvi számra is szűkíteni. A főkönyvi szám utolsó jegye joker karaktert (*,%) is tartalmazhat.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsT_K>

    A paraméter megadása kötelező.

    ”T” – a tartozik forgalmi értéket ad vissza

    ”K” – a követel forgalmi értéket ad vissza

    Példa

    SUPGyujtoForg(”DEMO”; 1, ”0010”; ”01”; ”5211”; ”T”; ”2013.01.01”;”2013.12.31”)

    A DEMO cég ”0001”-es gyűjtőcsoport, ”01”-es gyűjtőazonosító ”5211” főkönyvi számának előjeles tartozik forgalmát adja vissza.

     

    Rögzítés
    SUPFkEgy
    SUPFkEgy

  • SUPFkEgy - <AsCegKod>, <AiRecalc>, [AsFokszam], [AsPFolysz], [AsRFolysz], [AsGyCsop1], [AsGyazon1], [AsGyCsop2], [AsGyazon2], [AsGyCsop3], [AsGyazon3], [AsGyCsop4], [AsGyazon4], [AsNaplosz], <AsIdoszakTol>, <AsIdoszakIg>
    Univerzális függvény, amellyel főkönyvi számla, folyószámla (részletező, partner), naplók és gyűjtők adott időszaki előjeles egyenlegét tudjuk lekérdezni. A paramétereket együttesen alkalmazva akár gyűjtő-gyűjtő kimutatást is készíthetünk főkönyvi szám, esetleg folyószámla bontásban. Korlátokat csak a SUP paraméterezése jelent.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    <AsPFolysz>Partner kódja, utolsó jegye joker karaktert (*) is tartalmazhat.
    <AsRFolysz>Részletező számla kódja, utolsó jegye joker karaktert (*) is tartalmazhat. Csak főkönyvi számmal együtt adható meg.
    <AsGyazonx>Gyűjtőazonosító kódja, utolsó jegye joker karaktert (*) is tartalmazhat.
    <AsNaplosz>Napló száma, utolsó jegye joker karaktert (*) is tartalmazhat.
    Példa

    SUPFkEgy(”DEMO”; 1, ”5111”;;; ”0001”; ”01”;;;;;;; ”301”; ”2013.01.01.”;”2013.12.31.”)

    A DEMO cég 0001-es gyűjtőcsoport 01-es azonosítójához tartozó 5111-es főkönyvi számának 301-es naplóban lévő tételértékeinek előjeles egyenlegét adja az adott időszakban.

     

    Rögzítés
    SUPFkForg
    SUPFkForg

  • SUPFkForg - <AsCegKod>, <AiRecalc>, <AsTK>, [AsFokszam], [AsPFolysz], [AsRFolysz], [AsGyCsop1], [AsGyazon1], [AsGyCsop2], [AsGyazon2], [AsGyCsop3], [AsGyazon3], [AsGyCsop4], [AsGyazon4], [AsNaplosz], <AsIdoszakTol>, <AsIdoszakIg>
    Univerzális függvény, amellyel főkönyvi számla, folyószámla (részletező, partner), naplók és gyűjtők adott időszaki forgalmát tudjuk lekérdezni. A paramétereket együttesen alkalmazva akár gyűjtő-gyűjtő kimutatást is készíthetünk főkönyvi szám, esetleg folyószámla bontásban. Korlátokat csak a SUP paraméterezése jelent.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    [AsPFolysz]Partner kódja, utolsó jegye joker karaktert (*) is tartalmazhat.
    [AsRFolysz]Részletező számla kódja, utolsó jegye joker karaktert (*) is tartalmazhat. Csak főkönyvi számmal együtt adható meg.
    [AsGyazonx]Gyűjtőazonosító kódja, utolsó jegye joker karaktert (*) is tartalmazhat.
    [AsNaplosz]Napló száma, utolsó jegye joker karaktert (*) is tartalmazhat.
    <AsTK>

    ”T” – tartozik forgalmi értéket ad vissza

    ”K” – követel forgalmi értéket ad vissza

    A paraméter megadása kötelező.

    Példa

    SUPFkForg(”DEMO”; 1,”T” ”311”; ”001”;;;;;;;;;; ”2013.01.01.”; ”2013.12.31.”)

    A DEMO cég 311-es főkönyvi szám 001-es folyószámlájának tartozik forgalmának értékét adja az adott időszakban.

    Qsboxmegjegyz

    A SUPFkEgy() és SUPFkForg() függvényekkel lehet Önelszámoló egységenkénti kimutatást készíteni. Az önelszámoló egységek "normál" gyűjtőként kérdezhetők le a AsGyCsop1, AsGyazon1 paraméterek megadásával.

     

    Rögzítés
    SUPPartnerMegnev
    SUPPartnerMegnev

  • SUPPartnerMegnev - <AsCegKod>, <AiRecalc>, <AsPartner>
    A paraméterként megadott partnerkódhoz tartozó partner rövid nevét adja vissza.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    [AsPartner]A partner kódja.
    Példa

    SUPPartnerMegnev( ”DEMO”; 1; ”001” )

    A DEMO cég 001-es partnerének rövid nevét adja vissza (Hungarocamion Rt.).

     

    Rögzítés
    SUPReszlMegnev
    SUPReszlMegnev

  • SUPReszlMegnev - <AsCegKod>, <AiRecalc>, <AsFokszam>, <AsReszl>
    A paraméterként megadott főkönyvi számhoz tartozó részletező folyószámla megnevezését adja vissza.

    A paraméterek általános értelmezésénél nem szereplő paraméterek
    [AsReszl]A részletező folyószámla kódja.
    Példa

    SUPReszlMegnev( ”DEMO”; 1; ”36111”;”01” )

    A DEMO cég 36111-es részletező főkönyvi szám 01-es folyószámlájának megnevezését adja vissza (Kiss Lajos).



...

Közvetlen SQL parancsot futtató függvény

Rögzítés
SUPSQLDirect
SUPSQLDirect

SUPSQLDirect - <AsCegkod>, <AiRecalc>, <AsSQL>, <AiMaxRows>, <AiMaxColumns>, <AiHeaders>
Univerzális függvény, amely egy vagy több cellányi értéket ad vissza. Alkalmazását csak azoknak ajánljuk, akik SQL lekérdezést tudnak összeállítani.
Több cellányi információhoz csak úgy juthatunk, ha a függvény megszerkesztése után [Ctrl-Shift-Enter]-rel hagyjuk jóvá a függvényt. Csak Enter lenyomásával egy cellányi információt kapunk!

A paraméterek általános értelmezésénél nem szereplő paraméterek
<AsSQL>SQL lekérdezés
<AiMaxRows>A visszaadott sorok számának maximuma. Ha 0, akkor a kijelölt területet veszi figyelembe.
<AiMaxColumns>A visszaadott oszlopok számának maximuma. Ha 0, akkor a kijelölt területet veszi figyelembe.
<AiHeaders>

Értéke lehet:

       1 – a lekérdezés mezőinek megnevezését (oszlopnevek) adja vissza

       0 – esetén csak adatokat kapunk oszlopnevek nélkül.

Példa

SUPSQLDirect(”DEMO”; 1; ”SELECT fokszam, megnev FROM vt_szlator WHERE tipus ='K' AND fokszam LIKE ’5%’ ORDER BY fokszam”; 0; 0; 0)

A DEMO cég 5-ös könyvelési főkönyvi számláinak számát és megnevezését adja főkönyvi szám sorrendben.

...

 

Adatbázis információt adó függvény

Rögzítés
SUPXlsInfo
SUPXlsInfo

  • SUPXlsInfo - <AsCegkod>, <AiRecalc>
    A függvény 1 cellában adja vissza az XlsFuncs.NET függvénycsomag verziószámát, a Cégkódhoz tartozó cég adataiból a Könyvelt cég nevét, az Adatbázis file nevét, illetve az adatbázis Verziószámát.

    Példa

    SUPXlsInfo(”DEMO”; 1)

    A DEMO cégkódú cég esetén a visszakapott érték:
    SUPXlsFuncs.NET A15.1 2018.03.28. - [Cég]: DEMO - DEMO Kft. [Adatbázis]: FB2_Demo2018.fdb [Verzió]: A015-P001

    Hiba esetén a visszatérési értékek lehetnek:

    • Nem létező cégkód megadása esetén: SUPXlsFuncs.NET A15.1 2018.03.28. - Nincs ilyen cég. Cégkód: DEMO

    • Licence hiánya esetén: SUPXlsFuncs.NET A15.1 2018.03.28. - A SUPXlsFuncs modul nincs licence-elve!

    • Nem tud csatlakozni a megadott cégkódú adatbázishoz: SUPXlsFuncs.NET A15.1 2018.03.28. - Csatlakozási hiba: Cégkód: DEMO

Tippek a függvények használatához

  • Célszerű a cégkódot és az újraszámítási jelzőt egy külön, paraméterként

Tippek a függvények használatához

  • Célszerű a cégkódot és az újraszámítási jelzőt egy külön, paraméterként szolgáló cellában meghatározni, és a függvények meghívásakor erre a cellára hivatkozni. Ugyanez igaz, minden olyan paraméterre, amelyet dinamikusan változtatni szeretnénk a táblázatunkban. Ilyen pl. univerzális táblázatnál az évek, hónapok, lekérdezési időpont, főkönyvi számok (ehhez bonyolultabb táblázat esetén meghatározható külön cellában a főkönyvi szám jellemző egyenlege, előjeles érték visszaadása esetén előjel megadása).

  • Kisebb táblázatok esetén, ahol a függvényhivatkozásokat másolásra kerülnek, célszerű cellaneveket vagy relatív cellahivatkozások helyett abszolút hivatkozásokat használni, mert ezek a cella másolásakor nem változnak meg. (Az Excel alapesetben relatív hivatkozásokkal dolgozik). Pl.: A4 helyett A$4, F2 helyett $F2, B8 helyett $B$8
    További információt az Excel Súgójában találhatunk a Relatív és abszolút hivatkozások témakörben.

  • A cellákba írt adatokat az Excel automatikusan tartalmuk alapján értelmezni próbálja (pl.: számok, amelyek valójában szövegként értelmezendők, dátum, amit a beállított formátumra ír át, pedig nekünk a beírt formában kell). Ez elkerülhető úgy, hogy a beírt értéket az ’ jellel kezdjük (pl.: ’2003.01.01, ’511).

  • Nagy és bonyolult táblák esetén az abszolút hivatkozás helyett jobb és kényelmesebb megoldás a cellák elnevezése.További információt az Excel Súgójában találhatunk a Cella elnevezése témakörben.

  • A paraméterek, ill. az egyes lekérdezések, táblázatok, diagrammok külön-külön munkalapon is elhelyezhetők.

  • Abban az esetben, ha egy havi bontásos táblázatot egyszer egyik évre, másszor másik évre kell kiértékelni, akkor az évet is célszerű kiemelni egy külön cellába, majd a havi bontáshoz szükséges időszak intervallumokat javasolt - az Excelben ritkán használt - string összefűzéssel képezni.
    Pl.: =TargyEv & ".02.01." vagy =A1 & ".02.01.", ahol az A1 cella elnevezése TargyEv, tartalma 2002.
    További információt az Excel Súgójában találhatunk a Több cella szövegének és értékének összefűzése témakörben.

  • A SUPSQLDirect függvény alkalmazásakor az SQL lekérdezést célszerű külön cellában meghatározni, és a függvényben csak a cellára hivatkozni. Így bármikor megváltoztatható a lekérdezés, de a visszaadott oszlopok és sorok száma nem változhat. Ha változik, akkor újra kell kezdeni a cellatartomány kijelölését, és a függvényt újra meg kell hívni.
    Több cellányi információt csak úgy kaphatunk, hogy a függvény megszerkesztése után [Ctrl-Shift-Enter]-rel hagyjuk jóvá a függvényt. (Csak Enter lenyomásával egy cellányi információt kapunk!)
    Az eredményként kapott adatsorok vízszintesen helyezkednek el. Ha szeretnénk függőlegesen megjelenő adatsorokat, akkor a TRANSZPONÁLÁS nevű függvényt kell meghívnunk, és abba kell beágyaznunk a SUPSQLDirect függvényhívásunkat.
    További információt az Excel Súgójában találhatunk a Transzponálás témakörben.

SUP függvénycsomag telepítése

A SUP_XLS_NET_Setup.exe futtatásával kezdeményezhető az installálás. A telepítő utasításait követve a függvénycsomag a C:\QSoft\Sup\bin könyvtárba kerül. Ahhoz, hogy az Excelben meghívhatók legyenek a függvények, az Excel indítását követően a Bővítménykezelő-ben be kell állítani a SUPXlsFuncs.NET.Excelxx.xla bővítménytxll bővítményt (az Excel verzióhoz megfelelő 32 vagy 64 bites változatot), mely alapesetben C:\QSoft\Sup\bin könyvtárban található. Ezt követően az Excel | Függvény beszúrása funkcióval a Felhasználói függvények között SUP Excel függvénycsomag (.NET) függvénykategóriában megtalálhatók a SUP függvényei.

...

Az Excel függvénycsomag eltávolítása csak indirekt módon lehetséges. A SUP függvénycsomag eltávolítása a SUPXlsFuncs.xlaNET.Excelxx.xll file törlésével, valamint a bővítmény excelből történő eltávolításával van lehetőség.
A file alapesetben a C:\Qsoft\Sup\bin könyvtárban található (más esetben, megtekinthető az Excel | Bővítménykezelőjében). A file eltávolítása, csak akkor sikeres, ha az Excel nincs elindítva! A SUP függvénycsomag sikeres eltávolítás érdekében a file törlését követően az Excel bővítménykezelőjéből is el kell távolítani a hivatkozást, hogy az excel következő indításkor ne keresse a bővítményt. Ennek eltávolításának legegyszerűbb módja az, ha a bővítmény file törlését követően, elindítva az Excelt, az rákérdez - a bővítmény file hiánya miatt - a függvény eltávolítására, - erre [Igen]-nel válaszolva, sikeresen végrehajtható a függvénycsomag eltávolítása az Excelből.

...

  • A már megszerkesztett táblázatban #NÉV? látható a függvényeknél
    Hiba oka:
    Ez többnyire akkor fordulhat elő, ha a táblázatot átvitelre kerül egy másik gépre, és az Excelben nincs regisztrálva a SUP XlsFunc függvénycsomag. Másik ok az lehet, hogy a különböző gépeken más-más helyen van telepítve a SUPxlsFuncs.xla gépre, és az Excelben nincs regisztrálva a SUPXlsFunc.NET  függvénycsomag.
    Megoldás:
    Az Excelben regisztrálni kell a SUP XlsFunc SUPXlsFunc.NET függvénycsomagot, mint Bővítményt, továbbá biztosítani kell, hogy minden gépen ugyanazon könyvtárban legyen a SUPXlsFuncs. xla. Ajánlott hely a C:\QSoft\Sup\bin\SUPxlsFuncs.xla. Az Excel - a bővítményként regisztrált függvények esetén - a táblázatba azt is eltárolja, hogy milyen könyvtárban található a bővítmény. Ha a megadott helyen nincs, akkor a cellába a #NÉV? szöveget írja. Az eredeti elérési út a szerkesztősorban látható. Lehetőség van a hivatkozások csoportos javítására a Szerkesztés | Csatolások menüpontban (Office 2003).NET.Excelxx.xll.
  • Nem sikerült bejelentkezni a SysData adatbázisba, …. (Provider cannot be found. It may not be properly installed)
    Hiba oka: Az _IBProvider_v3_free_i A FirebirdSql.Data.FirebirdClient.dll nincs regisztrálva.
    Megoldás: A SUP függvényeket csak akkor tudjuk az Excel táblázatkezelőben használni, ha azt a Windows-ban regisztrálásra került az adatbázis eléréséhez szükséges ún. . OLEDB NET providert.
    Ezt a következőképpen kell megtenni:
    Windows parancssorból, abból a könyvtárból, ahol az _IBProvider_v3_free_iFirebirdSql.Data.FirebirdClient.dll található, (ez általában a C:\Qsoft\Sup\bin könyvtár) a következő parancsot futtatva: REGSVR32  _IBProvider_v3_free_iFirebirdSql.Data.FirebirdClient.dll regisztrálható az ún. OLEDB .NET provider.
    Ezt a „kézi” regisztrálást csak akkor kell megtenni, ha a függvénycsomag nem SUP_XLS_NET_Setup.exe futtatásával került telepítésre a gépre, vagy az a telepítéskor nem regisztrálódott, pl: megfelelő jogosultság hiányában.

  • Nem sikerült bejelentkezni a SysData adatbázisba, …. (Invalid procedure call or argument)
    Hiba oka: A Windows Registry-ben a HKCU\Software\QSoft\SUP kulcson a HomeDirectory érték nem megfelelő könyvtárra mutat.
    Megoldás: A SUP-ban a Szerviz | Névjegy menüpontban lehet ellenőrizni az ún. SUP alapkönyvtárat. Ez az üzenet leginkább csak akkor fordulhat elő, ha olyan gépen kell a függvénycsomagot üzemeltetni, ami egyébként nem SUP kliens gép.
    A függvénycsomag alapvetően a legutoljára használt rendszeradatbázishoz kapcsolódik. Ezt a Windows Registry: HKCU\Software\QSoft\SUP kulcson a HomeDirectory által hivatkozott SUP alapkönyvtárból nyíló …BIN\SUP.INI file-ból olvassa ki.
    Ha egy hálózatban több SUP Licence is van, akkor több rendszeradatbázis is van. Ha több rendszeradatbázis van, vagy nem találja a táblázatkezelő a beírt cégkódot, akkor az Initialize függvényt kell használni.

    Rögzítés
    Initialize
    Initialize

    Initialize( <AsSysData> )
    <AsSysData>A paraméterben megadható, hogy melyik rendszeradatbázist használjuk a lekérdezéseknél.
    File név elérési útvonallal együtt.
    PéldaInitialize(”C:\Qsoft\Sup\db\FB2__SysData.fdb”)

...