IM-XML Kérdések - Válaszok

IM-XML Kérdések - Válaszok MI AZ IM-XML?......................................................................................................................................................... 2 MI AZ XML? .............................................................................................................................................................. 2 MILYEN ELŐNYÖKET HORDOZ EZ A RENDSZER ÜGYFELEINK SZÁMÁRA? ................................................................ 2 MILYEN TRANZAKCIÓK ÉRHETŐEK EL AZ IM-XML-BEN? .......................................................................................... 2 MI A TECHNIKAI FELTÉTELE AZ INGRAM MICRO ÁLTAL INDÍTOTT TRANZAKCIÓK FOGADÁSÁNAK? ....................... 3 MI AZ AKTUÁLIS LEGÚJABB VERZIÓJA A RENDSZERNEK? ........................................................................................ 4 MILYEN XML VERZIÓT HASZNÁL A RENDSZER?........................................................................................................ 4 A TRANZAKCIÓK MILYEN SZABVÁNY SZERINT LETTEK KIALAKÍTVA?........................................................................ 4 MIÉRT NEM MÁR LÉTEZŐ, ÁLTALÁNOS XML KERESKEDELMI TRANZAKCIÓS SZABVÁNYOKAT HASZNÁLUNK? ....... 4 AZ EGYEDI TRANZAKCIÓK MEGVALÓSÍTÁSA AZ ÜGYFÉLOLDALON EGYEDI FEJLESZTÉST JELENT? .......................... 4 AZ IM-XML HASZNÁLATÁHOZ SZÜKSÉG VAN EGYÉB ELŐFELTÉTELEK MEGLÉTÉRE? ............................................... 4 MILYEN CÍMEN ÉRHETŐ EL A SZOLGÁLTATÁS? ........................................................................................................ 5 MI AZ AZ ADMIN WEBSITE? ..................................................................................................................................... 5 MILYEN DOKUMENTÁCIÓ TÖLTHETŐ LE AZ ADMIN WEBSITE-RÓL?........................................................................ 5 MI AZ AZ IM-XML SCHEMA, DTD ÉS MI A KÜLÖNBSÉG KÖZTÜK? ............................................................................ 5 AZ XML DOKUMENTUM FELDOLGOZÁSAKOR SZÜKSÉG VAN A DTD-RE VAGY A SÉMÁRA? .................................... 6 MI A MÓDJA ADOTT IM-XML TRANZAKCIÓ ELKÜLDÉSÉNEK? .................................................................................. 6 AZ ADAT MEGHATÁROZOTT FORMÁTUMBAN ÉRKEZIK AZ INGRAMTÓL, DE AZ ÜGYFÉL RENDSZERÉNEK MÁS FORMÁTUMBAN VAN ARRA SZÜKSÉGE, MI A MEGOLDÁS? .................................................................................... 6 AZ IM-XML HASZNÁLATÁHOZ VALAMI SPECIÁLIS XML FELDOLGOZÓ SZOFTVERRE SZÜKSÉG VAN? ...................... 6 JAVA ALKALMAZÁSOKBÓL HOGYAN LEHET KEZELNI AZ XML DOKUMENTUMOKAT? ............................................. 6 FIZIKAILAG HOL VAN A SZOLGÁLTATÁS?.................................................................................................................. 7 A TRANZAKCIÓ LOG MEDDIG ŐRZŐDIK MEG? ......................................................................................................... 7 MI TÖRTÉNIK, HA HIBÁS VAGY ÉRVÉNYTELEN TRANZAKCIÓT KÜLDÖK BE? ............................................................ 7 HOGYAN LEHET AZ EGYES TRANZAKCIÓKAT BEAZONOSÍTANI?............................................................................... 7 MENNYIBE KERÜL A SZOLGÁLTATÁS? ...................................................................................................................... 7 A NAP MELY IDŐSZAKÁBAN HASZÁLHATÓ A RENDSZER ÉS MIKOR NEM? .............................................................. 7 HOGYAN NÉZ KI EGY XML ÜZENET? ......................................................................................................................... 7 HOGYAN LEHET XML ÜZENETEKET (DOKUMENTUMOKAT) LÉTREHOZNI? .............................................................. 8 MIVEL AZ XML EGYSZERŰ SZÖVEG, HOGYAN REJTHETŐ EL A TARTALMA ILLETÉKTELENEK ELŐL AZ INTERNETEN TÖRTÉNŐ ÁTKÜLDÉS KÖZBEN? ................................................................................................................................ 8 AZ XML FILE-OK TARTALMÁT MIVEL LEHET MEGNÉZNI?......................................................................................... 9 HOGYAN LEHET IM-XML HOZZÉFÉRÉST IGÉNYELNI? ............................................................................................... 9 AZ IMPLEMENTÁCIÓ SORÁN MILYEN TECHNIKAI TÁMOGATÁS ÁLL RENDELKEZÉSEMRE? ..................................... 9 HOL KAPHATOK TOVÁBBI INFORMÁCIÓT? .............................................................................................................. 9

