Treenitietokannan toteutusdokumentti

Samankaltaiset tiedostot
Treenitietokannan suunnitteludokumentti

1. Kalenterin omistajan käyttöohje

TYÖNTEKIJÄN KÄYTTÖOHJEET - SOKU

RYHMIEN PERUSTAMINEN OODIIN

Pedanet oppilaan ohje Aleksanteri Kenan koulu Eija Arvola

Meeting Plannerin käyttöohje

Oulun kaupunki Liikuntapalvelut. Timmi -tilanvarauksen pikaopas internetasiakkaille

KiMeWebin käyttöohjeet

Kaksinkäsin.fi - ohjeet varaamiseen

Seutudokumenttien pä ivittä misohje

EVTEK-PROJEKTORI KÄYTTÖOHJE Tekijä: Teemu Tammivaara VBP04S

RYHMIEN PERUSTAMINEN JA OPINTOJEN ETENEMISRAPORTTI OODISSA

1 PIKAOHJE SELAA AIKOJA PALAUTE AJANVARAUS VARAUKSEN TARKASTELU VAHVISTA LÄHTÖÖN OSALLISTUMINEN...

UUDEN NETTIJÄSENREKISTERIN OHJEET. Kirjaudu sisään antamalla käyttäjätunnus ja salasana

Nettisivujen Päivitysohje

Fixcom Webmail ohje. Allekirjoitus. Voit lisätä yhden tai useamman allekirjoituksen.

Suvi Junes/Pauliina Munter Tietohallinto/Opetusteknologiapalvelut 2014

PROJEKTISIVUJEN PAÄ IVITTAÄ MISEN OHJEET

KÄYTTÖOHJE. Servia. S solutions

Nutri-Flow ravintotulkki ALOITUSOPAS

1. ASIAKKAAN OHJEET Varauksen tekeminen Käyttäjätunnuksen luominen Varauksen peruminen... 4

KYMP Webmail -palvelu

TIMMI-TILAVARAUSOHJELMISTO

Kilpailuhakemuksen luonti IRMA-järjestelmässä

Markkinointijakelun tilaaminen

Tik Tietojenkäsittelyopin ohjelmatyö Tietotekniikan osasto Teknillinen korkeakoulu KÄYTTÖOHJE. LiKe Liiketoiminnan kehityksen tukiprojekti

Päänäkymä Opiskelijan ohjeet Kurssin suorittaminen Opettajan ohjeet kurssin teko

Tallinohjaus & TIMERGPS

Uuden Peda.netin käyttöönotto

Käyttöohje Vianova Systems Finland Oy Lokakuu 2014

NETTISIVUJEN PÄIVITYS OHJEET versio 1.1

Onni-oppimispäiväkirjan ohje version 1.2

ASIO-OHJE HENKILÖSTÖLLE.

Aloittaminen. Tilojen ja ajan haku. Liikuntapalvelut Hietalahdenkatu Vaasa

Lukkarikoneen käyttöohje

Kirjautuminen Timmiin

Octo käyttöohje 1. Sisältö

ARVI-järjestelmän ohje arvioinnin syöttäjälle

Käyttöohje 1 (8) Kontakti Tiedonsiirto Käyttöohje. Posti Oy. Helsinki PL POSTI

Kemuun viedään ainoastaan kemikaalikohteiden (Seveso-laitos) ulkoiset pelastussuunnitelmat ja niiden harjoitukset.

ProTieto Oy. Verottajan ilmoitus. Käyttöohje alihankkijoille

opiskelijan ohje - kirjautuminen

KÄYTTÖOHJE / Ver 1.0 / Huhtikuu WordPress KÄYTTÖOHJE Sotkamo 2016

LeadDesk Soittajan käsikirja

Ohjelmisto on selainpohjaisen käyttöliittymän tarjoava tietokantajärjestelmä merikotkien seurantaan WWF:n Merikotka-työryhmän tarpeisiin.

Erotuomareiden ResultCode ohje: kirjautuminen, omat tiedot, esteet, ottelut, pöytäkirjat ja palkkiot

1. Mene elogger.net sivulle ja valitse yläreunasta Kirjaudu sisään

Office 365 OneDrive Opiskelijan ohje 2017

opiskelijan ohje - kirjautuminen

Kirjautuminen Timmiin

Pauliina Munter / Suvi Junes Tampereen yliopisto/tietohallinto 2013

KÄYTTÖOHJE LATOMO VERSO

