GS1 Batch Query Használati útmutató. Verzió 1.0, Jóváhagyott, 2016 április

Átírás

1 Verzió 1.0, Jóváhagyott, 2016 április

2 Dokumentum összefoglaló Dokumentum Dokumentum neve Dokumentum kiadási dátuma GS1 Batch Query Használati útmutató 2016 április Dokumentum verzió 1.0 Dokumentum állapota Jóváhagyott Szerzők Név Bócsi Zsolt Ábrahám Fruzsina Szervezet neve GS1 Magyarország GS1 Magyarország A változások bejegyzése Kiadás Kiadás dátuma Szerkesztette A változások összefoglalása Ábrahám Fruzsina 1.0 Felelősségkorlátozó jognyilatkozat A GS1 a Szellemi tulajdonjogokra vonatkozó politikájával (GS1 IP Policy) arra törekszik, hogy elkerülje a szellemi tulajdonjog követelésével kapcsolatos bizonytalanságokat. Ezért kikéri a jelen GS1 Logger Felhasználói Kézikönyv dokumentumot kidolgozó Munkacsoport tagjainak szükségszerű beleegyezését ahhoz, hogy a GS1 tagjai számára jogdíjmentes felhasználási engedélyt adjanak, illetve ésszerű és megkülönböztetéstől mentes (RAND) licenc jogot engedélyezzenek a Szükséges Követelésekhez a GS1 Szellemi tulajdonjogok politikájában meghatározottak szerint. Továbbá felhívja a figyelmet arra a lehetőségre is, hogy a jelen specifikáció egy vagy több elemének alkalmazásbavétele olyan szabadalom vagy egyéb szellemi tulajdonjog hatálya alá tartozhat, amely nem jár Szükséges Követeléssel. Az ilyen szabadalom vagy egyéb szellemi tulajdonjog nem képezi a GS1 licenc kötelezettségeinek tárgyát. Mindezeken túlmenően az a megállapodás, amely a GS1 Szellemi tulajdonjogok politikája szerint biztosítandó engedélyek megadására irányul, nem terjed ki azon harmadik személyek szellemi tulajdonjogaira és igényeire, akik nem vesznek részt a Munkacsoportban. Következésképpen a GS1 azt javasolja, hogy bármely szervezet, ha ezzel a specifikációval összhangban lévő megvalósítást tervez, feltétlenül állapítsa meg, hogy fenn áll-e szabadalom bármelyik olyan speciális alkalmazásra vonatkozóan, amit a szervezet azért hasznosítana, hogy megvalósítsa az összhangot ezzel a specifikációval; illetve, hogy a szabadalom vagy egyéb szellemi tulajdonjog alapján szükséges-e valamilyen licencengedély. Az ilyen, licencengedély szükségességét, a szervezet által tervezett konkrét rendszer tulajdonságainak figyelembe vételével, a szervezet saját szabadalmi ügyvivőjével egyeztetve kell meghatározni. EZ A DOKUMENTUM JELENLEGI FORMÁJÁBAN ÉRVÉNYES, NEM TARTALMAZ SEMMILYEN GARANCIÁT, BELEÉRTVE A FORGALMAZHATÓSÁGI, A JOGSZERŰSÉGI, EGY ADOTT CÉLRA VALÓ FELHASZNÁLHATÓSÁGI, ILLETVE A JELEN SPECIFIKÁCIÓBÓL FAKADÓ EGYÉB KÖRÜLMÉNYRE VONATKOZÓ GARANCIÁKAT. A GS1 kizárja mindennemű felelősségét a jelen szabvány akár rendeltetésszerű, akár rendeltetésellenes használatából eredő összes különleges, közvetett, következményes vagy kártérítéssel járó károk tekintetében, beleértve bármely szellemi tulajdonjog jelen dokumentumban található vagy azzal kapcsolatos információ felhasználásával összefüggő jogsértés felelősségét is. A GS1 fenntartja magának a jogot arra, hogy a jelen dokumentum tartalmát bármikor külön értesítés nélkül módosítsa. A GS1 nem vállal garanciát a jelen dokumentum felhasználásáért, továbbá nem felel a dokumentumban szereplő esetleges hibákért, valamint nem terheli kötelezettség a dokumentumban található információk frissítésére vonatkozóan. A GS1 és a GS1 logó a GS1 AISBL lajstromozott védjegye. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 2 of 11