Ingram Micro Magyarország | IM-XML GYIK | Utolsó mentés:2012-10-12

1

Mi az IM-XML? IM-XML Ingram Micro XML alapú eCommerce megoldása, amely a legújabb technológiai megoldást felhasználásával lehetővé teszi a szoros folyamat- és rendszerintegrációt kereskedelmi partnereinkkel.

Mi az XML? XML az eXtensible Markup Language rövidítése, amely egy nyitott szabványt takar, amit struktúrált adatok interneten, internetes alkalmazások között történő továbbítására fejlesztettek ki.

Milyen előnyöket hordoz ez a rendszer Ügyfeleink számára? Röviden: az IM-XML alkalmazása költségcsökkentést és folyamatoptimalizációt eredményez Ügyfeleink számára az Ingrammal folytatott mindenappi együttműködés során. Az IM-XML bevezetése és használata könnyeb, gyorsabb és olcsóbb mint bármely más integrációs megoldásé, például az EDI. Először is a csatlakozáshoz szükséges fejlesztési idő lecsökken, így Ügyfelünk gyorsabban épíheti ki az integrált kapcsolatot cégünk rendszerével. Az integrált (kereskedelmi, ügyviteli) rendszerek nyilvánvaló előnyökkel járnak, mint például kevesebb telefonhívás készletinformáció beszerzése és rendelések feladása ügyében. Ügyfelünk függetlenebbül szervezheti üzleti folyamatait, mivel kevésbé függ adott ingramos értékesítő kolléga elérhetőségétől. Az IM-XML lehetőséget nyújt az rendelési folyamat Ügyféltől Ingramig terjedő teljeskörű integrációjára. Kereskedelmi partnereink beszerzőik kezébe olyan rendszert adhatnak, amely az Ingram készletére online, valósidejű rálátást biztosít, vagy hasonlóképpen kapcsolhatják be ezt az információt a saját weboldalukba. Az ingramos adatok és rendelési folyamatok közvetlenül bekapcsolhatóak az Ügyfél pénzügyi illetve ügyviteli rendszerébe, folyamattámogató alkalmazásiba, hogy csak pár lehetőséget említsünk. Az IM-XML által kínált funkcionalitás megvalósítására olyan tranzakciókat hoztak létre, amelyek biztosítják az üzleti folyamatokhoz való kapcsolódásban a rugalmasságot, optimális teljesítményt és minimalizálják az adatismétlődést. Minden egyes tranzakció kifejezetten egy, a rendeléskezelés meghatározott területén alkalmazható miközben nagy mennyiségű információt biztosít a felhasználó számára. Az IM-XML valós idejű szolgáltatás, ami praktikusan azt jelenti, hogy a tranzakcók másodperceken belül feldolgozásra kerülnek és egyenesen az Ingram Micro ügyviteli rendszeréből származó naprakész, pontos válasz adatokkal térnek vissza. Ezáltal Ügyfeleink gyors és pontos adatokkal láthatják el a beszerzésben dolgozó kollégáikat avagy ügyfeleiket. A jó minőségű, pontos és gyorsan elérhető adatok lehetővé teszik, hogy minden időben megalapozott üzleti döntések szülessenek.

Milyen tranzakciók érhetőek el az IM-XML-ben? Ügyfél által indított tranzakciók:


2

