Timber-sovellusprojekti,

Velppikokoelman hallinta ja haku

Ismo Huhtiniemi
Paavo Itkonen
Joonas Lattu
Petteri Palojärvi
Seppo Tarvainen

Jyväskylän yliopisto
Tietotekniikan laitos
Jyväskylä

Velpattava testitiedosto löytyy kansiosta: ([root]/)kurssit/tie/ohj2/demot/demo1

Velppikokoelmia hakiessa haetaan puurakenteesta velppikokoelmia seuraavalla tapaa. Perässä olevat numerot viittaavat tässä vain velppikokoelmien määriin luettavuuden selkeyttämiseksi.

velp groups:
       tosi yleinen kokoelma 1
       tosi yleinen kokoelma 2

kurssit/velp groups:
       yleinen kokoelma 3

kurssit/tie/velp groups:
       tietotekniikan yleiset 4
       tietotekniikan yleiset 5

kurssit/tie/ohj2/velp groups:
       ohj2 yleiset 6
       ohj2 yleiset 7

kurssit/tie/ohj2/demot/velp groups:
       ohj2 demot yleiset 8

kurssit/tie/ohj2/demot/velp groups/demo1:
       demo 1 yleiset 9
       demo 1 yleiset 10
       demo 1 yleiset 11
       demo 1 yleiset 12

kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht1:
       teht 1 erikoiset 13
       teht 1 erikoiset 14

kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht2:
       teht 2 erikoiset 15

(oikeasti luku tapahtuu ylöspäin eli tehtävät ensin, root kansio viimeisenä)

users/mattimeikäläinen/velp groups:
       oma group 16
       oma group 17

Lisäksi tulee muualta importatut [hakasulkeissa käyttäjäryhmä kelle importattu]:

kurssit/biologia/purokalat/velpgroups:
    kaloja 18 [mattimeikäläinen]

kurssit/ruotsi/velp groups:
    kielioppivirheet 19 [ryhmä meikäläiset]

Lisäksi tulee importatut

Puurakenteessa kuhunkin näytettävään velppikokoelmaan tulee olla view-oikeus, jotta niitä voidaan käyttää. Esimerkiksi ylemmässä esimerkissä kansiossa kurssit/tie/ohj2/demot/velp groups olisi voinut olla useampikin kokoelma, mutta Matti näkee vain "ohj demot yleiset 8", koska se on ainut johon hänellä on view-oikeus (tai vahvempi).

Kokoelmien muualta importtaamista varten importtaajalla pitää olla manage-oikeus kyseiseen dokumenttiin/kokoelmaan. Jos käyttäjä importtaa kokoelman isommalle ryhmälle kuin vain itselleen, voivat muut ryhmän jäsenet hyödyntää kokoelmaa view-oikeuksien mukaisesti, vaikka heillä ei mitään oikeuksia dokumenttiin muuten olisikaan. Editointioikeuksia tai muita vahvempia oikeuksia he eivät saa. Sitä varten pitää antaa haluttu oikeus suoraan itse dokumenttiin / velppikokoelmaan.

Yllä olevassa esimerkissä "kaloja 18" kokoelma on importattu mattimeikäläiselle. Kellään muulla kuin Matilla itsellään ei ole oikeutta kyseiseen ryhmään, joten Matilla on oltava manage-oikeudet kyseiseen kokoelmaan. Sen sijaan "kielioppivirheet 19" on jaettu ryhmälle meikäläiset, johon Matti kuuluu. Koko ryhmällä tai Matilla ei välttämättä ole mitään oikeuksia kokoelmaan. Riittää, että jollakin ryhmän jäsenistä on kyseiseen dokumenttiin / kokoelmaan manage-oikeus, jonka avulla hän on saanut jaettua sen muun ryhmän käytettäväksi.

Käyttäjä voi raksia minkä velppikokoelmien vepit hän haluaa kulloinkin nähdä. Raksit ovat henkilökohtaisia eikä niitä voi jakaa muiden kanssa, jotta käyttöliittymä saadaan pidettyä yksinkertaisempana.

Kantaan pitää tallentaa tieto siitä mitä ryhmiä on ruksittu jotta seuraavan kerran samassa paikassa näkyy samalla tavalla

Eli kantaan tallentuu em esimerkistä (oletetaan että Matin id on 777, ja docid = 6354 sekä tuota koskevan paragraphin id 2364555, type=0 = doc, 1 = paragraph, 2=area

userid | docid | type | objectid | selected | velpgroup 
--------------------------------------------------------------------------------------------------------------
777    | 6354  |   1  | 2364555  |   true   | velp groups/tosi yleinen kokoelma 1
777    | 6354  |   1  | 2364555  |   true   | velp groups/tosi yleinen kokoelma 2
777    | 6354  |   1  | 2364555  |   true   | kurssit/velp groups/yleinen kokoelma 3
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/velp groups/tietotekniikan yleiset 4
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/velp groupstietotekniikan yleiset 5
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/velp groups/ohj2 yleiset 6
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/velp groups/ohj2 yleiset 7
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/velp groups/ohj2 demot yleiset 8
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 9
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 10
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 11
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 12
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht1/teht 1 erikoiset 13
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht1/teht 1 erikoiset 14
777    | 6354  |   1  | 2364555  |   true   | kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht2/teht 2 erikoiset 15\
777    | 6354  |   1  | 2364555  |   false  | users/mattimeikäläinen/velp groups/oma group 16
777    | 6354  |   1  | 2364555  |   true   | users/mattimeikäläinen/velp groups/oma group 17

Manage velp välilehdellä näkyy em seuraavasti, hakemiston nimi tosin tooltippinä ja tiedoston nimi ruksin vieressä. Oletuksena on ruksittu ne automaattisesti kerätyt

[x] velp groups/tosi yleinen kokoelma 1
[x] velp groups/tosi yleinen kokoelma 2
[x] kurssit/velp groups/a kokoelma 3
[x] kurssit/tie/velp groups/tietotekniikan yleiset 4
[x] kurssit/tie/velp groupstietotekniikan yleiset 5
[x] kurssit/tie/ohj2/velp groups/ohj2 yleiset 6
[x] kurssit/tie/ohj2/velp groups/ohj2 yleiset 7
[x] kurssit/tie/ohj2/demot/velp groups/ohj2 demot yleiset 8
[x] kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 9
[x] kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 10
[x] kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 11
[x] kurssit/tie/ohj2/demot/velp groups/demo1/demo 1 yleiset 12
[x] kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht1/teht 1 erikoiset 13
[x] kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht1/teht 1 erikoiset 14
[x] kurssit/tie/ohj2/demot/demo1/velp groups/demo1/teht2/teht 2 erikoiset 15\
[ ] users/mattimeikäläinen/velp groups/oma group 16
[x] users/mattimeikäläinen/velp groups/oma group 17