GS1 Logger Felhasználói kézikönyv. Verzió 1.0, Jóváhagyva, 2016 április

Átírás

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

2 Dokumentum összefoglaló Dokumentum Dokumentum neve Dokumentum kiadási dátuma GS1 Logger Felhasználói kézikönyv 2016 április Dokumentum verzió 1.0 Dokumentum állapota Jóváhagyva Szerzők Név Bócsi Zsolt Aigner Edit Ábrahám Fruzsina Szervezet neve GS1 Magyarország 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áhagyva, 2016 április 2015 GS1 AISBL Page 2 of 52

3 Tartalomjegyzék 1 Bevezető Felhasználói szintek áttekintése Regisztráció A GS1 tagszervezetek regisztrációja Cégek regisztrációja Tagszervezeti vagy céges felhasználók regisztrációja Mobil applikáció Bejelentkezés Elfelejtett jelszó Jelszó megváltoztatása Kijelentkezés Mobil applikáció beállításai Adatbevitel Kézi adatbetöltés Automatikus adatbetöltés Több adatcsatorna beolvasása Elemfüzér Validáció Minősítés Előzménylista Mylogger weboldal Lista Saját prefix Fordítás Statisztika Statisztika aloldalak Az Admin felület használata Új céges regisztráció aktiválása Céges adat szerkesztése Felhasználói adatok szerkesztése Tömeges lekérdezés A tömeges lekérdezés használata webes szolgáltatásként (BQ web service) Lekérdezések előzményei Kapcsolattartás Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 3 of 52