A tranzakció kezdeményezője az ügyfél (rendszere), ami a tranzakció végrehjtása során/után meghatározott adatokkal tér vissza. Price & Availability (P&A) – Ár- és készletinformáció: legfeljebb 50 SKU adatai kérhetőek le egyetlen tranzakcióban. Order Entry – Rendelésfeladás: Sztenderd (különleges eljárást nem igénylő) termékek rendelésére. Order Entry (Licences) – Rendelésfeladás (Licences): Licencelési eljárást igénylő termékek rendelésére. Order Change – Rendelésmódosítás: addig, amíg a rendelés szállításba nem kerül, a rendelés mindenféle jellemzője megváltoztatható (pl. mennyiség, SKU, szállítási cím, stb.) Order Status – Rendelés státusz info: Alapvető rendelés státusz információ kérdezhető le vele (pl. ingramos rendelésszám, vevő rendelésszáma, rendelés dátuma, suffix, rendelés összesen, státusz {szállítva|számlázva|függőben}, számla dátuma, szállítás dátuma, jóváírás) Order Detail – Részletes rendelésadatoa rendeléssel és tételeivel kapcsolatos adatok lekérdezése (pl. tömeg, rendelés dátum, összérték, szállítási költség, ÁFA, szállítási cím kontakt, szállítási cím, számlázási cím, státusz, szállítmányozó, szállítás dátuma, SKU, gyártói cíkkszám (VPN), rendelt mennyiség, függő mennyiség, egységár, termék megnevezése, rendelés sor ingramos száma, rendelés sor vevői száma, sorozatszámok, megjegyzések). Order Tracking – Rendeléskövetés: a rendelés kiszállításával kapcsolatos adatokra koncentrál (pl. Ingram Micro rendelésszám, tömeg, dobozmennyiség, rendelés suffix, szállítmányozó, csomagazonosító, szállítás dátuma, doboz száma, tracking URL, SKU). Product Alert – Fel lehet iratkozni értesítő email-re, amit akkor küld a rendszer, ha a megadott termékből lesz elérhető készleten.

Ingram Micro által indított tranzakciók: A tranzakció kezdeményezője a mi rendszerünk, azaz adott esemény bekövetkeztekor az adatokat úgy küldjük az Ügyfél rendszerének, hogy ahhoz annak nem kell külön XML kérést indítania. Invoice – Leszámlázott rendelésekről küldünk számlázási adatokat. Ez nem helyettesíti az Ingram által kibocsátott papír vagy elektornikus számlákat! Despatch Advice – Értesítés az Ingram által kiszállításra feladott rendelésekről, termékekről.

Mi a technikai feltétele az Ingram Micro által indított tranzakciók fogadásának? Ügyfelünknek ehhez ún. „post back URL”-t kell működtetnie és a tudomásunkra hoznia. Erre azért van szükség, hogy partnerünk határozhassa meg, hova küldjük az XML dokumentumot. Ahhoz, hogy az adott XML dokumentum megbízhatóan átkülthető legyen, az IM-XML rendszernek szüksége van a „post back URL”-re, amely által meghatározhatja, hogy az Ingramból indított „post” típusú üzenet sikeresen eljutott a célba. A „postback URL”-t működtető website-nak legalább egy Ingram Micro Magyarország | IM-XML GYIK | Utolsó mentés:2012-10-12

3

olyan weboldat kell tartalmaznia (pl. ASP vagy JSP oldal) amit meg lehet hívni oly módon, hogy a dokumentumküldést fogadja majd pedig HTTP 200-as üzenetet adjon vissza az IM-XML rendszernek, amivel igazolja az adatok fogadását.

Mi az aktuális legújabb verziója a rendszernek? IM-XML v2.0 a legújabb kiadása az Ingram Micro XML rendszernek.

Milyen XML verziót használ a rendszer? Nem is az a lényeg, milyen verziót használ hanem, hogy ún. jól fomázott (well formed) XML-t használ, ami praktikusan azt jelenti, hogy a rendszer nem követeli meg az egyes tranzakciók fejlécében (header section) található deklarációk használatát.

A tranzakciók milyen szabvány szerint lettek kialakítva? Az IM-XML tranzakció definíciók kifejezetten az Ingram Microval történő információcserére lettek kialakítva, más cégekkel nem működnek.