Ohjeita Irman käyttöön. 1) Uuden käyttäjän luominen 2) Lisenssin lunastaminen 3) Kilpailuihin ilmoittautuminen 4) Viesteihin ilmoittautuminen

Action Request System

Ohjeita Irman käyttöön. 1) Uuden käyttäjän luominen 2) Lisenssin lunastaminen 3) Kilpailuihin ilmoittautuminen 4) Viesteihin ilmoittautuminen

Lukkarikone Pikaohjeet v. 1.0

Autokunto-ohjelmiston käyttöohjeet

Muutostietojen ilmoittaminen sähköisellä lomakkeella NAPliikkumispalvelukatalogissa

OSAAMISENHALLINTA OMAT TIEDOT. Peruskäyttäjän pikaohje

Webmailin käyttöohje. Ohjeen sisältö. Sähköpostin peruskäyttö. Lomavastaajan asettaminen sähköpostiin. Sähköpostin salasanan vaihtaminen

Omien tietojen päivittäminen, käytettävyyskalenteri ja keikkakalenteri

Ohjeita Omapalvelun käyttöön

Koulutuksen arviointijärjestelmä

Ohjeet ALS Online-palvelun käyttöön PÄIVITETTY

OHJE 1: Uudet oppilaat

Opintokohteiden muokkaus

Seutudokumenttien pä ivittä misohje

Hotline-jäsenpalvelun käyttöohjeet

Epooqin perusominaisuudet

SQL Buddy JAMK Labranet Wiki

KIRJAUTUMINEN JÄRJESTELMÄÄN ALOITUSSIVU. OMAT ASETUKSET Salasanan vaihto. VITANet KÄYTTÄJÄOPAS. Avaa VITANet osoitteessa

OHJEITA OMAPALVELUN KÄYTTÖÖN

Titta-palvelun käyttöohje

Käyttöohje. Versiohistoria: versio Mari Kommenttien perusteella korjattu versio

VAAKAPESÄSEURANNAN KÄYTTÖOHJEET

Sonera Viestintäpalvelu VIP VIP Laajennettu raportointi Ohje

Doodle helppoa aikatauluttamista

Asiointipalvelun ohje

VIENET JULKAISUJÄRJESTELMÄLLÄ TOTEUTETTUJEN INTERNET-SIVUJEN YLLÄPITO-OHJE

ARVI-järjestelmän ohje arvioinnin syöttäjälle

Webforum. Version 14.4 uudet ominaisuudet. Viimeisin päivitys:

Artikkelin lisääminen

OHJEITA OMAPALVELUN KÄYTTÖÖN

GOOGLE-SIVUSTOJEN KAÄ YTTOÄ OÄ NOTTO

Käyttöohje. Ticket Inspector. Versio 1.0. Sportum Oy

Aimo-ohjauspaneelin käyttöohje Sisällys

Lääkärin Terveyskansio Lähettävän lääkärin ohje

STS Uuden Tapahtuma-dokumentin teko

Tämän ohjeen avulla opastetaan käyttäjää aloittamaan PlanWebin käyttö. Lue ohjeet huolellisesti läpi ennen käytön aloittamista.

Kotkaliikkuu.fi. Ohjeita seuroile ja yhteisöille palvelun käytöstä

KÄYTTÖOHJE / Ver 1.0 / Huhtikuu Martat - KÄYTTÖOHJE Yhdistyksille 2017

OPAS KULTA2 -JÄRJESTELMÄN KÄYTTÖÖN

TimeEdit opiskelijan ohje TimeEdit-instructions for students from this link

OHJEITA OMAPALVELUN KÄYTTÖÖN

Uuden lukuvuoden aloitus ViLLEssa

Diacor Turku extranet

Tietokannan luominen:

Kun olet valmis tekemään tilauksen, rekisteröidy sovellukseen seuraavasti:

ORGANISAATION KIRJAUTUMINEN TURVASIRU.FI-PALVELUUN

Transkriptio:

