Merge pull request #1458 from Tampere/chore/update-manual-with-v2.5-c…

…ontent

Chore/update manual with v2.5 content

frontend/src/views/Manual/fi.md

@@ -91,16 +91,17 @@ Hannan navigointipalkin oikeasta laidasta löytyy painike, joka ohjaa käyttäj
 
 Kartta on Hannan laskeutumissivu. Siellä käyttäjä voi tarkastella hankkeita, tai vaihtoehtoisesti niiden kohteita kartalla, tehdä hakuja, tarkastella niiden perustietoja sekä perustaa uusia hankkeita tai kohteita. Alla on kuvattu yllä näkyvään kuvaan numeroidut toiminnot tarkemmin.
 
-1. Valitse tarkasteltavaksi joko hanke- tai kohdekartta. Oletuksena hankekartta tulee näkyviin.
-2. Hakutoiminnot sijaitsevat sivun yläosassa. Niiden joukko vaihtuu sen mukaan, onko valittuna hanke vai kohdekartta.
-3. Hakutulokset näkyvät tässä. Klikkaamalla hakutulosta siirryt hanke- tai kohdesivulle. Kohdekartan puolella valikoituneet kohteet on ryhmitelty hankkeittain.
-4. Hankkeet tai kohteet voi viedä Excel-taulukkotiedostoon painikkeesta "lataa raportti". Tiedostoon tulevat viedyksi vain aktiivisen haun mukaiset hankkeet/kohteet. Jos hanketyyppejä on valittuna useita, viedään ne tiedostossa omille välilehdilleen. Asemakaavahankkeista viedään taulukkotiedostoon vain osa tietokentistä perustuen mallina käytettyyn asemakaavaluetteloon.
-5. Karttaikkuna, jolla näytetään joko hankkeita tai kohteita riippuen valinnasta kohdassa yksi. Piirtotapa on riippuvainen siitä, kuinka etäältä karttaa katsotaan. Kuvassa hankkeiden sijainnit ovat esitetty kootusti kuvanmukaisilla numeroiduilla pallosymboleilla, jotka tarkentuvat lähentäessä karttaan. Myös karttaikkuna toimii hakusuodattimena.
+1. Valitse tarkasteltavaksi joko hanke- tai kohdekartta.
+2. Käyttäjä voi luoda itselleen joukon pikasuodattimia vaihdellakseen nopeasti eri hanke-kohde-joukkojen välillä. Hanke- ja kohdevälilehdillä on omat pikasuodattimensa. 
+3. Eri haut mahdollistavat suodattimet sijaitsevat tässä. Niiden joukko vaihtuu sen mukaan, onko valittuna hanke- vai kohdekartta.
+4. Hakutulokset näkyvät tässä. Klikkaamalla hakutulosta siirryt hanke- tai kohdesivulle. Kohdekartan puolella haun palauttamat kohteet on ryhmitelty hankkeittain ja niiden omaisuusluokat sekä laji (suunnittelu/rakentaminen) on tuotu ilmi ikonein.
+5. Hankkeet tai kohteet voi viedä Excel-taulukkotiedostoon painikkeesta "lataa raportti". Tiedostoon tulevat viedyksi vain aktiivisen haun mukaiset hankkeet/kohteet. Jos hanketyyppejä on valittuna useita, viedään ne tiedostossa omille välilehdilleen. Asemakaavahankkeista viedään taulukkotiedostoon vain osa tietokentistä perustuen mallina käytettyyn asemakaavaluetteloon.
 6. Hankkeiden visualisointityyliä voi vaihtaa karttaikkunan vasemmasta yläkulmasta löytyvästä alasvetovalikosta.
