Plánky AMS pro Android

Plánky AMS pro Android Uživatelský manuál Mgr. Dan Vyhnalík 7.12.2012 Napsáno pro verzi aplikace 2.2

2 Obsah 1 Úvod... 3 2 Základní informace pro vstup do aplikace... 3 2.1 Požadavky pro běh aplikace... 3 2.2 Postup instalace... 3 2.3 Přihlášení... 4 2.4 Stavová ikona... 4 2.5 Odhlášení... 4 3 Funkce aplikace... 5 3.1 Výběr autobusu... 5 3.2 Informace o autobusu... 5 3.2.1 Základní prvky formuláře... 6 3.2.2 Záložka PLÁNEK... 7 3.2.3 Záložka SEZNAM... 8 3.2.4 Záložka INFO... 9 3.2.5 Detail místa a cestujícího... 10 3.3 Odeslání seznamu cestujících... 11 3.4 Nastavení aplikace... 12

3 1 Úvod Tento manuál popisuje podle podkladů Ing. Blažka funkcionalitu a způsob ovládání aplikace Plánky AMS. Tato aplikace umožňuje pomocí mobilních zařízení na platformě Android přístup řidiče autobusu do prodejního a rezervačního systému AMSBUS, ve kterém se prodávají klasické jízdenky a e-jízdenky na dálkové a mezinárodní spoje prakticky všech dopravců. 2 Základní informace pro vstup do aplikace Tato kapitola obsahuje základní informace pro instalaci a vstup do aplikace Plánky AMS. 2.1 Požadavky pro běh aplikace K běhu aplikace je nutná minimální verze operačního systému Android 1.6 (Donut) a alespoň 10 MB volného místa ve vnitřní paměti zařízení. Pro přihlášení do systému a výběr požadovaného autobusu je nutné připojení zařízení k internetu (Wifi, GPRS/EDGE/3G apod.). Po stažení potřebných dat týkajících se vybraného autobusu není už internetové připojení nutné a to až do odhlášení z aplikace. Je ale třeba vzít na vědomí, že bez aktivního připojení k internetu aplikace nemůže zobrazená data aktualizovat a měnit blokování spoje. 2.2 Postup instalace Aplikace lze nainstalovat následujícím postupem: 1. Instalace aplikace se zahajuje spuštěním příslušného instalačního balíčku s příponou.apk. 2. Po jeho spuštění je uživatel tázán, zda opravdu chce aplikaci nainstalovat a jestli souhlasí s oprávněními, které aplikace pro svůj běh vyžaduje (Obrázek 2.2.1). Pro úspěšnou instalaci je nutné požadovaná oprávnění povolit. 3. V dalším kroku proběhne proces vlastní instalace aplikace, který může trvat několik vteřin. 4. Pokud instalace proběhne bez problémů, zobrazí se okno potvrzující její úspěšné dokončení (Obrázek 2.2.2) a aplikace se přidá do seznamu nainstalovaných aplikací v zařízení. Obrázek 2.2.1: Potvrzení instalace Obrázek 2.2.2: Dokončení instalace

4 2.3 Přihlášení Po zapnutí aplikace se nejprve zobrazí přihlašovací formulář. Pro přihlášení do systému AMSBUS je třeba zadat číslo řidiče a heslo do příslušných boxů a potvrdit tlačítkem Přihlásit se (Obrázek 2.3.1). Pokud v průběhu přihlašování dojde k chybě, zobrazí se dialogové okno se zprávou upřesňující důvod této chyby (např.: Nesprávné číslo uživatele nebo heslo apod.) (Obrázek 2.3.2). Obrázek 2.3.1: Přihlašovací formulář Obrázek 2.3.2: Neúspěšné přihlášení 2.4 Stavová ikona Po úspěšném přihlášení se ve stavové liště zobrazí ikona. Tato ikona uživatele informuje o tom, že je přihlášen do systému AMSBUS. Aplikace zůstane přihlášena i po jejím opuštění hardwarovými tlačítky Domů nebo Zpět, případně při přepnutí do jiné aplikace a může na pozadí (i při uspaném zařízení) v nastavených intervalech stahovat aktuální data. V průběhu volání vzdáleného serveru pro získání aktuálních dat se ikona změní na animované šipky v kolečku. Pro ruční vyvolání požadavku na obnovení aktuálně zobrazených dat lze stisknout hardwarové tlačítko Menu a z něj vybrat položku Obnovit s ikonou. 2.5 Odhlášení Odhlášení je možné provést v libovolném formuláři aplikace (kromě přihlašovacího) kliknutím na hardwarové tlačítko Menu a výběrem položky Odhlásit se s ikonou (Obrázek 2.5.1). Z některých formulářů je možné se odhlásit kliknutím na stejnou ikonu v horním modrém panelu. Odhlášení je potřeba potvrdit v zobrazeném dialogovém okně kliknutím na odpověď OK (Obrázek 2.5.2).

