Liferay Road Show Helsinki, Case Innokylä, 2012-09-13

Innokylän verkkopalvelun
toteuttaminen
Liferay Road Show, Helsinki

13.9.2012 www.ambientia.fi 1

Projektin osapuolet
• Terveyden ja hyvinvoinnin laitos (THL)
• THL tekee vä estö terveyteen ja hyvinvointiin
n
liittyvä ä tutkimusta ja kehittä mistä . Tutkimus liittyy
terveyden ja hyvinvoinnin edistä miseen sekä
sairauksien ja vajaakuntoisuuden ehkä isyyn.

• Ambientia
• Ambientia on sä hkö iseen liiketoimintaan ja
viestintä ä n sekä yhteisö llisiin ratkaisuihin
erikoistunut asiantuntijayritys.
• Henri Leisma
• Senior Software Developer, yksi Innokylän
sovelluskehittäjistä

Taustaa
• Julkinen tarjouskilpailu
• Palvelu toteutus aloitettiin maaliskuussa 2011,
ensimmä inen vaihe julkaistiin 15.12.2011
• Toteutus tehtiin scrum kehystä mukaillen,
iteraation pituus oli 3 viikkoa
• Palvelun lä hdekoodi, saavutettavuus ja
kä ytettä vyys testautettiin kolmannella
osapuolella


Innokylä-projektin tavoitteet
“Innokylä tarjoaa sosiaali- ja terveysalan toimijoille
ympä ristö jossa nä mä voivat lö
n, ytä ä toisensa,
kehittä ä yhdessä sekä levittä ä uusia ideoita ja
innovaatioita. Innokylä ssä ihmiset ja ideat
kohtaavat.”

-Mahdollistaa kehittämisen ja ideoinnin yhdessä

-Keskussivusto menneille ja nykyisille hankkeille

-Tapahtumien jakaminen alan keskeisten toimijoiden
kesken
-Samankaltaisten projektien parissa toimivien löytäminen


Haasteet / määrittelyt
- Loppukäyttäjät voivat jakaa hankkeiden ja
tapahtumien muokkausoikeuksia
- Loppukäyttäjiä ei päästetä Liferayn hallintapaneeliin
- LR Groups, permissions

- Nostoja voitava tehdä lähes mistä tahansa
sisällöistä
- LR Asset Publisher, AssetEntry, indexing

- Saavutettavuus ja käytettävyys
- Sulautetut ohjeet tageilla, joissa näytetään web artikkeleita
- Rakenteen ja teeman korostettu yksinkertaisuus (monilla
käyttäjillä rajoitteita ja apuvälineitä)


Ratkaisut / Keskeiset toiminnot
- Julkinen tiedon jakaminen
- Hankkeet
- Tapahtumat
- Käytännöt (tulossa)
- Verstaat (tulossa)

- Osallistuminen ja kehittäminen
- Rekisteröidy palveluun
- Ota yhteyttä muihin käyttäjiin
- Kehitä muiden hankkeita ja osallistu tapahtumiin
- Luo omia hankkeita ja tapahtumia


www.innokyla.fi


Haasteita ja miten ne ratkaistiin
• Sivuston hallinta ilman hallintapaneelia
• Vaatimusmä ä rittely esittä ä varsin paljon erilaisia
hallintavaatimuksia, joiden tulee olla helposti
kä ytettä vissä julkiselta puolelta ja vielä pä
tapahtuma-/hankekohtaisesti.
• Ratkaisu
• Tapahtumat ja hankkeet pä ä tettiin toteuttaa omina
Liferay yhteisö inä ä n (Group), jolloin kä yttöoikeudet
nä ille saatiin toimimaan vaatimusten mukaisesti ilman
rä ä tä löintejä . Ominaisuuksien tuominen julkipuolelle
kä yttö n hoidettiin toteuttamalla rä ä tä lö
ö ityjä portletteja,
jotka lukevat Liferayn tarjoamia yhteisö ja muita tietoja.
-

