WWW-asiakasohjelman käyttöohje

asetetaan tietolähteeksi IMAP-postipalvelin
luodaan kontekstimalli work
luodaan projectmanager-profiili ja määritetään client-sääntö
joka ohjaa asiakkaan viestit clientmessages-näkymään.
luetaan saapuneet viestit clientmessages-näkymästä

luodaan yhteystietoja

lähetetään viesti

1. Alkutoimet

1.1 Selaimen asetukset

Järjestelmä ei nykyisellään toimi www-proxyn kanssa, joten proxyn joutuu ottamaan pois päältä selaimen asetuksista.
Lisäksi keksien eli cookieiden tulee olla käytössä.

1.2 Järjestelmään rekisteröityminen ja sisäänkirjautuminen

Uusi käyttäjä rekisteröityy kirjoittamalla käyttäjätunnuksensa ja salasanansa ja rastittamalla
kohdan new user.

Vanha käyttäjä kirjautuu sisään User -valinnalla. Group -valinnalla voi myös kirjautua sisään,
jos ylläpitäjä on liittänyt käyttäjän johonkin ryhmään.

1.3 Järjestelmän pääsivu

Uudelle käyttäjälle esitetään tällainen pääsivu. Sivulle ilmestyvät profiilimäärittelyjen mukaiset
viestinäkymät aikanaan.

Valikkojen toiminnot ovat seuraavat:

Main: Tästä käyttäjän määrittelemiin viestinäkymiin.
DataSources: Tästä pääsee katsomaan määrittelemiään tietolähteitä ja lisäämään sekä poistamaan niitä.
(Tällä hetkellä ainut mahdollinen tietolähde on IMAP-postipalvelin.)
ContextModels: Tästä käyttäjä pääsee määrittelemään kontekstimallejaan.
Profiles: Tästä käyttäjä pääsee määrittelemään ja muokkaamaan profiilejaan sekä
aktivoimaan/deaktivoimaan niitä. Lisäksi sivun kautta on mahdollisuus antaa profiileille
sääntöjä, raja-arvoja, ajastettuja toimintoja.ja liittää niihin toiminta.
ContactList: Tästä pääsee syöttämään yhteystietoja (nimi, sähköpostiosoite), joita voidaan
hyödyntää mm. viestien kirjoituksen yhteydessä.
Write: Sähköpostiviestien kirjoitus.
Log out: Järjestelmästä uloskirjautuminen.

Sisällysluetteloon

2. Tietolähteet

2.1 Uuden tietolähteen luonti

Uuden tietolähteen lisäysikkkunaan päästään valikon kohdasta DataSources.

Käyttäjän tulee antaa käyttämälleen tietolähteelle

nimi
palvelin
palvelimen käyttäjätunnus
salasana

Lopuksi lisätään tietolähde painamalla Add new server -painiketta

2.2 Tietolähteen poisto

Järjestelmään lisätyt tietolähteet näkyvät Main ikkunassa, josta ne voidaan poistaa delete-painikkeella.

Sisällysluetteloon

3. Kontekstimalli

3.1 Uuden kontekstimallin luonti

Uuden kontekstimallin lisäysikkunaan päästään valikon kohdasta ContextModels.

Syötä uudeksi kontekstimallinimeksi work ja paina Add ContextModel-painiketta.

3.2 Kontekstimallin poisto

Luodut kontekstimallit voidaan poistaa painamalla delete-painiketta ko. kontekstimallille.

3.3 Kontekstimallimuuttujien arvovälin asetus

Klikkaa kontekstimallisanaa work...

.. jolloin pääset kontekstimallimuuttujien määrittelysivulle.

Tarkoituksena on määrittää kontekstimalliin kuuluvaksi sellaiset viestit, joiden otsikossa esiintyy sana work.
Aloita valitsemalla Name-vetolistasta Subject sekä vertailulistasta in.
Kirjoita Valuekenttään work ja anna lisäksi Weight arvoksi 80.

Nyt olet muodostanut lauseen: "Subject in work 80". Lause tarkoittaa sitä, että viestit, joiden otsikkokentässä
sana work esiintyy, kuuluvat määriteltävään työkontekstimalliin ja saavat painoarvon 80. Älä laita rastia
kohtaan forced (Jos rasti on forced kohdassa, ei työkontekstimalliin voisi kuulua sellaisia viestejä joiden
otsikossa ei olisi merkkijonoa "work"). Paina add.

Muuttujien selitykset (suluissa esimerkkisyöte)