Miért nem már létező, általános XML kereskedelmi tranzakciós szabványokat használunk? Cégünk úgy találta, hogy azokon a területeken, amelyek a lefontosabbak az Ügyfeleinkkel való ügyvitelünkben , a külön kialakított tranzakciók tudnak a legjobban csatlakozni a saját rendszerünkhöz, ezáltal a leghatékonyabb kommunikációt megvalósítani. A legtöbb általánosan elfogadott szabvány a mi igényeinkhez képest túl bonyolult, túl egyszerű vagy egyáltalán más iparágnak készült.

Az egyedi tranzakciók megvalósítása az ügyféloldalon egyedi fejlesztést jelent? Igen, de csak korlátozott mértékben. Az XML, mint nyelv vagy technológia általánosan elfogadott módja az adatcserének az interneten, tehát egyszerre több partnerrel is használható. Ami külön fejlesztést igényel, az ingramos adatok megfeleltetése az Ügyfél rendszerében található adatoknak. Az XML tranzakciók részletes dokumentációjának segítségével ez olyan nagyságú feladat, amely a későbbi gyors, pontos adatcseréből adódó előnyök során sokszorosan megtérül.

Az IM-XML használatához szükség van egyéb előfeltételek meglétére? Mivel az IM-XML tranzakciókkal az Ingram Micro kereskedelmi rendszerében elérhető adatokkal lehet csak dolgozni, így célszerű naprakész termékkatalógussal rendelkezni, ami alapján pl. az abban található SKU-kra rendeléseket lehet feladni.


4

A termékkatalógus és készletinformáció az IM-FTP szolgáltatásunkon keresztül tölthető le. Bővebb információért írjon a [email protected] email címre.

Milyen címen érhető el a szolgáltatás? http://coronado.ingrammicro.com/imxml/login.jsp IM-XML Admin Website. https://newport.ingrammicro.com/im-xml 64.40.232.254

IM-XML URL, ahova az XML hívásokat kell küldeni (POST-olni). IM-XML az aszinkron tranzakciókat erről a címről küldi, ezt az IP címet fogja látni az ügyfél a saját rendszerében.

Mi az az Admin Website? Ez a webes adminisztrációs rendszer az IM-XML ügyfelek központi információforrása és az IM-XML adminisztratív funkciók is itt érhetőek el:      

Tranzakciós logok visszakeresése, letöltése. Az admin website profilkezelése. IM-XML tranzakciók tesztelése, egyszerű bemásolás és elküldés útján, így nagyon gyorsan, könnyen tesztelhetőek a tranzakciók. További hozzáférések definiálása az IM-XML rendszerhez. A különböző felhasználókak különböző hozzáférési szinteket, tranzakciókat lehet engedélyezni. A rendszerrel kapcsolatos (angol nyelvű) dokumentáció letöltése. Az IM-XML gateway teljesíménye (átlagos válaszidő) tesztelhető.

Milyen dokumentáció tölthető le az Admin Website-ról? IM-XML Schemas – A tranzakciók gép által olvasható technikai definíciói. IM-XML Transaction Layouts – A tranzakciók ember által olvasható definíciói. IM-XML Test plan – Ajánlott teszetlési eljárások. IM-XML FAQ – GYIK (ennek a leírásnak az angol nyelvű változata). IM-XML Sample Documents – Példa XML dokumentum minden egyes tranzakcióra.

Mi az az IM-XML Schema, DTD és mi a különbség köztük? A Schema leírja azt a struktúrát és adattípus és -kezelési szabályokat, amelyek minden bejövő és kimenő tranzakcióra érvényesek. A schema megmondja, hogyan kell adott XML dokumentumot létrehozni, ami ebben az esetben az Ingram által meghatározott tranzakciók szabályai. A Document Type Definition (DTD) pusztán technikai szempontból hasonlít az XML sémára. A különbség az általuk biztosított funkcionalitásban van, pl. az XML séma intézményét arra találták ki, hogy pótoljon bizonyos, a DTD-ből hiányzó funkciókat, például pontosabb típusellenerzés. Másik különbség, hogy a DTD a saját nyelvezetét, míg a séma XML-t használ az XML dokumentum elemeinek leírására.


5

