Kapselin käyttöohje

Tältä sivulta löydät yksityiskohtaiset ohjeet Kapselin tilaamiseen, käyttämiseen ja tulosten anonymiteetin varmistamiseen.

Näin tilaat Kapselin

1. Kirjaudu asiointipalveluumme (asiointi.findata.fi)
2. Valitse ylävalikosta ”Jätä hakemus”
3. Selaa alaspäin ja valitse ”Valitse alta uusi hakemuslomake” -otsikon alta ”Kapseli-käyttöympäristön tai aineiston säilytyspalvelun tilaus tai päivitys” ja paina sen kohdalla ”Täytä hakemus”
4. Täytä hakemuslomake
   • Kirjoita Hakija-kenttään oma nimesi
   • Lisää sen jälkeen ”Kutsu jäsen…” -painikkeen avulla kaikki ne henkilöt ja sähköpostiosoitteet, jotka tarvitsevat käyttöoikeuden Kapseliin
   • Kutsutut henkilöt liittyvät käyttäjiksi käyttäen vahvaa tunnistautumista
   • Täytä loput lomakkeesta
   • Huom! R-Toolsia ei asenneta automaattisesti Kapseliin. Jos tarvitset R-Toolsia, ilmoita tämä lomakkeen lisätiedoissa
5. Valitse lopuksi oikean laidan ”Toiminnot” kohdasta ”Lähetä hakemus”

Tietoturvallisen Kapseli-käyttöympäristön käyttö

Tietoturvallinen Kapseli-käyttöympäristö vastaa hyvin pitkälti oman koneen työpöytää, mutta Kapselin työpöytä on etäyhteyden päässä. Tietoturvamääräysten takia Kapselin käytössä on muutamia eroja verrattuna tavallisen työpöydän käyttöön:

• Kapselista ei ole pääsyä internetiin. Vaikka selain on asennettu, sitä voi käyttää vain paikallisesti esimerkiksi html-muotoisten dokumenttien avaamiseen.
• Tietojen kopioiminen etätyöpöydän ja oman tietokoneen välillä on estetty.
• Kapselin näkymästä ei saa ottaa kuvaa.
• Mitään tietoja tai kuvia tai muuta materiaalia ei voi itsenäisesti siirtää Kapseliin vaan kaikki tietojen siirto tapahtuu Findatan kautta.

Kapselin kanssa käytettävän IP-osoitteen on oltava staattinen eli yleisimmin organisaation IP-osoite. Yleensä etätyössä oman organisaation IP-osoite voidaan saada käyttöön etäyhteyden esim. VPN-yhteyden kautta. Mikäli organisaation yhteyksissä on vaihtuvuutta, kannattaa kysyä oman organisaation IT-tuesta IP-osoitteiden koko osoiteavaruutta, jotta vaihtuvuus ei haittaa Kapselin käyttöä. Kapselia ei voi käyttää yksityisten IP-osoitteiden kautta.

Kapseliin kirjautuminen

Varmista ennen kirjautumista, että käyttäjätunnuksesi on rekisteröity ja käyttövalmis. Jos et ole varma tunnuksesi käyttövalmiudesta, ole yhteydessä Findatan yhteyshenkilöön.

1. Asenna Duo Mobile (duo.com) -sovellus matkapuhelimeesi ja aktivoi se (kehittäjä: Duo Security Inc.). Jos olet jo asentanut ja aktivoinut sovelluksen, siirry kohtaan 2.
   • Asennus: hae Duo Mobile -sovellus matkapuhelimesi sovelluskaupasta ja asenna se.
   • Aktivointi: Kapseli-tilauksen yhteydessä ilmoitettuihin matkapuhelinnumeroihin lähetetään automaattisesti aktivointiviesti Duo Mobilen käyttöä varten. Sovellus aktivoidaan käyttöön klikkaamalla aktivointiviestissä olevaa linkkiä. Jos puhelin vaihtuu, tarvitaan uusi aktivointikoodi.
2. Kirjaudu Kapseliin käyttäen tietokoneen verkkoselainta.
   • Valitse kirjautumissivulla olevasta listasta se tunnistautumistapa, joka on ilmoitettu rekisteröitymisessäsi. Kirjaudu tunnistautumisen vaatimien välivaiheiden kautta.
3. Valitse käytettävissä olevista käyttäjäympäristöistä se, jota aiot käyttää. Jos käytössäsi on vain yksi käyttäjäympäristö, siirry seuraavaan kohtaan.
   • Valinnan jälkeen järjestelmä siirtyy tunnistautumisen toiseen vaiheeseen.