Namearvo
CC	Vertailussa käytetään viestin CC kentän arvoja
From	Vertailussa käytetään viestin lähettäjäkentän arvoja
Precedence	Vertailussa käytetään viestin tärkeyslipukkeen arvoja (bulk, junk, none, first-class)
Subject	Vertailussa käytetään viestin otsikon arvoja
Date	Vertailussa käytetään viestin päivämääräarvoja
To	Vertailussa käytetään viestin vastaanottajakentän arvoja
Priority	Vertailussa käytetään viestin prioriteettiarvoja (1=korkein, 5=matalin)
MESSAGE_BODY	Vertailussa käytetään itse viestin sisältöä
MESSAGE-ID	Vertailussa käytetään viestin id-arvoa
Vertailulauseke
in	Valuekenttään syötetty arvo esiintyy muuttujamääreen osana esim. lause "From in pekka". Tällöin viesti, jossa olisi pekka@iki.fi lähettäjänä kuuluisi kyseiseen kontekstimalliin.
not in (!in)	Valuekentän arvo ei saa esiintyä muuttujamääreen osana esim. lause "From not in pekka". Tällöin viestin lähettäjäosassa ei saa esiintyä merkkijonoa "pekka" ("Pekka" kelpaa) Saattaa jossain kohdin esiintyä myös muodossa !in
=	valuekentän arvo täytyy olla täsmälleen sama kuin Name-vetovalikon määräämän muuttujakentän arvo.esim jos lähetetyn viestin säännöksi määritellään "Subject = moi", saapuvalla viestillä tulee olla otsikkonaan "moi", jotta viesti kuuluisi tähän kontekstimalliin.
!=	Edellinen käänteisenä eli "Subject != moi" tarkoittaisi sitä että kaikki saapuneet viestit, joissa ei ole otsikkona "moi" kuuluvat tähän kontekstimalliin.

Uusi muuttujaehtolause näkyvissä. Nyt voidaan siirtyä projectmanager-profiilin luontiin.

Sisällysluetteloon

4. Profiili

4.1 Oletusprofiili

Järjestelmällä on oletusprofiili DEFAULT, joka sisältää oletussäännön All_to_INBOX.
Oletussääntö määrää, että kaikki saapuneet viestit menevät INBOX näkymään.
Oletusprofiili vaatii kuitenkin, että käyttäjä määrittelee ajastetun säännön,
jossa Get-message toiminnon kohteeksi asetetaan jokin aikaisemmin luoduista tietolähteistä esim IMAP1.

4.2 Uuden profiilin luonti

Uuden profiilin lisäysikkunaan päästään valikon kohdasta Profiles.

Haluamme luoda oletusprofiilin rinnalle projectmanager-profiilin. Aloitamme syöttämällä
profiilin nimeksi projectmanager ja painamalla Add Profile-painiketta.

4.3 Profiilin sääntöjen luonti

Siirry projectmanager-profiilin sääntöjen luontiin ja määrittelyyn klikkaamalla sanaa projectmanager.
Profiili-ikkunassa oleva teksti No contextmodel references! tarkoittaa sitä, että profiililla ei ole vielä
kontekstimalliviittauksia. Älä välitä viestistä, vaan klikkaa sanaa projectmanager (teemme
kohtekstimalliviittauksen vähän myöhemmin).

Anna uudelle projectmanagerprofiilin säännölle nimeksi client sekä paina Add Rule -painiketta.

Siirry clientsäännön ehtojen ja toimintojen lisäykseen klikkaamalla sanaa client.

4.3.1 Profiilin sääntöjen ehtojen ja toimintojen lisäys

Lisää clientsäännölle ehto: From in CarryClient.
Lisää clientsäännölle toiminta: ADD Set-To-View clientmessages.

Tulos: "Jos lähettäjäkentässä esiintyy CarryClient -merkkijono,
aseta viesti clientmessages näkymään".

Ehdot ja toiminnot lisätty.

Vetovalikoiden muuttujat

And	Lisää ehdon aiempaan ehtoon/ehtoihin. Jos entuudestaan oli määritelty ehto: "From in CarryClient -> Set-To-View: clientmessages" ja uutena ehtona määriteltäisiin: AND Subject in work, täytyisi molemmat ehdot päteä: Lähettäjänä olisi oltava CarryClient ja viestiotsikossa esiintyä sana work, jotta järjestelmä liittäisi saapuneen viestin clientmessages viestinäkymään.
or	Tekee lisättävän ehdon valinnaiseksi aiemmin määritellylle ehdolle. Esimerkiksi jos aiemmin oli ehtona "From in CarryClient -> Set-To-View: clientmessages" ja uusi ehto olisi OR Subject in work, riittää viestin liittämiseen clientmessages viestinäkymään se, että edes toinen ehdoista saapuneessa viestissä toteutuu.
ADD	Lisää seuraus
DELETE	Poista seuraus
Set-To-View	Aseta näkymään

