GS1 Logger for Staff. Felhasználói kézikönyv. Verzió 1.4.1, GS1 Logger Staff Felhasználói kézikönyv

Átírás

1 GS1 Logger for Staff Felhasználói kézikönyv Verzió 141, Minden jog fenntartva GS1 Magyarország Zrt Oldal: 1 / 20

2 Tartalom 1 Bevezetés 3 2 Funkcionális leírás a szoftver működése 3 20 Jelszókiadás 3 21 Bejelentkezés 4 22 Adatbevitel Manuális adatbevitel 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 23 Adattovábbítás és adatellenőrzés 8 24 Előzmények listázása 10 3 Műszaki leírás A rendszer elemei A Logger for Staff működése Ellenőrzési funkciók az alkalmazás elindításakor Adatbevitel és Lekérdezés küldése Szerver felé Információgyűjtés és Válaszüzenet Szervertől iphone felé Előzmények (History) Időzóna AI (254) LOC számítás Jelentés (Report iphone kliensről) Nyelvi támogatás 19 4 A Logger for Staff 13 és 141 verziójának összehasonlítása 20 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 2 / 20

3 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 20 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 címe report 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 ben 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 ben kiküldünk számára (az tartalmazza, hogy sikeresen regisztrált a pilotba, és munkatársai a mellékelt kód segítségével tudnak regisztrálni a weboldalunkon) Minden jog fenntartva GS1 Magyarország Zrt Oldal: 3 / 20

4 Ez az egyedi kód lehető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 későbbiekben regisztráltak) adatait Felhasználók regisztrációja A felhasználó a gs1loggergs1huorg 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, GS1 Tagszervezet, 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, akkor a regisztráció sikertelen és erre figyelmeztetjük a felhasználót 21 Bejelentkezés A GS1 Logger for Staff-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 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 4 / 20

5 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 22 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 5 / 20

6 Az adat elküldése előtt a hálózati kapcsolatok ellenőrzése történik meg, illetve a report címek frissítése, ha a szerveren új report címek érhetőek el 221 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 az AI listából kell kiválasztani a szükséges AI-t, ezt követően kell megadni az ellenőrizni kívánt azonosítókulcsot Manuá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, hogy az adott kódban adott pozíciótól kezdve engedélyezett-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, a maximális hossz elérését pedig figyelmeztető hangüzenet jelzi Minden jog fenntartva GS1 Magyarország Zrt Oldal: 6 / 20

7 222 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 vagy EAN-13, GS típusú vonalkódok leolvasása mellett a QR-Code, a GS1 DataMatrix, GS1 DataBar Omnidirekcionális irekcioná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áskor minden szabványos és nem szabványos jelkép beolvasásra kerül, feladására azonban csak a szabványos AI-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), GCTIN (8006), GSRN (8018), PRODUCT URL (8200) esetében van lehetőség GS1 DataBar Omnidirekcionális (halmozott, csökkentett magasságú) Minden jog fenntartva GS1 Magyarország Zrt Oldal: 7 / 20

8 23 Adattovábbítás és adatellenőrzés Adatküldés előtt további automatikus ellenőrzésre is sor kerül, melynek részleteit az ellenőrzőlistában listában tekinthetjük 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 kezelt-e a leolvasott azonosító globális prefixe és a kijelőlt tartomány Továbbá arra is van lehetőségünk, 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ő ikon arról tájékoztat, hogy az azonosítókulcs további beavatkozás nélkül is küldhető-e (zöld pipa), beavatkozást igényel küldés előtt (sárga felkiáltójel), ill nem küldhető (piros X) Zöld azonosítók az ellenőrző lista megtekintése nélkül is küldhetők, itt az ellenőrző listát a pipára katttintva érjük el A másik két esetben mindig az ellenőrzőlista jelenik meg először a küldés gomb pedig csak az ellenőrző lista javítható elemeinek javítását követően válik aktívvá Láncolt kód esetében mindig az első elemet használjuk feldolgozásra Az eszköz oldali érvényesítést követően 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 az azonosítókulcs egyéb pl céprefix szerinti érvényességét is Elküldeni (feladni) csak olyan számot tudunk, amelynek globális prefixe a GEPIR Root XML-je alapján a GEPIR-ben allokált, ill kezelt Adatküldéskor az AI-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 és az eszközön aktuálisan beállított időzónát valamint az eszköz egyedi azonosítóját Ha az adatküldés nem sikerül (pl mert nincs internet-kapcsolat), akkor az adott rekord tárolásra kerül a telefon memóriájában, és a 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 8 / 20

