Käyttöohje Ticket Inspector Versio 1.0 Sportum Oy 10.5.2017
Sivu 1 Sisällysluettelo 1. Yleistä... 2 2. Kirjautuminen ensimmäisellä kerralla / PIN-koodin unohtuessa... 3 3. Tunnistautuminen... 4 4. Päänäkymä... 5 5. Lipun lukeminen... 6 6. Lipun tietojen tarkastelu ja kapasiteetin päivittäminen... 7 7. Asetusten hallinta... 8 8. PIN-koodin päivittäminen / poistaminen sekä session aikakatkaisun säätäminen... 9 9 9. Pohjalipun päivittäminen... 10 10. Ongelmatilanteita... 11 11. Sovelluksen asentaminen... 13
Sivu 2 1. Yleistä Sportum Oy:n Ticket Inspector mahdollistaa lipun merkitsemisen käytetyksi ja käyttömerkinnän poiston. Sovellus kykenee lisäksi näyttämään tiedot lippuun kytketystä tuotteesta ja vaihtamaan tarkastelussa olevaa tuotetta nopeasti. Sovelluksella käsiteltävät tuotteet ovat tyypiltään risteilyjä tai tapahtumia. Lippujen tietojen noutaminen tapahtuu lippuun kirjoitetun QR-koodin avulla. QR-koodin tietojen perusteella sovellus toimittaa tiedot rajapinnan kautta TravelNet - järjestelmään. Täten sovelluksen käyttäminen edellyttää internet-yhteyttä. Tässä dokumentissa esitetään sovelluksen mahdolliset käyttötavat vaiheittain. Dokumentin lopusta löytyy myös kuvauksia mahdollisista ongelmatilanteista sekä asennusohje, jota noudattamalla sovelluksen voi asentaa älypuhelimeen tai tablet-tietokoneeseen (sovellus tukee vain Android käyttöjärjestelmää).
Sivu 3 2. Kirjautuminen ensimmäisellä kerralla / PIN-koodin unohtuessa Sovelluksen asentamisen jälkeen tai PIN-koodin unohtuessa tulee suorittaa kirjautuminen käyttämällä käyttäjätunnusta ja salasanaa. Tämä tapahtuu syöttämällä käyttäjätunnus sekä salasana kuvassa 1 näkyviin kenttiin sekä painamalla Kirjaudu sisään. Tämän jälkeen sovellus pyytää vielä asettamaan uuden PIN-koodin (kuva 2). PIN-koodin asettaminen tapahtuu aktivoimalla syöttökenttä sekä syöttämällä haluttu PIN-koodi, jonka jälkeen tulee vielä painaa Aseta PIN-koodi. PIN-koodin asetuksen voi myös ohittaa painamalla Älä aseta PIN-koodia. Lopuksi sovellus siirtyy kuvassa 4 (ks. sivu 5) esitettyyn päänäkymään. Kuva 1: Kirjaudu sisään -näkymä Kuva 2: Aseta PIN-koodi -näkymä
Sivu 4 3. Tunnistautuminen Sovelluksen avaamisen jälkeen pyytää sovellus käyttäjää tunnistautumaan (jos PIN-koodi on käytössä) syöttämällä asetettu PIN-koodi kuvassa 3 näkyvään kenttään sekä painamalla Tunnistaudu. Jos PIN-koodi on unohtunut voi siirtyä sisään kirjautumiseen painamalla PIN-koodi unohtunut?. Kuva 3: Tunnistaudu -näkymä
Sivu 5 4. Päänäkymä Näkyvässä kuvassa 4 havainnollistetaan sovelluksen päänäkymää. Päänäkymässä näytetään asetetun pohjalipun tiedot. Päänäkymästä voidaan siirtyä tarkistamaan lippuja painamalla Lue lippu. Lisäksi päänäkymästä voidaan siirtyä Asetukset -näkymään painamalla oikealla yläkulmassa näkyvää rattaan kuvaa. Kuva 4: Päänäkymä
Sivu 6 5. Lipun lukeminen Näkyvässä kuvassa 5 havainnollistetaan Lue lippu -näkymää. Lipun lukeminen tapahtuu kohdistamalla laitteen kamera lippuun tulostettuun QR-koodiin. Tämän jälkeen sovellus lukee lipun automaattisesti. Ongelmatilanteissa (sovellus ei lue lippua) voit myös tarkentaa kameran haluamaasi kohtaan painamalla haluttua kohtaa näytöllä. Kuva 5: Lue lippu -näkymä
Sivu 7 6. Lipun tietojen tarkastelu ja kapasiteetin päivittäminen Lipun tietojen tarkastelu ja kapasiteetin päivittäminen tapahtuvat kuvassa 6 esitetyssä Lippu luettu -näkymässä. Lipun tietojen tarkistamista varten sovellus näyttää myös lipun numeron, lippuun kytketyn tuotteen, päivämäärän, ajankohdan, lipputyypin sekä lipun henkilömäärän ja kapasiteetin. Kapasiteetin päivittäminen tapahtuu valitsemalla haluttu määrä käyttämällä näkyviä nuolisymboleja ja painamalla Päivitä kapasiteetti. Tämän jälkeen sovellus päivittää kapasiteetin ja siirtyy seuraavan lipun lukemiseen eli näkyville tulee edellisellä sivulla havainnollistettu Lue lippu -näkymä. Palaaminen päänäkymään tapahtuu painamalla vasemmalla yläkulmassa näkyvää nuolisymbolia. Kuva 6: Lippu luettu -näkymä
Sivu 8 7. Asetusten hallinta Näkyvässä kuvassa 7 esitetään sovelluksen Asetukset -näkymä. - Painamalla Aseta pohjalippu pääset vaihtamaan valittua pohjalippua. - Painamalla Turvallisuus pääset päivittämään PIN-koodin tai poistamaan PIN-koodin käytöstä sekä säätämään session aikakatkaisua. - Painamalla Kirjaudu ulos voit kirjautua ulos sovelluksesta (sovellus kysyy vielä vahvistuksen uloskirjautumiseen). Kuva 7: Asetukset -näkymä
Sivu 9 8. PIN-koodin päivittäminen / poistaminen sekä session aikakatkaisun säätäminen Kuvassa 8 havainnollistetaan Turvallisuus -näkymää, jonka avulla voit päivittää PIN-koodin tai poistaa PIN-koodin käytöstä. Lisäksi session aikakatkaisun säätäminen tapahtuu esitetyssä näkymässä. Asetukset -näkymään pääset palamaan painamalla vasemmalla yläkulmassa näkyvää nuolisymbolia. - PIN-koodin päivittäminen tapahtuu syöttämällä uusi PIN-koodi kuvassa näkyvään kenttään sekä painamalla Päivitä PIN-koodi. PIN-koodin tulee olla 4 numeroa pitkä. - PIN-koodin poistaminen tapahtuu painamalla Poista PIN-koodi käytöstä. Tämän jälkeen sovellus kysyy vielä vahvistuksen PIN-koodin poistamiseen. - Session aikakatkaisua pääset säätämään painamalla näkyvää pudotusvalikkoa, jonka jälkeen sovellus näyttää käytettävissä olevat vaihtoehdot. Valinta tapahtuu painamalla haluttua vaihtoehtoa, jonka jälkeen valinta tulee vielä päivittää painamalla Päivitä session aikakatkaisu Kuva 8: Turvallisuus -näkymä.
Sivu 10 9. Pohjalipun päivittäminen Pohjalipun päivittäminen tapahtuu kuvassa 8 havainnollistetussa Pohjalippu asetettu - näkymässä. Tätä ennen sovellus näyttää kameranäkymän, jossa voit lukea myöhemmin asetettavan pohjalipun. Tämän jälkeen sovellus esittää pohjalippuun kytketyn tuotteen, päivämäärän ja ajankohdan tiedot, jonka jälkeen pohjalippu tulee vielä tallentaa painamalla Aseta pohjalippu. Pohjalipulla tarkoitetaan tässä yhteydessä lippua, johon muiden lippujen tietoa verrataan tuotteen, päivämäärän ja ajankohdan suhteen. Jos luettavan liput poikkeavat asetetusta pohjalipusta antaa sovellus virheilmoituksen. Tämä ei kuitenkaan tarkoita sitä, että luettua lippua ei voitaisi käsitellä (lipun kapasiteettia päivittää), mutta käyttäjän tulisi huomioida tällaiset poikkeavuudet ja päättää itse hyväksytäänkö lippu vai ei. HUOM! Pohjalipun tarkistaminen tulee myös suorittaa samalla tavalla kuin muiden lippujen tarkistaminen, sillä pohjalipun asettaminen ei vaikuta lipun kapasiteettiin. Kuva 8: Pohjalippu luettu -näkymä
Sivu 11 10. Ongelmatilanteita Seuraavassa taulukossa esitetään yleisimpiä ongelmatilanteita ja näihin liittyviä kuvauksia sekä mahdollisia ratkaisukeinoja. Taulukko 1: Mahdollisia ongelmatilanteita Sovelluksen antama virheilmoitus Kirjautuminen epäonnistu - Virheellinen tunnus tai salasana. Kirjautuminen epäonnistui - Tunnistautumista ei voitu käsitellä Kirjautuminen epäonnistui - Ei yhteyttä palvelimeen Tunnistautuminen epäonnistui - Virheellinen PIN-koodi PIN-koodin asettaminen epäonnistui - PIN-koodin tulee olla 4 numeroa pitkä. PIN-koodin asettaminen epäonnistui - PIN-koodia ei voitu vaihtaa. Yritä uudelleen. PIN-koodin poistaminen epäonnistui - PIN-koodia ei voitu poistaa. Yritä uudelleen Pohjalippu ei ole kelvollinen - Luettu pohjalippu ei ole kelvollinen. Pohjalipun tarkistus epäonnistui - Pohjalippua ei voitu varmentaa palvelimelta. Pohjalipun tarkistus epäonnistui - Pyyntöä ei voitu käsitellä. Lippu ei ole kelvollinen - Luettu lippu ei ole kelvollinen. Kuvaus Käyttäjänimi tai salasana väärin. Yhteys rajapintaan, mutta response-koodi muu kuin '0'/'Success Fetch-pyyntö palautui virhekoodilla, ei yhteyttä rajapintaan Näppäilty koodi ei vastaa laitteelle tallennettua PIN-koodia PIN-koodi liian lyhyt PIN-koodin vaihtamisessa tapahtui odottamaton virhe PIN-koodin poistamisessa tapahtui odottamaton virhe Ongelmia lipun sisällön parsimisessa, luettu luultavasti jotain muuta kuin lippu. Yhteys rajapintaan, mutta response-koodi muu kuin '0'/'Succes. Ei yhteyttä rajapintaan tai luettu lippu vääränlainen Ongelmia lipun sisällön parsimisessa, luettu Kokeile tätä ratkaistaksesi ongelman Tarkista käyttäjänimi ja salasana. Tarkista, että laitteella on internetyhteys. Jos laite on internetyhteydessä tarkista vielä tunnuksesi. Ongelman Tarkista, että laitteella on internetyhteys. Jos laite on internetyhteydessä ja ongelma toistuu ole yhteydessä Tarkista PIN-koodi ja yritä uudelleen. Tarkista PIN-koodi ja yritä uudelleen. Sulje sovellus ja yritä uudelleen. Ongelman Sulje sovellus ja yritä uudelleen. Ongelman Tarkista lippu ja yritä uudelleen. Ongelman Yritä uudelleen. Ongelman Tarkista internetyhteys ja lippu. Yritä uudelleen ja ongelman toistuessa ole yhteydessä Tarkista lippu ja yritä uudelleen. Ongelman
Lippu on jo käytetty - Lipun kapasiteetti on jo käytetty. Lipun tarkistus epäonnistui - Lippua ei voitu varmentaa palvelimelta. Lipun tarkistus epäonnistui - Pyyntöä ei voitu käsitellä. Lipun käsittely epäonnistui - Lipputiedot ovat virheelliset. Lipun käsittely epäonnistui - Pyyntöä ei voitu käsitellä. Lipun käsittely epäonnistui - Ei yhteyttä palvelimeen Sivu 12 luultavasti jotain muuta kuin lippu Huomautus: Onnistunut tarkistus, mutta lipun kapasiteetti on jo ennemmin käytetty, ei estä käyttöä. Yhteys rajapintaan, mutta response-koodi muu kuin '0'/'Success' Ei yhteyttä rajapintaan tai luettu lippu vääränlainen Yhteys rajapintaan, mutta response-koodi muu kuin '0'/'Success Ei yhteyttä rajapintaan tai lipun sisältö vääränlainen Ei yhteyttä rajapintaan Voit päivittää lipun kapasiteetin virheilmoituksesta huolimatta, jos aiemmin tehty esimerkiksi virheellinen päivitys. Yritä uudelleen. Ongelman Tarkista internetyhteys ja lippu. Yritä uudelleen ja ongelman toistuessa ole yhteydessä Tarkista internetyhteys ja lippu. Yritä uudelleen ja ongelman toistuessa ole yhteydessä Tarkista internetyhteys ja lippu. Yritä uudelleen ja ongelman toistuessa ole yhteydessä Tarkista internetyhteys ja yritä uudelleen. Ongelman
Sivu 13 11. Sovelluksen asentaminen Sportum Oy:n Ticket Inspector sovelluksen voit ladata laitteellesi Google Play -kauppapaikasta. Tämän jälkeen sovelluksen asentaminen tapahtuu samalla tavalla, kuin minkä tahansa muun sovelluksen asentaminen. Asentamisen jälkeen tulee vielä suorittaa rekisteröinti luvussa 2 esitetyn toimintatavan mukaisesti. Jos sovelluksen asentaminen ei onnistu, voit etsiä ohjeita puhelimesi valmistajalta ja olla yhteydessä asiakaspalveluumme.