Lisää vetovalikoiden muuttujia ja niiden selityksiä

4.3.2 Viestinäkymän määrittäminen

Ylläolevassa kuvassa Set-To-View + teksti määrittää mihin näkymään ehdon toteuttava viesti menee.

4.4 Profiilin liittäminen kontekstimallin raja-arvoon

Aseta projectmanagerprofiilin work -kontekstimallin raja-arvoksi 100. Tämä tarkoittaa, että saapuneen viestin tulee saada
work-kontekstimallin vertailussa 100%, jotta se aiheuttaisi projectmanager-profiilin sääntöjen tutkimisen.

4.5 Ajastimen luonti ja ajastetun säännön tarkistusvälin asetus

Seuraavaksi luo ajastin (kuva yllä). Nimeä ajastin nimellä myScheduler tms. ja anna ajastimen
toimintaväliksi 1 minuutti. Paina add.

Seuraavaksi luo ajastettu sääntö luomallesi ajastimelle. Klikkaa ajastimen nimeä.

4.6 Ajastetun säännön luonti

Anna ajastimen ajastetulle säännölle nimeksi schedule1 tms.

Älä määritä säännölle tällä kertaa aikaehtoa, jotta emme joudu odottelemaan...

Lisää säännön toiminnaksi: ADD Get-Message IMAP1.

Vetovalikon muuttujat

Get-Message	Hae viesti tietolähteestä....
Activate-Profile	Aktivoi profiili ...
DeActivate-Profile	Deaktivoi profiili ...
Toggle-Profile-Activation	Profiilin aktivointitilan vaihtaminen: aktiivinen -> passiivinen, passiivinen -> aktiivinen

Ajastettu sääntö valmis (kuva alla).

4.7 Profiilin aktivoiminen

Projectmanager-profiili aktivoidaan painamalla activate painiketta (napin tekstiksi tulee painamisen jälkeen deactivate).

4.8 Profiilin deaktivoiminen

Aktiivinen profiili deaktivoidaan painamalla deactivate -painiketta (sama painike kuin activate).

Sisällysluetteloon

5. Viestien lukeminen

5.1 Viestinäkymän valitseminen

Main-ikkunasta valitaan haluttu viestinäkymä.

5.2 Viestien luku

Viestin avaaminen tapahtuu klikkaamalla viestin otsikkoa.

5.3 Liitetiedoston luku

Jos avatussa viestissä on liitetiedosto(ja), näkyvät ne viestin Attachment -kentässä.
Liitetiedoston noutaminen tapahtuu tiedostonnimeä napsauttamalla.

5.4 Viestin poisto

Viesti poistetaan joko suoraan viesti-ikkunasta "Delete this message" -painikkeella (yläkuva) tai viestinäkymäikkunasta
viestin nimen vieressä olevalla delete-painikkeella (alakuva). Huom. Jos viesti on ohjautunut useampaan kuin yhteen
näkymään ei viestin poistaminen poista sitä kuin nykyisestä näkymästä.

5.5 Viestinäkymän poisto

Viestinäkymä voidaan poistaa vasta sitten kun kaikki näkymän viestit on poistettu.

Sisällysluetteloon

6. Yhteystietojen asettaminen

6.1 Yhteystiedon luonti

Uusi yhteystieto luodaan kirjoittamalla henkilön nimi nimikenttään sekä hänen sähköpostiosoite sähköpostiosoitekenttään.

6.2 Yhteystiedon poisto

Yhteystiedon poistaminen tapahtuu painamalla delete painiketta poistettavan yhteystiedon kohdalla

Sisällysluetteloon

7. Viestin kirjoitus

7.1 Viestin kirjoitus ja lähetys

Sähköpostiviestien lähettäminen tapahtuu tutunoloisesti.

From	osaan kirjoitetaan lähettäjän sähköpostiosoite.
To	osaan kirjoitetaan vastaanottajan sähköpostiosoite.
or to	osasta on valittavissa kontaktilistan yhteystieto jonka sähköpostiosoitteeseen viesti lähetetään mikäli To osa on jätetty tyhjäksi.
Subject	osaan kirjoitetaan viestin otsikko.
Body	osaan kirjoitetaan varsinainen viesti.

Tällä hetkellä tiedoston liittäminen viestiin ei ole mahdollista.

Sisällysluetteloon

8 Järjestelmän käytön lopettaminen

8.1 Uloskirjautuminen järjestelmästä

Järjestelmästä kirjaudutaan ulos klikkaamalla valikosta Log out.