-7. Oikeassa yläkulmassa on erikseen esitetty hankkeet, jotka koskevat koko kunnan aluetta. Ikonia klikkaamalla pääset selaamaan koko kunnan hankkeita ja halutessasi siirtymään niiden hankesivulle.
-8. Perusta uusi hanke tai kohde.
-9. Käyttäjä voi valita eri kartta-aineistoja näkyville ja pois näkyvistä. Valittavana on joukko taustakarttoja, rekisterikohteita ja aluejakoja.
-10. Karttaselite.
+7. Karttaikkuna, jolla näytetään joko hankkeita tai kohteita riippuen valinnasta kohdassa yksi. Piirtotapa on riippuvainen siitä, kuinka etäältä karttaa katsotaan. Kuvassa hankkeiden sijainnit ovat esitetty kootusti kuvanmukaisilla numeroiduilla pallosymboleilla, jotka tarkentuvat lähentäessä karttaan. Myös karttaikkuna toimii hakusuodattimena.
+8. Perusta uusi hanke (tai kohde, jos kohdekartta valittuna).
+9. Oikeassa yläkulmassa on erikseen esitetty hankkeet, jotka koskevat koko kunnan aluetta. Ikonia klikkaamalla pääset selaamaan koko kunnan hankkeita ja halutessasi siirtymään niiden hankesivulle.
+10. Käyttäjä voi valita eri kartta-aineistoja näkyville ja pois näkyvistä. Valittavana on joukko taustakarttoja, rekisterikohteita ja aluejakoja.
+11. Karttaselite.
 
 Käyttäjä voi klikata kartalla näkyviä hanke- ja kohdealueita, jolloin niille näytetään ponnahdusikkunassa perustiedot, ja josta käsin on mahdollista siirtyä hanke- tai kohdesivulle. Jos klikkaus kohdistuu useampaan hankkeeseen tai kohteeseen, niiden välillä voi selata nuolinäppäimillä. Karttavalinta korostetaan keltaisella. Toistaiseksi kaupungin rajapinnoilta haettavien aineistojen ominaisuustietoja ei pysty lukemaan Hannasta käsin.
 
@@ -143,6 +144,8 @@ Jos hakuehtoja on useampia, niiden kaikkien pitää toteutua, jotta hanke tai ko
 
 Myös itse karttaikkuna toimii suodattimena. Hakutuloksiin ilmestyvät oletuksena myös hankkeet tai kohteet, joilta puuttuu aluerajaus. Käyttäjä voi painaa riippuen valitusta välilehdestä painiketta _vain sijaintitiedon sisältävät hankkeet_ tai painiketta _vain sijaintitiedon sisältävät kohteet_ jättääkseen hakutuloksista pois geometriattomat hankkeet tai kohteet. Lisäökis tarjolla on painike, jolla hakutuloksiin saa nopeasti tuotua vain koko kunnan aluetta koskevat hankkeet. Kohteiden puolelta löytyy vielä painike, jolla saat valituksi vain omat kohteet. Oma kohde tarkoittaa kohdetta, jossa käyttäjälle on osoitettu kohteella jokin toimijarooli (esim. rakennuttaja, suunnitteluttaja tai valvoja).
 
+Käyttäjillä on myös mahdollisuus luoda omia pikasuodattimia. Pikasuodattimien lukumäärää ei ole rajattu. Ne sallivat käyttäjän vaihdella nopeasti eri hakujen välillä. Toisistaan erilliset pikasuodattimet löytyvät hankekartalta, kohdekartalta sekä investointiohjelmoinnin näkymästä. Jokaiselle pikasuodattimelle tulee antaa nimi, eikä kaksi pikasuodatinta saa omata samaa nimeä samalla sivulla. 
+
 # Käyttöoikeudet
 
 ## Käyttäjätyypit
@@ -464,9 +467,9 @@ Kunnossapitohankkeen ja sen kohteiden taloussuunnittelu vastaa investointihankke
 
 ![Investointiohjelmointi](/images/investointiohjelmointi.png)
 
-Investointiohjelmointinäkymä on tarkoitettu vuosikohtaisen investointiohjelman rakentamiseen, sen seuraamiseen ja hallinnointiin. Kyseinen näkymä muodostuu taulukosta, joka listaa **investointihankkeiden kohteita**. Näkymään voi siirtyä päänavigointipalkista käsin (1). Näkymä helpottaa suuren kohdejoukon hallinnoimista kerralla ja kokonaiskuvan muodostumista.
+Investointiohjelmointinäkymä on tarkoitettu vuosikohtaisen investointiohjelman rakentamiseen, sen seuraamiseen ja hallinnointiin. Kyseinen näkymä muodostuu taulukosta, joka listaa **investointihankkeiden kohteita**. Näkymään voi siirtyä päänavigointipalkista käsin. Näkymä helpottaa suuren kohdejoukon hallinnoimista kerralla ja kokonaiskuvan muodostumista.
 
-Taulukossa (8) jokaiselle kohteelle on kerrottu seuraavat tiedot.
+Taulukossa jokaiselle kohteelle on kerrottu seuraavat tiedot.
 
 - Hanke, johon kohde kuuluu
 - Kohteen nimi
@@ -483,25 +486,26 @@ Taulukossa (8) jokaiselle kohteelle on kerrottu seuraavat tiedot.
 
 Alla on kuvattu näkymään liittyvät toiminnallisuudet yllä olevan kuvan numeroinnin mukaan.
 
