Liite A: Käyttöönoton tarkistuslista

Ennen käyttöönoton aloittamista

Tarkista palvelun tekniset vaatimukset kohdasta Tekniset vaatimukset ja tietoliikenneyhteydet.

Organisaatiokohtaiset hakemistopolku- ja koodimääritykset

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Hakemistopolut Organisaatiokohtaiset hakemistopolkumääritykset on tarkistettu.		Hakemistopolut
Kuntakoodi Kuntakoodi on määritetty.		Kunnan määrittäminen
Palvelun näkyvyys Linkit palveluun on lisätty sopiviin paikkoihin esim. organisaation www-sivuille.	Linkki palveluun on suositeltavaa lisätä näkyvälle ja helposti löydettävälle paikalle, jotta hakijat löytävät palveluun.	Palvelun osoite
Koodistot Sopivat koodistoarvot ja ohjausarvot on annettu palveluun tarvittavista koodistoista.	Tarkista, että uusien koodistojen nimet ovat helppotajuisia. Käytä koodistojen ohjausarvoja harkitusti.	Koodistoarvot
Liitteiden koko Oletuksena palautteen liitteiden sallittu yhteenlaskettu koko on 4 MB.	Lisää sallittua kokoa 32 MB. Lisää web.config-tiedoston `<appSettings>-lohkoon`: `<add key="AttachmentsMaxSizeInKB" value="32768" />`	Tarkista myös `maxRequestLength` ja lisää tarvittaessa `<system.web>`-lohkoon: `<httpRuntime executionTimeout=”950” maxRequestLength=”32768” />`

Palvelun lähettämät sähköpostiviestit

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Sähköpostimääritykset Sähköpostien lähetykseen tarvittavat määritykset on tehty.	Ei ole suositeltavaa lähettää sähköpostia kaikista palautteen käsittelyssä tehdyistä toimenpiteistä palautteen antajalle. Lähetettävien sähköpostien määrää kontrolloidaan käsittelyvaiheiden ohjausarvoilla.	Sähköpostien lähettämisen määritteleminen Koodistoarvot
Sähköpostien sisältö Sähköpostien sisältötekstit on muokattu organisaatioosi sopiviksi.	Lisää sähköpostipohjiin esim. organisaatiosi yhteystiedot. Voit muokata vakiotekstejä palautteisiin liittyvien sähköpostien sisällön pohjaksi. Voit määritellä Web.config-tiedostossa asiakaskohtaisen URL-osoitteen sähköposteissa käytettäville linkeille asetuksella `ServiceURLForXSLTemplates`.	Rekisteröitymiseen liittyvät sähköpostit Sähköpostivastaus Vakiotekstin lisääminen
Kieliversiot Sähköpostien sisältöteksteihin tehdyt muutokset on tehty myös kaikilla muilla palvelun kielillä.		Sähköpostit eri kielillä

Vahvan tunnistamisen määritykset

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Vahvan tunnistamisen yhteys Yhteys on määritetty.	Yhteyden määrittämistä varten organisaatiollasi tulee olla sopimus tunnistamisen palveluntarjoajan kanssa.
Palautetyyppikohtaisuus Vahva tunnistaminen on otettu käyttöön halutuissa palautetyypeissä.	Voit määrittää tunnistamisen palautetyypeille, joissa tunnistaminen vaaditaan. Vahva tunnistaminen esimerkiksi pankkitunnuksilla on palautteen antajille tutumpaa. Tunnistaminen tuottaa palautteen antajalle lisätyötä, joten se tulisi vaatia vain silloin, kun se on ehdottoman välttämätöntä.	Palautetyypin lisääminen

Trimble Locus -järjestelmä ja Trimble Feedback -palvelu

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Palvelun käytön kontrollointi muuttujalla Jos palautteita Trimble Locus - järjestelmään lukevilla käyttäjillä on XC_PLUGIN ympäristömuuttujassa ennestään asetettu esimerkiksi dokumenttiarkisto, on sinne lisättävä myös palautepalvelu (oletuksena sitä ei siis tarvita, jos muuttujalla ei ole arvoa): XC_PLUGIN Enable:eFeedback	Palvelun käyttöä voidaan kontrolloida Trimble Locus -ohjelmassa muuttujalla XC_PLUGIN: Enable:eFeedback - palautepalvelu käytössä Trimble Locus -ohjelmassa Disable:eFeedback - palautepalvelu ei käytössä Trimble Locus -ohjelmassa	Trimble Locus Pääkäyttäjän käsikirja.
Hankkeen julkaisu Jos hankkeita julkaistaan Trimble Locus -järjestelmästä palautepalveluun, tarvitaan tietojen hakemiseen ominaisuustiedostoja.	Tarvittavat ominaisuustiedostot löytyvät oikeista kansioista.	Liite B: Hankkeen ominaisuustiedostot

