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

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

GS1 Batch Query Használati útmutató

Dokumentum összefoglaló Dokumentum Dokumentum neve


Dokumentum kiadási dátuma

2016 április

Dokumentum verzió

1.0

Dokumentum állapota

Jóváhagyott

Szerzők Név

Szervezet neve

Bócsi Zsolt

GS1 Magyarország

Ábrahám Fruzsina

GS1 Magyarország

A változások bejegyzése Kiadás

Kiadás dátuma

Szerkesztette

A változások összefoglalása

2016.04.06

2016.04.06

Á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


1

Tömeges lekérdezés A http://stafflogger.gs1hu.org 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 200 000 sor tölthető fel, több oszlop esetén maximum 100 000 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.


© 2015 GS1 AISBL

Page 3 of 11


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.


© 2015 GS1 AISBL

Page 4 of 11


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 email címzettjét a megküldött számok utókövetésével kapcsolatban.


© 2015 GS1 AISBL

Page 5 of 11



© 2015 GS1 AISBL

Page 6 of 11


Emlékeztető email tartalma

Alább látható a rendszer által az illetékes tagszervezetnek kiküldött email. 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 e-mail. Please do not reply to this email. 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:

You received this list of GS1 ID Keys since the GCPs belong to your country.

The list was uploaded by <user name> from using the following email address: <email 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 [email protected]. Kind regards, GS1 Logger Team


© 2015 GS1 AISBL

Page 7 of 11


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 Service1-t (web szolgáltatást) azonosító kulcsok feltöltésére.

1.1.1.1 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 file2-on alapuló BQ web service kliens applikációt. A web service kliens hét műveletet kell, hogy végrehajtson:

1

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

A Batch Query Web Service SOAP-alapú üzenet technológiát alkalmaz.


© 2015 GS1 AISBL

Page 8 of 11

GS1 Batch Query Használati útmutató 1. ábra A tömeges lekérdezés folyamata és a hozzá kapcsolódó webes szolgáltatás műveletei

1.1.1.2 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.


© 2015 GS1 AISBL

Page 9 of 11


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:

1.1.2

□

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.


© 2015 GS1 AISBL

Page 10 of 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 [email protected] címen.

Üdvözlettel, GS1 Logger csapata


© 2015 GS1 AISBL

Page 11 of 11

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

Recommend Documents