-2. Taulukko kohdistuu ensisijaisesti yhteen kalenterivuoteen. Sivun yläosassa on vuosivalinta, josta käsin käyttäjä pystyy valitsemaan häntä kiinnostavan vuoden. Vuosivalinta vaikuttaa siihen, miltä vuodelta kohderiveille haetaan talousluvut. Valinta voi kohdistua kerrallaan vain yhteen vuoteen. Huomioi, että kohde katsotaan mukaan aina, kun se _leikkaa_ valittua vuotta. Näin ollen kohde, jonka toteutusväli on 31.12.2023-31.12.2024, valikoituisi mukaan vuosivalinnan ollessa `2023`, ja sille näytettävät talousluvut johdettaisiin päivältä yksinään päivältä 31.12.2023. Käyttäjä voi valita vuosivalitsimesta myös valinnan `koko elinkaari`, jolloin talousluvut johdetaan kohderiveille niiden koko elinkaaren ajalta. Tällöin talouslukuja ei pysty kuitenkaan muokkaamaan taulukossa.
+1. Investointiohjelmointi päänavigointipalkissa.
+2. Taulukko kohdistuu ensisijaisesti yhteen kalenterivuoteen. Sivun yläosassa on vuosivalinta, josta käsin käyttäjä pystyy valitsemaan häntä kiinnostavan vuoden. Vuosivalinta vaikuttaa siihen, miltä vuodelta kohderiveille haetaan talousluvut. Valinta voi kohdistua kerrallaan vain yhteen vuoteen. Huomioi, että kohde katsotaan mukaan aina, kun se _leikkaa_ valittua vuotta. Näin ollen kohde, jonka toteutusväli on 31.12.2023-31.12.2024, valikoituisi mukaan vuosivalinnan ollessa `2023`, ja sille näytettävät talousluvut johdettaisiin yksinään päivältä 31.12.2023. Käyttäjä voi valita vuosivalitsimesta myös valinnan `koko elinkaari`, jolloin talousluvut johdetaan kohderiveille niiden koko elinkaaren ajalta. Tällöin talouslukuja ei pysty kuitenkaan muokkaamaan taulukossa.
 3. Painikkeesta _näytä vain omat kohteet_ taulukkoon tuodaan vain kohteet, joissa kirjautunut käyttäjä on merkitty niissä yhteen tai useampaan rooliin (esim. rakennuttaja tai valvoja).