Treenitietokannan toteutusdokumentti Johdanto Järjestelmän tarkoitus Järjestelmän tarkoituksena on luoda Yliopiston Taido Ry:n treenien vetäjille ja treeneissä kävijöille toimiva ympäristö, jossa vetäjät voivat helposti lisätä kuvauksia ja aiheita omille treeneille sekä tarvittaessa lisätä yleisiä tapahtumia (mm. leirejä, kilpailuja) tietyille päiville kalenteriin. Myös treenien muokkauksen tulee olla vaivatonta ja se tulee olemaan järjestelmän pääsääntöinen käyttötarkoitus, sillä ylläpidon tehtävänä on hoitaa geneeriset harjoitustiedot scriptin kautta tietokantaan puolen vuoden välein, kun uudet syksy-kevät- tai kesätreeniajat ovat tiedossa. Lisäksi tietojen pitää olla helposti luettavassa ja havainnollisessa muodossa esillä seuran sivuilla, jotta muut treeneissä kävijät näkevät mahdolliset aiheet, muutokset harjoitusajoissa sekä vuorojen peruutukset selkeästi ja nopeasti. Mahdollisista peruutuksista ja aikamuutoksista tiedotetaan myös seuran postituslistalla, mutta treenitietokannassa ne ovat pysyvästi esillä. Toimintaympäristö Järjestelmän toimintaympäristöksi tulee suomalaisen internetpalveluja tarjoavan Kapsi Internetkäyttäjät Ry:n Lakka-palvelin. Tietokanta sijoitetaan erilliselle Puolukka-palvelimelle, jolle on yhteys Lakka-palvelimelta. Rajaukset Tietokannasta tulee kurssin puitteissa kohtuu suppea, mutta tulevaisuudessa tarkoituksena on lisätä tietokantaan muutakin tietoa seuran toimintaan liittyen. Toteutusympäristö Järjestelmä toteutetaan Helsingin Yliopiston Tietojenkäsittelytieteen laitoksen Users-palvelimella ja siihen on mahdollista päästä tutustumaan osoitteessa: http://slinkola.users.cs.helsinki.fi/treenikalenteri.shtml

Ohjelmiston yleisrakenne

