Lähdekoodi sivulle Sote-ammattikortin käyttö Ajas-järjestelmään kirjautumisessa


Ajas-järjestelmän kirjautumiseen on nyt saatavana uusi vaihtoehto niille käyttäjille, joiden tilaukseen kuuluu myös Kanta.<br>

Tämä näkyy käyttäjille niin, että kun kirjautumista aloitetaan, käyttäjä voi valita joko perinteisen "Kirjaudu käyttäjätunnuksilla" kirjautumistavan tai uuden "Kirjaudu Sote-ammattikortilla" -kirjautumistavan. <br><br>

'''Toiminnot on julkaistu Ajas Touchin esijulkaisuversiossa'''. Ne tulevat näkyviin, jos edellisen kirjautumisen yhteydessä samalla selaimella Ajas Touch -versio on ollut valittuna Esijulkaisuksi. Jos valinnat eivät näy, kirjaudu ensin käyttäjätunnuksilla, vaihda käyttöön Esijulkaisuversio, kirjaudu ulos ja kirjaudu uudelleen. 
*Uudelleen kirjautumiseen kannattaa käyttää alkuperäistä kirjautumisosoitetta. Muussa tapauksessa sinun on ensin syötettävä yrityksen tunniste. 

==Sote-ammattikortilla kirjautumisen edellytykset==

'''Sote-ammattikortilla on mahdollista kirjautua''':<br>
*Jos yritykselläsi on Kanta-tilaus ja Kanta-käyttöönotto on suoritettu. 
*Jos sinulla on Sote-ammattikortti. 
*Jos tietokoneelle on asennettu ERA SmartCard -sovellus: https://www.ehoito.fi/Driver
*Jos Sote-ammattikortti on kiinni tietokoneesssa kortinlukulaitteen avulla.
*Jos olet omassa käyttäjäprofiilissa liittänyt kortin Ajas-tiliin tai pääkäyttäjä on tehnyt sen sinun puolestasi.

*Jos työntekijälle on lisäksi lisätty käyttöoikeudet Kantaan, Kanta-kirjautuminen avautuu automaattisesti Ajas Touch-kirjautumisen jälkeen. 
**Työntekijälle voidaan lisätä käyttöoikeudet Kantaan, kun tilinhaltija tekee lisäkäyttäjätilauksen ja toimittaa meille (asiakaspalvelu (at) ajas.fi) uuden lisättävän käyttäjän voimassaolevan Sote-ammattikortin rekisteröintinumeron. 
**Lisäkäyttäjätilaus tarvitaan paitsi Kannan tuotantoympäristöön myös testiympäristöön. 
Lisätietoja Sote-ammattikortista: https://dvv.fi/sote-ammattikortti<br><br>

==Sote-ammattikortin liittäminen Ajas-tiliin==

Sote-ammattikortin voi liittää Ajas-tiliin 2 tavalla. Voit itse tehdä sen omassa käyttäjäprofiilissasi tai tilin pääkäyttäjä voi tehdä sen sinun puolestasi uudella Kela/Kanta -asetusten sivulla. <br><br>

===Työntekijän oma käyttäjäprofiili===
<br>
[[Tiedosto:Sote-touch13.jpg|800px]]<br>
Jos yrityksen Ajas-tilillä Kanta on käytössä, työntekijän käyttäjäprofiilissa näkyy uusi osio: Kirjautuminen Sote-ammattikortilla.<br>
Aseta kortti kortinlukijaan ja klikkaa "Muokkaa". Kortin liittämis- ja irrotustoiminnot tulevat näkyviin. <br><br>

[[Tiedosto:Sote-touch141.jpg|800px]]<br>

'''1)''' Sote-ammattikortilta tunnistettu käyttäjän nimi.<br>
'''2)''' Sote-ammattikortilta tunnistettu käyttäjän reskisteröintinumero.<br>
'''3)''' Paina "Yhdistä kortti tiliin".<br>
'''4)'''Jos lukijassa ei ollut vielä korttia kun muokkaus avattiin / oli väärän henkilön kortti, voi kortin etsinnän tehdä uudestaan päivitä-painikkeella.<br><br>


