A "sERPa Webaruhaz-kapcsolat" szolgáltatást feltelepítve (az InstCD-n található, vagy letölthető a PartnerOldalakról) válik lehetővé az adatcsere és a webáruház között.
!Fontos: csak 1 szolgáltatás lehet egy adatbázishoz.
Telepítés lépései
1. A letöltött WebAruhazKapcsolat-.xx.exe kicsomagoljuk pl. c:\WebAruhazKapcsolat könyvtárba.
2. A webaruhazkapcsolat.ini-minta átnevezzük webaruhazkapcsolat.ini -ra.
3. A webaruhazkapcsolat.ini átírjuk a paramétereket a saját rendszerünkre. (részletek lentebb)
4. startsws.bat batch fájl futtatása rendszergazdaként, ezzel kerül be a Windows Szolgáltatásai közé, és ekkor indul el a sERPa Webáruház-kapcsolat.
Ha valami okból kifolyólag le kell állítani a szolgáltatást, akkor vagy a Windows Szolgáltatásai között keressük ki a "sERPa Webaruhaz-kapcsolat"-ot és leállítás műveltet válasszuk vagy stopsws.bat batch fájl futtatása rendszergazdaként.
!Fontos
125-ös verziótól!
A működéshez szükséges "MySQL Connector/C" amelyet a szolgáltatás futtató gépre kell telepíteni.
Ingyenesen letölthető: https://downloads.mysql.com/archives/c-c/ (Windows (x86, 64-bit), MSI Installer)
A megfelelő működéshez a PATH kell lennie amit a telepítő beállít. (libmysql.dll használja a szolgáltatás)
126-os verziótól!
MySQL Connector/C már a 64bites verzió szükséges.
Egyéb
1. Ha a szolgáltatás véglegesen törölni akarjuk akkor parancssorból tehetjük meg: sc delete <szolgatatasrovidnev>
2. A libeay32.dll és ssleay32.dll fájlok megléte adott esetben a megfelelő SSL kapcsolathoz szükséges.
3. FTP kapcsolódás várakozási idő: 20 másodperc; Transfer timeout 120 másodperc, ez idő után átlép a következő feladatra.
4. Ha a rendelést mi kérjük le, és Debug>=2, akkor a rendelés csomag lementésre kerül a log könyvtárba (naponta készülnek mappák mappákat, a file nevében található az időpont.
5. srvMessages.dll szükséges szolgáltatás részletesebb hibaüzenetek logolására. Nem kötelező elem, de hasznos lehet hibakeresés esetén. sERPa 146 verziótól.
Ha nincs megadva a LOGFILEPATH vagy a TEMPPATH, akkor a webáruház mappájában automatikusan létrehozásra kerül egy log vagy temp könyvtárat. (ha van hozzá joga a szolgáltatásnak.)
- Bármilyen hiba van, annak legalább a log mappába be kell kerülni.
- Ha a log mappába nem tud bekerülni a bejegyzés, mert nem elérhető a könyvtár, nem írható, akkor a webáruház mappájába kerül egy log fájl: _{Dátum}. néven.
- Ha ide sem tud bekerülni a hiba, akkor legalább a Windows hibanaplóba írunk.
- Ha indításnál van hiba, akkor a service megáll és hibaüzenetet generál a hibanaplóba.
Frissítés lépései
1. Szolgáltatás leállítása.
2. A letöltött WEBAruhazKapcsolat-xx.exe fájlt kicsomagoljuk, majd a kicsomagolt webaruhazkapcsolat.exe-vel felülírjuk a régit. (A libeay32.dll és ssleay32.dll fájlok frissítése is szükséges.)
3. Szolgáltatás újraindítása.
INI fájl vezérlése
A webservice szolgáltatás működését a webservice.ini fájl vezérli az alábbi módon:
COMMON szekcióban lévő adatok:
VERSION |
Az ini fájl melyik webáruház szervizzel működik rendeltetésszerűen. |
VERSIONCHECK |
Legyen-e verzióellenőrzés indításkor (0: nem, 1: igen) |
SERPA szekcióban lévő adatok:
SERVER |
Az sql szerver neve, amelyen az adatbázis található. |
DATABASE |
Az SQL szerveren az adatbázis, amellyel kommunikálunk. |
USER |
sERPa felhasználó funkciójába felveendő felhasználó, akinek a nevében a történik a kommunikáció-a userek az SQL-re az adatbázisra owner joggal kell rendelkeznie! |
PWD |
Előzőleg leírt user jelszava |
DRIVER |
Megadható, hogy melyik illesztőprogramot használja. Nem kötelező, alapértelmezésben SQL Native Client próbál használni, de amennyiben a gépen nincs ilyen illesztőprogram akkor itt meg kell adni, különben hibára fog futni indításkor. Ajánlott: ODBC Driver 17 for SQL Server vagy SQL Server Native Client 11.0 |
FOTEXNET szekcióban lévő adat:
PORT |
Melyik porton figyeljen a FOTEXNET-es XML-re. |
Config szekcióban lévő adat:
PELDANY |
Nem kötelező, mintában nincs is benne. Ha egy gépen több webáruház szolgáltatás akarunk indítani akkor ide kell megadni a példány nevét, ezt a nevet kell a starme, stopme batch fájlokban is megadni a net start/stop me részbe. (Két külön könyvtár is szükséges) |
OSCOMMERCE szekcióban levő adatok:
MYSQLPORT |
Nem kötelező, csak ha nem a megszokott porton keresztül kell kommunikálni a mySQL-el. (pl. ingyenes tárhely estén) |
PINGINTERVAL |
Jelentése, hogy milyen gyakran nézzen rá a paramétertáblára és a feladatokra a service. Az érték másodpercben értendő és minimális érték 10. Ennél kisebb érték megadása esetén a service automatikusan 10-re állítja be. |
LOG szekcióban levő adatok:
DEBUG |
1 esetén több infó kerül a log fájlba. (Legnagyobb szint a 4-es ) |
LOGFILEPATH |
A logfájl elérési útvonala, ahová mentse a service. |
LOGFILENAME |
A logfájl neve, amilyen néven jöjjön létre a fájl. |
SAVEFILE |
[0] / 1 - FTP kommunikációjú webshopok esetén vesszük figyelembe. 1 esetén a LOGFILEPATH mappában létrehozunk egy IN és egy OUT mappát, amelyekbe létrehozunk napra bontva log mappákat, amelyekbe időpontonként külön mappákba mentjük az elküldött, letöltött fájlokat. |
DOLOG megszüntetésre került.
Példa Webservice.ini beállításra:
[COMMON]
VERSION = 201251
VERSIONCHECK = 1
[SERPA]
SERVER = Server
DATABASE = serpa001
USER = felhasznalo_nev
PWD = valami_jelszo
DRIVER = SQL Native Client
[OSCOMMERCE]
MYSQLPORT =3306
PINGINTERVAL = 10
TEMPPATH = C:\TEMP\
[FOTEXNET]
PORT = 7890
[Config]
PELDANY = Masodik
[LOG]
DEBUG = 0
DOLOG = 1
LOGFILEPATH = C:\WebAruhazKapcsolat\
LOGFILENAME = log_webaruhazkapcsolat.txt
SAVEFILE = 0