4. Kaksivaiheisen tunnistautumisen toinen vaihe.
   • Kirjaudu käyttäjäympäristöön.
   • Saat Duo Mobileen ilmoituksen kirjautumisyrityksestä. Tekemäsi kirjautuminen hyväksytään Duo Mobilen kautta valitsemalla ”Approve”.

Tietojen siirto ja kansiorakenne

Kaikki Kapselin ohjelmistoasennukset ja tietojen siirrot tapahtuvat tilausten ja tarkastusten kautta. Et voi itsenäisesti viedä tietoja Kapseliin tai tuoda tietoja ulos Kapselista.

Tietoluvassa määritellään ne tiedot, joiden käsittelyyn lupa on myönnetty. Kokoamme, yhdistelemme, esikäsittelemme ja tarvittaessa pseudonymisoimme ja anonymisoimme tiedot. Tietojen käytössä tarvittava lisätieto, kuten esim. julkisesti saatavilla oleva tilastotieto, vaatii myös Findatan tarkastuksen ja tietojen siirron Kapseliin.

Aineiston käsittelyn sujuvoittamiseksi pyydämme aineistot rekisterinpitäjiltä ensisijaisesti CSV-muodossa ja toimitamme ne Kapseliin CSV-muodossa (erotinmerkkinä puolipiste, merkistönä UTF-8-koodaus).

Kapselista löytyy seuraava kansiorakenne:

• Data (D:)
• Backup (E:)
• CRAN (N:)
• Output (O:)
• Work (W:)

Tietoluvassa määritellyt tiedostot ovat saatavilla Data (D:) -asemalta. Data-asema on kirjoitussuojattu. Myös muut Kapseliin toimitettavat tiedostot, kuten mahdolliset ohjelmakoodit, siirtyvät Data-asemalle tarkastuksen jälkeen.

Työskentelyä varten on käytettävissä Work (W:) -kansio. Kopioi tänne tiedostot Data-asemalta.

Output (O:) -kansio on tarkoitettu tietojen siirtoon. Kansiosta tiedot siirretään Findatan järjestelmään tarkastettavaksi. Huomaa, että siirrettäväksi laitettavien tietojen tulee olla anonyymissä muodossa. Varmista myös ohjelmakoodien osalta, ettei henkilötietoa sisälly siirrettäviin tiedostoihin.

Vie tiedot, jotka haluat varmuuskopioida, Backup (E:) -kansioon.

CRAN (N:) -kansio sisältää R-ohjelmiston käyttämiseen tarvittavia ohjelmistopaketteja.

Poistuminen järjestelmästä

Kapselin etätyöpöydän käytön voi lopettaa kahdella eri tavalla:

• Sign out löytyy vasemmassa alareunassa olevan ihmishahmon takaa. Käytä tätä vaihtoehtoa, kun olet lopettanut tietojen käsittelyn. Sign out -vaihtoehdon kautta  poistuessasi vapautat etätyöaseman resurssit.
• Disconnect löytyy Power-napin takaa. Käytä tätä vaihtoehtoa, jos jokin ajo pitää jättää pyörimään, kun poistut työasemalta. Resurssit jäävät tällöin varatuksi.

Molempien vaihtoehtojen jälkeen näet vaihtoehdot Reconnect ja Logout. Valitse uloskirjautuessa vaihtoehto Logout. Sulje selain ellet halua kirjautua takaisin.

Kapselin ohjelmistot

Kaikkiin uusiin Kapseleihin asennetaan vakiona alla olevasta taulukosta löytyvät ohjelmistot. Laajennamme ohjelmistovalikoimaa tarvittaessa.

Aiemmin tilattuihin Kapseleihin ohjelmistoversiot päivitetään tilaajan pyynnöstä. Jos käytössäsi on vanhempi versio ja haluat päivittää sen alla olevaan, sovi päivitysaikataulu lähettämällä sähköpostia osoitteeseen kapseli@findata.fi. Ilmoita viestissä Kapselin tunnus (esim. A01) sekä päivitettävä ohjelmisto.

Ohjelmistot päivittyvät tietoturvaan liittyvissä päivityksissä kaikkiin konepaketteihin tarpeen mukaan.

Linux-käyttöjärjestelmä (CentOS 7)