Järjestelmän komponentit Yleiskommentti En ole suunnitellut järjestelmää toimimaan joka sivulla täsmälleen samalla logiikalla. Tämä tulee esille varsinkin tietojen lähettämisessä.php-tiedostoille joiden on tarkoitus muokata tietokannan tietoja tai sivunäkymää. Osassa tapauksista lähetän tiedot normaalin formin avulla html:ssä. Toisissa käytän javascriptiä lähettämään tiedot php-tiedostolle ja vastausdatan avulla päivittämään jotakin sivun elementeistä ja osassa tapauksista lähetän ne ajaxin avulla tiedoston käsiteltäviksi enkä odota mitään vastausta käsittelyn tuottamasta datasta. Olen toiminut näin, koska olen ottanut oman oppimiseni pääkohdaksi ja vaikka osaltaan toimintalogiikan seuraaminen voi olla vaikeaa tämän takia (ja arvostelun kannalta pisteitä vähentävää), niin itse olen kokenut oppivani tästä paljon enemmäin, kuin siitä, että olisin tehnyt kaikki toiminnot orjallisesti samalla tavalla. Tämä ei välttämättä tule vielä esiin tässä osassa dokumenttia niin hyvin, kuin se tulee ohjelmakoodiosassa, mutta minusta on hyvä sanoa asiasta jo nyt, sillä osa UI-sivujen ja PHP-scriptien toiminnasta saattaa vaikuttaa hämärältä (ja se voi ollakin sitä) tämän takia. UI:n sivut Kaikki tietokannan sivut ovat alinäkyminä tietokanta.php:ssa (Tietokannan päävalikko ja sen alinäkymät). Siis tietokanta.php ja tk_valikko.php näkyvät tietokannan käyttäjälle aina ja näin ollen mistä tahansa tietokannan toiminnosta pääsee mihin tahansa muuhun tietokannan toimintoon valikon linkkejä painamalla. Ainoastaan 'Aloitussivu' ja 'Kirjautumissivu' eivät ole ole osa tätä kokonaisuutta.. Aloitussivu Generoitu sivu, tiedosto: treenikalenteri.shtml (sekä treenikalenteri.php ja hae_ja_nayta_harjoitukset.php, jotka näkyvät treenikalenteri.shtml:n #tk_kalenterinakyma div:ssä) Sivulla on aluksi näkymä kuluvan kuun ja seuraavan kuun sekä värillisten että kurssin treeneihin. 'Hae harjoitukset' -linkillä voidaan generoida muiden kuukausien tai pelkästään kurssin tai värillisten kalenterinäkymät. Kalenterinäkymässä ovat myös mahdolliset muut ajanjaksolle sijoittuvat tapahtumat. Sivulla on lisäksi lyhyt kuvaus treenikalenterista ja linkillä 'treenikalenterin lukuohje' tulee näkyviin lyhyt selitys eri kalenterikenttien merkityksistä. Linkillä 'tietokantaan' pääsee itse tietokannan sisäänkirjautumissivulle (kirjaudu.html). Kirjautumissivu Staattinen sivu. Sivulla on lomake, jossa kenttinä 'tunnus' ja 'salasana'. Kirjaudu-linkillä lomakkeen tiedot lähetetään sisaan.php:n käsiteltäviksi. Tietokannan päävalikko ja sen alinäkymät. Generoitu sivu, tiedosto: tietokanta.php (sivu on staattinen kun mitään tietokannan muokkaustoimintoa ei ole valittu, mutta päivittyy muokkaustoimenpiteen mukaan joko staattiseksi

tai generoiduksi sivuksi. Päävalikko tietokannan eri toiminnoille. Toimintojen lomakkeet ja näkymät tulevat näkyviin tälle sivulle 'tk_nakymat' div:iin (visuaalisesti heti staattisen valikon alle) Sivulla pääelementin ylälaidassa linkit 'takaisin tietokantaan' sekä 'näytä lisäominaisuudet'. Linkit toimintoihin ovat (niiden toiminnallisuus on listattu alla ko. toiminnallisuudelle nimetyllä sivulla): 'Lisää / muokkaa tapahtumia', 'Lisää harjoitus' ja 'Muokkaa harjoitusta' Sivun näkymä ja rakenne: ks. liite i Tietokannan päävalikko ja lisäominaisuudet Generoitu sivu, tiedosto tietokanta.php + linkin 'näytä lisäominaisuudet' painallus (sivu on generoitu samasta syystä kuin yllä.) Muuten sama sivu kuin päävalikko, mutta lisää toiminnallisuuksia tietokannan muokkausta varten. Tarkoitettu lähinnä ylläpidolle, mutta pienen ja luotettavan käyttäjäkunnan takia sivu on avoin kaikille kirjautuneille käyttäjille. Lisäksi ylläpidon ollessa tavoittamattomissa voi joku muu tehdä tarvittavat toimenpiteet. Lisätoiminnot ovat (niiden toiminnallisuus on listattu alla ko. toiminnallisuudelle nimetyllä sivulla): 'Aseta vetäjä aktiiviseksi', 'Aseta vetäjä epäaktiiviseksi', 'Lisää vetäjä', 'Poista vetäjä', 'Poista harjoitus', 'Lisää kausiharjoitusaika' Sivun näkymä ja rakenne: ks. liite ii Lisää / Muokkaa tapahtumia Generoitu sivu, tiedostot: etsitapahtuma.html ja naytatapahtuma.php Ensimmäinen näkymä sivulla on staattinen. Näkymässä on pelkästään lomake, johon täytetään päivämäärä. Tämän jälkeen sivu generoi tekstikentän, johon ilmestyy päivän tapahtumien kuvailu, jos ko. päivälle on jo tapahtumia. Jos ei, niin tekstikenttään tulee 'lisää tapahtuma'-teksti. Lisää / muokkaa-linkki lähettää lomakkeen, jossa kentät 'pvm' ja 'huom' php-tiedostolle 'lisaatapahtuma.php'. Sivun näkymä ja rakenne: ks. liite iii Lisää harjoitus Generoitu sivu, tiedostot: anna_h_pvm.html ja haeharjoitustiedot.php Ensimmäinen näkymä on staattinen (anna_h_pvm.html). Näkymässä on pelkästään lomake, johon täytetään päivämäärä. Tämän jälkeen sivu generoi harjoituksen lisäyslomakkeen (haeharjoitukset.php). Päivämäärää tarvitaan hakemaan tietokannasta sille päivälle merkityt normaalit harjoitusajat. Molemmat lomakkeet ovat näkyvissä samaan aikana, joten päivämäärän voi asettaa uudestaan niin halutessaan. Lomakkeessa on kentät 'pvm', 'viikonpva', 'aika', 'alku', 'loppu', 'kurssi', 'vetaja', 'tagit[]', 'aihe'. Ne lähetetään php-tiedostolle 'tallenna_h_db.php'. Sivun näkymä ja rakenne: ks. liite iv

Muokkaa harjoitusta 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY Generoitu sivu, tiedostot: muokkaaharjoitusta.php, muokattavat.php sekä muokkaa.php Sivu muodostuu kolmesta osasta. Ylimpänä on muokkaaharjoitusta.php, jossa on vuoden ja kuukauden sisältävät valikot ja 'hae harjoitukset'-linkki, jonka avulla voidaan hakea muiden ajankohtien harjoituksia. Sivu hakee aluksi kuluvan kuukauden harjoitukset. Toisessa osassa ovat haetut harjoitukset (muokattavat.php), joista näkyvät jokaisen harjoitukset perustiedot: pvm, vetäjä, tagit, aihe ja onko harjoitus kurssin vai ei. Listan vasemmalla puolella jokaisella harjoituksella on valitsin, jota painamalla harjoituksen kaikki tiedot ilmestyvät alalaitaan. Sivun alalaidassa ovat kaikki valitun harjoituksen tiedot lomakkeena (muokkaa.php). Lomakkeen kenttiä ovat: 'harjoitusid', 'pvm', 'vetaja', 'alku', 'loppu', 'kurssi', 'tagit[]', sekä 'aihe'. Lomakkeen tiedot lähetetään 'Tallenna muutokset'-linkillä tallenna_m_db.php:lle käsiteltäviksi. Sivun näkymä ja rakenne: ks. liite v Aseta vetäjä aktiiviseksi / epäaktiiviseksi Generoidut sivut, tiedostot: aktivoivetaja.php tai deaktivoivetaja.php Kummallakin sivulla on näkymä vetolaatikko-valikkoon, jossa näkyvät joko aktiiviset tai epäaktiiviset vetäjät (aktivoivetaja.php:ssä epäaktiiviset ja päinvastoin). Lisäksi näkyvillä linkki 'OK'. Linkkiä painaessa lähetetään lomake, jossa kenttinä 'akti' ja 'henkiloid' muuta_vetajan_aktiivisuus.php:lle käsiteltäväksi. Jos kyseessä aktivoivetaja.php, niin akti = kyllä, ja jos deaktivoivetaja.php niin akti = ei. Lisää vetäjä Staattinen sivu, tiedosto: lisaavetaja.html Sivulla näkyvissä tekstikenttä ja linkki 'Uusi vetäjä'. Linkkiä painettaessa lähetetään tekstikentän teksti (siis vetäjän nimi) lomakkeena lisaavetaja.php:lle käsiteltäväksi. Poista vetäjä Generoitu sivu, tiedosto: poistavetaja.php Sivulla vetolaatikko-valikko, jossa kaikki vetäjät, jotka löytyvät tietokannasta. 'OK'-linkkiä painettaessa lähetetään tieto valitun vetäjän henkiloid:stä poista_vetaja_tietokannasta.php:lle, joka käsittelee yrityksen poistaa vetäjä. Tämä ei tule onnistumaan, jos vetäjällä on yhtään harjoitusta tk_harjoitukset-taulussa tietokannassa. Poista harjoitus Generoitu sivu, tiedostot: poistaharjoitus.php, poistettavat.php Sivu on muuten samanlainen kuin 'Muokkaa harjoitusta'-sivu, mutta alalaitaan ei tule lomaketta harjoituksen muokkaamista varten vaan vain 'Poista' -linkki. Linkkiä painettaessa lähetetään tieto valittuna olleen harjoituksen harjoitusid:stä poista_harjoitus_tietokannasta.php:lle käsiteltäväksi. Lisää kausiharjoitusaika Staattinen sivu, tiedosto: lisaakausih_aika.html Sivulla on näkyvissä lomake, jossa kentät: 'alku_pvm', 'loppu_pvm', 'viikonpva', 'alku_aika',

'loppu_aika' sekä 'taytakalenteriin'. 'Lisää harjoitusaika'-linkistä lomake lähetetään 'lisaa_kausih_aika.php':lle käsiteltäksi. PHP-ohjelmat treenikalenteri.php Ohjelma suoritetaan samalla kun treenikalenteri.shtml ladataan. Luo vetolaatikko-valikot vuodelle, kuukaudelle ja harjoitustyypin (kurssi, värilliset tai kaikki) valinnalle. Klikkaamalla 'Hae harjoitukset'-linkkiä näyttää valitun ajanjakson halutut harjoitukset #harjoituskalenteri div:ssä lähettämällä tiedot valinnoista hae_ja_nayta_harjoitukset.php:lle näkymän generoimiseksi. sisaan.php Ohjelma suoritetaan kirjaudu.html:n 'Kirjaudu' -linkin painalluksella. Tietojen vastaanottotyyppi: POST Parametrit: string: tunnus, salasana Ohjelma validoi tunnuksen ja salasanan oman arraynsa perusteella. hae_ja_nayta_harjoitukset.php Ohjelma suoritetaan treenikalenteri.php:n 'Hae harjoitukset'-linkin painalluksella. Parametrit: int: kk, vuosi, kurssi ja vari (kurssi ja vari sallitut arvot 1 tai 0) Luo varsinaisen kalenterinäkymän treenikalenteri.php:n #harjoituskalenteri div:iin. Hakee halutun ajanjakson halutut harjoitustyypit tietokannasta. (Käyttää tietokantaan määriteltyä rinnakkainviewiä.) Lisäksi hakee ko. ajankohdalle sijoittuvat tapahtumat tk_tapahtumat taulusta ja luo näistä dynaamisen kalenteri näkymän taulukkona. Tapahtumat, joille on samana päivänä harjoituksia liitetään näkymään harjoitusten jälkeen, kun taas tapahtumat, joilla ei ole samana päivänä harjoituksia sijoitetaan omalle rivilleen. naytatapahtuma.php Ohjelma suoritetaan lisaatapahtuma.html:n 'Valitse päivä'-linkin painalluksella. Parametrit: string: pvm (käsitellään päivämääränä) Etsii tk_tapahtumat-taulusta annetulla päivämäärällä tapahtumaa. Jos tapahtuma löytyy, niin päivittää tiedot omaan tekstikenttäänsä. Jos ei löydy niin päivittää tekstikenttään 'Lisää tapahtuma'.

lisaatapahtuma.php 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY Ohjelma suoritetaan naytatapahtuma.php:n 'Lisää / muokkaa'-linkin painalluksella. Tietojen vastaanottotyyppi: POST Parametrit: string: pvm (käsitellään päivämääränä), huom Ottaa vastaan 'pvm' ja 'huom' lomakkeen, jonka tiedot päivittää tk_tapahtumat-tauluun, jos 'huom' ei ole NULL. Päivittämisessä tapahtumalle asetetaan loppu- ja alkuajat, jotka ovat Timestamp muotoa. Ne asetetaan 'pvm' mukaiselle päivälle ajoiksi 00:00:00 ja 23:59:59. Jos 'huom' on NULL, niin kyseiseltä päivältä poistetaan merkintä tk_tapahtumat-taulusta, jos sellainen oli. lisaaharjoitus.php Ohjelma suoritetaan anna_h_pvm.html:n 'OK'-linkin painalluksella. Parametrit: string: pvm (käsitellään päivämääränä) Vastaanottaa lomakkeen, jossa tieto harjoituspäivämäärästä. Hakee tk_harjoitusajat taulusta vastaavalle päivälle osuvat kausiharjoitusajat. Jos niitä on lisää ne harjoitustietojen täyttölomakkeeseen vetolaatikko-valintaan, muuten generoi staattisen harjoitustietojen täyttölomakkeen. tallenna_h_db.php Ohjelma suoritetaan lisaaharjoitus.php:n 'Lisää harjoitus'-linkin painalluksella. Tietojen vastaanottotyyppi: POST Parametrit: string: pvm (käsitellään päivämääränä), aika ('poikkeus' tai alkuajankohta, jota käsitellään time-tyyppinä), alku ja loppu (käsitellään time-tyyppeinä jos aika = 'poikkeus', muutoin ei käsittelyä), vetaja, aihe int: kurssi array: tagit Vastaanottaa lomakkeen, jossa uuden harjoituksen tiedot. Lisää harjoituksen tietoineen tk_harjoitukset-tauluun ja jos lomakkeen 'aihe'-kenttä ei ole NULL, niin lisää tauluun tk_harjoitusaiheet kentässä olleen tekstikuvailun ja 'harjoitusid'-kentän numerosarjan. Lisäksi jos lomakkeen 'tagit'-matriisi ei ole tyhjä, niin lisää jokaisen 'tagit'-kentän numeroarvon ja 'harjoitusid'- kentän arvon tk_harjoitustagit-liitostauluun. muokkaaharjoitusta.php Ohjelma suoritetaan tk_valikko.php:n 'Muokkaa harjoitusta'-linkin painalluksella. Generoi vetolaatikkovalikot vuodelle ja kuukaudelle. 'Hae harjoitukset'-linkistä lähettää tiedon vuodesta ja kuukaudesta muokattavat.php:lle ja päivittää vastaanottamillaan tiedoilla oman #naytamuokattavat div:n.

muokattavat.php 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY Ohjelma suoritetaan, kun muokkaaharjoitusta.php:tä ladataan sekä kun ko. ohjelman 'Hae harjoitukset'-linkkiä painetaan. Parametrit: int: kk, vuosi Saa tietona vuoden ja kuukauden ja hakee kaikki sille kuukaudelle sijoittuvat harjoitukset tk_harjoitukset-taulusta. Tekee taulukon, jossa lisää jokaisen harjoituksen geneeriset tiedot omalle rivilleen ja lisää riville myös tk_harjoitustagit- ja tk_harjoitusaiheet-taulujen harjoitusid:llä indentifioidut rivit. Jokaisen harjoitusrivin eteen lisätään myös radiobutton jonka valitsemalla päivitetään muokkaa.php asianomaiselle riville sijoittuvan harjoituksen tarkoilla tiedoilla. muokkaa.php Ohjelma suoritetaan kun muokattavat.php:n generoimasta taulukosta valitaan jokin harjoitus. Parametrit: int: harjoitusid Saa tietona harjoitusid:n, jonka identifioiman harjoituksen tiedoilla täyttää generoimansa harjoitustietojen muutoslomakkeen valmiiksi. tallenna_m_db.php Ohjelma suoritetaan tallenna_m_db.php:n 'Tallenna muutokset'-linkin painalluksella. Tietojen vastaanottotyyppi: POST Parametrit: string: pvm (käsitellään päivämääränä), alku ja loppu (käsitellään time-tyyppeinä), vetaja, aihe int: kurssi, harjoitusid array: tagit Vastaanottaa lomakkeen, jossa muokattavan harjoituksen tiedot. Päivittää harjoituksen tiedot tk_harjoitukset-tauluun lomakkeen tiedoilla. Sen jälkeen poistaa vanhan aiheen tk_harjoitusaiheettaulusta harjoitusid:llä identifioiden ja lisää mahdollisen uuden aiheen (jos lomakkeen 'aihe'-kenttä trimmattuna 'whitespace'-charactereista ei ole NULL) ja jos lomakkeen 'tagit'-kenttä ei ole NULL niin lisää kaikki kentässä olleet arvot niputettuna harjoitusid:n kanssa tk_harjoitustagitliitostauluun. aktivoivetaja.php ja deaktivoivetaja.php Ohjelmat suoritetaan tk_valikko.php:n 'Aseta vetäjä aktiiviseksi' tai 'Aseta vetäjä epäaktiiviseksi' linkkien painalluksilla. Luo vetolaatikko-valikon joko epäaktiivisista (aktivoivetaja.php) tai aktiivisista (deaktivoivetaja.php) vetäjistä. 'OK'-linkin painalluksella lähettää tiedon eteenpäin muuta_vetajan_aktiivisuus.php:n käsiteltäväksi tiedon vetäjän henkiloid:stä sekä aktiivisuuden

muutoksesta. 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY muuta_vetajan_aktiivisuus.php Ohjelma suoritetaan aktivoivetaja.php:n tai deaktivoivetaja.php:n 'OK'-linkin painalluksella. Parametrit: string: akti ('kyllä' tai 'ei') int: vetaja (henkiloid) Ottaa vastaan tiedon vetajan identiteetistä sekä siitä mihin aktiivisuus pitää muuttaa; vaihtoehtoina 'kyllä' ja 'ei'. Muokkaa tk_vetajat taulua muokkaamalla aktiivisuus-sarakkeen arvon vastaavan henkiloid-rivin kohdalta uutta aktiivisuutta vastaavaksi. lisaavetaja.php Ohjelma suoritetaan lisaavetaja.html:n 'Uusi vetäjä'-linkin painalluksella. Tietojen vastaanottotyyppi: POST Parametrit: string: nimi Vastaanottaa uuden vetäjän nimen ja lisää sen tk_vetäjät tauluun. poistavetaja.php Ohjelma suoritetaan tk_valikko.php:n 'Poista vetäjä' -linkin painalluksella. Luo vetolaatikko-valikon kaikista vetäjistä. 'OK'-linkin painalluksella lähettää tiedon vetäjän henkiloid:stä poista_vetaja_tietokannasta.php:lle poista_vetaja_tietokannasta.php Ohjelma suoritetaan poistavetaja.php:n 'OK' -linkin painalluksella. Parametrit: int: vetaja (henkiloid) Saa tiedon vetäjän henkiloid:stä. Yrittää poistaa ko. henkiloid:tä vastaavan rivin tk_vetajat-taulusta. Riviä ei poisteta jos vetäjään on vielä referenssejä muualla (tk_harjoitukset-taulussa). poistaharjoitus.php Ohjelma suoritetaan tk_valikko.php:n 'Poista harjoitus' -linkin painalluksella. Toimii kuten muokkaaharjoitusta.php. Ainoastaan lähettää tiedot poistettavat.php:lle ja päivittää oman 'naytapoistettavat' div:n.

poistettavat.php 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY Ohjelma suoritetaan poistaharjoitus.php:tä ladattaessa sekä kun ko. ohjelman generoimassa näkymässä valitaan jokin harjoitus. Parametrit: int: kk, vuosi Toimii kuten muokattavat.php lukuunottamatta sitä, että ei päivitä valitun harjoituksen tietojan mihinkään, vaan sisältää vain linkin 'Poista', jota painamalla valitun harjoituksen harjoitusid lähetetään poista_harjoitus_tietokannasta.php:lle käsiteltäväksi. poista_harjoitus_tietokannasta.php Ohjelma suoritetaan poistettavat.php:n 'Poista'-linkin painalluksella. Parametrit: int: harjoitusid Poistaa tk_harjoitustagit- ja tk_harjoitusaiheet-tauluista rivit joilla esiintyy harjoitusid ja sen jälkeen poistaa tk_harjoitukset-taulusta harjoituksen, jonka harjoitusid on sama. lisaa_kausih_aika.php Ohjelma suoritetaan lisaakausih_aika.html:n 'Lisää kausiharjoitusaika' -linkin painalluksella. Parametrit: string: alku_pvm ja loppu_pvm (käsitellään timestamp-tyyppeinä), kurssitreeni ( = kurssi tai NULL), taytakalenteriin ( = tayta tai NULL) int: viikonpva Vastaanottaa tiedot uudesta kausiharjoitusajasta ja tallentaa ne tk_harjoitusajat-tauluun. Jos taytakalenteriin = 'tayta' niin täyttää kyseisen harjoitusajan kaikki ilmentymät valmiiksi tk_harjoitukset-tauluun asettaen kurssi = 0 sekä henkiloid:ksi sen vetäjän, jonka nimi on 'vapaa'. Jos kurssitreeni = 'kurssi', niin lisätään tk_harjoitukset tauluun vielä edellisten lisäksi samat tiedot, mutta niin, että kurssi = 1.

Asennustiedot 12.12.2010 / Simo Linkola / toteutusdokumentti / Tietokantasovellus S2010 / TKTL / HY hae_ja_nayta_harjoitukset.php treenikalenteri.shtml tk_info_finished.png tk_kalenterinakyma.php tk_lukuohje.html // lukuohjeen havainnostava kuva. /tk_db kirjaudu.html sisaan.php tietokanta.php tk_valikko.php /lisaa_harjoitus anna_h_pvm.php lisaaharjoitus.php tallenna_h_db.php /lisaa_kausiharjoitusaika lisaa_kausih_aika.php lisaakausih_aika.html /lisaa_tapahtuma etsitapahtuma.html lisaatapahtuma.php naytatapahtuma.php /lisaa_vetaja lisaavetaja.html lisaavetaja.php /muokkaa_harjoitusta muokattavat.php muokkaa.php

muokkaaharjoitusta.php opaste_harjoitusten_muokkaus.html tallenna_m_db.php /poista_harjoitus poistaharjoitus.php poista_harjoitus_tietokannasta.php poistettavat.php /poista_vetaja poistavetaja.php poista_vetaja_tietokannasta.php /vetajan_aktiivisuus aktivoivetaja.php deaktivoivetaja.php muuta_vetajan_aktiivisuus.php

Käynnistys- ja käyttöohje http://slinkola.users.cs.helsinki.fi/treenikalenteri.shtml Varsinaiseen tietokantaan pääsee 'Vetäjät: Ilmoittakaa muutoksista suoraan tietokantaan!' - linkistä. Tunnus: Harri Salasana: Laine

Liite i: tietokannan valikon näkymä

Liite ii: tietokannan lisävalikon näkymä

Liite iii: Lisää / muokkaa tapahtumia näkymä

Liite iv: Lisää harjoitus näkymä

Liite v: Muokkaa harjoitusta näkymä