4 1 Bevezető 2015 júliusa óta a GS1 MO-k regisztrálják és kezelik a felhasználó cégeket a GS1 Logger rendszerben. Így a GS1 MO rendelkezésre bocsájthatja a GS1 Loggert a tagszervezetnél regisztrált cégek felhasználói számára. Ebből adódóan a cégek elérhetik a következő fő funkciókat: GS1 azonosító kulcsok és vonalkódok gyors érvényesítése és validációja a GS1 Logger mobilapplikáción keresztül (elérhető Android, ios és Windows Phone telefonokon) Rekordok és statisztikák előzményei az LFS weboldalon ( Tömeges lekérdezés (Batch Query) nagy mennyiségű GS1 azonosító kulcsok érvényesítése és validációja az LFS weboldalon Excel formátumú lista feltöltésével és a Batch Query webservice n (Web szolgáltatás) keresztül Admin weboldal a felhasználók adatainak kezelésére 2 Felhasználói szintek áttekintése A GS1 Logger rendszerének 4 különböző szintű felhasználója lehet. Az alábbi ábra bemutatja a felhasználók hierarchikus szintjeit. Rendszer Adminisztrátor GS1 Tagszervezet Supervisor Cég Supervisor Cég Felhasználó GS1 Tagszervezet Felhasználó GS1 Tagszervezet Riport Adminisztrátor Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 4 of 52

5 Felhasználó Rendszer Adminisztrátor GS1 MO Supervisor Céges Supervisor GS1 MO felhasználó Céges felhasználó GS1 MO Riport Adminisztrátor Feladatok és jogok A GS1 MO-k (Tagszervezetek) regisztrációját kezeli és támogatja. A GS1 MO azon tagja, aki az MO felhasználóinak és cégeinek jogait kezeli és az Admin felületen szerkeszti a felhasználói adatokat. A MO Supervisora minden alatta lévő szint felhasználóinak rekordjait látja (MO és Céges felhasználó). Egy regisztrált cég azon tagja, aki a felhasználói jogokat kezeli és az adminisztrációs felületen szerkesztői joggal rendelkezik. A Céges Supervisor minden alatta lévő szint felhasználóinak rekordjait látja (Céges felhasználó). A GS1 MO felhasználók és Céges felhasználók ugyanazokkal a jogokkal rendelkeznek és csak a saját rekordjaikat látják a mylogger weboldalon (stafflogger.gs1hu.org). A GS1 MO Riport Adminisztrátor egy MO felhasználó speciális jogokkal. A Riport Adminisztrátor a Logger jelentések címzettje és a többi felhasználó által jelentett érvénytelen azonosító kulcsok felgöngyölítéséért is felel. 3 Regisztráció 3.1 A GS1 tagszervezetek regisztrációja Ha olyan tagszervezetet szeretne egy felhasználó regisztrálni, amely még nem regisztrált a GS1 Logger rendszerébe, a következő oldalon indíthatja el a regisztrációt: 1. Töltse ki a regisztrációs űrlapot: a. Válassza ki a tagszervezet nevét a legördülő listából. b. Adja meg az MO Supervisorának felhasználói nevét és címét. c. Másik kollégát is megadhat Riport Adminisztrátorként, az [Eltérő jelentés felhasználó megadása] melletti négyzet bepipálásával. Ha ez nincs bepipálva, az MO Supervisor lesz egyben az MO Riport Adminisztrátora is. 2. A [Regisztráció] gombra kattintva egy automatikus elektronikus levelet kap a GS1 Logger Rendszer Adminisztrátora, aki leellenőrzi a regisztrációs űrlapon megadott adatokat. 3. Ha az űrlapot helyesen töltötték ki, a Rendszer Adminisztrátor engedélyezi a regisztrációt és egy emlékeztető elektronikus levelet küld ki az MO Supervisornak és a Riport Adminisztrátornak a regisztráció befejeződéséről. 4. Az MO Supervisor megkapja az MO érvényesítő kódját is, ami a további kollégák regisztrációjához szükséges. Ez biztosítja, hogy csak azok regisztrálhassanak a rendszerben felhasználóként, akik ismerik ezt a kódot. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 5 of 52

6 Business Process MO regisztráció MO Supervisor Regisztráció indítása MO regisztrációs űrlap kitöltése Értesítés fogadása a regisztrációról Regisztráció vége LFS system Notification küldése a regisztrációról sikeres regisztrációról Regisztráció vége MO regisztrációról Értesítés küldése MO Supervisornak a regisztrációról MO report user System Admin Az MO regisztrációja az Admin felületen Mindig Értesítés küldése MO report usernek Ha SV nem report user sikeres regisztrációról Értesítés fogadása a regisztrációról Regisztráció vége Regisztráció vége Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 6 of 52

7 3.2 Cégek regisztrációja Ha egy GS1 MO egy céget szeretne regisztrálni a rendszerbe, a következő lépésekben teheti ezt meg: 1. Adja meg a cégnek a regisztrációs URL-t: A cég kapcsolattartója töltse ki a regisztrációs űrlapot (Cég regisztráció). Válassza ki a Tagszervezetet, ami keretében regisztrál. a. Ha az MO nincs a legördülő listában i. vegye fel a kapcsolatot a Tagszervezettel, hogy regisztráljon GS1 Logger rendszerve VAGY ii. válassza a legördülő listából a GS1 Global Office-t. 4. A megfelelő MO Supervisor kap egy értesítő elektronikus levelet a regisztráció megtörténtéről. 5. Az MO Supervisor ellenőrzi az adatokat és amennyiben megfelelőek, engedélyezi a regisztrációt az Admin oldalon: 6. Az MO Supervisor küld t a Céges Supervisornak a regisztráció befejezéséről. Az nek tartalmaznia kell egy érvényesítő kódot. Alább olvasható egy ezzel kapcsolatos, ajánlott sablon üzenet. Tárgy: Üdvözli a GS1 GS1 Logger Üzenet: Kedves GS1 GS1 Logger Supervisor, Cége sikeresen regisztrált a GS1 Logger rendszerbe. Az online felhasználói regisztrációhoz szükséges érvényesítő kód: xxxxxx Felhívjuk figyelmét, hogy minden felhasználónak az alábbi linken regisztrálnia kell az alkalmazás használatához: Supervisori regisztrációval a következő linken láthatja a kollégái által leolvasott rekordokat: Üdvözlettel, MO Supervisor Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 7 of 52

8 Business Process Company regisztráció Company Supervisor Regisztráció indítása Company regisztrációs űrlap kitöltése fogadása sikeres regisztrációról Regisztráció vége LFS System Company adatok tárolása a rendszerben (inaktív státusz) Notification küldése MO Supervisornak sikeres regisztrációról Regisztráció vége MO Supervisor Company regisztrációja az Admin felületen company regisztrációról küldése Company Supervisornak Regisztráció vége Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 8 of 52

9 3.3 Tagszervezeti vagy céges felhasználók regisztrációja A regisztrált Tagszervezetek vagy cégek felhasználói a következő weboldalon regisztrálhatnak a rendszerbe: A felhasználóknak szükségük van egy érvényesítő kódra, melyet a szervezetük Supervisorától kérhetnek el. Ez biztosítja, hogy csak azok regisztrálhassanak a rendszerben felhasználóként, akik ismerik ezt a kódot. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 9 of 52

10 4 Mobil applikáció 4.1 Bejelentkezés A mobil applikáció főoldalán található Regisztráció gomb a GS1 GS1 Logger regisztrációs honlapjára vezet. A Bejelentkezés gomb megnyomásával a saját bejelentkezési nevükkel és jelszavukkal használhatják a felhasználók a GS1 Logger alkalmazást. Ez garantálja, hogy a felhasználók csak a saját adataikhoz férhessenek hozzá. A szerver oldali azonosítás független attól, hogy weben vagy mobil kliensen történt a bejelentkezés. Nem érvényes felhasználói adatok bejelentkezési hibát eredményeznek. Szintén hibaüzenet jelenik meg abban az esetben, ha az alkalmazás azonosítása nem támogatott. Futtatás során GEPIR Root XML, nyelvi- és helyszíni források frissülnek, amennyiben elérhetőek a szerveren új adatok. Továbbá automatikus ellenőrző folyamatok (pl. Internet-elérés) is lefutnak. 4.2 Elfelejtett jelszó Amennyiben elfelejtette jelszavát, használja ezt a funkciót. 4.3 Jelszó megváltoztatása Amennyiben szeretné megváltoztatni jelszavát, használja ezt a funkciót. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 10 of 52

11 4.4 Kijelentkezés Használja ezt a funkciót a kijelentkezéshez. 4.5 Mobil applikáció beállításai A GS1 Logger mobil applikáció rendelkezik egy olyan funkcióval, aminek segítségével a GPS ki-be kapcsolással további helyszín információk beállíthatók. Ezen kívül, az adminisztrációs oldalon a rekordhoz tartozó korlátozott helyszín-információkat is megadhatunk, illetve az applikáció honlapján a megfelelő koordinátákat is láthatjuk. A GPS ON (alapértelmezett) koordináták beállítással az aktuális koordináták betöltődnek a szerverre és a Supervisor is ugyanezeket az információkat látja a rekordunk megtekintésekor. Eme beállítás két új tulajdonsággal bővült: más felhasználók számára a koordináták helyett az ország, vagy a legkisebb régió jelenhet meg. GPS OFF beállítással a készülék nem tud koordinátákat megosztani, viszont megadhatunk egy legördülő listából helyet, országot, vagy akár kisebb területeket is, amennyiben azok elérhetőek. Alapértelmezett beállításként a regisztrációkor megadott ország (GLN azonosító) jelenik meg, így minden leolvasott rekord helyszínéül ezt a területet adja meg. A GSP ON és OFF beállításai addig élnek, míg a felhasználó nem módosítja őket, pl. nem ad meg további helyszínadatot. GPS ON beállításkor zöld, GPS OFF beállításkor piros színű jelzés látható. Ha a GPS kikapcsolt állapotban van, arra a felhasználót figyelmezteti az alkalmazás elindításkor. GPS ON üzemmódban a felhasználó három szinten adhatja meg tartózkodási helyét: Koordináták (alapértelmezett) Ország Régió Az első lehetőség kiválasztásával láthatóvá válik a leolvasás pontos helye. A koordináták a másik két lehetőség során is továbbítódnak, ám a pontos helyszín csak a felhasználó számára elérhető, más felhasználók csak a választott szintet látják (ország, régió). GPS OFF használatakor egy hierarchikus listából választhatóak ki a helyszínadatok. A legtöbb esetben legalább az ország elérhető. További szinteket az MO a későbbiekben is határozhat meg. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 11 of 52

12 4.6 Adatbevitel Bejelentkezést követően egy főoldal jelenik meg, amin beolvashatjuk az ellenőrizni kívánt számsort. Az adatbevitel történhet manuálisan, vagy a készülékbe épített fényképezőgép/kamera/szkenner használatával automatikusan. Az ellenőrizendő GS1 azonosítószámon kívül a főoldalon elérhetőek még a következő funkciók: új rekord, új fotó, érvényesítés, minősítés, előzmények és beállítások. Adatbeküldés előtt ellenőrzésre kerül a hálózathoz kapcsolódás állapota. Lehetőség van a rekord azonnali képekkel együtt való beküldésére, vagy adatbevitel után csatolva a főoldalon keresztül az Új fotó gomb megnyomásával Kép csatolása a Rekord részletek oldalon is megtehető a jelentés előtt. Minden esetben 3 féle képméret közül választhatunk (kicsi, közepes, nagy). Minden rekordhoz legfeljebb három kép csatolható. A Küldés gomb megnyomásával továbbíthatjuk a rekord adatait és a csatolt képeket. Ugyanakkor, ha a Küldés és jelentés gombot megnyomjuk a képek csatolása előtt, ez a jelentés is elküldésre kerül. Ezt követően már nincs lehetőség további fotók csatolására még az előzmények- Rekord részletek -en keresztül sem. A Küldés és jelentés gomb inaktívvá válik, ha érvényesítési hibát talál a rendszer beolvasás után. Lehetőség van a jelentésekhez kommentek hozzáadására ezzel az érvénytelen számokkal dolgozó felhasználók munkáját lehet segíteni. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 12 of 52

13 4.6.1 Kézi adatbetöltés Kézi adatbetöltés esetén csak az AI kiválasztási listában megjelenő AI-k közül választhatunk. Más típusú rekord beolvasása nem lehetséges. Kézi adatbetöltés során először a szükséges AI azonosítót kell kiválasztani az AI listából, ezt követően gépelhetjük be a kulcsot. A billentyűzet automatikusan változik numerikustól alfanumerikusig az AI-tól függően. A Kész gomb is aktívvá válik, amint beütöttük a minimum számsort. Figyelmeztető hangjelzés jelzi a túlgépelést Automatikus adatbetöltés Automatikus adatbeolvasáskor nyomjuk meg az Olvas gombot és a készülék beépített fényképezőgépe/szkennere/kamerája lehetővé teszi a vonalkód beolvasását. Lineáris kódok (EAN-8, EAN-13 és GS1-128) beolvasásán túl be tudunk olvasni GS1 QR-kódot, inverz GS1 QR-kódot, GS1 Data Matrixot, inverz GS1 Data Matrix, GS1 DataBar Omnidirekcionális (halmozott, csökkentett magasságú) és ITF-14 kódokat. Minden GS1 azonosító kulcs és AI pár, ami az Általános GS1 Specifikációban szerepel, beolvasható, beleértve ebbe a más elemfüzér párok elemeit, illetve más egyszerű vagy bonyolult szimbólumot. Jelképek beolvasása esetén minden szabványos és nem szabványos jelkép beolvasásra kerül. A nem szabványos jelképek, melyek és www -vel kezdődnek, weboldal URL-ként automatikusan új ablakban jelennek meg. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 13 of 52

14 Ha a kód URL-t is tartalmaz (nem számít, hogy GS1 szabványos vagy sem) akkor az automatikusan megnyílik. Ha a jelkép több ID kulcsot is tartalmaz, akkor az érvényesítés gombot lenyomva egy lista jelenik meg, melyen kiválaszthatjuk azt az ID kulcsot, amelyet a GEPIR-en keresztül szeretnénk leellenőrizni. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 14 of 52

15 Olvasható típusok: GS1 DataBar Omnidirekcionális (halmozott, csökkentett magasságú): Több adatcsatorna beolvasása Elemfüzér Amennyiben egy jelkép beolvasása után egy másikat szeretnénk beolvasni, a rendszer meg fogja kérdezni, hozzá akarjuk-e fűzni a következő jelképet az előzőleg leolvasotthoz (mivel azonos jelképben helyezkednek el), vagy felül kívánjuk írni azt. Az összefűzhető jelképtípusok szabályai az alábbi táblázatban láthatók: Első jelképtípus Hozzáfűzött jelképtípus Új jelképtípus EAN-8, EAN-13 GS1-128 GS1-128 GS1-128 EAN-8, EAN-13, GS1-128 GS1-128 GS1 DataMatrix GS1 DataMatrix GS1 DataMatrix GS1 QR GS1 QR GS1 QR Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 15 of 52

16 4.7 Validáció Az ellenőrzési funkció az eddigi verziókhoz hasonlóan működik. Míg az érvényesítéshez internet és a szerver hozzáférés szükséges, a validáció funkció minden külső kapcsolat nélkül futtatható a készüléken. A leellenőrizendő, AI-val kiegészített szám mellett az alkalmazás a GPS koordináták beolvasási helyét is megküldi a WGS84/UTM rendszerben (amennyiben a felhasználó engedélyezte a GPS használatát a mobiltelefonon) valamint a beállított értékeket a GPS ki vagy bekapcsolt állapotának megfelelően. Mindkét beállítás alapértelmezett funkcióként működik. A szkennelés helyének meghatározása mellett a szkennelési idő, az aktuális időzóna és az egyedi eszköz azonosító is továbbításra kerül. Ha az adatátvitel nem sikerül (például internet kapcsolathiba következtében), a rekordot a memóriában tárolja a telefon, és a következő adatátviteli lehetőségnél küldi el. Ha három sikertelen próbálkozás után sem tudja elküldeni a rekordot, akkor automatikusan törlődik. Sikeres adatátvitelt követően a szerveroldalról a következő válaszok érkezhetnek: A szám érvényes - zöld háttérrel jelenik meg; A szám érvénytelen piros háttérrel jelenik meg; A kapcsolat nem jött létre sárga háttérrel jelenik meg. Mindhárom esetben a GEPIR visszatérési kód (RC) és a választ adó router adatai jelennek meg a képernyőn, státuszuknak megfelelően. Az Új log gombra kattintva (az oldal alján) kezdeményezhetünk új beolvasást, aminek következtében újraindul a validálási folyamat. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 16 of 52

17 Ha a szám érvénytelen, javasoljuk az Új fotó gomb megnyomását, amivel fényképe(ke)t készíthetünk a termékről úgy, hogy a GTIN szám is látsszon, amit így továbbíthatunk a szerverre. Az adatátvitel során a rendszer en keresztül küld egy riportot az illetékes tagszervezetnek, aki megteszi a szükséges lépéseket. Képe(ke)t az Előzmények részletei oldalon a jelentés küldése előtt is csatolhatunk. A jelentés elküldését követően viszont már nem tudunk a rekordhoz képeket csatolni. Az illetékes MO automatikus azonosítása az ország prefixen keresztül történik a szerveren. A felhasználó értesítést kap a kézbesítést követően, mely tartalmazza a címzettek listáját, vagy a hiba leírását. 4.8 Minősítés A minősítés funkció alapja a GS1LIB programkönyvtár. A GS1LIB tartalmazza az Általános GS1 Specifikáció által meghatározott definíciókat, ellenőrzi a kötelező, kizárólagos és kapcsolt párok szabályait, valamint a GS1 prefixeket és GS1-8 prefixeket. Ez a működési modell lehetővé teszi, hogy a mobil kliensen a GS1 minősítést el lehessen végezni a beolvasott szimbólumon vagy egy kézzel bevitt elemfüzéren internet és/vagy szerver-kapcsolat nélkül is. A Minősítés első képernyője egy lista, amely a feldolgozott kódot (beolvasott vagy manuálisan rögzített) és egyéb paramétereket (a dekódolt ID Kulcsok, az AI pár és a szimbólum) tartalmazza. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 17 of 52

18 A sikeres beolvasást vagy a kézi adatbevitelt követően a minősítés a készülék oldalán automatikusan lefut, és az ellenőrzések eredményei különböző színű ikonokkal jelennek meg a Minősítés gombra kattintva. A Zöld pipa azt jelenti, hogy szabványos, a sárga felkiáltójel azt jelenti, hogy javítható (pl ellenőrző számjegy), vagy kétséges (pl ismeretlen felhasználási területeken), és a piros X azt jelenti, nem szabványos a kód. A Minősítéssel egy időben a Fotó gomb aktiválódik, és rákattintva tudunk csatolni képe(ke)t a rekordhoz, illetve el tudjuk küldeni az adatokat a szerver oldalra, amely ellenőrzi GEPIR rendszer segítségével, hogy az azonosító kulcs, vagy cégprefix érvényes-e vagy sem. A dekódolt elemek kiválasztása során az azonosító kulcsok egyenként vagy az AI tartalom szerint részleteiben ellenőrizhetők a minimum-maximum hosszúság, formátum, prefix, prefix-kezelő, prefix alapú AI támogatás, elválasztó és tartalom figyelembevételével. Az elem füzérpár ellenőrző listája adattartalmi szempontból több különböző sorból is állhat /(pl. abban az esetben, ha az AI hibás vagy a nem azonosítható AI egyéb információi nem jelennek meg, vagy egyéb AI esetében (pl dátum) egyéni ellenőrzéseket teszünk (pl egy dátum esetében leellenőrizhető, hogy a hónap/nap adatok érvényesek-e vagy sem)/, más esetben ez a sor egyáltalán nem jelenik meg. 4.9 Előzménylista Az Előzmény gombbal kilistázhatók a korábbi ellenőrzések (rekordok) és a hozzájuk kapcsolódó információk. Alapesetben az utolsó 10 rekord elérhető, de a felhasználó kibővítheti a listát kilenc oldalnyi egyenként letölthető előzménylistával (legfeljebb 100 rekord). A lista megjelenítését mindig adatkommunikáció előzi meg, ami a szerverről történő összes rekord letöltését jelenti. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 18 of 52

19 Az előzménylistában az első ikon mutatja a minősítés, a második pedig a validáció eredményét (GEPIR lekérdezés). A megadott sorra kattintva további információkat kapunk a rekordról. A részletes adatok alatt a minősítés és validálás funkciói egymástól függetlenül megjelennek, mint azonosító kulcsok a Tagszervezet adatforrásaiként. Ha a szám érvényes, láthatóvá válik a cégprefix tulajdonosának neve és címe (akár még Google Mapsszel is leellenőrizhetjük, ha csatlakoztattuk az alkalmazáshoz), az adatbeküldés és rögzítés dátuma, a rekordhoz csatolt képek és a bejelentés időpontja. Ezen kívül, még nem engedélyezett használat esetén is pl. érvénytelen számok, a beolvasási idő és beolvasási helyszín (a hozzá tartozó GLN-nel, amit szintén Google Maps-ben leellenőrizhetünk), a felhasználó neve és az eszköz GIAI száma, a GEPIR válaszkódjainak adatai és a választ adó router is rögzítésre kerül. Amennyiben ezek a rekordok a helyszín adatbázisban is fellelhetők, a helyszíni adatlapokat egy URL is jelzi a beolvasási helyszín blokkban. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 19 of 52

20 5 Mylogger weboldal Az Előzménylista a következő weboldalon is elérhető: Ezen az oldalon minden felhasználó beléphet a saját felhasználónevével és jelszavával és kilistázhatja a rekordjait időrendi sorrendben, valamint szűrheti pl. időpont, helyszín vagy státusz szerint. Ez a weboldal nyolc nyelven elérhető (angolul, magyarul, portugálul, oroszul, csehül, németül, lettül és szlovénul). A honlap vázlatos térképe: 1. Lista Az előzmények rekordjai egyetlen oldalon kilistázhatóak 2. Saját prefixek Az összes saját prefix 3. Statisztika Statisztika készítése a rekordokból (tömeges lekérdezés, vagy mobil segítségével leolvasott rekordok) többféle nézetben 4. Tömeges lekérdezés Nagy mennyiségű adat feltöltése, érvényesítése és megosztása 5. Admin A megfelelő jogosultsággal módosíthatóak a felhasználók adatai 6. Kapcsolattartás Itt látható minden GS1 MO Supervisor és Riport Adminisztrátor felhasználó neve és címe 5.1 Lista Az előzményekből elérhető rekordok egyetlen képernyőn korlátozott számban megjeleníthetők, ám az oldalak száma nem korlátozott. A felhasználók nem törölhetnek vagy módosíthatnak előzményrekordokat. A profilbeállításoknak megfelelően módosítható a rekordok megjelenítése, így mások számára (pl. Supervisor) is a rekord pontos beolvasási helyszínét vagy csak a megadott terület korlátozott nézetét is megadhatják. Lehetőség van dinamikus szűrésre is, időszak, helyszín, AI, ország, GS1 azonosító kulcs, beolvasó eszköz szerint. A Supervisorok további szűrőket (cég, felhasználó) is alkalmazhatnak. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 20 of 52

21 A Részletes információk link alatt nemcsak a rekord részletei, de a beolvasás pontos helyszínét tartalmazó Google térkép is elérhető. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 21 of 52

22 Amennyiben a megadott rekordok képeket is tartalmaznak, a weboldalon szintén megjelennek (bármikor eltávolíthatók és menthetők) a rekord részletei között. A minősítés funkció következtében a weboldal képes minkét ellenőrző mód eredményeinek ábrázolására. A GEPIR státusz, illetve Logger státusz oszlopok szabványos vagy nem szabványos módon (az Általános GS1 Specifikációnak megfelőlen) jelennek meg a weboldalon. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 22 of 52

23 Továbbá a GEPIR státusz alatt lehetőség van a rekord aktuális GEPIR státuszának ismételt lekérdezésére is. A GEPIR és Logger státusz alatt láthatjuk az érvénytelen számok illetve a nem szabványos számok indokait. A Leolvasás helye és ideje blokkban a beolvasás helyszínének koordinátáit láthatjuk. A részletek fül is tartalmaz egy Google térképet a beolvasás pontos helyszínével, valamint további információkat a felhasználó nevéről, GSRN számáról, a készülék GIAI számáról és hogy a felhasználó melyik MO-hoz vagy Céghez tartozik. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 23 of 52

24 A Rekord státusz oszlopban leellenőrizhetjük, hogy a jelentés- elküldésre került-e, illetve további részleteket is megtekinthetünk. A jelentés részleteinél megjegyzést fűzhetünk a kommentek-űrlap segítségével, így kapcsolatba léphetünk az érvénytelen GTIN beolvasását végző felhasználóval, így a termékről interaktív módon további információkat tudhatunk meg. Minden egyes kommentről a címzettnek a rendszer emlékeztető elektronikus levelet küld. Attól függően, hogy hol tart az érvénytelen szám feldolgozása, a státusz is módosítható (Új, Feldolgozás alatt, és Lezárva). Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 24 of 52

25 A Lista oldal alján letölthetőek a rekordok a weboldalról Excel vagy.csv formátumban. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 25 of 52

26 5.2 Saját prefix A felhasználók csak a hozzájuk kapcsolódó MO prefixével ellátott felhasználói kulcsokat láthatják. A Riport Admisztrátor és a Supervisor láthatja az összes olyan azonosító kulcsot, ami a saját tagszervezetük prefixéből lett képezve (beleértve a mások által beolvasott vonalkódokat is). 5.3 Fordítás A Fordítás menü segítségével a weboldal és alkalmazás interaktív módon, képek segítségével lefordítható fordítói jogosultsággal. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 26 of 52

27 5.4 Statisztika A Statisztika menüpont kiválasztásával egy irányítópult jelenik meg Statisztika aloldalak A Statisztika irányítópult hat különböző ábrát jelenít meg az aktuális hónap rekordjai alapján1. Természetesen az időszak is beállítható az irányítópulton. Fontos megjegyezni, hogy az előzménylistában kiválasztott időszak nincs befolyással a statisztikára. 1. Érvényes, érvénytelen és hibás rekordok szétválogatása 2. Szabványos és nem szabványos rekordok szétválogatása 3. Adattartalmak (AI kombinációk) szétválogatása 4. Jelképtípusok szétválogatása 5. GEPIR visszatérő kódok leválogatása - csak GS1 MO Supervisorok számára elérhető 6. GS1LIB visszatérő kódok leválogatása - csak GS1 MO Supervisorok számára elérhető A Részletek gombra kattintva az aloldalon megkapjuk a kért statisztikát és részleteit. Az adatok az irányítópulton előzetesen megadott időtartam szerint jelennek meg (1). 1 Például egy i időponttal megnyitott statisztikai irányítópult esetében a és közti időszak jelenik meg. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 27 of 52

28 Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 28 of 52

29 Érvényes, érvénytelen és hibás rekordok eloszlása A bal oldali grafikon a MO-k szerint leválogatást tartalmazza három GEPIR státusz szerint (érvényes, érvénytelen, hibás/faulted). Ha a kurzort a grafikonon a beküldő neve melletti sorra vezetjük, megjelenik a rekordok száma. A kördiagram a beolvasott rekordok GEPIR státuszonkénti számát jelzi (érvényes, érvénytelen, hibás). A kördiagram egyes cikkeinek további információi is megtekinthetők a kördiagram megfelelő szeletére kattintva: 1. szint. Felhasználó MO/Cég által kezdeményezett lekérdezések rekordjai 2. szint. A kiválasztott MO/Cég felhasználóinak rekordjai 3. szint. A kiválasztott felhasználó és az azonosító kulcsot kiadó MO rekordjai Az aktuális szint a körcikk neve alatt jelenik meg. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 29 of 52

30 A grafikon alatti táblázat a kördiagram pontos értékeit mutatja. A statisztika magában foglalhatja a mobil és tömeges lekérdezés rekordjait is. Az időtartam a lap tetején módosítható. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 30 of 52

31 GS1 MO Supervisorként való belépéskor cégnévre is szűrhetünk, így egy adott cég statisztikáit is lekérhetjük. Az ábrák képfájlként is exportálhatóak. A statisztika adatai Excel munkafüzetbe vagy.csv file-ba is exportálhatók. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 31 of 52

32 Szabványos és nem szabványos rekordok eloszlása A bal oldali grafikon a felhasználó szervezetek (MO/Cég) szerinti leválogatást tartalmazza GS1 LIB státusz szerint (szabványos, nem szabványos). Ha a kurzort a szervezet nevét követő grafikonra vezetjük, megjelenik a rekordok száma. A jobb oldali kördiagram a beolvasott rekordok GS1 LIB státuszonkénti számát jelzi. A kördiagram egyes cikkeinek további információi is megtekinthetők a kördiagram megfelelő szeletére kattintva: 1. szint. A felhasználó szervezetek által kezdeményezett lekérdezések rekordjai 2. szint. A kiválasztott felhasználó szervezet felhasználóinak rekordjai Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 32 of 52

33 A grafikon alatti táblázat a kördiagram pontos értékeit mutatja. Az időtartam a lap tetején módosítható. GS1 MO Supervisorként való belépéskor cégnévre is szűrhetünk, így egy adott cég statisztikáit is lekérhetjük. Az ábrák képfájlként is exportálhatóak. A statisztika adatai Excel munkafüzetbe vagy.csv file-ba is exportálhatók. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 33 of 52

34 Adattartalmak (AI kombinációk) eloszlása Jelképtípusok eloszlása Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 34 of 52

35 GEPIR visszatérő kódok leválogatása Ez a fajta statisztika csak GS1 MO Supervisorok számára elérhető. A kördiagram a GEPIR visszatérő kódokat mutatja meg. Minden visszatérő kódhoz lekérhető a részletes statisztikai adat a kördiagram egyik cikkére való kattintással: 1. szint. A kiválasztott visszatérő kódra válaszoló MO-k rekordjainak leválogatása Az aktuális százalék a körcikk neve mellett jelenik meg. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 35 of 52

36 A grafikon alatti táblázat a kördiagram pontos értékeit mutatja. A statisztika adatai Excel munkafüzetbe vagy.csv file-ba is exportálhatók. A statisztika magában foglalhatja a mobil és tömeges lekérdezés rekordjait is. Az időtartam a lap tetején módosítható. Az ábrák képfájlként is exportálhatóak. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 36 of 52

37 GS1LIB visszatérő kódok leválogatása Ez a fajta statisztika csak GS1 MO Supervisorok számára elérhető. A kördiagram a GS1 LIB visszatérő kódjait mutatja meg. Minden visszatérő GS1 LIB kódhoz lekérhető a részletes statisztikai adat a kördiagram egyik cikkére való kattintással: 1.szint. A visszatérő kódot megkapó MO-k rekordjainak leválogatása Az aktuális százalék a körcikk neve mellett jelenik meg. É R V É N Y T E L E N A I Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 37 of 52

38 A grafikon alatti táblázat a kördiagram pontos értékeit mutatja. A statisztika adatai Excel munkafüzetbe vagy.csv file-ba is exportálhatók. Az időtartam a lap tetején módosítható. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 38 of 52

39 Az ábrák képfájlként is exportálhatóak. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 39 of 52

40 5.5 Az Admin felület használata Az Admin felület az MO vagy a Céges Supervisor számára elérhető a következő címen: GS1 Supervisorként a tagszervezetünkhöz kapcsolódó összes céget kilistázhatjuk Új céges regisztráció aktiválása A GS1 MO Supervisor értesítő elektronikus levelet kap, amint egy új cég regisztrál a rendszerbe. A Cég és a Supervisor adatai rögzítésre kerülnek, de a cég státusza még inaktív állapotban van. A következő lépésekkel aktiválhatjuk az új céget: 1. Kattintsunk az emlékeztető ben megadott URL-re amely az Admin felületen nyílik meg. 2. Az Admin felületen a Céges Supervisor adatlapja jelenik meg. 3. Pipáljuk be a lap alján az Aktív felirat melletti négyzetet. 4. Kattintsunk a Mentés (Save) gombra. 5. érkezik a Céges Supervisornak a sikeres regisztrációról. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 40 of 52

41 5.5.2 Céges adat szerkesztése Amennyiben valamilyen okból céges információkat szeretnénk megváltoztatni, azt a céges adatlapon megtehetjük. Nyissuk meg az Admin felületet és kattintsunk a Szerkesztés (Edit Company) gombra a megváltoztatandó cég sorában. A céges adatlapon láthatjuk a nevet, címet, azonosító kódot és az országot. Amennyiben törölni kívánjuk egy cég GS1 Logger hozzáférését, minden felhasználóját inaktívvá kell tenni (lásd következő fejezet) Felhasználói adatok szerkesztése Az MO felhasználóinak listáját a lap tetején lévő Users (Felhasználók) gombbal hívhatjuk elő. Ha egy bizonyos cég felhasználóira vagyunk kíváncsiak, a megfelelő cég sorában látható Users (Felhasználók) gombra kattintsunk. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 41 of 52

42 A felhasználói listában kattintsunk a Szerkesztés (Edit) gombra a megváltoztatni kívánt felhasználó sorában. A felhasználói adatlapon megtekinthetjük/megváltoztathatjuk a felhasználónevet, címet, a felhasználó jogosultsági körét, valamint aktiválhatjuk/deaktiválhatjuk a felhasználó státuszát. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 42 of 52

43 5.6 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áhagyva, 2016 április 2015 GS1 AISBL Page 43 of 52

44 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áhagyva, 2016 április 2015 GS1 AISBL Page 44 of 52

45 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áhagyva, 2016 április 2015 GS1 AISBL Page 45 of 52

46 Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 46 of 52

47 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áhagyva, 2016 április 2015 GS1 AISBL Page 47 of 52

48 5.6.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 2 -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. ábra A tömeges lekérdezés folyamata és a hozzá kapcsolódó webes szolgáltatás műveletei 2 A Batch Query Web Service SOAP-alapú üzenet technológiát alkalmaz. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 48 of 52

49 A Batch Query Web Service részletei GS1 Logger Felhasználói kézikönyv 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. 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. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 49 of 52

50 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 Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 50 of 52

51 5.6.2 Lekérdezések előzményei GS1 Logger Felhasználói kézikönyv 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. Kattintson a ikonra a kiválasztott fájl összes kapcsolódó lekérdezésének megtekintéséhez. Verzió 1.0, Jóváhagyva, 2016 április 2015 GS1 AISBL Page 51 of 52

52 5.7 Kapcsolattartás GS1 Logger Felhasználói kézikönyv Amennyiben további kérdések merültek fel, ezen az oldalon megtalálja a regisztrált tagország Riport Adminisztrátorának és Supervisorának felhasználónevét és címét. 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áhagyva, 2016 április 2015 GS1 AISBL Page 52 of 52