Az XML dokumentum feldolgozásakor szükség van a DTD-re vagy a Sémára? Attól függ, milyen rendszert használunk a feldolgozásra. DTD vagy Séma hiányában is feldolgozható egy XML dokumentum, csak ekkor pl. az XML elem neveket nem ellenőrzi a feldolgozó alkalmazás. A használatukkal viszont a tranzakciók által megkövetelt szabályok betartathatóak az XML dokumentumok feldolgozása során így kiszűrhetőek a szintaktikai hibákból eredő adathibák.

Mi a módja adott IM-XML tranzakció elküldésének? Az IM-XML dokumentumokat (tranzakciókat) ún. POST HTTPS üzenet formájában kell elküldeni egy megadott URL-re és a válasz is ugyanezen a kapcsolaton keresztül érkezik. Ilyen hívást pl. egy egyszerű script segítségével is intézhetünk, amelyben csupán azt kell megadni, melyik IM-XML dokumentumot hova kell küldeni. Ahhoz, hogy az adatcsere titkosított csatornán történjen, ugyanúgy nem kell tanusítványt telepíteni a kliensoldalon, mint bármely más HTTPS weboldal böngészőben való megjelenítésekor, ugyanis az alrendszerek automatikusan intézik a megfelelő titkosított kapcsolat felépítését.

Az adat meghatározott formátumban érkezik az Ingramtól, de az Ügyfél rendszerének más formátumban van arra szüksége, mi a megoldás? A legjobb és legkönnyebb megoldás az eXtensible Stylesheet Language Transformation (XSLT) technológia használata, amely lehetővé teszi olyan minták (template) létrehozását, amik meghatározzák, adott bejövő XML adathalmazt hogyan kell más formátumra alakítani.

Az IM-XML használatához valami speciális XML feldolgozó szoftverre szükség van? Nem, a rendszer bármely olyan kliens rendszerből használható, amely dokumentumokat képes létrehozni, elküldeni (POST-olni) és fogadni az Interneten HTTP/HTTPS használatával. Ez egyúttal azt is jelenti, hogy a legegyszerűbb kliens alkalmazástól kezdve (pl. Excel) egy sztenderd webszerveren keresztül (IIS, Apache) akár egy XML modullal rendelkező SAP rendszerig bármelyiket rábírhatjuk az Ingram rendszerével való együttműködésre.

Java alkalmazásokból hogyan lehet kezelni az XML dokumentumokat? A leggyakoribb módszer a Sun Java API for XML (JAXP) használata. A JAXP két felületet is biztosít az XML dokumentumok feldolgozására (parse-olására): Document Object Model (DOM) és Simple API for XML (SAX).


6

Fizikailag hol van a szolgáltatás? A rendszert kiszolgáló szerverek az Ingram Micro európai adatközpontjában vannak.

A tranzakció log meddig őrződik meg? A tranzakciókkal kapcsolatos alapvető adatokat, mint XML dokumenum neve, ID és dátum, nem töröljük.

Mi történik, ha hibás vagy érvénytelen tranzakciót küldök be? A rendszer hibaüzenetet ad vissza. Adott tranzakció a legkülönfélébb okok miatt lehet hibás és ennek megfelelően a rendszer különböző hibakódokat ad vissza, hogy segítségére legyen a probléma megértésében. Az Admin Website-on minden tranzakció visszakereshető, így az egy nagyon hasznos hibakereső eszköz.

Hogyan lehet az egyes tranzakciókat beazonosítani? Az IM-XML lehetővé teszi, hogy Ügyfelünk egyedi azonosítót rendeljen minden egyes tranzakcióhoz (a TransactionHeader-ben). Itt egy legfeljebb 18 karakteres alfanumerikus azonosítót lehet megadni. Emellett a rendszer automatikusan ellát minden egyes tranzakciót egy ún. Globális Egyedi Azonosítóval (Global Unique IDentifier -- GUID). A GUID egy 32bites egyedi kód, amit az egyes tranzakciók beazonosítására lehet használni. Itt egy példa: {E28F6D26-D3D8-4F7B-B6801BD13DB36065}

Mennyibe kerül a szolgáltatás? Az IM-XML ingyenes minden ügyfelünknek, aki a B2B összeköttetésben fantáziát lát.