9 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 é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 kezdve az ellenőrzési folyamatot Hiba, vagy é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, amelyen a számot találtuk, és e- mailben továbbíthatjuk azt a megfelelő MO részére A termékhez tatozó MO kiválasztása az azonosító ország prefixe és a GEPIR Root XML-je alapján automatikusan történik Az 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 pl Saját címmel is kiegészíthető, helyettesíthető Ha mégsem szeretné kiküldeni az adott reportot, akkor egy figyelmeztető ő üzenet érkezik, mely szerint a report t nem lehet elhelyezni a kimenő postafiókban Minden jog fenntartva GS1 Magyarország Zrt Oldal: 9 / 20

10 24 Előzmények listázása A jobb szélső Előzmény (History) gombbal tudjuk listázni a korábbi ellenőrzéseinket (rekordjainkat), és a lekérdezés során kapott információkat A felhasználó négy új szerverről letölthető oldallal bővítheti az előzmények listáját (max 100 rekord) Az előzmények lista megjelenítését minden esetben adatkommunikáció elő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, 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 az alkalmazás google maps kapcsolata segítségével) Ezen kívül minden esetben (illetéktelen számhasználat, tehát érvénytelen szám esetén is) tárolásra kerül az ellenőrzés helye (annak GLN-je, melyet térképen is megtekinthetünk a google közreműködésével) és időpontja, valamint az 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, router információi Szerver oldali forrásból maximum 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 nem lehet törölni, sem módosítani Minden jog fenntartva GS1 Magyarország Zrt Oldal: 10 / 20

11 A GPS koordinátával, vagy pontos címmel 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 hozzá tartozó mérési rendszer hosszúsági-szélességi-magassági adatait, mind a Spatial szerverről lekérdezett információkat meg tudjuk jeleníteni Az Előzmények/History elérhető egy weboldalon is: Ezen az oldalon minden felhasználó saját jelszavával jelentkezhet be és a saját leolvasásait tekintheti meg időrendi sorrendben, illetve szűréseket végezhet pl időszakra, helyre A Supervisor felhasználó viszont már dinamikus szűréseket is végezhet pl időszakra, helyre, státuszra (illetéktelen/jogos telen/jogos használat), AI-kra, országokra, felhasználókra, GS1 azonosítókra, leolvasó eszközökre Valamint a részletek fül alatt google térképen is megtekinthető a leolvasás pontos helye Minden jog fenntartva GS1 Magyarország Zrt Oldal: 11 / 20

12 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 12 / 20

13 3 Műszaki leírás 30 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 kiszűrésének segítését célozza meg A rendszer az alábbi fő 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ű, átfogó logikai felépítését az alábbi ábra szemlélteti: Minden jog fenntartva GS1 Magyarország Zrt Oldal: 13 / 20

14 31 A Logger for Staff működése 311 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 312 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 14 / 20

15 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-t összeállítható legyen A General Specifications v12 definíciója mentén, és az AI (8200)-at kötelező (01) párral együtt kezeljük Az egyetlen limitáció az AI (8200) -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 az AI szelektorból kell kiválasztani szükséges AI-t, ezt követően en kell megadni a kódot A billentyűzet attól függő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, 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 pontosság (vertikális és horizontális) idő (telefon ideje) + időzóna 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 azonosító szám, akkor a régi rekord felülíródik az új rekord adataival (pl új beolvasási idő, új koordináták stb) Manuális adatbevitelt, vagy szkennelést követően en a rekordok azonnal mentésre kerülnek Adatküldést, vagy visszautasítást követően pedig a korábbi törléstől eltérően csak a státuszuk változik meg Az alkalmazás következő ő elindításakor ellenő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 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ó megjelenítés sem az utolsó rekordról, azt ilyenkor csak a History menüpontban lehet elérni Minden jog fenntartva GS1 Magyarország Zrt Oldal: 15 / 20