5 Obrázek 2.5.1: Odhlášení Obrázek 2.5.2: Potvrzení odhlášení 3 Funkce aplikace Tato kapitola popisuje jednotlivé funkce aplikace a způsob jejich používání. 3.1 Výběr autobusu Po úspěšném přihlášení (viz kapitola 2.3) se natáhne ze serveru AMSBUS a zobrazí chronologicky seřazený seznam autobusů vyjíždějících včera, dnes, zítra a pozítří, které má daný řidič přístupné. Autobusy, jejichž čas výjezdu je v minulosti, jsou podbarveny šedě (Obrázek 2.5.1: Odhlášení). U každého autobusu se zobrazují následující údaje: První řádek: datum a čas odjezdu z výjezdní zastávky, číslo linky, spoje a busu (pouze v případě spojů s posilovými busy) Druhý řádek: výjezdní zastávka cílová zastávka V seznamu je možné vertikálně rolovat. Pro výběr autobusu stačí kliknout na příslušný řádek. Při prvním zobrazení příslušného autobusu od přihlášení řidiče aplikace automaticky natáhne ze serveru AMSBUS jeho obsazenost. 3.2 Informace o autobusu Formulář s informacemi o vybraném autobusu ve výchozím stavu aplikace (bez zapnutí módu Jednotlivé zastávky) zobrazuje veškeré informace pro stav autobusu v rámci celého spoje (od výjezdní až do cílové zastávky). V nastavení aplikace je ale možné zapnout mód Jednotlivé zastávky (viz kapitola 3.4). V tomto módu řidič musí vybírat nástupní zastávku, pro kterou chce zobrazit potřebné informace. Odlišnosti mezi oběma módy jsou vždy na příslušných místech v následujících podkapitolách uvedeny.

6 3.2.1 Základní prvky formuláře Formulář s informacemi o autobusu se skládá z následujících částí: Horní modrý pruh: Tento pruh funguje v závislosti na módu Jednotlivé zastávky: o Vypnuto zobrazení pro Jednotlivé zastávky (Obrázek 3.2.1.1): V prvním řádku se zobrazuje datum a čas odjezdu z výjezdní zastávky, číslo linky a číslo spoje. Ve druhém řádku se zobrazuje výjezdní zastávka cílová zastávka. o Zapnuto zobrazení pro Jednotlivé zastávky (Obrázek 3.2.1.2): V prvním řádku vlevo se zobrazuje datum a čas odjezdu spoje z právě vybrané zastávky. Vpravo se zobrazuje obsazenost z vybrané zastávky. V druhém řádku se zobrazuje název této zastávky. Kliknutím na levou část modrého pruhu se zobrazí dialogové okno umožňující výběr aktuální zastávky (Obrázek 3.2.1.3). Tlačítka s šipkami doprava a doleva v pravé části pruhu umožňují rychlé přepínání na předchozí, resp. následující zastávku na spoji. Záložky: Pod modrým pruhem jsou zobrazeny vedle sebe tři záložky: Plánek, Seznam a Info (např. Obrázek 3.2.1.1). Klikáním na jednotlivé záložky se přepíná zobrazení informací v prostoru pod záložkami. Mezi jednotlivými záložkami je také možné se přepínat horizontálním posunem prstu po displeji. Samotné záložky jsou popsány jednotlivě v následujících odstavcích. Doplňkové informace: Ve spodní části formuláře se vlevo zobrazuje stavová informace o době, před kterou byly naposledy staženy ze serveru zobrazované informace o tomto autobusu a vpravo informace o tom, jestli příslušný spoj je nebo není zablokovaný. Pokud je spoj zablokovaný, zobrazuje se tento nápis červeně (např. Obrázek 3.2.4.2). Pro návrat do formuláře Výběr autobusu musíme kliknout na hardwarové tlačítko Zpět. Obrázek 3.2.1.1: Vypnuto zobrazení pro Jednotlivé zastávky Obrázek 3.2.1.2: Zapnuto zobrazení pro Jednotlivé zastávky Obrázek 3.2.1.3: Výběr zastávky v módu Jednotlivé zastávky