[[Tiedosto:Sote-touch15.jpg|800px]]<br><br>
Kun kortti yhdistetään tiliin, näkymä päivittyy. Tämän jälkeen käyttäjä voi kirjautua yhdellä kertaa sekä Ajas Touchiin että Kantaan.<br><br>

===Pääkäyttäjän Kela/Kanta asetukset===
<br>
[[Tiedosto:Sote-touch16.jpg|700px]]<br>
Jos yrityksen Ajas-tilillä on Kanta käytössä, pääkäyttäjä voi avata Asetukset-sivulla Kela/Kanta osiossa Ylläpitäjän asetukset.  "Hallinnoi tunnuksia" -painikkeesta pääkäyttäjä pääsee manuaalisesti liittämään Sote-ammattikorttien rekisteröintinumeroita työntekijöille.<br><br>

[[Tiedosto:Sote-touch17.jpg|700px]]<br><br>
Uusi näkymä avautuu, johon haetaan aluksi lista Ajas-käyttäjistä, joille ei ole liitetty kortin numeroa. "Näytä kaikki" -painikkeesta voi hakea lisäksi ne käyttäjät, joille on jo liitetty kortin numero. <br><br>

[[Tiedosto:Sote-touch18.jpg|700px]]<br>

Kun kenttiin tehdään muutoksia, näkymän yläreunaan ilmestyy "Tallenna muutokset" -painike. Tämä pysyy näytön yläreunassa, vaikka nimiä olisi niin paljon, että listaa rullattaisiin sivukaupalla alas päin.<br><br>
Rekisteröintinumeron muoto on 11 merkkiä pitkä tekninen numerosarja. Muokattujen kenttien reunukset muuttuvat vihreäksi tai punaiseksi riippuen siitä onko syötetty arvo oikean muotoinen.<br><br>
Kun kentässä on arvo, näkyviin tulee myös "Tyhjennä" painike kentän tyhjentämistä varten. Kaikki muutokset tallennetaan yhdellä kertaa yläreunan "Tallenna muutokset" -painikkeesta.<br><br>

[[Tiedosto:Sote-touch19.jpg|700px]]<br><br>
Jos kenttään on syötetty väärän muotoinen arvo, tallennusta ei edes yritetä tehdä vaan näkyviin tulee virheviesti. Pääkäyttäjän tulee silloin tarkistaa missä virhe oli ja mikä on oikea rekisteröintinumero. <br><br>

[[Tiedosto:Sote-touch20.jpg|600px]]<br><br>
Jos kaikki tallennettavat arvot ovat oikean muotoisia,  järjestelmä tarkistaa vielä, että sama numero ei ole käytössä jo toisella käyttäjällä.
Jos samaa numeroa yritetään tallentaa toiselle käyttäjälle, näkyy ylläoleva virheviesti. <br><br>

[[Tiedosto:Sote-touch21.jpg|700px]]<br><br>
Asetukset tallennettu -viesti kertoo siitä, että järjestelmä on pystynyt tallentamaan kaikki syötetyt tiedot onnistuneesti.<br><br><br>