• Oikeuksien jakaminen resurssikohtaisesti
• Vaadittiin, että loppukä yttä jien pitä ä pystyä
myöntä mä ä n eritasoisia kä yttö oikeuksia palvelussa
tapahtuma-/hankekohtaisesti. Kä yttö oikeuksien jakaminen
tapahtuu kä yttä jien kesken ja yksinkertaisesti julkiselta
puolelta.
• Ratkaisu
• Ongelma ratkaistiin toteuttamalla tapahtumat ja hankkeet
Liferayn omina yhteisö inä , jolloin kä yttöoikeuksien
jakaminen yksittä in eri tapahtumille/hankkeille voitiin
toteuttaa yhteisö kohtaisesti. Lisä haasteena oli toteuttaa
kutsuminen yhteisö n, eli oikeuksien antamisen toisille
ö
kä yttä jille tuli kulkea kutsutun kä yttä jä n oman
hyvä ksynnä n kautta.

Tapahtumakalenteri

Nä kymä tapahtumakalenterin etusivusta(web sisä ltö kuvakaruselli, luonti, asset
,
listaus)

Ominaisuudet: Tapahtumakalenteri
Tapahtumakalenteri on yhdistelmä erilaisia portletteja.

Tapahtumien kuvien esittä minen tapahtuu Javascript-karusellilla,
muuten tapahtumanostoihin kä ytettä ä n Liferayn Asset julkaisijaa.
http://www.innokyla.fi/web/guest/ajankohtaista

Varsinaisista tapahtumista muodostuu omia Liferay yhteisö . Tä mä
jä
on toteutettu Liferayn sivustopohjana, jossa on mä ä ritelty mistä
asetteluista, portleteista ja niiden asetuksista se koostuu.
•Ominaisuuksia:
• Ilmoittautumisen aktivointi
• Aktivointi kuvakaruselliin
• Yllä pitä jien mä ä rittä minen tapahtumalle
• Alisivujen luominen
• Kommentointi
• Kaikki nä mä tuotu kä ytettä vä ksi julkiselle puolelle


Hankepankki

Nä kymä hankkeen julkisesta sivusta (murupolku, toiminnot, sisä llö vä lilehdittä in)
t


Hankkeen luonti
• Joka hankkeelle luodaan oma yhteisö (Group)
• Hankkeen luoneelle käyttäjälle lisätään
oikeuksia (Permissions)
• Hankkeen yhteisön sivuston asettelu ja portletit
(Layout) tulevat sivustopohjalta (Site Template)

• Asettelu päivitettävissä startup action:lla (6.0 vs.
6.1)
• Hankkeen sisältö versioidaan tallennettaessa


Samankaltaiset hankkeet

Nä kymä samankaltaisten hankkeiden listauksesta luonnoksen tallentamisen jä lkeen


Samankaltaiset hankkeet
• Uutta hanketta luotaessa
• Sanasto käytettävissä oman sisällön
asiasanoitukseen
• Kategorisointi tulee valituista tageista
• Lisätään portaalin yhteiseen hakuindeksiin
• Luodaan AssetEntry portaalin listauksia varten

• Hankeluonnosta tallennettaessa
• Perustietojen täytön lisäksi valittuna asiasanoja
• Samankaltaisia hankkeita haetaan hakuindeksistä
• Hankkeiden tiivistelmiä näytetään


Käyttäjäprofiilisivu

Nä kymä kä yttä jä profiilista (alisivut, perustiedot, Asset-listauksia)


Ominaisuudet: Käyttäjäprofiili
• Jokaiselle kä yttä jä lle muodostuu
automaattisesti oma profiilisivu. Kä yttä jä voi
pä ivittä ä ja hallita oman profiilin tietoja julkisen
kä yttö liittymä n kautta.
• Profiilista löytyy:
• Kä yttä jä n oma palvelun sisä inen postilaatikko
• Kä yttä jä n asetukset (sä hköpostimuistutusten
vastaanotto, onko kutsuttavissa yhteisö ihin jne.)
• Profiiliin listataan yhteisö joihin kä yttä jä kuuluu,
t
tapahtumailmoittautumiset, suosikit ja kiinnostuksen
kohteet