16 313 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 314 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 plaz 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 16 / 20

17 315 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 316 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: karakter = koordináta rendszer típusa: W= WGS84/UTM 2-6 karakterek = hosszúsági adat A hosszúsági adat egész részének +180-nal (azért, hogy biztos ne legyen negatív szám), tort részének pedig val (balra 6 számjeggyel, hogy ne legyen tizedespont) tortént eltolása után kapott kerekített érték (pl ból ) 62-es számrendszerben ábrázolt alakja, szukség esetén balról kitolto karakterrel (0) feltoltve 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), tort részének pedig val (balra 6 számjeggyel, hogy ne legyen tizedespont) tortént eltolása után kapott kerekített érték (pl ból ) 62-es számrendszerben ábrázolt alakja, szukség esetén balról kitolto karakterrel (0) feltoltve karakterek = magassági adat Ha van magassági adat és az értkéken belul van, akkor annak rel torté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 szukség esetén balról kitolto karakterrel (0) feltoltve Értéktartományon kívuli, vagy nem létezo adat esetén 'zzz' (az utolsó értéktartománybeli alak a 62-es számrendszerben) A magasság tehát méter kozott értelmezett, ha 0, akkor azt jelenti, hogy métert mértünk ( et toljuk el rel és alakítjuk át 62-es számrendszerre), ha 'zzz, akkor' nem volt megadva (nem volt mérheto) a magasság 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, kulonben 'zz' (utolsó értéktartománybeli alak a 62-es számrendszerben), szukség esetén balról kitolto karakterrel (0) feltoltve karakter = vertikáls pontosság Minden jog fenntartva GS1 Magyarország Zrt Oldal: 17 / 20

18 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, kulonben 'zz' (utolsó értéktartománybeli alak a 62-es számrendszerben), szukség esetén balról kitolto karakterrel (0) feltoltve 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 317 Jelentés (Report 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 ben 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 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 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 címmel Az küldését azonban nem a Staff alkalmazás végzi, hanem a telefon -kezelő kliense Sikeres 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 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 Minden jog fenntartva GS1 Magyarország Zrt Oldal: 18 / 20

19 318 Nyelvi támogatás 3181 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: a kliens kiadott verziójába becsomagoljuk és az alkalmazást az AppStore-on keresztüli frissítéstjük, vagy szerver oldalon a resource állományt bővítjük, verzió számát módosítjuk, így a kliens program a 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 halaszthatja (pl amikor van wifi kapcsolata) Minden jog fenntartva GS1 Magyarország Zrt Oldal: 19 / 20

20 4 A Logger for Staff 13 és 141 verziójának összehasonlítása GS1 Szimbológia GS1 AI-k és azonosító kulcsok Logger for Staff verzió 13 ( ) EAN-8, EAN-13, GS1-128, GS1 QR Code, GS1 DataMatrix (00) SSCC, (01) GTIN, (414) GLN, (415) PAY TO Logger for Staff verzió 141 (2012 június) EAN-8, EAN-13, GS1-128, GS1 QR Code, GS1 DataMatrix, ITF-14, GS1 Databar Omnidirekcionális (00) SSCC, (01) GTIN, (253) GDTI, (401) GINC, (402) GSIN, (414) GLN, (415) PAY TO, (8003) GRAI, (8004) GIAI, (8006) GCTIN, (8018) GSRN RF X X Mobil Operációs Rendszer Nyelv Logger szerver Stafflogger weboldal ios 4 féle nyelv (magyar, angol, portugál és orosz) Automatikus report cím kezelés az adott MO GS1 Prefixe és GEPIR Root XML-je alapján Szűretlen lekérdezések, az AI értékének egy sorban történő megjelenítése ios Any registered user can define language strings on both sides the mobile and the web frontend Automatikus report cím kezelés az adott MO GS1 Prefixe és GEPIR Root XML-je alapján, kiegészítve azon MO-k címeivel, akik még nem csatlakoztak a projekthez Komplex statisztikai lekérdezések, az AI értékének és megnevezésének megjelenítése egy sorban Új funkciók az 141-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 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