3 1 Tömeges lekérdezés A weboldalra való belépéskor az oldal tetején található menüsorból érhetjük el a tömeges lekérdezés funkciót. Az azonosító kulcsok listája a tömeges lekérdezés oldalán tölthető fel. Nyomja meg a Tallózás gombot, majd válassza ki azt az Excel fájlt, ami az ellenőrizendő azonosító kulcsokat tartalmazza. Fájlformátum: Kérjük, csak.xlsx formátumú Excel fájlt töltsön fel (Office 2007 vagy annak újabb verziójával készült Excel munkafüzet) Az.xls formátum nem támogatott! Fájltartalom: A feltöltött Excel csak egy munkafüzetet tartalmazhat. Az oszlopok száma korlátozott: GS1 azonosító kulcs + maximum 4 oszlop. A sorok száma korlátozott: ha csak egy oszlop van, maximum sor tölthető fel, több oszlop esetén maximum sor. Amennyiben rendelkezik olyan listával, amely tartalmazza a lekérdezett azonosító kulcsokat, de az azt használó cég GLN azonosítóját nem, a következő formátumban töltheti fel a táblázatot: Az első oszlop (A oszlop) az azonosító kulcs nevét tartalmazza (pl. GTIN, GLN, SSCC, GRAI stb.). Ez az oszlop csak egy fajta (az első sorban meghatározott) azonosító kulcsot jelölhet. A következő oszlopok (2-4) további GS1 azonosító kulcshoz kapcsolódó adatokat is tartalmazhatnak (gyártó, terméknév stb). Ezek az adatok megjelennek az elkészülő Excelben is, segítve a folyamatot. Amennyiben rendelkezik olyan listával, amely tartalmazza nemcsak a lekérdezett azonosító kulcsokat (pl. GTIN), de az azt használó cég GLN azonosítóját is, a következő formátumban töltheti fel a táblázatot: A oszlop: fejlécben (1. sor): a GS1 azonosító kulcs neve (pl. GTIN, GLN, SSCC, GRAI stb), alatta az azonosító kulcsok (cellánként egy). Az oszlop csak egyféle azonosító kulcsot tartalmazhat (az első sorban megadottat). B oszlop: fejlécben (1. sor): GLN, alatta az A oszlopban megadott azonosító kulcshoz kapcsolódó GLN azonosító (cellánként egy). A következő oszlopok (2-4) további GS1 azonosító kulcshoz kapcsolódó adatokat is tartalmazhatnak (gyártó, terméknév stb). Ezek az adatok megjelennek az elkészülő Excelben is, segítve a folyamatot. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 3 of 11

4 A kiválasztott fájl átnevezhető. Töltse ki a Cégnév mezőt annak a cégnek a nevével, amelyik a listát adta (opcionális). A fájl feltöltését követően (nyomja meg Feltölt gombot) a rendszer ellenőrzi a fájlt és az adattartalom formátumát. Ennek eredményeképp a következő információ jelenik meg az oldalon: A feltöltött fájl sorainak száma A GS1 szabvánnyal nem egyező azonosító kulcsok száma (pl. érvénytelen ellenőrzőszám, hossz, vagy karakterkészlet) A Letöltés gomb megnyomásával töltheti le a formátum ellenőrzés utáni azonosító kulcsok eredményét (az eredetileg feltöltött fájlban jelölve vannak a nem szabványos azonosító kulcsok). Nyomja meg a Futtat gombot a GEPIR-en való lekérdezés indításához. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 4 of 11

