Toimintosarja TIMESWITCH_ADD

Toimintosarja TIMESWITCH_ADD luo tai muokkaa tapahtumaa aikataulutettavassa laitteessa.

Huomautus: Aikataulutettu laite on tallennettava samaan elementtiin.

Vinkki: Tapahtuman muokkaamiseen kaikki arvot voidaan lukea toimintosarjan TIMESWITCH_GET avulla.

Syöttö ADD

Syöttö luo tai muokkaa tapahtumaa kalenterissa, kun syöttö on positiivinen. Jos syöttö on aina tosi, tapahtuma luodaan uudelleen, kun se on poistettu. Tapahtuman muutokset eivät tunnisteta.

Tärkeää: Tapahtuman luomista ja samanaikaisesti poistamista tulisi välttää, koska tämä voi rasittaa SSD-levyä huomattavasti.

Syöttö TIMESWITCH

Tässä tallennetaan aikataulutettavan laitteen tietokanta merkkijonona. Tämä on oltava jo olemassa toimintosarjana TIMESWITCH. Huomioithan myös ohjelman järjestys, jotta tämä toimintosarja alustetaan oikein.

Syöttö ID

Määrittää tapahtuman tunnisteen merkkijonona. Tämä mahdollistaa yksilöllisen tunnistamisen ja estää muut tapahtumat aiheuttamasta konfliktiä. Tunnisteen tulisi koostua vain kirjaimista ja numeroista. Isot ja pienet kirjaimet otetaan huomioon.

Huomautus: Tunnisteen tulisi olla yksilöllinen kaikille kalentereille. Käyttäjä voi kopioida tapahtuman visualisoinnissa toiseen kalenteriin.

Syöttö TITLE

Tapahtuman otsikko merkkijonona. Tämä ei saisi sisältää rivinvaihtoja. Jos syöttö ADD on tosi, kaikki muutokset kirjoitetaan heti kalenteriin.

Syöttö DT_START

Tapahtuman alkamisaika muodossa DT#. Jos syöttö ADD on tosi, kaikki muutokset kirjoitetaan heti kalenteriin.

Vinkki: Kytkentäajat voidaan laskea toimintosarjojen MKTIME, STR2DT ja EASTER_DATE avulla.

Syöttö DT_END

Tapahtuman loppumisaika muodossa DT#. Jos syöttö ADD on tosi, kaikki muutokset kirjoitetaan heti kalenteriin. Jos loppumisaika on pienempi kuin DT_START, DT_END määritellään alkamisaikaksi.

Jos syöttöä ei määritellä, otetaan sama arvo kuin DT_START ja tapahtumalle luodaan impulssi.

Syöttö DIS

Syöttö deaktivoi tapahtuman kalenterissa. Jos syöttö ADD on tosi, kaikki muutokset kirjoitetaan heti kalenteriin.

Syöttö REPEAT

Syötössä voidaan määrittää toistot merkkijonona. Nämä voidaan generoida apufunktioiden REPEAT_YEARLY, REPEAT_MONTHLY, REPEAT_WEEKLY, REPEAT_DAILY ja REPEAT_HOURLY avulla tai julistaa kuten kuvattu.

Merkkijono voidaan rakentaa kaksoispisteellä erotettuna seuraavasti:

w:2:4:135

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

Lyhenne	Aikaväli
h	Tuntisesti
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äärittää 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ällä tapahtuma tulisi toistaa. Tuenna luvut -1 ja 4. 0 tai ei määrittelyä toistaa joka kuukausi samana päivänä, riippumatta viikonpäivästä. Viikonpäivä otetaan ensimmäisestä päivämäärästä.

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 ERR

Virhetilanteessa tulo asetetaan todeksi. Tämä voi tapahtua, jos kalenteri ei ole olemassa tai tunniste on määritelty virheellisesti.