• Nostot
• Vaatimuksena oli erilaisten nostojen lä hes vapaa tekeminen
mihin tahansa kohtaan palvelua.
• Ratkaisu
• Ongelma ratkaistiin Liferayn tarjoaman Asset Framework:n
avulla. Esim. jokaisesta julkaistusta hankkeesta luodaan
tallennuksen yhteydessä myö AssetEntry. Tä mä tallentuu
s
portaalin puolelle ja mahdollistaa rä ä tä löityjen portlettien
sisä llö esittä misen/listaamisen asset julkaisijan avulla.
n
• Muutamia esimerkkejä siitä mitä tä mä n avulla
mahdollistettiin:
• Tykkä ysten listaaminen
• Suosituimman sisä llö listaaminen
n
• Hankkeiden listaaminen erilaisten metatietojen perusteella
• Tapahtumien listaaminen erilaisten metatietojen perusteella


Asset Framework
Räätälöidyn portletin sisällön näyttäminen portaalissa

•Jokainen portlet-app “elää omassa galaksissaan”
•Asset Publisher elää itse portaalissa
•Portlet-app:n omien entiteettien näyttäminen ja
listaaminen (vain portlet-app)
•Portlet-app:n omien entiteettien “korvikkeiden”
näyttäminen ja listaaminen (myös portal)
• Tallennetuista AssetEntry:ista
•AssetEntry:jen tallentaminen mahdollistaa
AssetEntryQuery-kyselyiden käyttämisen


Anonyymit toiminnot
•Kommentointi (kirjautumatta)
•Kutsutoiminnallisuus (nimimerkin kutsuminen)

•Haastavia toteutettavia, kun pyrkimys käyttää
mahdollisimman paljon Liferayn mukana tulevia
portletteja ja tagi-kirjastoja
•Kyseessä portaali (kohdentaminen sivuun vs.
kohdentaminen sivulle nostettuun sisältöön)


Ominaisuudet: Kutsutoiminnallisuus
• Kutsutoiminnallisuus
• Palveluun on toteutettu toiminto, jonka avulla
kä yttä jä voidaan kutsua hankkeen kehittä jä ksi
tai yllä pitä jä ksi.

• Ominaisuudet:
• Sisä isen kutsun lä hettä minen, jolla kutsutaan
kä yttä jä kehittä jä ksi tai yllä pitä jä ksi yhteisö n
ö
• Kutsu voidaan hyvä ksyä tai hylä tä
• Kutsu kulkee palvelun sisä isen postin kautta
• Ennustava kä yttä jä n valinta kä yttä jä n nimimerkin
13.9.2012 mukaan www.ambientia.fi 21

Ominaisuudet: Kommentointi
Toteutettu rä ä tä löitynä portlettina
•Sivun kommentointi (kommentti kuuluu oikeasti jollekin
sivulle, tä tä voidaan ja hyödynnetä ä n muissa palvelun
osissa)
•Kommentit muodostavat puuhierarkian, kommentoi
kommenttia
•Kirjautunut kä yttä jä voi valita kommentoiko
nimimerkillä vai omalla nimellä ä n
•Vierailijoiden kommentointimahdollisuus
•IP-sulkulista
•Verkkopalvelun yllä pitä jä t voi muokata kaikkia
kommentteja, yhteisö yllä pitä jä voi muokata oman
n
yhteisö laajuudessa
n
•Kieltosanalista

Esteettömyys ja käytettävyys

•Korostetun yksinkertainen rakenne ja siirtymä t
•Huomioitu myö kontrasteja
s
•Toteutettu kustomoituja nä ppä intoimintoja ja esteettömyys
huomioitu mahdollisuuksien mukaan teemojen ja layouttien
teossa.


Ominaisuudet:
Laajat hakutoiminnallisuudet
Monipuoliset haun rajausmahdollisuudet eri
tietosisä ltö mukaan, lisä ksi piti pystyä
jen
nä yttä mä ä n tulokset (kuinka moneen vaihtoehtoon
rajaus vaikuttaa) etukä teen ennen kä yttä jä n oman
haun suorittamista.
Ratkaisu
Varsin haasteelliselta kuulostanut vaatimus ratkaistiin
suhteellisen yksinkertaisesti hyö dyntä mä llä Lucene-
hakumoottorin ominaisuuksia.
•Rä ä tä löidyistä portleteista tarjotaan entiteettien tiedot
tallennettavaksi portaalin yhteiseen hakuindeksiin.
•Hakutulosten suodattamiseen kä ytetä ä n Liferayn
kategorisointi-toiminnallisuutta.

