EMVHost Online SUBJECT: COMPANY: COMMENTS: AUTHOR: EMVHOST ONLINE CLIENT - AUTOMAATTISIIRROT NETS OY EMVHost Online Client sovelluksen käyttöohje NETS OY DATE: 15.03.2011 VERSION: 1.0
1 SISÄLLYS SISÄLLYS... 1 1 YLEISTÄ... 2 1.1 KÄYTTÖÖNOTTO... 2 1.2 JÄRJESTELMÄVAATIMUKSET... 2 2 SOVELLUKSEN ASENTAMINEN... 3 2.1 ASENTAMINEN ASENNUSPAKETISTA... 3 3 SOVELLUKSEN KÄYTTÖ... 5 3.1 ASETUKSET... 5 3.1.1 Käyttö... 5 3.1.2 Käyttäjätunnus ja avain (Account)... 5 3.2 RAPORTIN NOUTAMINEN PALVELUSTA... 5 3.2.1 Raporttien vaihtoehdot ja tiedostomuoto (Report options)... 5 3.2.2 Raportin automatisointi (Report automation)... 6 3.3 VIITETIEDOSTOJEN LATAUS PALVELUUN... 7
2 1 YLEISTÄ Automaattisiirto -ohjelman avulla Nets Oy:n maksupäätepalvelun raporttitiedot voidaan hakea Kaupan määrittelemän käyttäjän koneelle suoraan ilman, että raportointitietoja tarvitse erikseen noutaa selainpohjaisesta Maksupäätepalvelun raportointipalvelusta. Automaattisiirto sovelluksen avulla Nets Oy:n maksupäätepalvelun raportointitiedot voidaan hakea halutulta aikaväliltä tai asettaa automaattinen raportinnouto, jolloin palvelusta noudetaan kaikki uudet aineistot (noutamattomat aineistot). Raporttitieto tallentuu käyttäjän koneen kovalevylle haluttuun aikaan, joka voidaan asettaa ohjelman asetuksissa. Raportit sisältävät tiedot halutulta aikaväliltä eräkohtaisesti. Tämä tarkoittaa sitä, että aikaväli noutaa tällä välillä muodostetut erät. Erissä olevat tapahtumat voivat olla myös muulta aikaväliltä kuin erän päiväys. Normaalisti erässä on saman päivän tapahtumat, mutta tämä riippuu siitä milloin erä on muodostettu. 1.1 Käyttöönotto Automaattisiirto sovelluksen käyttöönotto tapahtuu Nets Oy:n maksupääteasiakaspalvelun kautta. Maksupääteasiakaspalvelu toimittaa ohjelmistopaketin ja tarvittavat käyttäjätunnukset sekä avaimet liittymän käyttöön. Tunnukset ovat yksilölliset jokaiselle liittymälle ja tarjottavat erätiedostot määritellään Nets Oy:n maksupäätepalvelun raportointipalvelussa. 1.2 Järjestelmävaatimukset Sovellus tarvitsee toimiakseen NET Framework 2.0:n ja verkkoyhteyden palveluun. Verkkoyhteys tapahtuu HTTP(S) liikenteen yli portin 443 kautta SSL suojattuna. Yhteys tapahtuu asiakkaalta palvelimelle päin eikä mitään avauksia tehdä palvelusta asiakkaaseen päin. Tuetut järjestelmäalustat ovat Windows XP tai uudempi sekä Windows 2003 tai uudempi. Verkko-osoite, johon sovellus ottaa yhteyttä on https://emvhost.screenway.com. Linux -pohjaisissa järjestelmissä sovellusta voidaan ajaa Novellin kehittämän Mono -frameworkin kautta. Nämä ympäristöt eivät kuitenkaan ole tällä hetkellä virallisesti tuettuja sovelluksen käyttöön.
3 2 SOVELLUKSEN ASENTAMINEN Sovellusta varten on luotu oma asennuspaketti, jota käyttämällä asennus hoituu yksinkertaisesti. Ohjelma saa myös tarvittaessa käyttöön ilman asennuspakettia ja tähän käyttöön tarvittavat tiedostot toimitetaan zip pakattuna tiedostona. 2.1 Asentaminen asennuspaketista Asennus tapahtuu seuraamalla ohjeita asennuksen edistyessä. Asennuksen aikana voidaan valita asennushakemisto. Sovelluksen poistaminen tapahtuu ohjauspaneelin kautta jos käytetään tässä esiteltyä asennusohjelmaa. Paina Next (Seuraava) Valitse asennushakemisto ja paina Next. Paina Install aloittaaksesi asennuksen. Tässä vaiheessa voidaan vielä peruuttaa asennus.
4 Lopuksi paina Finish. Sovelluksen voi käynnistää joko asennushakemistosta valitsemalla sovelluksen EMVHostClient.exe tai sitten käynnistämällä käynnistä-valikon pikakuvakkeesta.
5 3 SOVELLUKSEN KÄYTTÖ Kun sovellus avataan ensimmäisen kerran, tulee asetuksiin syöttää käyttäjätunnus ja avain, jolla palveluun liitytään. 3.1 Asetukset 3.1.1 Käyttö Aineistojen noudon voi käynnistää manuaalisesti Run painikkeella. Painike Hide to tray piilottaa sovelluksen ja käyttöliittymä saadaan näkyviin klikkaamalla kaksoisnuoli ikonia ohjelmapalkista. Asetuksien muutosten jälkeen tulee painaa Save painiketta, jotta muutokset tallentuvat. Jos sovellus suljetaan ennen kuin Save painikkeella on tallennettu muutokset niin nämä tiedot menetään. Tämä ei vaikuta noudettuihin eräaineistoihin. 3.1.2 Käyttäjätunnus ja avain (Account) Sovelluksen asetusten kohtiin User ID ja Key syötetään Nets Oy:n maksupäätetuen toimittamat käyttäjätiedot. 3.2 Raportin noutaminen palvelusta 3.2.1 Raporttien vaihtoehdot ja tiedostomuoto (Report options) Raporttien noutamiseen on kaksi vaihtoehtoa: Haetaan kaikki noutamattomat erä tai haetaan erät tietyltä aikaväliltä. Valinta None ei nouda raporttia ollenkaan.
6 Haettaessa kaikki noutamattomat aineistot (Latest settlements) palvelimelle merkitään aineistot noudetuiksi ja niitä ei voi enää ladata uudelleen. Tämä toiminto on sen vuoksi kertaluontoinen ja virhetapauksissa tulee ottaa yhteyttä Nets Oy:n maksupäätetukeen. Vaihtoehtoisesti aineistot voi noutaa tietyltä aikaväliltä ja sen jälkeen toimittaa käsiteltäviksi taustajärjestelmiin. Tällöin taustajärjestelmän tulee pystyä estämään duplikaattien syntyminen. 3.2.1.1 Tiedostomuodot Palvelusta voi ladata erien tiedot useassa eri muodossa. - CSV, XML, JSON ja EmvCard Ledger Kolme ensimmäistä on listaus tapahtumista ja Ledger formaatti tuottaa tiedoston kiinteämittaisella sisällöllä. Tiedostomuodosta on saatavilla erillinen kuvaus. Tiedostomuoto valitaan alasvetovalikosta. Kielivalinta vaikuttaa siihen millä kielellä raporttien otsikot tuotetaan. Kielivalintaa ei voi tehdä jos tiedostomuoto on EmvCard Ledger. Kenttään Filename kirjoitetaan haluttu kansio ja se tiedostonimi, jolle aineistot tallennetaan. Kentän perässä olevalla painikkeella voi polun hakea selaamalla tiedostojärjestelmää. Jos tiedoston nimen edessä ei ole asetettu polkua niin silloin tiedot tallentuvat sovelluksen käynnistyshakemistoon. 3.2.2 Raportin automatisointi (Report automation) Raportin automatisoinnilla tarkoitetaan sitä, että aineisto noudetaan automaattisesti haluttuna kellonaikana palvelimelta ja tallennetaan edellä mainittuun tiedostoon. Jos aineistot halutaan noutaa automaattisesti, tulee valinta Daily report at olla valittuna. Raportin automatisointiin liittyy myös se miten tietoja ja tiedostoja käsitellään raporttia noudettaessa. Create new Käytettäessä tätä yhdessä Daily report at valinnan kanssa muodostetaan aina uusi nimi tiedostolle. Tiedostonimen lopussa on päivämäärä. Overwrite Ylikirjoitetaan tiedosto aina. Tiedostossa mahdollisesti aikaisemmin olleet tiedot menetetään. Append data
7 Tiedot kirjoitetaan olemassaolevan tiedoston perään. Jos tiedostoa ei ole niin se luodaan Filename kentässä annetulle nimelle. 3.3 Viitetiedostojen lataus palveluun Automatisoitu viitetietojen lataus palveluun tulee mahdolliseksi myöhemmin.