7 3.2.2 Záložka PLÁNEK Na záložce Plánek se zobrazuje tabulka míst v autobusu (Obrázek 3.2.1.1). Plánek se zobrazuje pouze v případě, že se jízdenky do tohoto autobusu prodávají na konkrétní sedadla. V opačném případě se plánek nezobrazuje a aplikace automaticky přeskočí na záložku Seznam. Místa jsou zobrazena tak, že horní hraně tabulky odpovídá čelo autobusu při pohledu seshora. U patrových autobusů se zobrazuje nejprve horní a za ní dolní paluba. Každé místo obsahuje číslo, znak obsazenosti a je barevně odlišeno. Při zapnutém módu Jednotlivé zastávky se zobrazují pouze informace o obsazení sedadel od zvolené nástupní zastávky do cílové zastávky spoje. Při vypnutém módu Jednotlivé zastávky se zobrazují informace pro celou trasu spoje. Místa jsou podbarvena těmito barvami s následujícím významem: Šedá: zablokované místo Tyrkysová: volné místo až do cílové zastávky Levandulová: volné místo pro invalidy až do cílové zastávky Červená: při zapnutém módu Jednotlivé zastávky označuje místo, které má cestující obsadit na zvolené nástupní zastávce. Při vypnutém módu Jednotlivé zastávky označuje místo obsazené jedním nebo více cestujícími, z nichž ještě žádný nenastoupil. Sytě žlutá: při zapnutém módu Jednotlivé zastávky označuje místo, které již cestující obsadil na zvolené nástupní zastávce. Při vypnutém módu Jednotlivé zastávky označuje místo obsazené jedním nebo více cestujícími, kteří už nastoupili. Lososová: při prodeji jízdenek vyžadujících údaje o cestujících označuje v obou módech sedadla, která se právě prodávají a ještě se čeká na vložení jména a případně dalších údajů. Při vypnutém módu Jednotlivé zastávky též označuje sedadlo obsazené více cestujícími, z nichž někteří již nastoupili a někteří ještě nenastoupili. Světle žlutá: při zapnutém módu Jednotlivé zastávky označuje místo, které cestující obsadil na některé z předchozích zastávek a na zvolené zastávce ještě nevystupuje. Tmavě modrá: při zapnutém módu Jednotlivé zastávky označuje místo, které není ze zvolené nástupní zastávky obsazené, ale je obsazené z některé z příštích zastávek. Zelená: označuje rezervované místo. Buďto se jedná o nezávaznou rezervaci pro pozdější nákup, která vyprší nejpozději 10 hodin před výjezdem z výjezdní zastávky, nebo o dočasnou rezervaci v průběhu nákupu e-jízdenky, u které se čeká maximálně 20 minut na zaplacení. Obsazená sedadla jsou aktivní. Při kliknutí na ně se zobrazí dialogové okno s Detailem místa (viz kapitola 3.2.5).