Haku ja suodatukset

Nä kymä hakusivulta (suodattimet, haku, tulokset)


Haku, kategoriat ja tagit
• Käytettävissä olevat asiasanat parsittu
ontologiasta
• Tagit luokiteltu aihealueiden kategorioihin

• Hanketta ja tapahtumaa luotaessa käyttäjä
valitsee sille asiasanoja
• Haettaessa , käyttäjä voi suodattaa tuloksia
aihealueiden kategorioilla

• Lopputuloksena (adminien) muokattavissa
olevat hakusuodattimet


Haku ja suodatukset

Nä kymä aihealueiden hallinnasta (LR kategoriat)


Haku ja suodatukset

Nä kymä aihealueiden ja asiasanojen linkitysten hallinnasta (LR hallintapaneeli)


Haku ja suodatukset

Nä kymä Liferayn kategorioiden ominaisuuksista


Haasteita ja miten ne ratkaistiin:
Integroitavuus
Vaadittiin dokumentoitu (wsdl) rajapinta eri
hankelä hteiden integroimiseen palveluun. Hankkeiden
tuonnissa integraation kautta pitä ä , samoin kuin
kä yttöliittymä n kautta uusia luotaessa, luoda yhteisö
ja sivusto sekä antaa oikeuksia.

Ratkaisu

Toteutamme nykyä ä n omat portletit Liferayn Service
Builder -koodin generointityökalua hyödyntä en, jolloin
web servicet saadaan luotua helposti. Toteutustapana
on palvelukerroksen etä rajapinnan paljastaminen.


Haasteita ja miten ne ratkaistiin:
Yhdenaikaisten muokkausten hallinta
Palvelun tulee tarjota tieto siitä , mikä li toinen
kä yttä jä muokkaa samaa tietosisä ltö . ä

Ratkaisu
Tutkimisen jä lkeen lö ysimme Liferaysta
dokumentoimattoman poller-toiminnallisuuden. Tä mä
mahdollistaa hyvin monipuolisten tilantarkastelu-
toiminnallisuuksien toteuttaminen. Ominaisuuden
avulla toteuteltiin pollaus, jolla tarkastellaan
kä siteltä vä n aineiston tilaa ja varoitetaan
kä yttä jä ä mahdollisesta pä ä llekkä isestä
muokkauksesta.

Yhteenveto
• Mitä tehtiin hyvin
• Arkkitehtuuri (uudelleenkäytettävyys, kehysten valmiit
ominaisuudet)
• Käyttöoikeudet ja tietoturvan taso (haavoittuvuuksia
skannattu)
• Koodin laatu (kolmannen osapuolen audiotoima)

• Mitä tehtäisiin toisin
• Yksinkertaisempaa Asset Framework:n käyttöä
(suositaan enemmän AssetRenderer:ia)
• Ohitetaan Liferayn oman hakutoteutuksen rajoitukset
esim. suoralla SOLR hakumoottorin käytöllä
• Core+näytöt vs. ketjutetut portlet-app:t


Mitä tehtiin hyvin: Tietoturva


Mitä tehtiin hyvin:
Koodin laatu
Ohjelmakoodi auditoitiin kolmannen tahon toimesta
jokaisen sprintin pä ä tteeksi. Emme tiedä kuka
tä mä kolmasosapuoli oli, mutta koodimme
todettiin olevan parasta THL:lle ikinä toimitettua
ohjelmakoodia.


Henri Leisma

Puhelin: 0290 010 500
Sä hköposti: henri.leisma@ambientia.fi
Twitter: @ambientia

Liferay Road Show Helsinki, Case Innokylä, 2012-09-13

Recommandé

Recommandé

Contenu connexe

En vedette

En vedette (11)

Similaire à Liferay Road Show Helsinki, Case Innokylä, 2012-09-13

Similaire à Liferay Road Show Helsinki, Case Innokylä, 2012-09-13 (20)

Plus de Ambientia

Plus de Ambientia (20)

Liferay Road Show Helsinki, Case Innokylä, 2012-09-13

Notes de l'éditeur