Kapselin käyttöohje

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

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äsi 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ä (Ubuntu)

Ohjelmisto	Versio	Lisätietoja
Emacs
Gnome System Monitor
Golang
Josm
LibreOffice		Base, Calc, Draw, Impress, Math, Writer
Pigz
Python	3.12	Sisältää seuraavat paketit:  tensorflow nltk spacy scikit-learn seaborn plotly bokeh pydot xgboost lightgbm catboost eli5 torch keras gensim scrapy beautifulsoup4 numpy scipy pandas statsmodels matplotlib trio httpx qrcode
R + R studio	4.2.1	Käytössä CRAN-kirjaston paketit. 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	Ajantasainen
Adobe Acrobat Reader DC	Ajantasainen
Anaconda 3	2024.06-1	Käyttää Python Wheeliä 3.12
GeoDa	1.22
Git	2.46.1
Google Chrome	Ajantasainen
IBM SPSS Statistics	29	Lisenssi aktivoidaan pyynnöstä.
LibreOffice	Ajantasainen	Base, Calc, Draw, Impress, Math, Writer
LyX	2.4.1.1
MiKTeX	24.1
Notepad++	Ajantasainen
QGIS	3.34.11
R	4.4.1	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	2024.09.0-375
SAS	9.4	Lisenssi aktivoidaan pyynnöstä. HUOM. 1.6.2025 alkaen SAS-lisenssi muuttuu erikseen tilattavaksi palveluksi, jonka hinta (114,00 €/kk) laskutetaan erikseen.
Stata	16	Lisenssi aktivoidaan pyynnöstä.
WinPython	3.12

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

Julkaisemisella tarkoitetaan tiedon tuomista julkisuuteen ja sen levittämistä ympäröivään yhteiskuntaan. Julkaisemiseksi katsotaan tulosten esitteleminen oman työryhmän ulkopuolelle.

Katso myös