Publication: Magyar Közlöny
Issue: MK-2004-85 (Year: 2004, Number: 85)
Era: 2004-2010
Section: 6. számú függelék a 7/2002. (VI. 29.) GKM–BM–KvVM együttes rendelet
Paragraph Index: 467

6. mell . 3. ábra. A kommunikáció lépései 2.2.1. Az Internetes kapcsolat paramétereinek beállítása Az InitLibrary() függvény meghívásával állíthatjuk be a szükséges paramétereket. Következõ lépésként, ha még nem vagyunk regisztrálva a központi adatbázisban (nincs felhasználó nevünk és jelszavunk), akkor elõször el kell végezni a regisztrációt a 2.2.2. pontban leírtak alapján. 2.2.2. Regisztráció A regisztrációhoz hívjuk meg a Regisztracio() függvényt. Paraméterként egy HANDLE-t - amit az InitLibrary() függvény adott vissza - és egy mutatót vár, ami egy REGISZTRACIO típusú struktúrára mutat. A REGISZTRACIO struktúra leírása megtalálható az XML_Exchange.h illetve az XML_Exchange.pas állományokban. Ha a függvény visszatérési értéke TRUE, akkor a REGISZTRACIO.felhasznalo és REGISZTRACIO.jelszo mezõk tartalmazzák a bejelentkezéshez szükséges adatokat. 2.2.3. Adatküldés A PostUzenet() függvény segítségével küldhetjük el az adatokat a paraméterekben beállított Internet címre. Elsõ paraméterben egy HANDLE-t vár, amit az InitLibrary() függvény adott vissza. Második paraméterében egy XML_ADATOK típusú struktúrára mutató pointert kell átadni. A harmadik paramétere azt határozza meg, hogy az XML dokumentumot Interneten küldje el, elmentse egy fájlba vagy mindkét funkciót végezze el. Alapértelmezett értéke ST_REMOTE, ami csak az Internetes adatküldésre ad utasítást. Figyelem! Ha el akarjuk menteni fájlba is az XML dokumentumot, akkor a harmadik paraméternek adjunk ST_BOTH értéket és negyedik paraméterben adjuk meg az elmentendõ fájl nevét is. A negyedik paramétere egy fájl nevet határoz meg, ahová az XML dokumentum elmentésre kerül, ha a második paraméter ST_LOCAL vagy ST_BOTH. 2.2.4. Kijelentkezés A kijelentkezéshez hívjuk meg a Kijelentkezes() függvényt. 2.2.5. A Kommunikációs alrendszer megszüntetése Legutolsó lépésként meg kell hívnunk a DestroyLibrary() függvényt. 2.3. Mért adatok mentése egy megadott állományba Ahhoz, hogy a mért adatok külsõ ügyviteli rendszer számára is hozzáférhetõek legyenek, minden egyes felülvizsgálat végén hozzunk létre egy, az XML_Exchange.xsd sémán alapuló XML fájlt az alább leírtak szerint. Az elmenett fájlok útvonala: C:\EMISSZIO\ÉÉÉÉ\ - ahol ÉÉÉÉ az aktuális évszámot jelöli. A program automatikusan hozza létre az éves könyvtárat az adott év elsõ munkanapján. Az elmenett fájl neve: A fájl nevét a dátumból és a mérés kezdésének idõpontjából generáljuk. A fájl kiterjesztése xml. Pl.: C:\EMISSZIO\2003\09121202.XML, ami egy 2003. szeptember 12.-én 12 óra 02 perckor kezdett mérés adatait tartalmazza. Az állomány létrehozásához hívjuk meg a PostUzenet()-t függvényt. A dsHandle paraméterben adjunk meg nullát. A lpxmlAdatok paraméterben adjuk át a megfelelõ adatokat. A sendType értéke legyen ST_LOCAL és a FileName-ben adjuk meg a fájl nevét teljes elérési úttal. 2.4. Adattípusok A kommunikáció során felhasznált adattípusok leírását az XML_Exchange.h illetve az XML_Exchange.pas tartalmazza. 2.5. Az XML_Exchange.Dll-ben lévõ függvények leírása BOOL DestroyLibrary ( HANDLE dsHandle ); A kommunikáció által lefoglalt erõforrások felszabadítását végzi el. Paraméterek dsHandle Az InitLibrary () által elõzõleg visszaadott Handle. BOOL Kijelentkezes (void); Kijelentkezik az adatbázis szerverrõl és ha modemes kapcsolaton keresztül csatlakoztunk azt Internetre, akkor szétkapcsolja azt. Visszaadott értékek A kijelentkezés eredményességét adja vissza. Ha értéke FALSE, akkor a GetLastError() függvény hívásával bõvebb információt kaphatunk a hibáról. A hibakódokat az XML_Exchange.pas illetve XML_Exchange.h tartalmazza. BOOL PostUzenet ( HANDLE dsHandle, LPXML_ADATOK lpxmlAdatok, DWORD sendType = ST_REMOTE, LPSTR FileName = NULL ); A paraméterben kapott adatokat elküldi Interneten keresztül a PARAMINFO.Url által meghatározott szerverre. Paraméterek dsHandle Az InitLibrary által visszaadott handle. lpxmlAdatok Mutató egy XML_ADATOK struktúrára. sendType Meghatározza, hogy XML dokumentumot hogyan kezeljük. Értéke Jelentése ST_LOCAL Az XML dokumentumot csak a FileName-ben meghatározott útvonalra és néven menti el a rendszer. ST_REMOTE Az XML dokumentumot csak Interneten küldjük el. ST_BOTH Az XML dokumentumot elmentjük helyileg és elküldjük Interneten is. FileName Egy nullával lezárt stringre mutat, ami meghatározza az elmentendõ XML dokumentum nevét teljes elérési úttal. Visszaadott értékek Ha az elküldés sikeres volt, akkor érték TRUE. Ha hiba történik a függvény hívása során, akkor a GetLastError függvény hívásával bõvebb információt kapunk a hibáról. A hibakódokat az XML_Exchange.pas illetve XML_Exchange.h tartalmazza. BOOL Regisztracio( HANDLE dsHandle, LPREGISZTRACIO lpregisztracio ); Regisztrálja az adott mérõrendszert a paraméterben megadott adatokkal a rendelet által meghatározott szerveren. Paraméterek dsHandle Az InitLibrary által visszaadott handle. lpregisztracio A regisztráláshoz szükséges adatokat tartalmazó struktúrára mutat. Ha sikeres volt a regisztráció, akkor a lpregisztracio.felhasznalo és felhasznalo.jelszo mezõkben visszakapjuk a további bejelentkezéshez szükséges adatokat. Visszaadott értékek Ha a függvény hívása sikeres, akkor a visszaadott értéke TRUE. Ha hiba történik a függvény hívása során, akkor a GetLastError() függvény hívásával bõvebb információt kapunk a hibáról. A hibakódokat az XML_Exchange.pas illetve XML_Exchange.h tartalmazza. HANDLE InitLibrary ( HWND hwnd, LPSTR Url, LPSTR XML_Felhasznalo LPSTR XML_Jelszo, BOOL Log, LPSTR LogFileName, BOOL ConnectViaLAN, LPSTR RasConnect, LPSTR Proxy_ServerName INT Proxy_Port, LPSTR Proxy_User, LPSTR Proxy_Jelszo Az Internetes kapcsolat paramétereit állítja be a paramétereknek megfelelõen. Paraméterek Hwnd A DLL-t használó alkalmazás fõ ablakának leírója. Ha érvénytelen ablak leírót kap, akkor hibát ad vissza a függvény és a további kommunikáció nem lehetséges. Url A rendelet által meghatározott szerver URL-je. XML_Felhasznalo Ha már regisztráltuk a mérõegységet a szerveren, akkor ebben a paraméterben adjuk át a felhasználó nevet egyébként értéke NULL. XML_Jelszo Ha már regisztráltuk a mérõegységet a szerveren, akkor ebben a paraméterben adjuk át a jelszót egyébként értéke NULL. Log Ha értéke TRUE, akkor generál log fájlt az adatküldõ egység és a LogFileName paraméterben meghatározott néven kerül elmentésre. LogFileName Ha log értéke TRUE, akkor ezen a néven kerül elmentésre a log fájl. ConnectViaLAN Ha értéke TRUE, akkor a lokális hálózaton keresztül kapcsolódunk az Internetre. Ha értéke FALSE, akkor a RasConnect-ben meghatározott telefonos kapcsolatot használva csatlakozik. RasConnect Ha modemen keresztül csatlakozunk az Internetre, akkor ebben a paraméterben kerül átadásra a használni kívánt telefonos kapcsolat neve. Proxy_ServerName Proxy szerver neve. Proxy_Port Proxy port száma. Proxy_User Felhasználó a proxy szerveren. Proxy_Jelszo Jelszó a proxy szerveren. Visszaadott értékek Ha a függvény hívása sikeres, akkor a visszaadott értéke TRUE. Ha hiba történik a függvény hívása során, akkor a GetLastError() függvény hívásával bõvebb információt kaphatunk a hibáról

Source: https://magyarkozlony.hu/hivatalos-lapok/91ff1ab5e80660b743a229e181a15a797e79268f/dokumentumok/9280f3e9c43892e2aded8b85b346e56bff4218ec/letoltes