-4. Taulukon suodatuksen mukaiset kohderivit on mahdollista viedä Excel-taulukkoon valitsemalla painikkeen _lataa raportti_. Tarjolla on neljä eri raporttipohjaa: tulosteraportti, perusraportti, kustannusraportti ja toimijaraportti.
-5. Käyttäjä voi lisätä uuden kohteen myös investointiohjelmoinnista käsin. Valitsemalla painikkeen `uusi kohde` painikkeen käyttäjä päätyy suoraan kohdesivulle, jossa hän samalla pääsee yksilöimään sen, mihin hankkeeseen kohde avataan. Hankevalinnan alasvetovalikko sisältää vain hankkeet, joissa käyttäjällä on muokkausoikeus. Mikäli käyttäjällä ei ole mihinkään hankkeeseen muokkausoikeutta, ei painike ole ollenkaan valittavissa. Kohteen tallentamisen jälkeen käyttäjä palaa takaisin investointiohjelmointinäkymään ja perustettu kohde korostetaan siinä hetkeksi.
-6. Vuosivalinnan lisäksi käyttäjän tarjolla on joukko muita hakusuodattimia, joilla vaikuttaa taulukossa esitettävien kohderivien joukkoon. Hakusuodattimia voi valita yhden tai useamman. Jos käytössä on useampi hakusuodatin, on niiden välinen looginen operaattori `JA`. Näin ollen, jos käyttäjä on valinnut esimerkiksi vuodeksi `2024`, elinkaaritilaksi `aloittamatta` ja käyttötarkoitukseksi `ajoradat`, tulee taulukkoon ajoradat, jotka ovat aloittamatta ja joiden toteutus sijoittuu kokonaan tai osittain vuodelle 2024. Voit piilottaa yläosan hakusuodattimet klikkaamalla hakasta oikeassa laidassa.
-7. Summariviin lasketaan taulukossa kullakin hetkellä esitettävien kohderivien talousarvioiden, toteumien, ennusteiden ja käyttösuunnitelman muutosten summa.
-8. Taulukko, jonka solujen tietoja pystyy muokkaamaan olettaen, että käyttäjällä on muokkausoikeus kyseiseen kohteeseen. Mikäli käyttäjällä ei ole oikeutta muokata, on tekstin väri vaaleanharmaa. Muokkaustilaan siirrytään hiiren kaksoisklikkauksella. Kaikki solut eivät kuitenkaan ole muokattavissa (toteuma, hankkeen nimi). Painamalla hiirellä kohteen tai hankkeen nimen yhteydessä olevaa ikonia pääset hyppäämään kyseiselle hanke- tai kohdesivulle. Sivu aukeaa uuteen välilehteen. Kohderivit on järjestetty hankkeittain. Hankkeen nimi on korostettu vihreällä värillä. Hankkeen nimi on kirjattu vain ensimmäiselle kohteelle ja seuraavilla, samaan hankkeeseen kuuluvilla kohderiveillä hankkeen nimen tilalla on hakanen.
-9. Ponnahdusikkuna, joka aukeaa käyttäjän muokatessa solua. Ponnahdusikkunan tarkka sisältö riippuu muokattavasta sarakkeesta.
-10. Vierittäessä taulukkoa alaspäin sen vasempaan alakulmaan ilmestyy painike, jota painamalla käyttäjä pääsee takaisin ylös.
+4. Käyttäjän itselleen tallentamat pikasuodattimet.
+5. Taulukon aktiivisen suodatuksen mukaiset kohderivit on mahdollista viedä Excel-taulukkoon valitsemalla painikkeen _lataa raportti_. Tarjolla on neljä eri raporttipohjaa: tulosteraportti, perusraportti, kustannusraportti ja toimijaraportti.
+6. Käyttäjä voi lisätä uuden kohteen myös investointiohjelmoinnista käsin. Valitsemalla painikkeen `uusi kohde` painikkeen käyttäjä päätyy suoraan kohdesivulle, jossa hän samalla pääsee yksilöimään sen, mihin hankkeeseen kohde avataan. Hankevalinnan alasvetovalikko sisältää vain hankkeet, joissa käyttäjällä on muokkausoikeus. Mikäli käyttäjällä ei ole mihinkään hankkeeseen muokkausoikeutta, ei painike ole ollenkaan valittavissa. Kohteen tallentamisen jälkeen käyttäjä palaa takaisin investointiohjelmointinäkymään ja perustettu kohde korostetaan siinä hetkeksi.
+7. Vuosivalinnan lisäksi käyttäjän tarjolla on joukko muita suodattimia, joilla vaikuttaa taulukossa esitettävien kohderivien joukkoon. Suodattimia voi valita yhden tai useamman. Jos käytössä on useampi suodatin, on niiden välinen looginen operaattori `JA`. Näin ollen, jos käyttäjä on valinnut esimerkiksi vuodeksi `2024`, elinkaaritilaksi `aloittamatta` ja käyttötarkoitukseksi `ajoradat`, tulee taulukkoon ajoradat, jotka ovat aloittamatta ja joiden toteutus sijoittuu kokonaan tai osittain vuodelle 2024. Voit piilottaa yläosan suodattimet klikkaamalla hakasta oikeassa laidassa.
+8. Summariviin lasketaan taulukossa kullakin hetkellä esitettävien kohderivien talousarvioiden, toteumien, ennusteiden ja käyttösuunnitelman muutosten summa.
+9. Taulukko, jonka solujen tietoja pystyy muokkaamaan olettaen, että käyttäjällä on muokkausoikeus kyseiseen kohteeseen. Mikäli käyttäjällä ei ole oikeutta muokata, on tekstin väri vaaleanharmaa. Muokkaustilaan siirrytään hiiren kaksoisklikkauksella. Kaikki solut eivät kuitenkaan ole muokattavissa (toteuma, hankkeen nimi). Painamalla hiirellä kohteen tai hankkeen nimen yhteydessä olevaa ikonia pääset hyppäämään kyseiselle hanke- tai kohdesivulle. Sivu aukeaa uuteen välilehteen. Kohderivit on järjestetty hankkeittain. Hankkeen nimi on korostettu vihreällä värillä. Hankkeen nimi on kirjattu vain ensimmäiselle kohteelle ja seuraavilla, samaan hankkeeseen kuuluvilla kohderiveillä hankkeen nimen tilalla on hakanen.
+10. Ponnahdusikkuna, joka aukeaa käyttäjän muokatessa solua. Ponnahdusikkunan tarkka sisältö riippuu muokattavasta sarakkeesta.
 11. Jos käyttäjällä on tallentamattomia muutoksia, ilmestyy taulukon päälle sen vasempaan alanurkkaan tallennuspalkki. Sieltä käsin on tallentamisen ohessa mahdollisuus perua kaikki muutokset ja siirtyä muokkauksissa yhden eteen- tai taaksepäin.
 12. Taulukon oikeassa alanurkassa on mahdollista vaikuttaa siihen, kuinka paljon rivejä näytetään. Oletus on 1000 kappaletta. Jos rivejä on enemmän kuin valittu luku, voi käyttäjä siirtyä seuraavalle tulossivulle.
 
 # SAP-raportit näkymä
 
 ## Yleistä SAP-raporteista
 
