- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Napojeni na webovou sluzbu i6ws.100mega.cz - zbozi i4wifi - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Dobry den, webova sluzba je zprovoznena na https://i6ws.100mega.cz/ Prihlasite se do ni logovacimi udaji, jake Vam byly zaslany. Se sluzbou lze komunikovat pomoci protokolu SOAP. U metod s jednoduchymi parametry (exporty) take pomoci GET/POST, takze XML exporty lze stahovat/ziskat obycejnym odkazem. Na sluzbu se lze napojit nejen programove - poskytuje popis sluzby pomoci WSDL, ale lze ji take pouzivat/zkouset browserem. Sluzba ma jednoduche rozhrani, kde zobrazuje vypis metod, strucny popis, u nekterych take zkusebni formulare, kterymi lze metody rovnou z browseru vyvolat. Sluzba umi vracene XML data komprimovat (gzip, deflate), pokud se pozadavek vysle s hlavickou: Accept-Encoding: gzip, deflate EXPORTY DAT --------------------------------------------------------------------- Poskytuje sluzba/stranka: Default.asmx https://i6ws.100mega.cz/Default.asmx Exporty dat lze ziskat pomoci obecnych metod: GetResult - vraci vsechna data (resp. presneji zakladni mnozinu bez blizsi specifikace - u produktu - vse, u stavu skladu - vse skladem, u objednavek - jen otevrene a pod.) GetResultByCode - vraci data filtrovana dle jednoznacneho kodu - typicky jen jeden radek GetResultByFromTo - vraci data filtrovana dle datumu od/do - typicky na zaklade evidovane zmeny ### AKTUALNE DOSTUPNE EXPORTY - ZBOZI I4WIFI ### --------------------------------------------- --------------------------------------------- Zakladni export produktu, jejich vlastnosti, cen a skladovosti - https://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W_Schema Podmnoziny zakladniho exportu X-I4W: Export cen - https://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W-StoItemPriceOrd_Schema Export cen v mene klienta - https://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W-StoItemPriceOrdCur_Schema Obsahuje pouze elementy Id, Code, PartNo, PriceOrd, PriceEU, PriceRef, PriceRef2, TaxRate. Vhodny k aktualizaci cen, kdyz neni potreba stahovat vsechny informace o produktech. Export dostupnosti - https://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W-QtyFree_Schema Obsahuje pouze elementy Id, Code, PartNo, QtyIs, QtyFree. Vhodny k aktualizaci skladove dostupnosti. Export stromove struktury - https://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W-SPresentTree_Schema Export pro informacni system I6 (modul StoItemCom) - http://i6ws.100mega.cz/Default.asmx/GetResult?resultType=X-I4W-StoItemSiv_Schema Jenoduche stazeni pomoci metody GET ----------------------------- Zakladni syntax URL: https://JMENO:HESLO@i6ws.100mega.cz/Default.asmx/NAZEV_METODY?resultType=NAZEV_RESULTU&PARAMETRY UCASE hodnoty v URL se nahrazuji: JMENO - Prihlasovani jmeno do webove sluzby HESLO - Prihlasovani heslo do webove sluzby NAZEV_METODY - GetResult | GetResultByCode | GetResultByFromTo PARAMETRY GetResult - resultType= GetResultByCode - resultType= &code= GetResultByFromTo - resultType= &from= &to= Pozn.: Aby fungovala syntax: JMENO:HESLO@ s logovacimi udaji primo v linku, je treba pri rucnim zkouseni za pouziti Internet Exploreru to explicitne povolit: http://support.microsoft.com/kb/834489 Jinak pouzivat bez uvedeni JMENO:HESLO@ v URL, prohlizec pri prvnim pozadavku zobrazi prihlasovaci dialog. Priklady URL: zakladni vlastnosti vsech produktu: => Default.asmx/GetResult?resultType=X-I4W zakladni vlastnosti jednoho produktu 600623: => Default.asmx/GetResultByCode?resultType=X-I4W&code=600623 zakladni vlastnosti vice produktu, u kterych doslo ke zmene mezi 13.06.2005-06.06.2079: => Default.asmx/GetResultByFromTo?resultType=X-I4W&from=2005-06-13&to=2079-06-06 Ukazkove stazeni s vyslednym ulozenim XML souboru pomoci VBScriptu: '-------------------------------------------------------------------- Option Explicit Main Private Sub Main Dim strUrl, strFile strUrl = "https://JMENO:HESLO@i6ws.100mega.cz/Default.asmx/GetResultByCode?resultType=X-I4W&code=600623" strFile = "C:\StoItemBase.xml" With CreateObject("MSXML2.XMLHTTP") WScript.Echo "Opening url: " & strUrl .Open "GET", strUrl, False .Send If .Status <> 200 Then Err.Raise vbObjectError + 1, "GetResponseXml", "Bad response status: [" & .Status & "] " & .StatusText & vbCrLf & .ResponseText WScript.Echo "Saving file: " & strFile .ResponseXml.Save strFile WScript.Echo "Done." End With End Sub '-------------------------------------------------------------------- Pokud se obsah bloku ulozi do textoveho souboru s nazvem: i6ws_client.vbs Lze jej pak spustit v prikazovem radku CMD.EXE jako: cscript.exe i6ws_client.vbs Script provede stazeni zakladnich informaci o produktu 600623 a jeho ulozeni do souboru: C:\StoItemBase.xml Popis struktury exportu X-I4W ----------------------------- Export X-I4W je zakladni export poskytujici informace produktech. Dalsi produktove exporty jsou casto jeho podmnozinou (jen ceny, info o skladech a pod.) Za pouziti URL z ukazky vyse: https://JMENO:HESLO@i6ws.100mega.cz/Default.asmx/GetResultByCode?resultType=X-I4W&code=600623 by byla stazena nasledujici XML struktura: Pro usporu velikosti XML nejsou nektere attributy obsahujici prazdne texty - napr.: Code2, PartNo, PartNo2, NameAdd, NameE, ManName, SisName, NoteShort, Note NULLove/neprirazene hodnoty - napr.: PriceRef, RefProName, RefCode, PriceRef2, RefProName2, RefCode2, WeightRef, MeasureRef2 nulove =0 hodnoty - napr: QtyFreeIs, QtyFree, SNTrack, ThumbnailIs, ThumbnailSize, ImgIs, ImgSize, EnlargementIs, EnlargementSize vychozi hodnoty - napr.: QtyPack=1 vubec vraceny. Blizsi komentar k nekterym atributum: ThumbnailIs | ThumbnailSize + ImgIs | EnlargementSize + EnlargementIs | EnlargementSize => Drive exportovane info jen ve smyslu ANO/NE *Is lze nahradit nove pridanymi *Size (*Is = 1 je to stejne jako *Size > 0) *Is sloupce zustaly jen pro zpetnou kompatibilitu. Ze *Size lze detekovat zmenu obrazku (da se predpokladat, ze se zmenou obrazku se zmeni take jeho velikost) WarDur + WarDurEU => Zaruka je v systemu vedena jako Doba(2,24,...)+Jednoka(Rok,Mesic,...). Ve sluzbe je pro univerzalnost prepoctena na dny. Z takto exportovane hodnoty lze udelat zpetny prepocet: MAXINT=2147483647 - jedna se o dozivotni zaruku Je-li cislo beze zbytku delitelne 365 - jde udelat prepocet na roky Je-li cislo beze zbytku delitelne 31 - jde udelat prepocet na mesice. OBJEDNAVANI --------------------------------------------------------------------- Poskytuje sluzba/stranka: Order.asmx https://i6ws.100mega.cz/Order.asmx Sluzba nemusi byt u vsech distributoru nakonfigurovana / povolena. Pokud sluzba neni funkcni konci vsechny volani metod sluzby stavovym kodem: 501 Not Implemented Lze jednoduse vyzkouset GET pozadavkem: https://JMENO:HESLO@i6ws.100mega.cz/Order.asmx/GetStatus?Id=0 (dotaz na neexistujici objednavku - vrati bud chybu 500 nebo 501 - vubec nezna metodu) Vlastni popis objednavani pres webovou sluzbu je v samostatnem dokumentu: OrderReadMe.txt https://JMENO:HESLO@i6ws.100mega.cz/OrderReadMe.txt