5 A folyamatjelző sáv százalékosan mutatja a feldolgozott azonosító kulcsok számát. A folyamat a szerveren folytatódik, így a böngészőt akár be is zárhatjuk, és később visszatérhetünk az oldalra. A lekérdezés végeztével az eredmény táblázatos formában jelenik meg és az összes adat (a feltöltött azonosító kulcsok listája státuszokkal, információ másik félről stb) Excel munkafüzetbe exportálható. Ezen kívül, amennyiben érvénytelen számok is szerepelnek, az Értesítés küldése gombot megnyomva értesíthetjük az illetékes tagszervezetet, hogy megtegye a szükséges lépéseket. Ha már egyszer rákattintottunk, inaktívvá válik, ezzel jelezve, hogy már elküldésre került az értesítésünk. Amennyiben az ellenőrzés során nem találhatók érvénytelen számok, az Értesítés küldése gomb eleve inaktív. Az Értesítés küldése gomb megnyomásával megjelenik egy Megjegyzés (Comment) ablak. Megjegyzés hozzáadásával segíthetjük az címzettjét a megküldött számok utókövetésével kapcsolatban. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 5 of 11

6 Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 6 of 11

7 Emlékeztető tartalma Alább látható a rendszer által az illetékes tagszervezetnek kiküldött . A riport kezelője egy linket kap az értesített érvénytelen azonosító kulcsok listájához. Subject: GS1 Logger Report invalid ID Keys Dear GS1 Logger Staff Report Administrator, This is an automatically generated notification . Please do not reply to this . A list of GS1 ID Keys has been uploaded to GS1 Logger platform. After checking this list through GEPIR, the batch query service indicated that the GEPIR status of the following GS1 ID Keys are invalid. Please see the invalid keys belonging to your country on the following link: <direct link to the list of reported Id Keys Excel spreadsheet format> You received this list of GS1 ID Keys since the GCPs belong to your country. The list was uploaded by <user name> from <GS1 MO> using the following address: < address>. Uploader s comment: < - > Even if the list of ID Keys may not be enough to explore and identify the reason of their invalid status but you may contact the relevant GS1 MO or company who uploaded the original list and initiated the batch query. Should you need further information about GS1 Logger or need assistance, please contact the GS1 Logger Support at lfs_support@gs1hu.org. Kind regards, GS1 Logger Team Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 7 of 11

8 1.1.1 A tömeges lekérdezés használata webes szolgáltatásként (BQ web service) Az LFS rendszer tömeges lekérdezés funkciójának használatához fel-, illetve letöltheti a GS1 azonosító kulcsok Excel fájlját a mylogger weboldalon keresztül, vagy használhatja a Batch Query Web Service 1 -t (web szolgáltatást) azonosító kulcsok feltöltésére A szolgáltatás jellemzői Az 1. ábra mutatja be a GS1 azonosító kulcsok feltöltésének teljes folyamatát, valamint a webes szolgáltatás műveleteit, melyek az általános adatfeltöltés főbb fázisaihoz kapcsolódnak a tömeges lekérdezés folyamatán belül. A tömeges lekérdezés webes szolgáltatásának alkalmazásához az ügyfél partnernek ki kell fejlesztenie egy WDSL file 2 -on alapuló BQ web service kliens applikációt. A web service kliens hét műveletet kell, hogy végrehajtson: 1. GetQueryGroups: az előzőleg feltöltött adatok kinyerésére (csoportosítva) 2. GetSessions: egy csoporthoz tartozó munkamenetek kinyerésére 3. ValidateQueryGroup: a feltöltött adat validálása GS1 LIB adatforrás alapján 4. RunQueryGroup: a tömeges lekérdezés adatbázisba feltöltött adathoz kapcsolódó lekérdezés feltöltése és futtatása GEPIR adatforrás információi alapján 5. RunExistingQueryGroup: egy, már létező csoportazonosítóra vonatkozó lekérdezés futtatása 6. GetSessionProgress: információ a folyamat munkamenet állapotáról 7. GetSessionResult: információk a folyamat munkamenet végső kimeneteléről 1 A Batch Query Web Service SOAP-alapú üzenet technológiát alkalmaz. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 8 of 11