-SAP-raportit sisältää kaksi taulukkoa, joista toinen tarjoaa tietoa ympäristökoodeista (ympäristöinvestoinnit) ja toinen puitesopimuksista. Näkymään voi navigoida valitsemalla sen päänavigointipalkista. Tiedot haetaan suoraan SAP:sta, mutta Hanna kyselee ne kaikki kerralla yöaikaan. Näin ollen tiedoissa voi olla maksimissaan päivän viive. Kulunut aika edellisestä hausta on kerrottu sivun oikeassa ylälaidassa. Taulukkoon valikoituvia rivejä voi rajata valitsemalla yhdestä tai useammasta tarjolla olevasta hakusuodattimesta arvon. Jos arvoja useampi hakusuodatin on valittu, pitää rivin täyttää kaikki ehdot. Taulukossa näkyvät tiedot on mahdollista viedä excel-tiedostoon valitsemalla painike _lataa raportti_.
+SAP-raportit sisältää kaksi taulukkoa, joista toinen tarjoaa tietoa ympäristökoodeista (ympäristöinvestoinnit) ja toinen puitesopimuksista. Näkymään voi navigoida valitsemalla sen päänavigointipalkista. Tiedot haetaan suoraan SAP:sta, mutta Hanna kyselee ne kaikki kerralla yöaikaan. Näin ollen tiedoissa voi olla maksimissaan päivän viive. Kulunut aika edellisestä hausta on kerrottu sivun oikeassa ylälaidassa. Taulukkoon valikoituvia rivejä voi rajata valitsemalla yhdestä tai useammasta tarjolla olevasta suodattimesta arvon. Jos arvoja useampi suodatin on valittu, pitää rivin täyttää kaikki ehdot. Taulukossa näkyvät tiedot on mahdollista viedä excel-tiedostoon valitsemalla painike _lataa raportti_.
 
-SAP-raportit sisältää kaksi taulukkoa, joista toinen tarjoaa tietoa ympäristökoodeista (ympäristöinvestoinnit) ja toinen puitesopimuksista. Näkymään voi navigoida valitsemalla sen päänavigointipalkista. Tiedot haetaan suoraan SAP:sta, mutta Hanna kyselee ne kaikki kerralla yöaikaan. Näin ollen tiedoissa on maksimissaan päivän viive. Kulunut aika edellisestä hausta on kerrottu sivun oikeassa ylälaidassa. Taulukkoon valikoituvia rivejä voi rajata valitsemalla yhdestä tai useammasta tarjolla olevasta hakusuodattimesta arvon. Jos arvoja useampi hakusuodatin on valittu, pitää rivin täyttää kaikki ehdot. Taulukossa näkyvät tiedot on mahdollista viedä excel-tiedostoon valitsemalla painike _lataa raportti_.
+SAP-raportit sisältää kaksi taulukkoa, joista toinen tarjoaa tietoa ympäristökoodeista (ympäristöinvestoinnit) ja toinen puitesopimuksista. Näkymään voi navigoida valitsemalla sen päänavigointipalkista. Tiedot haetaan suoraan SAP:sta, mutta Hanna kyselee ne kaikki kerralla yöaikaan. Näin ollen tiedoissa on maksimissaan päivän viive. Kulunut aika edellisestä hausta on kerrottu sivun oikeassa ylälaidassa. Taulukkoon valikoituvia rivejä voi rajata valitsemalla yhdestä tai useammasta tarjolla olevasta suodattimesta arvon. Jos arvoja useampi suodatin on valittu, pitää rivin täyttää kaikki ehdot. Taulukossa näkyvät tiedot on mahdollista viedä excel-tiedostoon valitsemalla painike _lataa raportti_.
 
 SAP:a mukaillen on menot esitetty positiivisina lukuina ja tulot negatiivisina. Toteuma on näiden summa. Taulukon yläpuolella on summarivi, johon johdetut luvut muodostuvat taulukossa näkyvistä riveistä.