Ohjelmisto	Versio	Lisätietoja
Emacs
Golang
LibreOffice		Base, Calc, Draw, Impress, Math, Writer
Nextflow
Pigz
Python	3.7.9.	Sisältää seuraavat paketit: tensorflow nltk spacy scikit-learn seaborn plotly bokeh pydot xgboost lightgbm catboost eli5 torch keras dist-keras elephas gensim scrapy beautifulsoup4 numpy scipy pandas statsmodels matplotlib pyfuse3 crypt4gh trio httpx qrcode
R + R studio	4.2.1	Käytössä CRAN-kirjaston paketit. Rstudion saa Linuxissa avattua terminaalissa komennolla ”start-rdesktop”. Huom! R-Toolsia ei asenneta automaattisesti Kapseliin. Jos tarvitset R-Toolsia, ilmoita siitä tilauslomakkeen lisätiedoissa.
VS Code

Windows-käyttöjärjestelmä (Windows Server 2016 Standard)

Ohjelmisto	Versio	Lisätietoja
7-Zip	23
Adobe Acrobat Reader DC	Ajantasainen
Anaconda 3	2023.07	Käyttää Python Wheeliä 3.11
GeoDa	1.22
Git	2.43.0
Google Chrome	Ajantasainen
IBM SPSS Statistics	29	Jos ohjelmiston lisenssi vaatii päivitystä, ilmoita siitä osoitteeseen kapseli@findata.fi.
LibreOffice	7.6	Base, Calc, Draw, Impress, Math, Writer
LyX	2.3
MiKTeX	23.10
Notepad++	8
QGIS	3.32
R	4.3	Sisältää itse asennettavat CRAN-kirjaston paketit, asennusohjeet Kapselin käyttöohjeissa. Huom! R-Toolsia ei asenneta automaattisesti Kapseliin. Jos tarvitset R-Toolsia, ilmoita siitä tilauslomakkeen lisätiedoissa.
RStudio	2023.06.2+561
SAS	9.4	Jos ohjelmiston lisenssi vaatii päivitystä, ilmoita siitä osoitteeseen kapseli@findata.fi.
Stata	16	Jos ohjelmiston lisenssi vaatii päivitystä, ilmoita siitä osoitteeseen kapseli@findata.fi.
WinPython	3.11

Jos tarvitset vakiona saatavilla olevien ohjelmistojen lisäksi myös muita ohjelmistoja, niitä on mahdollista saada käyttöön lisätilauksesta. Lisäohjelmistojen tilaukset tehdään Kapseli-tilauksen yhteydessä tai Kapselin käytön aikana päivittämällä Kapseli-tilausta asiointipalvelussa.

Lisäohjelmistojen tilaus

Jos tarvitsemasi ohjelmisto ei ole mainittuna yllä olevassa taulukossa, se voidaan asentaa Kapseliin, jos tarvittavat ehdot täyttyvät. Lisäohjelmistot voivat olla joko open access- tai lisenssipohjaisia. Jos kyseessä on lisenssin vaativa ohjelmisto, vastuu lisensseistä on asiakkaalla.

Findata arvioi ohjelmiston tietoturvallisuuden ja yhteensopivuuden käyttöympäristön kanssa ennen asennusta, mutta emme pysty testaamaan ohjelmistoa tai takaamaan sen toimivuutta etäkäyttöympäristössä.

Toimi näin

1. Varmista, että ohjelmisto on joko open access- tai lisenssipohjainen.
   • Jos ohjelmisto on lisenssipohjainen, tarkista, että sinulla on virallinen lisenssi ja asennusohje.
2. Huomioi, että Kapselissa ei ole verkkoyhteyttä, joten ohjelman tulee toimia suljetussa ympäristössä.
3. Toimita Findatalle ohjelman asennukseen ja käyttöön tarvittavat tiedot.
4. Testaa ohjelman toimivuus Kapselissa.

Veloitamme omien työkalujen ja ohjelmistojen asennuksesta Kapseliin työmäärän mukaisesti 90,00 €/tunti + alv 25,5 %. Jos ohjelmiston tuominen Kapseliin vaatii laajempaa selvitystyötä (esimerkiksi yksityisen ohjelman tapauksessa), veloitamme asiantuntijatyöstä 147,00 €/tunti + alv 25,5 % toteutuneiden työtuntien mukaisesti.

Huomioithan, että Findata ei voi taata omien ohjelmistojen toimivuutta etäkäyttöympäristössä. Veloitamme asennuksesta koituvat kulut siinäkin tapauksessa, että ohjelmistoa ei voi käyttää asiakkaan suunnittelemalla tavalla Kapselissa.

Omien tiedostojen siirto Kapseliin

Kapseli toimii projektin työpöytänä koko aineiston käsittelyn ajan. Lähtökohtaisesti aineistojen käsittely tapahtuu Kapselissa eli vain valmiit analyysitulokset tuodaan järjestelmän ulkopuolelle. Myös analyysiin tarvittava ohjelmakoodi tuotetaan lähtökohtaisesti Kapselissa.