Käyttäjäoikeudet

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Pääkäyttäjäoikeudet Käyttäjille, jotka hallinnoivat toisten käyttäjien oikeuksia, on annettu pääkäyttäjäoikeudet.	Käyttäjäoikeudet on suositeltavaa antaa organisaatiossa niin, että vain muutamalla käyttäjällä on pääkäyttäjäoikeus, ja muilla kunnan työntekijöillä palautteiden selailu- ja analysointioikeus. Osalla kunnan työntekijöistä on oltava lisäksi palautteiden käsittelyoikeus. Asiakaspalvelussa on suositeltavaa olla oikeus antaa palautetta toisen puolesta.	Oikeuksien määritteleminen ensimmäisellä käyttökerralla
Palautteiden muut oikeudet Kunnan työntekijöille on annettu käsittelijän rooli ja sopivat oikeudet.	Hankkeiden luontiin ja julkaisuun palautepalvelussa tarvitsee erilliset oikeudet. Hankkeiden luontiin Trimble Locus -ohjelman kautta tarvitsee erilliset oikeudet.	Oikeuksien muokkaaminen palvelun käyttöönoton jälkeen

Palautteiden rakenteen ja sisällön määritykset

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Palautetyypit ja aiheet Valittavissa olevat palautetyypit ja niihin liittyvät aiheet on selkeästi määritetty.	Luo palautetyyppejä, joista kokemattomankin palautteen antajan on helppo tunnistaa haluamansa vaihtoehto.	Palautetyypin lisääminen
Palautetyyppien ryhmittely Luodut palautetyypit ovat näkyvissä ja ryhmitelty tarkoituksenmukaisesti.	Ryhmittele saman aihepiirin palautetyypit yhteen. Yksittäinen palautetyyppiryhmä voidaan avata tai sulkea käyttämällä asetusta `IsOpen:false/true` Ohjaus-sarakkeessa koodistossa Palautetyyppien ryhmittely. Oletuksena kaikki palautetyypit ovat auki (arvo on `true`). Muu palaute -palautetyypille sulkeminen määritetään tiedostossa Web.Config seuraavasti: `<add key="OtherFeedbackTypesIsOpen" value="false" />` Oletuksena Muu palaute -palauteryhmä on avoinna (arvo on `true`).	Palautetyyppien näyttäminen palvelussa
Pakolliset kentät Pakolliset kentät on määritetty.	Määritä pakollisiksi ne kentät, joiden tiedot ovat tärkeitä palautteen käsittelyssä, mutta älä vähemmän tärkeitä kenttiä, jotta palautteen antamisesta ei tule liian työlästä.	Pakolliset kentät
Valinta kartalta Internet-karttapalvelun sijainti on määritetty, jotta palautteen sijainnin voi valita kartalta.		Karttaikkunat palvelussa
Automaattinen sijainti Palautteen sijainti lisätään automaattisesti mobiililaitteesta (puhelin tai tabletti). Sijainnin automaattinen lisääminen edellyttää sijainnilta vähimmäistarkkuutta. Se määritellään asetuksella `FeedbackAddAutoLocationMinAccuracy`. Oletus on 200 metriä.	Automaattinen sijainti määritetään Web.Config-tiedostossa seuraavasti: `<add key="FeedbackAddAutoLocation" value="true"/>` `<add key="FeedbackAddAutoLocationMinAccuracy" value="200"/>`
Kartan lomakesivulle upottamiseen liittyvät määritykset on tehty. Kartan oletusarvoinen zoom-taso on säädetty sopivaksi. Oletuskarttana on useimmiten paras käyttää opaskarttaa.	Jos kartta on oletusarvoisesti zoomattu liian lähelle, palautteen antaja joutuu zoomaamaan karttaa kauan ennen kuin hän pystyy hahmottamaan sijaintinsa kartalla.	Karttavalinnan määritteleminen ja käyttöönottaminen
ID palautteille Näytä ID-numero kaikille palautteille. Palautteita voi hakea ID:n perusteella niitä selattaessa.	Palautteen ID määritetään Web.Config-tiedostossa seuraavasti: `<add key="FeedbackSearchByIdEnabled" value="true" />`

Palvelun ulkoasu

Määriteltävä asia	Määrittelyssä huomioitava	Lisätietoa
Kuvat Palvelussa tarvittavat kuvat on vaihdettu organisaatiosi kuviksi.	Organisaatiosi kuvien tulee olla helposti ymmärrettäviä ja niiden tulee sopia ulkoasultaan palvelun yleisilmeeseen.	Organisaatiokohtaiset kuvat
Tietosuojaseloste Käyttöehdot	Nämä dokumentit on muokattu vastaamaan organisaatiosi tarpeita.	Tietosuojaseloste ja Käyttöehdot
Ohjeet Käyttöliittymässä näkyvä ohjeistus on muokattu organisaatioosi sopivaksi.	Ohjeiden tulee olla lyhyitä ja helppotajuisia. Käytä ohjeissa samoja ilmaisuja kuin muualla sivulla.	Käyttöliittymässä näkyvä ohjeistus
Kieliversiot Palvelun mahdolliset kieliversiot on luotu (suomi, ruotsi ja englanti sisältyvät oletuspalveluun).	Jos organisaatio haluaa tarjota palvelua kielellä, jota oletuspalvelussa ei ole, tulee varmistua siitä, että kaikki palvelun kielisyyksiä sisältävät osat on käännetty ennen kieliversion julkaisua. Palvelun kääntäminen uudelle kielelle vain osittain ei ole suositeltavaa.	Kieliversioiden luominen ja käyttöönotto