8 3.2.3 Záložka SEZNAM Záložka Seznam zobrazuje údaje o všech cestujících. Při vypnutém módu Jednotlivé zastávky (Obrázek 3.2.3.1) nebo při zapnutém módu Jednotlivé zastávky (Obrázek 3.2.3.2) se obrazovky liší pouze obsahem horního modrého pruhu. Údaje o cestujících jsou primárně seřazeny podle nástupních zastávek, sekundárně podle výstupních zastávek a terciáně podle čísel sedadel. Skupiny se stejnou nástupní zastávkou začínají titulkovým tmavě šedým pruhem obsahujícím čas odjezdu, název a obsazenost z dané zastávky. Pro každého jednotlivého cestujícího se zobrazují následující informace (pokud jsou známy): První řádek: číslo sedadla (pokud se do tohoto autobusu prodávají jízdenky na konkrétní sedadlo), kód transakce (u nahlášek znak @) a příjmení a jméno cestujícího. Druhý řádek: cena a měna jízdného, symbol (E) v případě e-jízdenky a druh jízdného. Třetí řádek: výstupní zastávka cestujícího. Čtvrtý řádek (pokud je rezervace): čas a datum vypršení rezervace. Pátý řádek (pokud je rezervován pes): Rezervován pes. Informace o cestujících s rezervací jsou podbarveni zeleně, o cestujících s e-jízdenkou modře. Vpravo dole se u cestujících s klasickou jízdenkou, e-jízdenkou nebo nahláškou (nikoli s rezervací) zobrazuje ikona zaškrtávátka, které je ve výchozím stavu šedé. Řidič může jeho barvu měnit na žlutou a označovat tak cestující, kteří již nastoupili. Přímo v Seznamu není možné stav zaškrtávátek měnit, v této obrazovce se jedná o informaci pouze ke čtení. Měnit jejich stav jde v Detailu místa nebo v Detailu cestujícího (viz kapitola 3.2.5). Obrázek 3.2.3.1: Záložka Seznam s vypnutým módem Jednotlivé zastávky Obrázek 3.2.3.2 Záložka Seznam se zapnutým módem Jednotlivé zastávky

9 3.2.4 Záložka INFO Tato záložka obsahuje tři sekce (Obrázek 3.2.4.1): Info o busu: informace o aktuálním busu. Zobrazuje se jméno dopravce, číslo linky, spoje a busu (pokud jsou na daném spoji posilové busy), název výjezdní a cílové zastávky a čas a datum odjezdu z výjezdní zastávky. Info o místech: zobrazuje následující informace o obsazenosti busu pro celou trasu spoje: o Volných: počet míst volných z výjezdní až do cílové zastávky o Obsazených: počet míst obsazených alespoň na jednou úseku o Pes: číslo místa cestujícího s nahlášeným psem, při více takovýchto je uvedeno více o Cestujících: počet všech cestujících o S e-jízdenkou: z toho cestujících s e-jízdenkou o Rezervovaných: z toho cestujících s rezervací o Nahlášených: z toho cestujících s nahláškou Blokace spoje: zobrazuje informaci, jestli je spoj zablokován a případně také kdy a kým byl zablokován (Obrázek 3.2.4.2). Dále je zde tlačítko, které umožňuje spoj zablokovat resp. odblokovat. V případě, že řidič nemá potřebné oprávnění, je toto tlačítko neaktivní. Po kliknutí na tlačítko se zobrazí dialogové okno s požadavkem na potvrzení akce. Po jejím potvrzení dojde k volání vzdáleného serveru s tímto požadavkem. Pokud je úspěšně proveden, dojde k obnovení informací o vybraném busu. V opačném případě se zobrazí chybová hláška, např.: Bus můžete zablokovat teprve 30 minut před výjezdem (Obrázek 3.2.4.3). Obrázek 3.2.4.1: Nezablokovaný spoj Obrázek 3.2.4.2: Zablokovaný spoj Obrázek 3.2.4.3: Nelze zablokovat