A nap mely időszakában haszálható a rendszer és mikor nem? Hajnali 5-től este 11-ig (05:00 – 23:00).

Hogyan néz ki egy XML üzenet? A HTML-hez hasonlóan az adatoknak struktúrát és értelmet ún. „Tag”-ek, „Attribútum”-ok és „Elem”ek használatával adnak, amit összességében „Dokumentum”-nak neveznek. Az XML dokumentumban található adatok értelmezése még egy gyakorlatlan szemű laikusnak sem okozhat gondot. A rendszernek ez az ön-leíró tulajdonsága a műszaki rugalmassággal kombinálva teszi az XML-t a leghatékonyabb kommunikációs nyelvvé.


7

Az alábbi példában egy IM-XML ár- és készletinformáció lekérdezés („dokumentum”) látható. XML UK UKTESTLOGIN <Password>UKTESTPASSWORD 12345

Magyarázat A tranzakció neve és egyúttal kezdete Hozzáférési adatok szekció kezdete Országkód Az ügyfél loginID-ja Az ügyfél jelszava Ügyfél egyedi tranzakcióazonosítója Hozzáférési adatok szekció vége A cikk, amiről információt kérünk A cikk, amiről információt kérünk A tranzakció vége

A színezés csak a példában szereplő szekciók könnyebb beazonosíthatósága érdekében történt.

Hogyan lehet XML üzeneteket (dokumentumokat) létrehozni? Sok ingyenesen is elérhető alkalmazás van az interneten, amelyeket kifejezetten XML dokumentumok szerkesztésére készítettek. Mindazonáltal XML dokumentumok bármilyen szövegszerkesztővel létrehozhatóak, hogy csak a legegyszerűbb példát említsük ott van a Notepad.

Mivel az XML egyszerű szöveg, hogyan rejthető el a tartalma illetéktelenek elől az Interneten történő átküldés közben? Az IM-XML rendszer az ún. SSL titkosítást használja HTTP-n keresztül, ezen titkosítási és átviteli eljárások együttesét HTTPS-nek nevezik. Az alábbi biztonsági protokollok támogatottak:  SSLv3.0  TLSv1.0  PCTv1.0 A támogatott titkosító kulcsok:  RC2 128 bit  RC4 128 bit  3DES 168 bit A támogatott titkosító eljárások:  MD5  SHA


8

Az XML file-ok tartalmát mivel lehet megnézni? A legtöbb internet böngészőnek beépített XML értelmezője van, ami által lehetővé válik a file XML dokumentumhierarchia szerinti áttekintése, az egymásba ágyazott szekciók becsukhatókkinyithatóak, külön színekkel kiemeli az egyes szintaktikai elemeket, stb.

Hogyan lehet IM-XML hozzéférést igényelni? 1. lépés: Viszoteladói szerződés megkötése cégünkkel (a weboldalunkon: www.ingram.hu) és egyúttal webshop hozzáférés igénylése. 2. lépés: A kapott webshop hozzáférés alapján IM-XML hozzáférés igénylése az [email protected] email címen. Az igényléskor kérjük, adja meg:  Impulse vevőszámát (a számlán megtalálható)  Webshop login ID  A használni kívánt XML tranzakciókat és verziójukat.

Az implementáció során milyen technikai támogatás áll rendelkezésemre? Első szint: Részletes dokumentációk a tranzackiókról és az XML használatáról. XML tranzakciók tesztelését segítő kisalkalmazás. Különböző példa forráskódok, amelyek bemutatják az XML kapcsolat kezelését. Példa trazakciók, XML dokumentumok. Második szint: Ingram Micro Magyarország IT csoport, az [email protected] email címen. Harmadik szint: A probléma jellegétől függően a magyarországi IT csoport közvetlen kapcsolatba hozza Önt az Ingram Micro európai e-Commerce csapatával.

Hol kaphatok további információt? Technikai kérdések: Kérje bővebb leírásainkat és példaprogramjainkat az [email protected] email címen. Kereskedelmi kérdések: Kereskedelmi kérdések tekintetében keresse kapcsolattartóját illetve az Értékesítési Hotline-t (http://shop.ingrammicro.hu/IMHUweb/ContactInfo2.htm ).


9

IM-XML Kérdések - Válaszok

Recommend Documents