A DbConnector a SUP^® Rendszerhez kapcsolódó kiegészítő modulok gyűjtőneve. Két almodulből áll:

• DbConnector (Windows app és Windows srv)
• DbConnector API (JRE 1.8 app ill. srv)

Az mely modulok és funkciók telepítése szükséges, előzetes egyeztetés, esetenként interface építési rendszerterv alapján kerül megállapításra.

DbConnector app és srv

A DbConnector alkalmazás Windows operációs rendszer alatt működő, különböző időzítetten futtatható feldolgozó, exportáló, más gyártók által készített API-k hoz kapcsolódó funkciókat tartalmaz. A funkciók nagyobb része a Windows alkalmazásként futtatható DbConnector modulba van befordítva. Mivel a modul alkalmazásként fut, ezért a működtetéséhez bejelentkezett Windows felhasználó szükséges.
A funkciók kisebb része már be van fordítva a Windows serviceként futtatható modulba. Ez a termékfejlesztés során jelenleg is változik.
A DbConnector alkalmazás működési feltételei megegyeznek a SUP^® Rendszer működési feltételeivel.

DbConnectorAPI

A Java VM környezetet igénylő DbConnector API segítségével más gyártók által készített rendszerek tudnak kapcsolódni a SUP^® Rendszerhez. A kapcsolódás lehetőségek különböző lekérdezés, ill. adatbeküldés funkciókból állnak.
A működés szempontjából az API funkciók két csoportra bonthatók.

• Szinkron - a funkciók nagyobb része szinkron működésű. Ide sorolhatók a lekérdezések, és bizonyos adatbeküldési lehetőségek. A szinkron funkciók működtetéséhez elegendő a DbConnector API telepítése.
• Aszinkron - azok az adatbeküldési funkciók, melyek feldolgozása hosszabb ideig tart, aszinkron API funkcióként lettek megvalósítva. Ezen funkciók használatához a DbConnector API mellett szükséges a DbConnector alkalmazás, mint feldolgozó modul. Tehát az API-n beküldött adatok feldolgozási várólistába kerülnek. A DbConnector feldolgozó végzi az érdemi munkát.

A DbConnector modulokat az intraneten kell telepíteni. Az intraneten kívüli elérhetőséggel a DbConnector REST API dokumentációs oldal foglalkozik. A DbConnector alkalmazás és az DbConnector API nem feltétlenül ugyanazon a gépen kell, hogy működjön, de jellemezően egy könyvtárban szoktuk telepíteni.

A modulok telepítési helye lehetőség szerint nem a <SupHome>\BIN könyvtár. Javasolt hely a <SupHome>\DbConnector vagy <SupHome>\DbConnectorApi könyvtár nem feltétlenül a <SupHome>\BIN könyvtárban kell, hogy legyen, mivel a működése során számos LOG file-t hoz létre. Bár az elvégezhető feladatok többsége még csak alkalmazás módban fut, elképzelhető hely lehet a a <SupHome>\SRV könyvtár.

Szükséges file-ok:

• aDbConnector.exe - DbConnector alkalmazás, ha szükséges.
• aDbConnectorSrv.exe - DbConnector (Windows) szolgáltatás, ha szükséges.
• aDbConnector.ini - Közös INI file az alkalmazáshoz és a szolgáltatáshoz. Az aDbConnector.ini írja az adatbázis kapcsolatot a SUP.INI-hez hasonló módon.
• Servers.ini - a <SupHome>\SysData könyvtárból a SERVERS.INI másolata, ill. azok a bejegyzések, amik a DbConnector adatbázis kapcsolathoz szükségesek.
• DbConnectorApi.jar - valamint működéshez szükséges property és futtató file-ok.

Beüzemelés

A beüzemelést a DbConnector alkalmazással célszerű kezdeni. Első lépés, hogy a kívánt feladatot kézzel indítva jól működik-e. Ehhez már jól beállított INI-file-ok szükségesek.

...

Naplózás
A végrehajtott műveletek futásáról, és a külön az előforduló hibákról .LOG kiterjesztéssel napló file-ok készülnek.

Futtatás Windows szolgáltatásként

Néhány DbConnector feladat Windows szolgáltatásként is futtatható. Ilyen például a NAV Online Számla szerver kommunikáció (KOBAK agent) funkció.
A paraméterek beállítása a DbConnector alkalmazáson keresztül történik.

...

Az időzített futtatás napló (LOG) file-ok az EXE-vel azonos a .\LOG könyvtárban jönnek létre. Emellett a szolgáltatás bejegyzéseket ír írhat a Windows eseménynaplóba, melyet az EVENTVWR.EXE utility használatával lehet megnézni. Itt a Windows-naplók | Alkalmazás nézetet kell választani.

A DbConnector API működik Linux vagy Windows környezetben. A Java VM gépen futó modult egy ú.n. service wrapper segítségével szoktuk Windows környezetben üzemeltetni.

Verzió frissítés

A normál SUP rendszerkövetés ezeket a modulokat nem frissíti automatikusan. A verzió frissítés a következőképpen történik:

• Kilépés futó alkalmazásból vagy Windows szolgáltatás leállítása. A régi verziók dátumozott archiválását is célszerű elvégezni. Erre alkalmazható a 7Zip-Service.cmd batch file.
• A DbConnector alkalmazás telepítő file-ok letölthetők a www.sup.hu/kov helyről. A DbConnectorApi.jar file-t általában a direkt letöltési link-ként juttatjuk el, amikor ez esedékes.

• Az újabb verziójú file-ok bemásolása az SRV könyvtárbaa <SupHome>\DbConnectorApi könyvtárba. Csak a szükséges file-okat kell átmásolni. Pl.: ha nincs DbConnector Windows szervizként működtetett funkció, akkor az  aDbConnectorSrv.exe átmásolása fölösleges.
• Alkalmazás vagy Windows szolgáltatás elindítása.