Toimintosarja TIMESWITCH_GET

Toimintosarja TIMESWITCH_GET palauttaa kaiken tiedon aikataulutiedosta.

Huomio: Aikataulu on tallennettava samaan elementtiin.

Syöte TIMESWITCH

Täällä aikataulun tietokanta tallennetaan merkkijonona. Tämä on oltava jo olemassa toimintosarjana TIMESWITCH. Huomioithan myös ohjelman järjestyksen, jotta tämä toimintosarja alustetaan oikein.

Syöte ID

Määrittää tapahtuman tunnisteen merkkijonona.

Tulo ERR

Virhetilanteessa tämä tulo asetetaan todeksi. Tämä voi tapahtua, jos kalenteri ei ole olemassa tai jos tunniste on määritelty väärin tai se puuttuu.

Tulo TITLE

Palauttaa tapahtuman otsikon.

Tulo DT_START

Tapahtuman alkamisaika muodossa DT#.

Tulo DT_END

Tapahtuman loppumisaika muodossa DT#.

Tulo DIS

Jos tämä tulo on tosi, tapahtuma on poistettu käytöstä ja se jätetään huomiotta aikataulussa.

Tulo REPEAT

Tämä tulo palauttaa toistot merkkijonona. Nämä vastaavat apufunktioita REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY ja REPEAT_HOURLY.

Merkkijono voi olla kahtaan jakautunut tai se voidaan muodostaa seuraavasti:

w:2:4:135

Ensimmäinen numero (pienellä kirjaimella) määrittää toiston aikavälin:

Lyhenne	Aikaväli
h	Tuntia kohden
d	Päivittäin
w	Viikoittain
m	Kuukausittain
y	Vuosittain

Toinen numero määrittää toiston välin kokonaislukuna. Pienin arvo on 1.

Kolmas numero määrittää toiston lopun. Tässä voidaan määritellä kolme eri muotoa:

• Ei arvoa: Toisto on ääretön.
• Yksinkertainen kokonaisluku: Toisto päättyy määritetyn määrän toistojen jälkeen.
• Päivämäärä YYYY-MM-DD: Toisto lopetetaan ennen tätä päivämäärää.

Neljäs numero määrittää viikonpäivät, jolloin toisto tapahtuu. Tämä numeroa käytetään vain viikoittaisten tai kuukausittaisten toistojen määrittämisessä.

Viikoittaiset toistot

Tarkistetaan, onko nykyinen viikonpäivä luvussa. Useita päiviä voidaan ilmoittaa peräkkäin. Esimerkiksi 135 maanantaina, keskiviikkona ja perjantaina. Jos ei anneta arvoa (0 tai tyhjä merkkijono), toisto ei tapahdu millään päivänä.

Luku	Viikonpäivä
1	Maanantai
2	Tiistai
3	Keskiviikko
4	Torstai
5	Perjantai
6	Lauantai
7	Sunnuntai

Kuukausittaiset toistot

Määrittää, millä viikonpäivänä tapahtuma on toistettava. Tuetaan lukuja -1 ja 4. 0 tai ei määrittelyä toistaa joka kuukausi samana päivänä, riippumatta viikonpäivästä. Viikonpäivä otetaan ensimmäisen päivämäärän mukaan.

Arvo	Kuvaus
-1	Toista viimeisenä viikonpäivänä.
0	Toista samana päivänä. (Oletus)
1	Toista ensimmäisenä viikonpäivänä.
2	Toista toisenana viikonpäivänä.
3	Toista kolmantena viikonpäivänä.
4	Toista neljäntenä viikonpäivänä.

Tulo DT_MODIFY

Tämä tulo määrittää viimeisen muutoksen muodossa DT#. Tämä syöte voi myös olla määrittelemätön, jos tapahtuma on luotu ennen versiota 5.0.