Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 1 (7) Xerdacom Calendar 3.0 KatrinaXML-moottori Opas seurakuntien Katrinakäyttäjille Suomi EI VALMIS JULKAISTAVAKSI!
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 2 (7) Alkusanat Seurakuntanne on tehnyt hienon valinnan valitessaan suomalaisen Xerdacom Calendar 3.0:n verkkosivujensa kalenteriratkaisukseen. Tämä ohjekirja on tarkoitettu Katrinaan verkossa julkaistavia tapahtumia lisäävälle tai niitä ylläpitävälle henkilölle, sekä verkkotiedotuksesta vastaavalle henkilölle. Tässä oppaassa ei käsitellä XCal3:n tai KatrinaXML:n ylläpitoa. Lisätietoa näistä asioista on asiakirjassa Xerdacom Calendar 3.0 Ylläpitäjän opas Suomi. Lisätietoa Katrinan varausten hallinnasta saat Katrinan käyttöoppaasta. Tekijänoikeudet 2011, Riku Eskelinen/ Xerdacom Solutions. Tämä opas on osa Xerdacom Calendar 3.0:n dokumentaatiota, ja on lisensoitu samalla lisenssillä kuin sen ohjelmisto. Lisätietoja lisenssistä saat ohjelmiston asentaneelta taholta (esim. verkonvalvoja). Huomaa, että Katrinan kehittänyt M&V Software ei ole osallistunut Xerdacom Calendar 3.0:n tai KatrinaXMLmoottorin tekoon. Mahdollisissa ongelmatapauksissa käänny ensisijaisesti verkkosivujenne ylläpitäjän puoleen. Sisällysluettelo Alkusanat...2 Tekijänoikeudet...2 Ennen aloittamista...3 Kuvaus KatrinaXML:n ja XCal3:n toiminnasta...3 Varoituksia...3 Tapahtuman luonti...4 Tapahtuman hyväksyminen Katrinassa...5 Extramark-lisätiedot...6 Käyttö...6 Osallistujan lisääminen...6 Paikan lisääminen...6 Tapahtuman piilottaminen...7
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 3 (7) Ennen aloittamista Ennen kuin voit aloittaa verkkosivulla julkaistavien tapahtumien lisäyksen Katrinaan, varmista verkkosivujen ylläpitäjältä seuraavat asiat: Onko Katrinan www-moduuli tilattu ja otettu käyttöön? Onko Xerdacom Calendar 3.0 asennettu ja määritelty? Jos on, mihin osoitteeseen? Onko KatrinaXML-moduuli otettu käyttöön ja määritelty seurakuntanne asetusten mukaisesti? Käyttääkö KatrinaXML XCal3-KatrinaXML Extramark -lisätietoja? KatrinaXML vaatii toimiakseen Katrinan www-moduulin ja tunnukset siihen. Ylläpitäjä asentaa KatrinaXML:n M&V Softwaren saamiensa tietojen mukaan. Ylläpitäjän asennusohjeet löytyvät asiakirjasta Xerdacom Calendar 3.0 Ylläpitäjän opas Suomi. XCal3:n, ja sen KatrinaXML-moottorin tulee olla asennettuna ja määriteltynä ennen kuin voit lisätä tapahtumia verkkosivuille julkaistavaksi. Extramark-toiminto on vapaaehtoinen, mutta sen käyttöä suositellaan. Lisätietoja Extramark-lisätietojen lisäyksestä tapahtumiin löytyy tämän asiakirjan luvusta Extramark-lisätiedot. Kuvaus KatrinaXML:n ja XCal3:n toiminnasta Katrina on seurakuntanne ajanvarausjärjestelmä. Katrinan www-moduuli on Katrinaan erikseen tilattava toiminto, jonka avulla tapahtumalistaus voidaan viedä Internetiin. Xerdacom Calendar 3 (XCal3) on verkkosivujenne kalenteriohjelmisto ja KatrinaXML sen tapahtumamoottori. Oheinen kuvaaja esittää KatrinaXML:n toimintaa osana laajempaa kokonaisuutta: Katrinan ajanvaraus Katrinan www-moduuli KatrinaXMLmoottori Tapahtumakalenteri verkkosivuilla Katrina-ohjelmisto Xerdacom Calendar 3 Varoituksia VAROITUS: Jos Katrina on asetettu julkaisemaan verkkoon julkaistavaksi ilmoitetut varaukset automaattisesti, tapahtumat näytetään heti. Varmista ennen lisäystä, tapahtuma on julkaisukelpoinen. VAROITUS: Jos käytetään KatrinaXML:n Extramarks-ominaisuutta varmista, että tietoja ei julkaista sellaisenaan ennen esitarkistusta muualla (esim. lehdessä). VAROITUS: Ennen arkaluontoisten tietojen syöttöä varmista, että tiedot eivät tule sellaiseen kenttään, joka näytetään XCal3:ssa. Lisätietoa KatrinaXML:n saamista tiedoista on kohdassa Tapahtuman luonti.
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 4 (7) Tapahtuman luonti Tapahtuma verkkosivuille luodaan kuten mikä tahansa varaus. KatrinaXML osaa hakea Katrinasta seuraavat tiedot: <TODO> Nämä tiedot pitää tarkistaa vielä Oriveden seurakunnan kanssa Riku 5.8. Kenttä Katrinassa Tieto XCal3:ssa Kuvaus Varaustyyppi Vapaa tarkenne Nimi Tapahtuman nimi Kustannuspaikka Luokka Tapahtuman kategoria Selite Tapahtuman todellinen aika, Päivämäärä Tila Kuvaus Alkaa, Loppuu Paikka, Paikan alkaa, Paikan loppuu Tapahtuman vapaamuotoinen kuvaus Tapahtuman alkamis- ja loppumisajat ja -päivät Paikan nimi ja ajat paikassa. Järjestelmä näyttää paikkojen ajat vain silloin, kuin ne poikkeavat tapahtuman ajoista. HUOMAUTUS: KatrinaXML ei tuo XCal3-kalenteriin varauksesta muita tietoja kuin edellä mainitut. Jos haluat lisätä esim. erikoispaikkoja tai osallistujia, voit käyttää Extramark-toimintoa, jos se on otettu käyttöön KatrinaXML:n asetuksista. Lisätietoa Extramark-lisätiedoista löytyy luvusta Extramarklisätiedot. HUOMAUTUS: Varmista, että kaikki tiedot on syötetty oikeisiin kenttiin, ja että verkkosivuilla julkaistavissa kentissä ei ole mitään arkaluonteista materiaalia. VINKKI: Varmistaaksesi, että seurakuntasi mahdollisesti käyttämä työalakohtainen verkkotapahtumakalenteri toimii oikein, tulee tapahtuman luokan määrittely olla oikein Kustannuspaikka-kentässä. Tämän lisäksi varauksen Tiedotus lehteen/ www -valintalaatikko on oltava valittuna. Kun edellä mainitut kentät on täytetty asianmukaisesti, voidaan uusi varaus luoda. Jos Katrinan asetuksista on valittu, että tiedottaja tarkistaa Internetiin menevät tapahtumat, on hänen vielä hyväksyttävä tapahtuman julkaisu. Lisätietoja hyväksymisestä on luvussa Tapahtuman hyväksyminen Katrinassa.
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 5 (7) Tapahtuman hyväksyminen Katrinassa Jos Katrinan asetuksista on valittu, että verkkosivuilla (ja lehdessä) julkaistavat tapahtumat on erikseen hyväksyttävä, tulee verkkosivuille haluttu tapahtuma hyväksyä julkaistavaksi ennen kuin tapahtuma näkyy XCal3-tapahtumalistoissa. <TODO> Katrinan ohjeista ei löydy tietoa tähän asiaan. --Riku
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 6 (7) Extramark-lisätiedot Jos seurakuntanne käyttää KatrinaXML:n Extramark-toimintoa, voidaan XCal3:ssa näkyviä tapahtumia muokata tavoilla, jotka eivät muuten olisi mahdollisia. Extramark-toiminto mahdollistaa: Tapahtumaan osallistuvien henkilöjen/ryhmien (esim. saarnaajan, kanttorin tai kuoron) lisäämisen niin, että ne näytetään luettelona tapahtuman alla, eikä kuvauksessa. Tapahtuman paikan tarkentamisen. Esimerkiksi tilanteessa, jossa Katrinasta on valittu tilaksi Muu tila, voidaan tämä tila korvata XCal3-tapahtumassa kuvaavammalla nimityksellä. Tapahtuman piilottamisen. Jos seurakuntanne käyttää tapahtumien automaattista julkaisua Internetissä, mutta tarkistusta lehteen menevissä tapahtumissa, ja halutaan, ettei tapahtuma näy Internetissä, voidaan varauksen XCal3-tapahtuma piilottaa. Käyttö HUOMAUTUS: Extramark-toiminto tulee erikseen ottaa käyttöön KatrinaXML:n asetuksista. Ennen kuin lisäät Extramark-lisätietoja tapahtumaan, varmista verkkosivujen ylläpitäjältä, että Extramarklisätiedot ovat päällä. VAROITUS: Jos seurakuntanne julkaisee tapahtumia Katrinasta ilman tarkastusta muualla kuin XCal3:ssa (esim. muualla Internetissä tai lehdessä), ei Extramark-toimintoa tule käyttää, sillä vaikka Extramark-lisätietojen koodeja ei näytetäkään XCal3:ssa, ne voivat silti tulla näytetyksi esim. lehdessä. Varmista ennen Extramark-lisätietojen lisäämistä tiedottajalta, verkkosivujen ylläpitäjältä tai Katrinan pääkäyttäjältä, että tietoja ei julkaista sellaisenaan muualla. VAROITUS: Väärinmuotoillut Extramark-lisätiedot voivat aiheuttaa ongelmia tai jäädä käsittelemättä kokonaan. Varmista, että olet syöttänyt Extramark-lisätiedot tämän ohjeen mukaan. Extramark-lisätietoja lisätään erityisin helppokäyttöisin koodein, jotka lisätään Katrinassa varauksen selitekenttään. KatrinaXML tunnistaa nämä merkinnät ja muuttaa XCal3:n tapahtumaa niiden mukaan. Varauksessa voi olla rajaton määrä Extramark-lisätietoja. Lisätiedot kirjoitetaan hakasulkeisiin [...] (hakasulkeet saadaan suomalaisella näppäinasettelulla painamalla AltGr-näppäin alaspainettuna näppäimiä 8 ja 9), ja ne muodostuvat komento-osasta (esim. XM-PERSON: ) ja vaihtelevasta määrästä pilkulla erotettuja valitsinosia. HUOMAUTUS: Komento-osa tulee kirjoittaa ilman välilyöntiä heti [-merkin jälkeen, ja kaikki kirjaimet ovat TIKKUKIRJAIMIN. HUOMAUTUS: Nimet ja muut tekstit valitsimissa voivat koostua mistä tahansa kirjaimista, numeroista ja merkeistä, poislukien seuraavat: kaksoispiste (:), pilkku (,) ja hakasulkeet ([ ja ]) Osallistujan lisääminen Osallistuja lisätään merkinnällä [XM-PERSON:Osallistujan nimi], esimerkiksi [XM-PERSON:Erkki Esimerkki] tai [XM-PERSON:kanttori Kalle Kakkonen]. Jos XCal3-tapahtumalla on jo muita osallistujia (esimerkiksi KatrinaXML:n kokeellisen automaattisen nimihaun löytämät), nämä osallistujat lisätään niiden perään. Paikan lisääminen Paikka lisätään merkinnällä [XM-PLACE:Paikan nimi,alkuaika,loppuaika], esimerkiksi [XM- PLACE:Kirkko,1312621200,1312628400] (6.8.11 klo 12:00-14:00), tai [XM-PLACE:Kerhotila,0,0] (automaattiset ajat). Ajat tulee ilmoittaa ns. UNIX-aikaleimana. Päivämäärä ja kellonaika voidaan muuntaa aikaleimaksi esimerkiksi
Xerdacom Calendar 3.0 KatrinaXML Tapahtumien lisääjän opas, Suomi 7 (7) Wolfram Alpha -sivustolla (http://www.wolframalpha.com/input/?i=6.8.2011+14:31+to+unix+time). Jos tapahtuma alkaa antamassasi paikassa, voit antaa alkuajaksi arvon 0. Samoin jos tapahtuma loppuu antamaasi paikkaan, voit antaa loppuajaksi arvon 0. Tällöin KatrinaXML korvaa arvon tapahtumassa ilmoitetulla alkamistai loppumisajalla. VAROITUS: Jos KatrinaXML löytää yhdenkin Extramark-paikkakuvauksen, se korvaa kaikki tapahtumaan Katrinassa merkityt paikat Extramark-paikoilla. Tämä on suunniteltu ominaisuus, joka mahdollistaa Muu tila -tilan korvaamisen kuvaavammalla paikalla. Jos yhtään Extramark-paikkaa ei lisätä, tapahtuman paikkoja ei muuteta. Tapahtuman piilottaminen Jos haluat piilottaa tapahtuman XCal3-tapahtumalistoista, lisää merkintä [XM-HIDE]. Tällä merkinnällä ei ole valitsimia. Tapahtumaa ei tällöin näytetä XCal3-listauksessa. HUOMAUTUS: Vaikka tapahtumaa ei näytetä XCal3-listauksessa, ei merkintä vaikuta tapahtuman muuhun näkyvyyteen muualla Internetissä tai esim. lehdessä.