10 3.2.5 Detail místa a cestujícího Detail místa lze otevřít kliknutím na příslušné místo v Plánku. Otevře se dialogové okno s jedním nebo více chronologicky seřazenými cestujícími na tomto sedadle (Obrázek 3.2.5.1). Druhou možností je kliknout na údaje o cestujícím v Seznamu. V tom případě se zobrazí obdobné dialogové okno, ale pouze s detailem vybraného cestujícího (Obrázek 3.2.5.2). E-jízdenky jsou podbarveny modře a rezervace zeleně. Zobrazeny jsou následující informace (pokud jsou dostupné): Místo (v titulku): číslo místa (pokud se autobus prodává na konkrétní sedadla) Kód: kód transakce nebo symbol @ u nahlášek Jméno: příjmení a jméno cestujícího Cena: cena jízdenky a příslušná měna, u e-jízdenky symbol (E) Druh: druh jízdného Průkaz: číslo průkazu cestujícího Odkud: nástupní zastávka Kam: výstupní zastávka Rez.do: pouze u rezervací - čas a datum vypršení rezervace Pes: informace, jestli má cestující rezervaci pro přepravu psa Pas: číslo pasu cestujícího Tel.: telefon cestujícího Konflikt: důvod konfliktu Vpravo se u každé klasické jízdenky, e-jízdenky nebo nahlášky zobrazuje zaškrtávátko. Žlutě může řidič značit, že příslušný cestující již nastoupil. Kliknutím na zaškrtávátko mění jeho barvu. Ze šedé na žlutou nebo pro nápravu překlepu zpět na šedou. Příznak o nastoupení každého cestujícího zůstává uložen v telefonu 30 dnů po dojezdu. Promítá se do podbarvení místa v Plánku i barvy zaškrtávátka v Seznamu (viz kapitola 3.2.3). Také se uvádí v seznamu cestujících, který řidič odesílá emailem (viz kapitola 3.3). V módu Jednotlivé zastávky jde měnit stav zaškrtávátka jen u cestujících s právě zvolenou nástupní zastávkou. Obrázek 3.2.5.1: Detail místa Obrázek 3.2.5.2: Detail cestujícího

11 3.3 Odeslání seznamu cestujících Aplikace umožňuje odeslání seznamu cestujících emailem. Seznam může vypadat například: Po ceste snezilo, nabral jsem 20 minut zpozdeni. Cestující odjíždějící 30.11.2012 v 11:00 ze zastávky Praha,,ÚAN Florenc (Obsazenost 22) X 12 1P9GFQ 115 Kč obyčejné jízdné Jihlava,,aut.nádr. Švarc X 16 X04CFS 104 Kč senior nad 60 let Jihlava,,aut.nádr. Voda Transakce jsou v seznamu cestujících seřazeny shodně jako v Seznamu v aplikaci. Pro každou zastávku na trase spoje, ve které nastupovali nějací cestující, se zobrazuje souhrnná informace o datu a času odjezdu, názvu a obsazenosti z dané zastávky. Následuje seznam cestujících, kteří zde měli nastoupit. U každé transakce se zobrazují následující (dostupné) informace (v pořadí zleva): Symbol X, když cestující nastoupil nebo -, když nenastoupil, nebo když ho řidič neoznačil Číslo místa (pokud se autobus prodává na konkrétní sedadla) Kód transakce nebo znak @ u nahlášek Cena jízdného a příslušná měna Druh jízdného Výstupní zastávka Příjmení a jméno cestujícího Pro odeslání seznamu je nutné, aby v zařízení byl nakonfigurován alespoň jeden účet pro odesílání emailů. V aplikaci poté stačí ve formuláři s informacemi o vybraném autobusu stisknout hardwarové tlačítko Menu a vybrat položku Odeslat seznam. Pokud na daném zařízení existuje více způsobů, jak seznam cestujících odeslat, zobrazí se dialogové okno s výběrem akce, kterou chceme pro odeslání seznamu cestujících použít (1). V něm je nutné kliknout na vybraného emailového klienta s již nakonfigurovaným uživatelským účtem. Zejména na zařízeních se starší verzí operačního systému se může stát, že požadovaný emailový klient v seznamu akcí nebude. V tom případě lze vyzkoušet v nastavení aplikace změnit hodnotu nastavení Typ zprávy (viz kapitola 3.4). Po vybrání příslušné akce se otevře emailový klient. V něm se automaticky vyplní předmět a tělo emailu se seznamem cestujících. Pro odeslání emailu je ještě nutné vyplnit adresáta (Obrázek 3.3.2). Aby nebylo nutné jej vždy vyplňovat znovu, je možné jej v nastavení aplikace zadat do položky Výchozí emailová adresa (viz kapitola 3.4). Při příštím odesílání seznamu se již adresát doplní automaticky. Tělo emailu obsahuje seznam cestujících. Ve výchozím nastavení se aplikace pokusí emailovému klientovi vnutit nastavení neproporcionálního písma a jednotlivé sloupce se seznamem jízdenek zarovná na stejný počet mezer tak, aby byly dobře čitelné. Někteří emailoví klienti ovšem odeslání emailu s neproporcionálním písmem nepodporují. V tom případě můžeme v nastavení aplikace zrušit zaškrtnutí u položky Zarovnávat na sloupce (viz kapitola 3.4). V tomto nastavení aplikace nebude jednotlivé sloupce v seznamu jízdenek zarovnávat mezerami, ale pouze je mezi sebou oddělí pomocí středníku. Tímto způsobem je výsledný email sice hůře čitelný než při zarovnání na sloupce, ale je možné jej jednoduše importovat do tabulkového procesoru (např. MS Excel). Samotné tělo i všechny další položky emailu je možné libovolným způsobem před odesláním upravovat, např. doplnit do něj nějaké další poznámky apod.