Tekoaälyn samankaltaisuusanalyysin asetukset

Asetus	Määritys	Mahdolliset arvot
AI-palvelun URL	`<add key="AIBaseUrl" value="<URL address>"/>`
Käyttäjänimi	`<add key="AIUserName" value="<Username>"/>`
Salasana	`<add key="AIPassWord" value="<Password>"/>`
Näytetäänkö samankaltaisuushaun herkkyysarvo loppukäyttäjälle	`<add key="AIDisplayScores" value="<true/false>"/>`	Oletus = false.
Tallennetaanko uusi palaute tekoäly -palveluun	`<add key="AILiveSync" value="<true/false>"/>`	Oletus = false.
Teeman samankaltaisuuden tunnistamisessa käytettävä herkkyysarvo	`<add key="AIThemeScoreThreshold" value="0.5"/>`	Oletus = 0.35. Vaihteluväli = 0.01 - 1.0. Pienempi arvo tarkoittaa, että teema tunnistetaan helpommin.
Kohteen (esimerkiksi palaute) samankaltaisuuden tunnistamisessa käytettävä herkkyysarvo	`<add key="AISimilarityScoreThreshold" value="0.5"/>`	Oletus = 0.35. Vaihteluväli = 0.25 - 1.0. Pienempi arvo tarkoittaa, että kohde tunnistetaan helpommin.
Näytettävien samankaltaisten kohteiden lukumäärä	`<add key="AISimilarityMaxCount" value="0.5"/>`	Oletus = 10. Vaihteluväli = 1 - 50.
Samankaltaisten kohteiden enimmäisikä	`<add key="AISimilarityMaxAge" value="2 Months"/>`	`n Days` (ikä päivinä) tai `n Months` (kuukausina) tai `n Years` (vuosina).
Samankaltaisten kohteiden järjestys	`<add key="AISimilarityOrderBy" value="Date"/>`	Oletus on `Date`. Vaihtoehdot ovat `Date` (päiväys) tai `Score` (pisteet).

Tekla.GIS.eFeedbackAgentPlugin-asetuksia käytetään palautteiden ryhmän synkronointiin.

<SyncTasks> 
<SyncFeedbackTask>
<Name>AI Sync feedbacks</Name>
<Schedule> <Daily> <RunTime>4:00</RunTime> </Daily> </Schedule>
<BaseUrl>https://trimblenlp.topdatascience.com/test/api/</BaseUrl>
<UserName>trimble_test</UserName>
<PassWord>***</PassWord>
<MaxAge>10 Years</MaxAge>
<MaxBatchSize>2000</MaxBatchSize>
</SyncFeedbackTask>
</SyncTasks>

Palautepalvelun hallinta

Käyttäjät

Katso Käyttäjien rekisteröityminen ja hallinta.

Käyttäjien rekisteröitymisen kautta luotuja käyttäjätunnuksia hallitaan Microsoft Internet Information Server (IIS) -järjestelmällä sekä Trimble Feedback -palvelun käyttöliittymässä.

Palautetyypit

Katso Palautetyypin lisääminen.

Palautetyypit voivat koostua esimerkiksi toimialasta tai palvelusta (venesatama) ja palautetyyppi voidaan edelleen jakaa eri aihealueisiin (puhtaanapito).

Hankkeet

Katso Hankkeen luominen palvelussa

Trimble Locus -ohjelmassa voidaan myös luoda hankkeita, jotka julkaistaan Trimble Feedback -palveluun. Katso Palaute ja muut ohjelmat.

Vakiotekstit

Katso Vakiotekstin lisääminen

Vakiomuotoisia tekstejä voi käyttää palvelun lähettämissä sähköpostiviesteissä. Vakiotekstejä voidaan lisätä ja muokata tilanteeseen sopivaksi.

Ulkoasu

Katso Ulkoasun lisääminen

Ulkoasu määrittelee millainen on palvelun kartalle piirrettävien pisteiden, viivojen ja alueiden ulkoasu.

Kuvaustapa

Katso Kuvaustavan lisääminen

Kuvaustapa määrittelee ulkoasun, jota käytetään, kun pisteitä, viivoja ja alueita piirretään palvelussa kartalle.

Koodistot

Katso Koodistoarvot

Koodistoja käytetään palautepalvelun sivujen toiminnan ja sisällön määrittelyyn.