9 1. ábra A tömeges lekérdezés folyamata és a hozzá kapcsolódó webes szolgáltatás műveletei GS1 Batch Query Használati útmutató A Batch Query Web Service részletei Az előzőleg taglalt hét tömeges lekérdezés műveletet webes szolgáltatásként a következőképpen kell végrehajtani: Megjegyzés: A tömeges lekérdezés webes szolgáltatásának pontos leírása a szolgáltatás WDSL fájljában található. A műveletek használatához érvényes autentikációs adatok (felhasználónév/jelszó) az elsődleges input paraméterek. 1. GetQueryGroups: Ennek a műveletnek a célja, hogy az előzőleg feltöltött csoportokról (azonosító kulcs-listákról) információval szolgáljon. A lista újrafuttatható az adatcsoport ismételt feltöltése nélkül is, valamint akár egy befejezett munkamenet-t követően. A művelet során visszaérkező információk a következők: cégnév csoport azonosító a csoportban szereplő azonosító kulcs típusa információ az utolsó lefutott munkamenetekről egyéb csoport adat (lásd WSDL) 2. GetSessions: Ennek a műveletnek a célja, hogy minden, egy adatcsoporthoz kapcsolódó munkamenetről információval szolgáljon. A csoportazonosító az input paraméter. A művelet során visszaérkező információk a következők: munkamenet azonosítója munkamenet kezdeti és végidőpontja érvényes/érvénytelen GLN-ek száma érvényes/érvénytelen azonosító kulcsok száma más munkamenet adat (lásd WDSL) 3. ValidateQueryGroup: Ennek a műveletnek a célja, hogy a GS1 LIB adatforráson alapuló azonosító kulcs formátum validáció eredményét ismertesse. Az input paraméterek az azonosító kulcs-típusok, csakúgy, mint az azonosító kulcsok és opcionálisan az azonosító kulcsokhoz kapcsolódó GLN-ek. A művelet során érkező válasz lehet egy OK, vagy egy formátum hiba típus (pl. CDVHiba) 4. RunQueryGroup: Ennek a műveletnek a célja, hogy az azonosító kulcs-listát feltöltse és lefuttassa a tömeges lekérdezést a GEPIR adatforrás információira alapozva. Az input paraméterek a következők: futtatás neve cégnév azonosító kulcs típusa azonosító kulcs GLN számmal Ez a művelet egy munkamenet ID-t eredményez. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 9 of 11

10 5. RunExistingQueryGroup: RunQueryGroup-hoz hasonlító művelet, de input paraméterként csak az előzetesen feltöltött lekérdezési csoport csoportazonosítója szerepel. Ez a művelet egy munkamenet ID-t is eredményez. 6. GetSessionProgress: A futó munkamenet állapotára vonatkozó információkkal kapcsolatos művelet. Input paraméterként a munkamenet ID szerepel, valamint a munkamenetek oldalszáma. Ennek megfelelően a feldolgozott adatnak csak egy részére is lehet lekérdezést kezdeményezni. Ez a művelet százalékosan jeleníti meg a futó munkamenet állapotát. 7. GetSessionResult: Ennek a műveletnek a célja, hogy a befejezett munkamenetekről információt adjon. Az input paraméterek megegyeznek a GetSessionProgress művelet paramétereivel. A művelet során visszaérkező információk a következők: azonosító kulcs azonosító kulcs státusza (érvényes, érvénytelen, hibás) GEPIR-alapú válaszok: azonosító kulcsokhoz kapcsolódó visszatérő kód, válasz kulcs és GLN specifikus válaszkulcs GLN szám Lekérdezések előzményei Minden feltöltött (weboldalon és webes szolgáltatásnál keresztül leadott) fájl és lekérdezési eredmény a szerveren tárolódik, így minden felhasználó láthatja az előzőleg indított lekérdezések listáját. Bármikor indíthatunk lekérdezést egy feltöltött fájlra a lista újrafeltöltése nélkül a fájlnév mellett megjelenő Futtat gombot megnyomva. Minden, az adott fájlhoz kapcsolódó eredmény a fájlnév alatt van kilistázva. Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 10 of 11

11 Kattintson a ikonra a kiválasztott fájl összes kapcsolódó lekérdezésének megtekintéséhez. Sok sikert kívánunk az alkalmazáshoz! Amennyiben további információra lenne szüksége a GS1 Loggerrel kapcsolatban, vagy segítségre van szüksége, kérjük, hogy vegye fel a kapcsolatot a GS1 Logger Támogató Csapatával az lfs_support@gs1hu.org címen. Üdvözlettel, GS1 Logger csapata Verzió 1.0, Jóváhagyott, 2016 április 2015 GS1 AISBL Page 11 of 11