==Kirjautuminen==
Kun Sote-ammattikortin käytön [[Sote-ammattikortin_käyttö_Ajas-järjestelmään_kirjautumisessa#Sote-ammattikortilla_kirjautumisen_edellytykset|edellytykset täyttyvät]] kirjautuminen on mahdollista. <br>


[[Tiedosto:Sote-touch1.jpg|600px]]<br><br>
[[Mistä_löydän_yrityksen_tunnisteen%3F|Yritystunnisteen]] syöttämisen jälkeen näkyy kirjautumistapavalitsin. Tämä näkyy käyttäjälle vain kerran.<br><br>

[[Tiedosto:Sote-touch2.jpg|600px]]<br><br>

Kun kirjautumistapa on kertaalleen valittu, jatkossa vaihtoehdot näytetään välilehti-tyylisesti. Tapaa voi vaihtaa yläreunan välilehdillä. Viimeksi käytössä ollut tapa muistetaan selainkohtaisesti. <br><br>
'''1)''' Aloita kirjautuminen vanhalla tavalla, käyttäjätunnuksilla.<br>
'''2)''' Aloita kirjautuminen Sote-ammattikortilla.<br>
'''3)''' Yrityksen tunniste näkyy tässä, jos olet käyttänyt alkuperäistä Ajas Touch kirjautumisosoitetta tai syöttänyt yritystunnisteen manuaalisesti.<br><br>


[[Tiedosto:Sote-touch61.jpg|600px]]<br><br>

Kun käyttäjä on valinnut "Kirjaudu Sote-ammattkortilla" ja kun Sote-ammattikortti on ollut kortinlukijassa kirjautumisikkunassa näkyy: <br><br>

'''1)''' Sote-ammattikortilta tunnistettu käyttäjän nimi.<br>
'''2)''' Sote-ammattikortilta tunnistettu käyttäjän reskisteröintinumero.<br>
'''3)''' Ajas Touchin yritystunniste.<br>
'''4)''' "Kirjaudu käyttäen ERA testiympäristöä" -vaihtoehto. <br>
*Jos olet vasta aloittanut Kannan käytön ja haluat harjoitella merkintöjen tekemistä testiympäristössä, voit kirjautua sinne tästä linkistä. 
'''5)''' Muussa tapauksessa järjestelmä yrittää automaattisesti yhdistää Kannan tuotantoympäristöön kun painetaan "ERA kirjautuminen".<br><br>


"Kirjaudu käyttäen ERA testiympäristöä" -linkki avaa seuraavat valinnat:<br>
[[Tiedosto:Sote-touch8.jpg|600px]]<br><br>

Voit tässä vielä valita haluatko kirjautua testiympäristöön vai tuotantoympäristöön. Paina lopuksi "ERA kirjautuminen".<br><br>
[[Tiedosto:Sote-touch9.jpg|600px]]<br><br>

PIN1-koodin syöttöikkuna tulee näkyviin. Syötä PIN.<br><br>

[[Tiedosto:Sote-touch11.jpg|800px]]<br><br>

Kun PIN koodi on oikein ja kortti on liitetty Ajas tiliin, kirjaudutaan kyseiselle tilille. Tämän jälkeen jatketaan automaattisesti Kantaan kirjautumista ja näytetään organisaation valitsin Kantaan kirjautumisen viimeistelyä varten.<br>
'''Huom''': Vaikka käyttäjä tässä vaiheessa peruuttaisi Kanta-kirjautumisen, pysyy Ajas-kirjautuminen voimassa. Jos Kanta ominaisuuksia haluaa käyttää, sinne voi edelleen kirjautua vanhaan tapaan ylävalikon [[Kanta_Potilastiedon_arkisto#Aloita_kirjautuminen|kirjautuneen käyttäjän nimen alta]].<br><br>

[[Tiedosto:Sote-touch12.jpg|600px]]<br><br>

Jos organisaatiovalitsimessa on valittavissa vain yksi vaihtoehto, Kanta-kirjautuminen viimeistellään automaattisesti.<br><br>



<br><br>

==Ongelmia kirjautumisessa -toimintaohjeet==

===Käyttöoikeudet ja yhteyden muodostaminen===


[[Tiedosto:Sote-touch31.jpg|600px]]<br><br>

'''Yhtään toimikorttia ei löydy'''<br>
Syy: Toimikortti ei ole lukijassa, lukija ei ole kiinni koneessa.<br>
Ohje: Liitä toimikortti lukijaan ja lukija tietokoneeseen. Jos se ei auta, yritä liikutella ja liittää molempia uudelleen. Yritä toisella kortinlukijalla. Jos yksikään kortinlukija ei toimi, kortti voi olla vioittunut.

[[Tiedosto:Sote-touch5.jpg|600px]]<br><br>

'''Korttiin liitettyä käyttäjää ei löytynyt'''<br>
Syy: Sote-ammattikortin rekisteröintinumeroa ei ole lisätty ja liitetty Ajas-tiliin. <br>
Ohje: [[Sote-ammattikortin_käyttö_Ajas-järjestelmään_kirjautumisessa#Ty.C3.B6ntekij.C3.A4n_oma_k.C3.A4ytt.C3.A4j.C3.A4profiili|Liitä Sote-korttisi Ajas-tiliin omassa käyttäjäprofiilissa]] tai pyydä, että [[Sote-ammattikortin_käyttö_Ajas-järjestelmään_kirjautumisessa#P.C3.A4.C3.A4k.C3.A4ytt.C3.A4j.C3.A4n_Kela.2FKanta_asetukset|yrityksesi pääkäyttäjä lisää ja liittää Sote-korttisi Ajas-tiliin]].<br><br>

[[Tiedosto:Sote-touch22.jpg|600px]]<br><br>

'''Käyttäjä perui sisäänkirjautumisen'''<br>
Syy: Käyttäjä on painanut PIN-koodi-kyselyssä Peruuta.<br>
Ohje: Kirjaudu uudelleen.<br><br>

[[Tiedosto:Sote-touch23.jpg|600px]]<br><br>

'''PIN-koodikyselyyn ei vastattu riittävän nopeasti'''<br>
Syy: PIN-koodia ei syötetty muutaman kymmenen sekunnin sisään.<br>
Ohje: Kirjaudu uudelleen ja ole valmiina syöttämään PIN 1 -tunnus.<br><br>

[[Tiedosto:Kirjautumisen jälkeen.jpg|600px]]<br><br>
'''Organisaatiota ei ole lisensoitu käyttämään ERA-järjestelmää'''<br>
Syy: Käyttäjällä ei ole käyttöoikeuksia Kannassa. <br>
Ohje: Pääkäyttäjä voi tilata uuden Kanta-käyttäjän ottamalla yhteyttä: asiakaspalvelu (at) ajas.fi ja ilmoittamalla seuraavat tiedot:<br>
*Käyttäjän nimi
*Käyttäjän Sote-ammattikortin rekisteröintinumero (kortin etupuolelta)
*Toivottu aloituspäivä<br><br>

===Ajas-kirjautumisen ja Kanta-istuntojen tilanteita===


[[Tiedosto:Sote-touch101.jpg|600px]]<br><br>

'''Ajas Touch lukittu'''<br>
Kun Ajas Touchiin on kirjauduttu Sote-kortilla, ohjelma alkaa seurata kortin pysymistä kortinlukijassa. Jos kortti poistetaan, näytetään valkoinen lukitusruutu. Kun sama kortti palautetaan kortinlukijaan, lukitusruutu poistuu ja Ajas Touchin käyttöä voi jatkaa siitä missä oltiin ennen lukitusta.<br><br>

[[Tiedosto:Sote-touch24.jpg|600px]]<br><br>

'''Kortin poistaminen''' kortinlukijasta saa aikaan pienellä viiveellä myös sen, että ERA lukitsee sillä avatun Kanta-istunnon. Kun Ajas avautuu, Kanta-istunnon tila tarkastetaan. Tässä se on tullut lukituksi → lukkosymboli ylärivillä. Silloin automaattisesti pyydetään PIN-koodia Kanta-istunnon avaamiseen. <br><br>


[[Tiedosto:Sote-touch25.jpg|600px]]<br><br>
PIN-koodin oikea syöttö avaa Kanta-istunnon taas käytettäväksi.<br><br>

'''Aiempien Kanta-istuntojen tarkistus'''<br><br>
[[Tiedosto:Sote-touch26.jpg|600px]]<br><br>

Kun Ajas-kirjautuminen tapahtuu uudelleen, tarkastetaan onko käyttäjällä olemassa olevaa Kanta-istuntoa. Jos sellainen löytyy avoinna, otetaan se käyttöön ja näytetään ilmoitus "Yhdistetty uudelleen aikaisempaan Kanta-istuntoon". Tämä tarkoittaa sitä, että jos käyttäjä kirjautuu ulos Ajas-ohjelmasta jossa Kanta-istunto on ollut auki, ja kirjautuu takaisin sisään muutaman minuutin sisällä, pystyy aikaisempaa Kanta-kirjautumista yhä käyttämään.<br><br>


'''Lukittu Kanta-istunto'''<br><br>
[[Tiedosto:Sote-touch27.jpg|600px]]<br><br>

Jos aikaisempi Kanta-istunto löytyy, mutta se on jo lukittuna, näytetään ilmoitus "Havaittiin lukittu Kanta-istunto" ja lukkosymboli.<br>
Lukitun Kanta-istunnon voi avata joko klikkaamalla lukon kuvaa tai valitsemalla Ajas Touchin oikeassa yläkulmassa oman nimen alta valikosta "Kirjaudu Kantaan".<br><br>

===ERA SmartCard -kortinlukuohjelma===

Sote-ammattikortilla kirjauduttaessa, Ajas Touchin on saatava yhteys kortinlukijaan. Se tapahtuu ERA SmartCard sovelluksen kautta:<br>
*ERA SmartCard ohjelman on oltava asennettuna ja avoinna/käynnissä
*Yhteyttä tulee yrittää oikean portin kautta
*Kortinlukijan on oltava kiinni tietokoneessa
*Kortin on oltava kortinlukijassa

Kaksi viimeistä vaatimusta on käsitelty aikaisemmin, ja niillä on omat selkeät virheilmoitukset. Seuraavat koskevat ERA SmartCard-sovellusta.<br><br>

[[Tiedosto:Sote-touch28.jpg|600px]]<br><br>

'''ERA SmartCard -sovellusta ei löydy'''<br>
Syy: ERA kortinlukusovellusta ei ole asennettu tai se ei ole auki tai yhteyttä sovellukseen yritetään väärän portin kautta. <br>
Tavallisimmat syyt ovat nämä kaksi ensin mainittua:<br><br>
Ohje: <br>
Tarkista [[Kanta_Potilastiedon_arkisto#1._Onko_ERA_SmartCard_asennettu_tietokoneelle.3F|onko ERA SmartCard asennettu tietokoneelle ja asenna tarvittaessa]]<br>
Tarkista [[Kanta_Potilastiedon_arkisto#2._Onko_ERA_SmartCard_-sovellus_auki.3F|onko ERA SmartCard -sovellus auki ja avaa tarvittaessa]]<br><br>
Jos nämä ovat kunnossa, syy voi olla se, että Ajas ei saa vastausta yrittämästään portista. Tämä on harvinaisempi tilanne, mutta mahdollinen. <br><br>
Kuvassa näkyvä portin numero 44304 on ERA:n oletusportti.<br>

Ohje: Tarkista mitkä portit ovat avoinna ERA SmartCard-sovelluksessa. <br>
[[Tiedosto:Era-tietoa.jpg|250px]]<br><br>
Avaa tietokoneella oleva ERA-ikoni hiiren oikeaklikkauksella ja avaa "Tietoa". <br>
ERA ikoni löytyy Windows- ja Mac -koneissa kuten ohjeessa: [[Kanta_Potilastiedon_arkisto#2._Onko_ERA_SmartCard_-sovellus_auki.3F|Onko ERA SmartCard -sovellus auki]]<br><br>


[[Tiedosto:Sote-touch30.jpg|400px]]<br><br>

ERA SmartCardin käyttämät avoinna olevat portit näkyvät kuvassa.<br>
Kopioi avoinna oleva portin numero ja liitä se Ajas-ohjelman "ERA SmartCard Portti" -kohtaan. Paina uudelleen "Yhdistä ERA SmartCard"<br><br>

Jos tämä ei tuota tulosta, on mahdollista, että jokin muu koneellasi oleva ohjelma on varannut oletusportit. Asian selvittämiseksi ja oletusporttien vapauttamiseksi, ota yhteyttä yrityksesi IT-tukihenkilöön. <br><br>

[[Tiedosto:Sote-touch29.jpg|600px]]<br><br>