Käytännössä kuitenkin monesti analyysirunkona toimii jokin aiempi ohjelmakoodi. Aiempien koodien ja muiden omien tiedostojen, kuten tutkimusprotokollan ja muuttujien kuvausten tuominen Kapseliin on mahdollista Findatan kautta.

Omien tiedostojen siirrosta Kapseliin veloitetaan työmäärän mukaisesti 90,00 €/tunti + alv 25,5 %.

Katso tarkempi omien tietojen siirtämisen ohje sivulta Aineistojen ja tiedostojen toimittaminen Findataan.

R-ohjelman CRAN-yleisrepositorion käyttö

Cran-yleisrepositorio löytyy osoitteesta: https://cran.findata.local/

1. Poista .Renviron -tiedosto Documents -kansiosta tai Projekti -kansiosta (WORK). Voit vaihtoehtoisesti muokata tiedostoa ja poistaa seuraavia rivejä:
   • RSTUDIO_DISABLE_PACKAGES=TRUE
   • R_LIBS_USER=N:/
2. Luo .Rprofile-tiedosto Documents -kansioon alla olevilla tiedolla:
   local({
   r ←getOption(”repos”)
   r[”CRAN”] <-”https://cran.findata.local/”
   options(repos = r)
   })
   • Voit myös kopioida .Rprofile-tiedoston  D:\-asemalta (DATA)
3. Käynnistä RStudio uudelleen.
   • Voit asentaa R-paketteja install.packages(”PACKAGE”)-komennolla.
   • Jos haluat mieluummin käyttää graafista käyttöliittymää pakettien asentamiseen, löydät sen RStudiosta kohdasta Tools -> Install Package. Kun paketti on asennettu, lataa paketti library()-toiminnolla.

Pakettien asennus on myös mahdollista tilata palveluntarjoajalta, jolloin siitä veloitetaan hinnaston mukaiset työaikakustannukset: Hinnasto

Tulosten julkaiseminen

Aineistojen käsittely tapahtuu Kapseli-käyttöympäristössä ja vain valmiit analyysitulokset tuodaan järjestelmän ulkopuolelle. Käyttäjä tuottaa tulokset anonyymissa muodossa ja Findata varmistaa toisiolain mukaisesti tulosten anonymiteetin.

Tulosten anonymiteetin varmistaminen

1. Tarkista julkaistavaksi tarkoitettujen tulosten anonymiteetti ohjeen avulla. Ohje löytyy sivulta Anonyymien tulosten tuottaminen
2. Siirrä tulokset ja yhteenvetolomake Findatalle Kapseli-käyttöympäristön Output-aseman kautta.
   • Täytä ja liitä mukaan yhteenvetolomake (Pyyntö varmistaa tulosten anonymiteetti). Ajantasainen yhteenvetolomake löytyy Kapselin D-asemalta zip-tiedostosta Käyttöohjeet_User_guide_DDMMYYY.zip (esim. Käyttöohjeet_User_guide_28032024.zip).
   • Pakkaa tulokset ja yhteenvetolomake zip-kansioon ja nimeä se seuraavasti: Tulokset_tietoluvan_diaari_käyttöympäristön_tunniste_siirtopäivämäärä (anna päivämäärä muodossa ppkkvvvv, esim. Tulokset_THL_1234_14.02.00_2020_a01_15032022).
   • Luo Output-asemalle tyhjä tekstitiedosto, jonka nimi on ZZZ_READY.txt. Näin zip-kansio siirtyy automaattisesti Findatalle. Jotta siirto onnistuu, tarkista huolellisesti, että ZZZ_READY-tiedosto on nimetty oikein. Siirrot tapahtuvat tasatunnein ja 30 minuutin välein. Siirron jälkeen tiedostot poistuvat automaattisesti Output-asemalta.
   • Voit halutessasi lähettää tiedon siirrosta Findatalle (data@findata.fi). Olemme yhteydessä, jos siirto ei ole tullut perille (onnistuneesta siirrosta ei tule kuittausta).
3. Tarkastamme pyynnöt viiden arkipäivän sisällä ja toimitamme tulokset siirtopalvelu Nextcloudin välityksellä käyttäjälle. Käyttäjään ollaan yhteydessä, jos tarvitaan lisätietoja.
   • Jos tulostiedostot ovat erittäin laajoja, varmistamisessa voi mennä kauemminkin kuin viisi arkipäivää.

Katso myös