12 Obrázek 3.3.1: Výběr akce pro poslání seznamu jízdenek Obrázek 3.3.2: Otevřený emailový klient s předvyplněnou zprávou 3.4 Nastavení aplikace Nastavení aplikace (Obrázek 3.4.) je možné otevřít z libovolného okna po přihlášení se stiskem hardwarového tlačítka Menu a v něm po volbě Nastavení. Lze upravovat následující položky (tento dokument se na ně odkazuje u popisu příslušných funkcí): Jednotlivé zastávky: při aktivaci tohoto módu aplikace zobrazuje informace o obsazení autobusu pro vybranou nástupní zastávku. Více odstavce 3.2.2, 3.2.2 a 3.2.3. Otáčení displeje: povoluje nebo zakazuje otáčení displeje podle polohovacího senzoru. Obnovování na popředí: nastavuje interval automatického obnovování dat ze vzdáleného serveru, pokud je aplikace na popředí (Obrázek 3.2.5.1). Volit lze interval 1 minuta až Nikdy, to se data automaticky neobnovují. Řidič může data kdykoli obnovit hardwarovým tlačítkem Menu a volbou Obnovit. Ve formuláři Výběr autobusů se obnoví seznam řidiči přístupných autobusů, vyžadující přenos cca 5 kb dat. Ve formuláři Informace o autobusu se obnoví jeho obsazenost. Při 60 cestujících je jmény se přenáší cca 20 kb dat. Obnovování na pozadí: analogicky nastavuje interval automatického obnovování dat ze vzdáleného serveru, pokud je ale aplikace na pozadí (Obrázek 3.4.3). Volit lze interval od 15 minut až po Nikdy, to se data při aplikaci na pozadí automaticky neobnovují. Výchozí emailová adresa: umožňuje zadat výchozího adresáta pro odesílání emailů se seznamem cestujících po ukončení jízdy (více viz kapitola 3.3) (Obrázek 3.4.5). Zarovnávat sloupce: při zaškrtnutí této položky aplikace zarovnává jednotlivé sloupce u odesílaného seznamu cestujících na stejný počet mezer (více viz kapitola 3.3). V opačném případě jsou údaje v řádku odděleny středníkem. Ve výchozím nastavení je tato položka zaškrtnutá. Typ zprávy: umožňuje vybrat typ zprávy, který se používá při vybírání dostupných způsobů pro odesílání seznamu cestujících. Ve výchozím nastavení je položka message/rfc822. Pokud na daném zařízení aplikace neumožní v seznamu dostupných akcí vybrat požadovaného emailového klienta, je možné zkusit změnit toto nastavení na některou z dalších položek (více viz kapitola 3.3) (Obrázek 3.4.5).

13 Obrázek 3.2.5:Nastavení aplikace Obrázek 3.2.5.1:Obnovování na popředí Obrázek 3.2.5.2:Obnovování na pozadí Obrázek 3.4.4:Vložení emailové adresy Obrázek 3.4.5:Výběr typu zprávy