GS1 Logger Staff Felhasználói kézikönyv
GS1 Logger for Staff Felhasználói kézikönyv Verzió 1.4.1, 2012.06.01.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 1 / 20
GS1 Logger Staff Felhasználói kézikönyv
Tartalom 1.
Bevezetés ................................................................................................................................... 3
2.
Funkcionális leírás – a szoftver működése .............................................................................. 3 2.0. 2.1. 2.2.
Jelszókiadás ....................................................................................................................................... 3 Bejelentkezés ..................................................................................................................................... 4 Adatbevitel.......................................................................................................................................... 5 2.2.1. Manuális adatbevitel ................................................................................................................. 6 2.2.2. Automatikus adatbevitel ........................................................................................................... 7 Automatikus vonalkód leolvasás esetén az Olvas (Scan) gombot kell megnyomni, melynek hatására bekapcsol a készülék kamerája és leolvashatjuk a vonalkódot. A lineáris, EAN-8 vagy EAN-13, GS1-128 típusú vonalkódok leolvasása mellett a QR-Code, a GS1 DataMatrix, GS1 DataBar Omnidirekcionális (normál, halmozott, csökkentett magasságú és kiterjesztett) és ITF-14 típusok leolvasása is engedélyezett. ...................................................................................................... 7 2.3. Adattovábbítás és adatellenőrzés ...................................................................................................... 8 2.4. Előzmények listázása ....................................................................................................................... 10
3.
Műszaki leírás ........................................................................................................................... 13 3.0. 3.1.
4.
A rendszer elemei ............................................................................................................................ 13 A Logger for Staff működése ........................................................................................................... 14 3.1.1. Ellenőrzési funkciók az alkalmazás elindításakor .................................................................. 14 3.1.2. Adatbevitel és Lekérdezés küldése Szerver felé ................................................................... 14 3.1.3. Információgyűjtés és Válaszüzenet Szervertől iPhone felé ................................................... 16 3.1.4. Előzmények (History) ............................................................................................................. 16 3.1.5. Időzóna ................................................................................................................................... 17 3.1.6. AI (254) LOC számítás ........................................................................................................... 17 3.1.7. Jelentés (Report e-mail iPhone kliensről) .............................................................................. 18 3.1.8. Nyelvi támogatás .................................................................................................................... 19
A Logger for Staff 1.3 és 1.4.1 verziójának összehasonlítása ............................................... 20
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 2 / 20
GS1 Logger Staff Felhasználói kézikönyv
1.
Bevezetés A GS1 Magyarország fő bevételt eredményező alapszolgáltatása az elmúlt negyed évszázadban a GS1 cégprefixek, illetve azonosító számok kiadása volt. Bár tevékenységi körünk sokat bővült az utóbbi években, ez az alapszolgáltatás nagy valószínűséggel a jövőben is jelentős szeletet képvisel majd szolgáltatásaink között. Ugyanakkor az egész GS1 közösség küzd az illetéktelen számhasználatból adódó bevételkiesés ellen: globális és európai szinten is időről-időre feltűnnek kezdeményezések a probléma megoldására. Összhangban a fentebb leírtakkal, a GS1 Magyarország céljai között szerepel egy olyan szoftver kifejlesztése, ami megoldást jelenthet a GS1 Tagszervezetek munkatársai számára az illetéktelen GS1 azonosító számhasználat kiszűrésére. A GS1 Logger for Staff egy okostelefonra készülő alkalmazás, melyen keresztül a GS1 azonosító számok az érvényességéről kapunk információt a GEPIR hálózat és a GS1 Általános Specifikáció (verzió 12) előírásainak segítségével. A fejlesztési projektben megvalósításra kerülnek az alábbi rendszerelemek:
a kliens oldali alkalmazást (iPhone-ra és iPad-re),
a szerver oldali alkalmazást (validálási szabályokkal együtt),
a logolt adatokat tartalmazó adatbázist,
a kapcsolatot a GEPIR-rel, a helyadatbázisunkkal, az eszköz adatbázissal és a Logger adatbázissal
a belső weboldalt és a mögötte levő alkalmazást, amin a lekérdezések elvégezhetők
2011 októberében a GS1 Logger for Staff alkalmazás fenti elemei proof of concept szinten elkészültek, iOS operációs rendszeren működnek, az alkalmazástesztelésre, maximum 500 felhasználó kiszolgálására alkalmas.
2.
Funkcionális leírás – a szoftver működése
2.0.
Jelszókiadás GS1 Tagszervezet regisztrációja Supervisor-ként A pilotra jelentkező MO az erre létrehozott regisztrációs felületen megadja az alábbi adatokat: • • • • •
GS1 MO neve GS1 MO supervisor e-mail címe report e-mail cím (amire a reportok mennek később) adott ország GLNloc azonosítója (opcionális) jogi feltételek elfogadása
Az MO által megadott adatokat a GS1 Magyarország automatikus e-mailben megkapja és egy belső adminisztrációs weboldalon keresztül rögzíti a felhasználók adatait tartalmazó adatbázisba. Erre a lépésre azért van szükség, hogy a regisztráció során biztosítható legyen, hogy csak GS1 Tagszervezet regisztrálhasson. Az adatbázisban rögzítés pillanatában generálódik egy felhasználónév (pl. GS1RU, jelszó /ezt később bármikor megváltoztathatja a weboldalon/ és egy egyedi kód, amit az adott MO-hoz rendelünk, és egy automatikus e-mailben kiküldünk számára (az e-mail tartalmazza, hogy sikeresen regisztrált a pilotba, és munkatársai a mellékelt kód segítségével tudnak regisztrálni a weboldalunkon).
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 3 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
Ez az egyedi kód lehetővé ővé vé teszi, hogy csak azok regisztrálhassanak egy MO munkatársaiként, akik ismerik az adott MO kódját. A „Supervisor” felhasználónévvel és jelszóval belépve láthatja a saját munkatársai (adott MO-hoz hoz későbbiekben kés regisztráltak) adatait.
Felhasználók regisztrációja A felhasználó a gs1logger.gs1hu.org weboldalon a Regisztráció gombot megnyomva indíthatja el a regisztrációt. A megjelenő ő weboldalon beírja a kért adatokat: • • • • • • • • • • •
felhasználónév, utónév, vezetéknév, jelszó, jelszó megerősítése, sítése, GS1 Tagszervezet, e-mail cím, telefon sorozatszáma, telefon GIAI száma, ellenőrző kód, jogi feltételek elfogadása.
A regisztrációs oldal alján ott szerepel, hogy „Elfogadom a jogi feltételeket”, ha a jogi feltételek elfogadása nincs bepipálva, bepipálva, akkor a regisztráció sikertelen és erre figyelmeztetjük a felhasználót.
2.1.
Bejelentkezés A GS1 Logger for Staff-ot ot a felhasználók saját felhasználónévvel és titkos jelszóval használhatják. Ez garantálja, hogy minden felhasználó csak a saját adataihoz és rögzített rekordjaihoz férjen hozzá. A jelszóellenőrzés rzés szerver oldalon történik, akár a mobil, akár a webes kliens oldalról érkezik a bejelentkezés. Hibás felhasználónév és jelszó megadása esetén hibaüzenetet kapunk a sikertelen bejelentkezésről.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 4 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
Belépéskor frissül a GEPIR Root XML, ha a szerveren új verzió érhető el. el Továbbá vannak más automatikusan működő ő ellenőrzési ellen funkciók is, mint például azz internet kapcsolat ellenőrzésére, ellen és a helyinformáció nélküli adatok frissítésére is.
Valamint lehetőségünk ségünk van arra, hogy az alkalmazással megadjuk a tartózkodásunk helyszínét. A koordináták megadása nélkül a weboldalon sem tekinthető tekinthet meg a leolvasás helyszíne.
2.2.
Adatbevitel Bejelentkezés után az Logger alkalmazásválasztó képernyője je jelenik meg. Staff esetében ez egy funkcióra, ill. gombra korlátozódik, amit kiválasztva a Staff főképernyőjére f őjére jutunk. Az adatbevitel történhet manuálisan, illetve az eszköz kameráját használva automatikus szkenneléssel. A főképernyőn az ellenőrizni izni kívánt GS1 azonosító azonosí szám megadása adása mellett, a kilépés, a jelentés és az előzmények zmények funkciókhoz férhetünk hozzá, ill. Az alkalmazásválasztó képernyőre képerny tudunk visszalépni.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 5 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
Az adat elküldése előtt a hálózati kapcsolatok ellenőrzése ellen rzése történik meg, illetve a report e-mail e címek mek frissítése, ha a szerveren új report e-mail e címek érhetőek el.
2.2.1.
Manuális adatbevitel Manuális adatbevitel során a támogatott AI kódok számának növekedésével az adatbevitel sorrendje is megváltozott. Elsőként Els az AI listából kell kiválasztani a szükséges AI-t, AI ezt követően kell megadni az ellenőrizni rizni kívánt azonosítókulcsot. Manuális anuális adatbevitellel csak az AI listában rögzített típusú azonosító kulcs rögzíthető, egyéb típus rögzítésére itt nincs mód.
A billentyűzet attól függően, ően, hogy az adott adott kódban adott pozíciótól kezdve engedélyezett-e engedélyezett az alfanumerikus jel bevitele is, automatikusan numerikusról alfanumerikusra vált. A „Kész” gomb is akkor válik csak aktívvá, ha a minimális karakterszámot már beírtuk, a maximális hossz elérését pedig figyelmeztető hangüzenet jelzi jelzi.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 6 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
2.2.2.
Automatikus adatbevitel Automatikus vonalkód leolvasás esetén az Olvas (Scan) gombot kell megnyomni, melynek hatására bekapcsol a készülék kamerája és leolvashatjuk a vonalkódot. A lineáris, EAN-8 EAN vagy EAN-13, GS1-128 128 típusú vonalkódok leolvasása mellett a QR-Code, QR Code, a GS1 DataMatrix, GS1 DataBar Omnidirekcionális irekcionális (normál, halmozott és csökkentett magasságú) és ITF-14 ITF típusok leolvasása is engedélyezett. Jelképből történő olvasáskor minden szabványos és nem szabványos jelkép beolvasásra kerül, feladására azonban csak a szabványos AI-val val ellátott SSCC (00), GTIN (01), GDTI (253), GCN (255), GINC (401), GSIN (402), GLN loc (414), GLN org (415), GRAI (8003), GIAI (8004), (8004 GCTIN (8006), GSRN (8018), PRODUCT URL (8200) esetében van lehetőség.
GS1 DataBar Omnidirekcionális (halmozott, csökkentett magasságú)
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 7 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
2.3.
Adattovábbítás és adatellenőrzés adatellen Adatküldés előtt további automatikus ellenőrzésre ellen is sor kerül,, melynek mely részleteit az ellenőrzőlistában listában tekinthetjük tekinthet meg. Az ellenőrzőlista lista tartalmazza a leolvasott/beírt AI támogatottságát, az input hossz és tartalmi ellenőrzését,, valamint azt hogy a GEPIR-ben GEPIR kezelt-e a leolvasott azonosító globális prefixe és a kijelőlt kijel tartomány.. Továbbá arra is van lehetőségünk, lehet hogy a hibás ellenőrzőszámmal őszámmal rendelkező azonosító számot javítsuk. A küldés gomb jobb szélén megjelenő megjelen ikon arról tájékoztat, hogy az azonosítókulc azonosítókulcs további beavatkozás nélkül is küldhető-e küldhet (zöld pipa), beavatkozást st igényel küldés előtt el (sárga felkiáltójel), ill. nem küldhető (piros X). Zöld azonosítók az ellenőrző ellen lista megtekintése nélkül is küldhetők, küldhet itt az ellenőrző listát a pipára katttintva érj érjük ük el. A másik két esetben mindig az ellenőrzőlista ellen jelenik meg először ször a küldés gomb pedig csak az ellenőrző ellen lista javítható elemeinek javítását követ követően válik aktívvá. Láncolt kód esetében mindig az első els elemet használjuk feldolgozásra.
Az eszköz oldali érvényesítést követően követ az aktív Elküld (Send) gombra kattintva tudjuk elküldeni az adatokat a szerver oldali alkalmazás felé, amely a GEPIR hálózat segítségével ellenőrzi ellen az azonosítókulcs egyéb pl. céprefix szerinti érvényességét is. Elküldeni (feladni) csak olyan számot tudunk, amelynek nek globális prefixe a GEPIR Root XML-je alapján a GEPIR-ben ben allokált, ill. kezelt. Adatküldéskor az AI-val val kiegészített ellenőrizendő szám mellett az alkalmazás továbbítja a leolvasási hely GPS koordinátáit a WGS84/UTM rendszerben (amennyiben a felhasználó engedélyezte ezt a telefon Beállításai között), valamint a leolvasás időpontját őpontját és az eszközön aktuálisan beállított időzónát őzónát valamint az eszköz egyedi azonosítóját. Ha az adatküldés nem sikerül (pl. mert nincs ninc internet-kapcsolat), kapcsolat), akkor az adott rekord tárolásra kerül a telefon memóriájában, és a következő következ adatküldéskor kerül továbbításra. Három sikertelen küldés után az elküldetlen rekord törlődik. törl
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 8 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
Sikeres adattovábbítás esetén a szerver oldali alkalmazás három féle válaszüzenetet küldhet vissza az alkalmazásnak: •
érvényes szám – zöld háttéren
•
érvénytelen szám – piros háttéren
•
kommunikációs hiba – narancssárga háttéren
Mindhárom esetben a GEPIR válaszkódjai kódjai és a válaszadó router adatai is kiírásra kerülnek, amely alapján a státusz beállításra került. A lap alján az első (bal oldali) „Új adat/New log” gombbal jelezhetjük, ha újabb számot szeretnénk ellenőrizni, ezzel elölről ől kezdve az ellenőrzési ellen folyamatot. Hiba, vagy érvénytelen rvénytelen szám esetén, a képernyő alján, középen található „Jelentés” (Report) gomb megnyomásával fényképeket készíthetünk a termékről, termékr l, amelyen a számot találtuk, és ee mailben továbbíthatjuk azt a megfelelő megfelel MO részére. A termékhez tatozó ozó MO kiválasztása az azonosító ország prefixe és a GEPIR Root XML-je alapján automatikusan történik. Az email szövegezése az eszközön beállított nyelven és angolul, vagy csak angolul történik, természetesen küldés előtt el tt pl. Saját email címmel is kiegészíthető, kiegészí helyettesíthető.
Ha mégsem szeretné kiküldeni az adott reportot, akkor egy figyelmeztető ő üzenet érkezik, mely szerint a report e-mailt mailt nem lehet elhelyezni a kimenő kimen postafiókban.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 9 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
2.4.
Előzmények zmények listázása A jobb szélső „Előzmény zmény” (History) gombbal tudjuk listázni a korábbi ellenőrzéseinket ellen (rekordjainkat),, és a lekérdezés során kapott információkat. A felhasználó négy új szerverről szerverr letölthető oldallal bővítheti vítheti az előzmények el zmények listáját (max. 100 rekord). Az előzmények lista megjelenítését minden den esetben adatkommunikáció előzi zi meg, azaz minden rekordot mindig letöltünk a szerverről
Az egyes sorok jobb oldalán található nyílra kattintva az adott rekord részleteit tekinthetjük meg. A részletes adatok közt szerepel az azonosítóhoz tartozó MO adatforrás, adatforrás, ha érvényes számról van szó, szerepel az adott cégprefix tulajdonos cég neve, címe (akár térképen is ellenőrizhetjük ellen az alkalmazás google maps kapcsolata segítségével). segítségével) Ezen kívül minden esetben (illetéktelen (illetéktel számhasználat,, tehát érvénytelen szám esetén is) tárolásra kerül az ellenőrzés rzés helye (annak GLN GLN-je, je, melyet térképen is megtekinthetünk a google közreműködésével) és időpontja, őpontja, valamint az ellen ellenőrző személy (felhasználó) és az eszköz, vagyis a mobiltelefon on azonosítója (GIAI), valamint a lefuttatott GEPIR lekérdezések és az azokra kapott válaszüzenetek válaszkódjai, kódjai, router információi. Szerver oldali forrásból maximum aximum 100 db beolvasott adat történetét tudjuk megtekinteni a telefonos alkalmazáson keresztül. Ennél korábbi rekordok megtekintéséhez a webes felületet tudjuk használni, ahol az eseménylista maximális száma nincs limitálva. Az előzményekből elő nem lehet törölni, sem módosítani.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 10 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
A GPS koordinátával, vagy pontos címmel rendelkező rendelkez adatokról a térképi adatok mellett térinformatikai adatokat at is lekérdezhetünk: mind a telefon oldalon „helyben” számított legalsó szintű bennfoglaló poligon AI (414) és a jelölt pont AI (254), valamint a hoz hozzá tartozó mérési rendszer hosszúsági-szélességi szélességi-magassági adatait, mind a Spatial szerverről szerverr lekérdezett információkat meg tudjuk jeleníteni.
Az Előzmények/History zmények/History elérhet elérhető egy weboldalon is: http://stafflogger.gs1hu.org. http://stafflogger.gs1hu.org Ezen az oldalon minden felhasználó saját jelszavával jelszavával jelentkezhet be és a saját leolvasásait tekintheti meg időrendi id sorrendben, illetve szűréseket űréseket végezhet pl. időszakra, id helyre.
A Supervisor felhasználó viszont már dinamikus szűréseket sz is végezhet pl. időszakra, id helyre, státuszra (illetéktelen/jogos telen/jogos használat), AI-kra, AI országokra, felhasználókra, GS1 azonosítókra, azo leolvasó eszközökre. Valamint a részletek fül alatt google térképen is megtekinthető megtekinthet a leolvasás pontos helye.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 11 / 20
GS1 Logger Staff Felhasználói kézikönyv
Szintén ezen a weboldalon található a Statisztika menüpont, amely négy féle statisztikai lekérdezést foglal magába. A Stat1 az adott tagország felhasználóinak leolvasásainak számát mutatja státuszokra bontva. Itt lehetőség van szűrni egy adott időszakra és kiszűrhetjük a duplikációkat is. A Stat 2 alatt látható, hogy a különböző felhasználók leolvasásai miként oszlanak meg a különböző országok között mind a három státusz (valid, invalid, faulted) tükrében.
A Stat3 lehetőséget nyújt számunkra, hogy a GEPIR router válaszkódjai szerinti eloszlást figyelhetjük meg országok szerint. A Stat4 két táblázatból tevődik össze. Az első táblázat az adott tagország leolvasásainak számát mutatja összesítve státuszokra bontva. A második táblázat egy kiválasztott státuszú leolvasások (táblázat feletti részen megadható) eloszlását mutatatja a különböző országok (nemzetközi rövidítések) szerint.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 12 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
3.
Műszaki szaki leírás
3.0.
A rendszer elemei A GS1 Logger for Staff a GS1 Magyarország mobil alkalmazás fejlesztése iOS operációs rendszerre. A GS1 Logger for Staff a GS1 munkatársainak szóló alkalmazás, mely az illetéktelen GS1 azonosító számhasználat használat kiszűrésének kisz résének segítését célozza meg. A rendszer az alábbi ffő elemekből épül fel:
kliens oldali alkalmazás
szerver oldali alkalmazás
adatbázisok: hely (Location DB), Logger Staff DB, User tábla
GEPIR hálózati kapcsolat
Weboldal a rekordok és statisztikák megtekintéséhez
Az elemek kapcsolódását, a rendszer magas szintű, szint átfogó logikai felépítését az alábbi ábra szemlélteti:
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 13 / 20
GS1 Logger Staff Felhasználói kézikönyv
3.1.
A Logger for Staff működése
3.1.1.
Ellenőrzési funkciók az alkalmazás elindításakor Az alkalmazás elindításakor az alábbiakat ellenőrzi a szoftver:
Van frissebb szerver által támogatott kliens verzió?
Van új GEPIR Root XML lista?
Van új nyelvi sztring lista?
Helymeghatározás bekapcsolva?
User ID/jelszó helyes?
Van internet kapcsolat?
Vannak elküldetlen rekordok?
Elküldetlen rekordok között van helyinformáció nélküli rekord?
Ha van frissebb szerver által támogatott kliens verzió, akkor informálja a felhasználót a frissítés megjelenéséről és átirányíja az Apple AppStore megfelelő oldalára, ahonnan a frissítés letölthető. Ha van új GEPIR Root XML, vagy nyelvi sztring akkor a user jóváhagyást, majd hitelesítés követően az új verziójú listákat lekérdezi a szerverről és feldolgozza azokat. Ha vannak elküldetlen rekordok, akkor azokat az alkalmazás beviteli képernyőjén jelezzük (elküldetlen rekordok száma / helyinformáció nélküli rekordok száma + frissítés gomb). Ennek a gombnak a megnyomásával lehet manuálisan kezdeményezni az elküldetlen rekordok elküldését. Internet kapcsolat hiányában figyelmezteti a felhasználót, hogy az adatokat nem tudja ellenőrizni, csak rögzíteni. Eszközön kikapcsolt (eszköz szintű), vagy letiltott (alkalmazás szintű) helymeghatározás észlelésekor értesíti a felhasználót, hogy a rekordok rögzítése, továbbítása során hely adatok nem kerülnek rögzítésre, továbbításra. Azon elküldetlen rekordoknál, amelyeknél helyinformáció nem volt rögzítve, de azóta már helyinformáció is rendelkezésre áll (pl. megjött a GPS jel), küldés előtt megkérdezi, hogy a rendelkezésre álló új helyinformációs adatokkal kiegészítse-e. Helytelen felhasználónév/jelszó esetében (pl. szerver oldalon megváltoztatták) az alkalmazás a bejelentkező képernyőre irányítja a felhasználót, ahol be kell jelentkeznie csak ezt követően tud bármilyen más műveletet végezni, kliens oldalról szerverrel kommunikálni.
3.1.2.
Adatbevitel és Lekérdezés küldése Szerver felé Az adatbevitel történhet manuálisan és automatikusan, a telefonba beépített kamera segítségével is. A lineáris, EAN-8 vagy EAN-13, GS1-128 típusú vonalkódok leolvasása mellett a QR-Code, a GS1 DataMatrix, GS1 DataBar Omnidirekcionális (normál, halmozott és csökkentett magasságú) és ITF-14 típusok leolvasása is engedélyezett. Jelképből történő olvasás esetében csak szabványos AI-val ellátott SSCC (00), GTIN (01), GDTI (253), GINC (401), GSIN (402), GLN loc (414), GLN org (415), GRAI (8003), GIAI (8004), GCTIN (8006), GSRN (8018), PRODUCT URL (8200), ill. összetett jelképnél ezek közül mindig az első leolvasása és értelmezése az engedélyezett. (Kivétel AI (8200)) A Staffba integrált olvasó segítségével sokkal több jelképet, összetett kódot vagyunk képesek leolvasni, a jelenleg nem támogatott jelképek és/vagy kódok egy hibaüzenetben jelennek meg.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 14 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
Az AI (8200) olvasása is bevezetésre került, de mint ahogy azt a General Specifications v12 is definiálja, ehhez a (01) AI is szükséges, hogy a teljes PRODUCT URL-tt összeállítható legyen. A General Specifications v12 definíciója mentén, és az AI (8200)-at kötelező kötelez (01) párral együtt kezeljük.. Az egyetlen limitáció az AI (8200) -at at tartalmazó kódok esetében az az, hogy csak az összetett kód NEM AI (8200) része kerül továbbításra. Az ellenőrző listában a vonatkozó AI-k nevei megjelenítésre kerülnek. Manuális adatbevitel során a támogatott AI kódok számának növekedésével az adatbevitel sorrendje is megváltozott. Elsőként Els az AI szelektorból elektorból kell kiválasztani szükséges AI-t, AI ezt követően en kell megadni a kódot. A billentyűzet billenty attól függően, en, hogy az adott kódban adott pozíciótól kezdve engedélyezett-e e az alfanumerikus jel bevitele is, automatikusan numerikusról alfanumerikusra vált. A „Kész” gomb is akkor válik csak aktívvá, ha a minimális karakterszámot már beírtuk, ha viszont a maximális hosszat elérjük sem tudjuk túlírni az input mezőt, mez ezt egy figyelmeztető hang jelzi. Az azonosító szám bevitele után az alábbi adatokat tárolja az alkalmazás a telefon helyi adatbázisában, majd továbbítja azokat a szerver oldali alkalmazás felé:
GS1 azonosító szám és a hozzá tartozó AI
eszköz azonosító (iPhone ID)
felhasználó azonosító (user ID)
GPS koordináták (szélesség, hosszúság, magasság) + mérési mérési pontosság (vertikális és horizontális)
idő (telefon ideje) + időzóna id – ez lesz a leolvasás ideje
Ha nincs internet kapcsolat, akkor az adott rekord elküldetlen státuszt kap. Ha az elküldetlen rekordok között már szerepel ugyanez az a azonosító szám, akkor a régi rekord felülíródik az új rekord adataival (pl. új beolvasási idő, id új koordináták stb.). Manuális adatbevitelt, vagy szkennelést szkennelés követően en a rekordok azonnal mentésre kerülnek. Adatküldést, vagy visszautasítást követően követ pedig a korábbi törléstől eltérően ően csak a státuszuk változik meg. Az alkalmazás következő ő elindításakor elind ellenőrzi rzi az elküldetlen státuszú rekordokat, és manuálisan lehet újra megpróbálni az elküldést (lásd előző pontban). Ha egy rekord elküldése háromszor sikertelen, akkor elküldhetetlen státuszba kerül. Új rekord elküldése előtt őtt először el ször az elküldetlen rekordok kerülnek továbbításra a szerver felé. Ebben az esetben azonban nincs azonnali státusz-információ státusz információ megjelenítés sem az utolsó rekordról, azt ilyenkor csak a History menüpontban men lehet elérni.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 15 / 20
GS1 Logger Staff Felhasználói kézikönyv
3.1.3.
Információgyűjtés és Válaszüzenet Szervertől iPhone felé A fenti adatok alapján a szerver oldali alkalmazás lekérdezi:
a GEPIR-ből az adott azonosító szám érvényességét és adatait, illetve cégprefix érvényességét
a hely (Location) adatbázisból a GPS koordinátákhoz tartozó legalsó azonosított szint GLN-jét és címét
a user adattáblából a felhasználónévhez tartozó alkalmazott nevét
A Logger Staff adatbázisban tehát az alábbi adatok kerülnek tárolásra: GS1 azonosító szám és a hozzá tartozó AI Számhoz tartozó terméknév/helynév/szervezet név, gyártónév és gyártó GLN (ha ezek rendelkezésre állnak) Szám érvényességére vonatkozó információk: minden feltett lekérdezéshez a GEPIR funkció neve, a megszólított router GLN azonosítója, ill. a válaszként visszakapott kód értéke Felhasználónév és GS1 munkatárs neve leolvasás ideje időzónával a leolvasáshoz használt eszköz azonosítója adatbázisba írás ideje időzónával (ezt a szerver oldali alkalmazás adja) utolsó módosítás ideje GPS koordináták (ez nem kötelező, mert előfordulhat, hogy helyadatok nélkül küldi el az iPhone alkalmazás a rekordokat – lásd később) Ha volt helyinformáció, akkor a Location adatbázisból legalsó szint neve/címe + GLN Logikai jelölő: a rekord hiányos vagy teljes Ha a rekord hiányos, akkor hibakód tárolása, ami arra utal, hogy milyen adat hiányzik Ha kapcsolódási hiba lép fel (nem érkezik válasz valamelyik adatbázistól), akkor is tárolásra kerül az adott rekord. Ha nem sikerül beírni az adatokat a Logger adatbázisba, azt végzetes hibaként kezeljük. Ilyenkor üzenetet küld a szerver a felhasználónak, és az adott rekord visszakerül elküldetlen státuszba.
3.1.4.
Előzmények (History) Az Előzmények menüpont megnyitásakor az alkalmazás a Szerveren keresztül kéri le az utolsó 20 rekord adatait, amit a lista alján megjelenő „További rekordok letöltése” gomb megnyomásával újabb 20 rekorddal bővíthetünk max. 100 rekordig. Ha nincs internet kapcsolat, vagy a Szerver oldali alkalmazás nem érhető el, akkor hibaüzenet jelenik meg. Adatküldést követően telefon oldalon a megjelenő státusz ablakra kattintva a Historyból csak egy, a vonatkozó rekordhoz tartozó adatok kerülnek lekérdezésre és letöltésre a szerverről. A Logger Staff weboldalon az összes beolvasás eredménye elérhető és leválogatható. A megfelelő lekérdezési feltételek beállítása után (illetve a weboldal betöltésekor az alapértelmezett (default) beállítások elvégzése után), a lekérdezés során a szerver oldali alkalmazás automatikusan megpróbálja frissíteni a hiányos rekordokat, majd megjeleníti a szűrés szerinti rekordokat. Az előzmények adatai mind a telefon, mind a webes felületen először egy listában kerülnek megjelenítésre. A lista egy-egy sorát kiválasztva az adott rekord részletes adatait tudjuk megtekinteni. A részletes adatok tartalmazzák a szerver oldalon tárolt és lekérdezett adatokat, néhány plusz adat megjelenítése a rekord alapján azonban eszköz (vagy webes) odalon történik. Ilyen pl.az adatforrás, vagy a routerhez tartozó ország neve, ill. térképek, a koordinátákból számított AI (414), AI (254) adatok.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 16 / 20
GS1 Logger Staff Felhasználói kézikönyv
3.1.5.
Időzóna Az időpont adatok mérése mindig az adott akcióhoz, pl. szkennelés, rözítés... helyi időben történik, akár kliens, akár szerver oldali az akció. Ahhoz azonban, hogy ezek továbbítása, ill. megjelenítése egységes legyen, a mért helyi időt egy ún. egytemes időre (zulu) számítjuk át, és az időpont adatokat időzóna és időeltolás adatokkal is kiegészítjük. Így biztosítható, hogy mind a küldő, mind a fogadó oldalon ua. információ ugyan abban a formátumban és sorrendben legyen megjeleníthető: mindenki ua, időpillanatról beszéljen. Kliens oldali megjelenítés során ha a telefonon különböző időzónákban végzünk leolvasásokat (feltételezve, hogy a különböző időzónákhoz a telefon is felveszi akár automatikusan, akár kézzel beállítva a különböző időzónákat) az esemény hisztorikus sorrendje változatlan marad, az időpontok azonban a helyi idő szerint kerülnek megjelenítésre. A részletes adatokál a szerveren végzett mentési idő is a szerver lokális beállítása alapján most a budapesti helyi idővel kerül megjelenítésre.
3.1.6.
AI (254) LOC számítás Adott pont GPS koorditátái AI (254)-ben is ábrázolásra kerülnek. Ehhez a vonatkoztatási rendszer (GPS: WGS84/UTM) valamint a rendelkezésre álló hosszúsági-szélességi-magassági és vízszintes-függőleges mérési pontosságra vonatkozó információkat tömörítjük és az AI (254)-ben leírtak alapján alfanumerikus alakra alakítjuk, hogy max. 20 karakteren ábrázolni tudjuk. Ennek az átszámítása a következők szerint történik: 1
2-6
7-11
12-14
1
karakter = koordináta rendszer típusa: W= WGS84/UTM
2-6
karakterek = hosszúsági adat
15-16
17-18
19-20
A hosszúsági adat egész részének +180-nal (azért, hogy biztos ne legyen negatív szám), to rt részének pedig +1 000 000 -val (balra 6 számjeggyel, hogy ne legyen tizedespont) to rtént eltolása után kapott kerekített érték (pl. 47.539526839558 -ból 227 539 527) 62-es számrendszerben ábrázolt alakja, szu kség esetén balról kito lto karakterrel (0) felto ltve 7-11 karakterek = szélességi adat A szélességi adat egész részének +90-nel (azért, hogy biztos ne legyen negatív szám), to rt részének pedig +1 000 000 -val (balra 6 számjeggyel, hogy ne legyen tizedespont) to rtént eltolása után kapott kerekített érték (pl. 19.071081989918 -ból 109 071 082) 62-es számrendszerben ábrázolt alakja, szu kség esetén balról kito lto karakterrel (0) felto ltve 12-14
karakterek = magassági adat Ha van magassági adat és az +- 100 000 értkéken belu l van, akkor annak 100 000-rel to rtént eltolása után kapott érték (azért, hogy ne legyen negatív számunk) a 62-es számrendszerben ábrázolt alakja szu kség esetén balról kito lto karakterrel (0) felto ltve. Értéktartományon kívu li, vagy nem létezo adat esetén 'zzz' (az utolsó értéktartománybeli alak a 62-es számrendszerben) A magasság tehát +- 100 000 méter ko zo tt értelmezett, ha 0, akkor azt jelenti, hogy -100 000 métert mértünk (-100 000-et toljuk el +100 000-rel és alakítjuk át 62-es számrendszerre), ha 'zzz, akkor' nem volt megadva (nem volt mérheto ...) a magasság.
15-16
karakter = horizontális pontosság Ha van horizontális pontosság adat és az 3000-nél kisebb, akkor a horizontális pontosság érték 62- es számrendszerben ábrázolt alakja, ku lo nben 'zz' (utolsó értéktartománybeli alak a 62-es számrendszerben), szu kség esetén balról kito lto karakterrel (0) felto ltve.
17-18
Verzió 0.1.4.1 .
karakter = vertikáls pontosság
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 17 / 20
GS1 Logger Staff Felhasználói kézikönyv
Ha van vertikális pontosság adat és az 3000-nél kisebb, akkor a vertikális pontosság érték 62-es számrendszerben ábrázolt alakja, ku lo nben 'zz' (utolsó értéktartománybeli alak a 62-es számrendszerben), szu kség esetén balról kito lto karakterrel (0) felto ltve. 19-20
karakter = nem használt Későbbiekben a pont minősítő jellemzőinek rögzítésére alkalmazható, pl: 00: beszúrási pont 11: határpont 22: hármas határpont 33: körvonal pont 44: súlypont 55: mértani középpont 66: sarokpont 77: kitüntetett pont
3.1.7.
Jelentés (Report e-mail iPhone kliensről) Jelentés feladásához egy létező azonosító szükséges, amit vagy az azonosítószám manuális kitöltésével érhetünk el, vagy a szkennelést követően, ill. az utoljára feladott Log után, amíg státusz látszik a telefonon, azaz nem töröltük, addig lehetséges. Jelentést lehet csatolt képpel és anélkül is indítani. A csatolt képek száma nincs korlátozva, de a telefon szűkös memóriakapacitása miatt egy emailben célszerű 2-3 képnél többet nem használni. A jelentés generálása nyelvi sztringek alapján történik, címzése az azonosító országprefixe és a regisztráció során megadott email párosítása alapján történik. Amennyiben a telefon beállított nyelve nem angol és adott nyelvre létezik nyelvi implementáció, az üzenet a beállított nyelven kívül angolul is kitöltésre kerül. Amennyiben az ország nem regisztrált a Staffra, ill. nem adott meg report email címet, a magyar cím kerül címzetthez, amit másolatként azon országoknál is automatikusan kitöltünk, amelyek rendelkeznek saját report email címmel. Az email küldését azonban nem a Staff alkalmazás végzi, hanem a telefon email-kezelő kliense. Sikeres email küldéshez tehát a telefonnak rendelkeznie kell már beállított postafiókkal, amit a Staff alkalmazás csak meghív, ill. aminek az előkészített üzenetet átadja. Az email tartalmának módosításába, címzésének (feladó, címzett, másolat...) megváltoztatásába, ill. a postázás folyamatába azonban nem tud beleszólni, az a Stafftól függetlenül történik. A Staff csak arról az eseményről tud értesítést küldeni a felhasználónak, hogy az üzenetet sikerült-e átadnia a levelező kliensnek, vagy sem. Ez egy üzenetablakban a küldés gomb megnyomását követően mindkét esetben megtörténik.
Verzió 0.1.4.1 .
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 18 / 20
GS1 Logger Staff Felhasználói elhasználói kézikönyv
3.1.8.
Nyelvi támogatás
3.1.8.1. Telefon oldali kliens Telefon oldali nyelvi sztringek kezelése a telefon beállítása alapján automatikusan történik. Amennyiben az adott nyelvre létezik implementáció, a gombok, feliratok... az adott nyelvnek megfelelően en kerülnek megjelenítésre. Azon nyelvek amelyeknek még nincs kliens oldali implementációja, vagy az adott nyelvi implementáció a vonatkozó sztringre nem létezik, ott a szöveg/felirat angolul jelenik meg. Új nyelvi implementáció bevezetésére jelenleg két megoldás lehetséges:
Verzió 0.1.4.1 .
a kliens kiadott verziójába becsomagoljuk becsomagoljuk és az alkalmazást az AppStore-on AppStore keresztüli frissítéstjük, vagy
szerver oldalon a resource állományt bővítjük, b vítjük, verzió számát módosítjuk, így a kliens program a következő következ bejelentkezés során automatikusan jelzi a felhasználónak, hogy új/módosított nyelvi sztringek állnak letöltésre készen szerver oldalon. A letöltést a felhasználó jóváhagyhatja, vagy elutasítva későbbre kés bbre halaszthatja (pl. amikor van wifi kapcsolata)
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 19 / 20
GS1 Logger Staff Felhasználói kézikönyv
4.
A Logger for Staff 1.3 és 1.4.1 verziójának összehasonlítása Logger for Staff verzió 1.3 (2012.03.15.-2012.05.02.)
Logger for Staff verzió 1.4.1 (2012. június) EAN-8, EAN-13, GS1-128, GS1 QR Code, EAN-8, EAN-13, GS1-128, GS1 GS1 Szimbológia GS1 DataMatrix, ITF-14, GS1 Databar QR Code, GS1 DataMatrix Omnidirekcionális (00) SSCC, (01) GTIN, (253) GDTI, (401) GS1 AI-k és (00) SSCC, (01) GTIN, (414) GLN, GINC, (402) GSIN, (414) GLN, (415) PAY azonosító TO, (8003) GRAI, (8004) GIAI, (8006) (415) PAY TO kulcsok GCTIN, (8018) GSRN RF X X Mobil Operációs Rendszer Nyelv
Logger szerver
Stafflogger weboldal
iOS
iOS
Any registered user can define language strings on both sides the mobile and the web frontend. Automatikus report e-mail cím kezelés az Automatikus report e-mail cím adott MO GS1 Prefixe és GEPIR Root kezelés az adott MO GS1 Prefixe XML-je alapján, kiegészítve azon MO-k e-mail címeivel, akik még nem és GEPIR Root XML-je alapján csatlakoztak a projekthez. Szűretlen lekérdezések, az AI Komplex statisztikai lekérdezések, az AI értékének és megnevezésének értékének egy sorban történő megjelenítése. megjelenítése egy sorban. 4 féle nyelv (magyar, angol, portugál és orosz)
Új funkciók az 1.4.1-es verzióban •
Az új termék URL (8200), melynek a GTIN (01) kell együtt kell szerepelnie szintén bevezetésre került.
•
Nemcsak a termék URL és AI párja szkennelhető egy jelképből, hanem minden más láncolt kód is beolvasható. Az egyetlen limitáció ezen összetett jelképeknél, hogy mindig csak az első AI tag kerül felhasználásra, elemzésre, ill. szerver oldalra továbbításra.
Verzió 0.1.4.1 .
•
Küldés előtt egy új ellenőrző lista került bevezetésre.
•
A nyelvi támogatás kezelését a back end rendszerhez optimalizáltuk.
•
Az „Előzmények” gomb alatt akár az előző száz leolvasás is lekérdezhető a szerverről.
•
Új alkalmazás logó.
Minden jog fenntartva © GS1 Magyarország Zrt.
Oldal: 20 / 20