CalendarEntryInformation (Objekt): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Sed (Diskussion | Beiträge) |
Sed (Diskussion | Beiträge) |
||
(17 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | |||
==Name== | ==Name== | ||
− | + | CalendarEntryInformation - Objekt innerhalb einer [[CalendarInformation]] | |
==Beschreibung== | ==Beschreibung== | ||
− | + | CalendarEntryInformation Objekte sind die Objekte, die Kalenderdaten aufnehmen. Sie dienen zur Organisation und Abbildung von Terminen innerhalb des IES. Alle Attribute, die mit dem Prefix <code>calendar</code> beginnen sind gleichfalls die Typen für die Definition der Eingabefelder innerhalb der entsprechenden Subinformation. Der Name aller Eingabefelder ist stets <code>calendar</code>: | |
− | + | z.B. | |
+ | <source lang="xml"> | ||
+ | <sp:subinformation name="ical" type="calendar"> | ||
+ | <sp:text name="calendar" type="calendarType" value="day"/> | ||
+ | ... | ||
+ | </sp:subinformation> | ||
− | + | <sp:subinformation name="sp_eventDate" type="calendar"> | |
− | + | calendarFrom <sp:text name="calendar" type="calendarFrom" maxlength="10" size="12" format="dd.MM.yyyy"/><br> | |
− | + | calendarTo <sp:text name="calendar" type="calendarTo" maxlength="10" size="12" format="dd.MM.yyyy"/><br> | |
− | + | calendarType <sp:text name="calendar" type="calendarType"/><br> | |
− | + | calendarAllDay <sp:text name="calendar" type="calendarAllDay"/><br> | |
+ | calendarRepetitionCount <sp:text name="calendar" type="calendarRepetitionCount"/><br> | ||
+ | calendarRepetitionDate <sp:text name="calendar" type="calendarRepetitionDate" maxlength="10" size="12" format="dd.MM.yyyy"/><br> | ||
+ | calendarInterval <sp:text name="calendar" type="calendarInterval"/><br> | ||
+ | calendarDow <sp:text name="calendar" type="calendarDow"/><br> | ||
+ | calendarDom <sp:text name="calendar" type="calendarDom"/><br> | ||
+ | calendarDoy <sp:text name="calendar" type="calendarDoy"/><br> | ||
+ | calendarOom <sp:text name="calendar" type="calendarOom"/><br> | ||
+ | calendarMoy <sp:text name="calendar" type="calendarMoy"/><br> | ||
+ | </sp:subinformation> | ||
+ | </source> | ||
+ | |||
+ | Weitere Details hierzu bei der Beschreibung des [[sp:subinformation|Subinformation-Tags]]. | ||
==Attribute== | ==Attribute== | ||
− | {| class="prettytable" | + | {| class="prettytable sortable" |
|- class="hintergrundfarbe1" | |- class="hintergrundfarbe1" | ||
! Attribut || Type || Beschreibung || ab IES Version | ! Attribut || Type || Beschreibung || ab IES Version | ||
|- | |- | ||
− | | | + | | <code>startDay</code> |
+ | | [[Number]] | ||
+ | | Der Tag, an dem der Termin beginnt (ohne Uhrzeit) als Long-Wert. | ||
+ | | 2.0.3 | ||
+ | |- | ||
+ | | <code>from</code> | ||
| [[Number]] | | [[Number]] | ||
− | | Startzeitpunkt inkl. Tag und Uhrzeit als Long-Wert | + | | Uhrzeit mit dem Start des Termins. Relativ zum Starttag als Long-Wert. |
+ | | 2.0.3 | ||
+ | |- | ||
+ | | <code>to</code> | ||
+ | | [[Number]] | ||
+ | | Uhrzeit mit dem Ende des Termins. Relativ zum Starttag als Long-Wert. Dieser Wert kann auch über mehrere Tage gehen. | ||
+ | | 2.0.3 | ||
+ | |- | ||
+ | | <code>calendarFrom</code> | ||
+ | | [[Number]] | ||
+ | | Startzeitpunkt inkl. Tag und Uhrzeit als Long-Wert. Diese Methode erlaubt den einfachen Zugriff auf den Beginn des Termins. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarTo | + | | <code>calendarTo</code> |
| [[Number]] | | [[Number]] | ||
− | | Endzeitpunkt inkl. Tag und Uhrzeit als Long-Wert | + | | Endzeitpunkt inkl. Tag und Uhrzeit als Long-Wert. Diese Methode erlaubt den einfachen Zugriff auf den Beginn des Termins. |
| 2 | | 2 | ||
|- | |- | ||
− | | calendarType | + | | <code>calendarType</code> |
| [[String]] | | [[String]] | ||
| Typ der Wiederholung des Termins | | Typ der Wiederholung des Termins | ||
Zeile 36: | Zeile 67: | ||
! Wert || Beschreibung | ! Wert || Beschreibung | ||
|- | |- | ||
− | | day | + | | <code>day</code> |
| fester Termin (z.B. Urlaub) | | fester Termin (z.B. Urlaub) | ||
|- | |- | ||
− | | daily | + | | <code>daily</code> |
| tägliche Erinnerung (z.B. Blumen gießen) | | tägliche Erinnerung (z.B. Blumen gießen) | ||
|- | |- | ||
− | | weekly | + | | <code>weekly</code> |
| wöchentliche Termine (z.B. alle 4 Wochen Skat) | | wöchentliche Termine (z.B. alle 4 Wochen Skat) | ||
|- | |- | ||
− | | monthlyByDay | + | | <code>monthlyByDay</code> |
| der Tag X eines Monats (z.B. Erinnerung an eine Überweisung) | | der Tag X eines Monats (z.B. Erinnerung an eine Überweisung) | ||
|- | |- | ||
− | | monthlyByOccurrence | + | | <code>monthlyByOccurrence</code> |
| bestimmter Wochentag zum X-ten mal (z.B. jeden zweiten Samstag im Monat) | | bestimmter Wochentag zum X-ten mal (z.B. jeden zweiten Samstag im Monat) | ||
|- | |- | ||
− | | yearlyByDay | + | | <code>yearlyByDay</code> |
| der Tag X eines Jahres (keine sinnvolle Anwendung gefunden) | | der Tag X eines Jahres (keine sinnvolle Anwendung gefunden) | ||
|- | |- | ||
− | | yearlyByOccurrence | + | | <code>yearlyByOccurrence</code> |
| bestimmter Wochentag X eines Monats (z.B. FamilienTreffen jedes erste Wochenende im Juni) | | bestimmter Wochentag X eines Monats (z.B. FamilienTreffen jedes erste Wochenende im Juni) | ||
|- | |- | ||
− | | yearlyByMonth | + | | <code>yearlyByMonth</code> |
| Tag X eines Monats im Jahr (z.B. Geburtstag) | | Tag X eines Monats im Jahr (z.B. Geburtstag) | ||
|} | |} | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isRepeat | + | | <code>isRepeat</code> |
+ | | [[Boolean]] | ||
+ | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
+ | | 2 | ||
+ | |- | ||
+ | | <code>isDaily</code> | ||
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isWeekly | + | | <code>isWeekly</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isMonthlyByDay | + | | <code>isMonthlyByDay</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isMonthlyByOccurrence | + | | <code>isMonthlyByOccurrence</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isYearlyByDay | + | | <code>isYearlyByDay</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isYearlyByOccurrence | + | | <code>isYearlyByOccurrence</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | isYearlyByMonth | + | | <code>isYearlyByMonth</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Hilfsfunktion zur Abfrage des Kalendartyps. | | Hilfsfunktion zur Abfrage des Kalendartyps. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarInterval | + | | <code>calendarInterval</code> |
| [[Number]] | | [[Number]] | ||
− | | Wiederholungen (z.B. jeden 2. Tag) | + | | Intervall der Wiederholungen (z.B. jeden 2. Tag) |
| 2 | | 2 | ||
|- | |- | ||
− | | calendarAllDay | + | | <code>calendarAllDay</code> |
| [[Boolean]] | | [[Boolean]] | ||
| Zeigt an, ob es sich um einen ganztägigen Termin handelt. | | Zeigt an, ob es sich um einen ganztägigen Termin handelt. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarRepetitionCount | + | | <code>calendarRepetitionCount</code> |
| [[Number]] | | [[Number]] | ||
− | | Zeigt die Anzahl der Wiederholungen an. | + | | Zeigt die Anzahl der Wiederholungen an. Wurde lediglich ein Termin zum Ende der Wiederholungen eingeben, so steht dieser Wert nicht zur Verfügung. |
| 2 | | 2 | ||
|- | |- | ||
− | | calendarRepetitionDate | + | | <code>calendarRepetitionDate</code> |
| [[Number]] | | [[Number]] | ||
− | | Gibt den Zeitpunkt an dem die Wiederholung endet als Long-Wert zurück. | + | | Gibt den Zeitpunkt an dem die Wiederholung endet als Long-Wert zurück. Wurde eine Anzahl an Wiederholungen konfiguriert, so ist dieses Datum automatisch berechnet worden und steht somit zur Verfügung. |
| 2 | | 2 | ||
|- | |- | ||
− | | calendarDow | + | | <code>calendarDow</code> |
| [[String]] | | [[String]] | ||
| Gibt die Tage der Woche des Termins als Liste mit folgenden Werten aus | | Gibt die Tage der Woche des Termins als Liste mit folgenden Werten aus | ||
Zeile 124: | Zeile 160: | ||
! Wert || Beschreibung | ! Wert || Beschreibung | ||
|- | |- | ||
− | | sun | + | | <code>sun</code> |
| Sonntag | | Sonntag | ||
|- | |- | ||
− | | mon | + | | <code>mon</code> |
| Montag | | Montag | ||
|- | |- | ||
− | | tue | + | | <code>tue</code> |
| Dienstag | | Dienstag | ||
|- | |- | ||
− | | wed | + | | <code>wed</code> |
| Mittwoch | | Mittwoch | ||
|- | |- | ||
− | | thu | + | | <code>thu</code> |
| Donnerstag | | Donnerstag | ||
|- | |- | ||
− | | fri | + | | <code>fri</code> |
| Freitag | | Freitag | ||
|- | |- | ||
− | | sat | + | | <code>sat</code> |
| Samstag | | Samstag | ||
|} | |} | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarDom | + | | <code>calendarDom</code> |
| [[Number]] | | [[Number]] | ||
| Gibt den Tag des Monats zurück. | | Gibt den Tag des Monats zurück. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarDoy | + | | <code>calendarDoy</code> |
| [[Number]] | | [[Number]] | ||
| Gibt den Tag des Jahres zurück. | | Gibt den Tag des Jahres zurück. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarOom | + | | <code>calendarOom</code> |
| [[Number]] | | [[Number]] | ||
− | | | + | | Vorkommen innerhalb des Monats. |
+ | z.B. 30.7.2007 (Montag) = 5. Montag eines Monats. | ||
| 2 | | 2 | ||
|- | |- | ||
− | | calendarMoy | + | | <code>calendarMoy</code> |
| [[Number]] | | [[Number]] | ||
| Gibt den Monat des Jahres zurück. | | Gibt den Monat des Jahres zurück. | ||
+ | {| class="prettytable" | ||
+ | |- class="hintergrundfarbe1" | ||
+ | ! Wert || Beschreibung | ||
+ | |- | ||
+ | | <code>0</code> | ||
+ | | Januar | ||
+ | |- | ||
+ | | <code>1</code> | ||
+ | | Februar | ||
+ | |- | ||
+ | | <code>2</code> | ||
+ | | März | ||
+ | |- | ||
+ | | <code>3</code> | ||
+ | | April | ||
+ | |- | ||
+ | | <code>4</code> | ||
+ | | Mai | ||
+ | |- | ||
+ | | <code>5</code> | ||
+ | | Juni | ||
+ | |- | ||
+ | | <code>6</code> | ||
+ | | Juli | ||
+ | |- | ||
+ | | <code>7</code> | ||
+ | | August | ||
+ | |- | ||
+ | | <code>8</code> | ||
+ | | September | ||
+ | |- | ||
+ | | <code>9</code> | ||
+ | | Oktober | ||
+ | |- | ||
+ | | <code>10</code> | ||
+ | | November | ||
+ | |- | ||
+ | | <code>11</code> | ||
+ | | Dezember | ||
+ | |} | ||
| 2 | | 2 | ||
+ | |- | ||
+ | | <code>range</code> | ||
+ | | [[Number]] | ||
+ | | Anzahl der Tage zwischen Anfang und Ende des Termins | ||
+ | | 2 | ||
+ | |- | ||
+ | | <code>allDays</code> | ||
+ | | [[Collection]] | ||
+ | | liefert eine Collection mit allen Tagen zurück, an denen der Termin stattfindet. | ||
+ | | 2 | ||
+ | |- | ||
+ | | <code>allStartDays</code> | ||
+ | | [[Collection]] | ||
+ | | liefert eine Collection mit allen Start-Tagen eines Termins zurück. Eine sinnvolle Anwendung findet sich für Wiederholtermine, die über mehrere Tage gehen. | ||
+ | | 2.0.4 | ||
+ | |} | ||
+ | |||
+ | ==Methoden== | ||
+ | {| class="prettytable" | ||
+ | |- class="hintergrundfarbe1" | ||
+ | ! Methode || Rückgabewert || Beschreibung || ab IES Version | ||
+ | |- | ||
+ | | <code>relativeStartDay([[Number]] date)</code> | ||
+ | | [[Number]] | ||
+ | | Bei Wiederholterminen, die über mehrere Tage gehen, liefert diese Methode den relativen Start-Tag zurück, in das angegebene Datum liegt. | ||
+ | | 2.0.4 | ||
+ | |- | ||
+ | | <code>days([[Number]] from, [[Number]] to [,"all"|"start"])</code> | ||
+ | | [[Number]] | ||
+ | | Bei Wiederholterminen, die über mehrere Tage gehen, liefert diese Methode alle (Start-)Tage in dem angegebenen Zeitraum. | ||
+ | | 2.15 | ||
|} | |} | ||
+ | |||
+ | ;<code>[[Number]] relativeStartDay([[Number]] date)</code> | ||
+ | : | ||
+ | :;Parameter | ||
+ | ::;<code>date</code> | ||
+ | :::Datum als <code>Long</code>, für den der entsprechende Start-Tag ermittelt werden soll. | ||
+ | :;Rückgabewert | ||
+ | ::;Number | ||
+ | :::Das Datum, an dem der Zeitraum des Termins, bezogen auf die Wiederholungen, beginnt. | ||
<noinclude> | <noinclude> | ||
[[Category:Objekte]] | [[Category:Objekte]] | ||
− | |||
[[Category:Qualität_des_Codes_prüfen]] | [[Category:Qualität_des_Codes_prüfen]] | ||
</noinclude> | </noinclude> |
Aktuelle Version vom 13. April 2016, 16:11 Uhr
Name
CalendarEntryInformation - Objekt innerhalb einer CalendarInformation
Beschreibung
CalendarEntryInformation Objekte sind die Objekte, die Kalenderdaten aufnehmen. Sie dienen zur Organisation und Abbildung von Terminen innerhalb des IES. Alle Attribute, die mit dem Prefix calendar
beginnen sind gleichfalls die Typen für die Definition der Eingabefelder innerhalb der entsprechenden Subinformation. Der Name aller Eingabefelder ist stets calendar
:
z.B.
<sp:subinformation name="ical" type="calendar">
<sp:text name="calendar" type="calendarType" value="day"/>
...
</sp:subinformation>
<sp:subinformation name="sp_eventDate" type="calendar">
calendarFrom <sp:text name="calendar" type="calendarFrom" maxlength="10" size="12" format="dd.MM.yyyy"/><br>
calendarTo <sp:text name="calendar" type="calendarTo" maxlength="10" size="12" format="dd.MM.yyyy"/><br>
calendarType <sp:text name="calendar" type="calendarType"/><br>
calendarAllDay <sp:text name="calendar" type="calendarAllDay"/><br>
calendarRepetitionCount <sp:text name="calendar" type="calendarRepetitionCount"/><br>
calendarRepetitionDate <sp:text name="calendar" type="calendarRepetitionDate" maxlength="10" size="12" format="dd.MM.yyyy"/><br>
calendarInterval <sp:text name="calendar" type="calendarInterval"/><br>
calendarDow <sp:text name="calendar" type="calendarDow"/><br>
calendarDom <sp:text name="calendar" type="calendarDom"/><br>
calendarDoy <sp:text name="calendar" type="calendarDoy"/><br>
calendarOom <sp:text name="calendar" type="calendarOom"/><br>
calendarMoy <sp:text name="calendar" type="calendarMoy"/><br>
</sp:subinformation>
Weitere Details hierzu bei der Beschreibung des Subinformation-Tags.
Attribute
Attribut | Type | Beschreibung | ab IES Version | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
startDay
|
Number | Der Tag, an dem der Termin beginnt (ohne Uhrzeit) als Long-Wert. | 2.0.3 | ||||||||||||||||||||||||||
from
|
Number | Uhrzeit mit dem Start des Termins. Relativ zum Starttag als Long-Wert. | 2.0.3 | ||||||||||||||||||||||||||
to
|
Number | Uhrzeit mit dem Ende des Termins. Relativ zum Starttag als Long-Wert. Dieser Wert kann auch über mehrere Tage gehen. | 2.0.3 | ||||||||||||||||||||||||||
calendarFrom
|
Number | Startzeitpunkt inkl. Tag und Uhrzeit als Long-Wert. Diese Methode erlaubt den einfachen Zugriff auf den Beginn des Termins. | 2 | ||||||||||||||||||||||||||
calendarTo
|
Number | Endzeitpunkt inkl. Tag und Uhrzeit als Long-Wert. Diese Methode erlaubt den einfachen Zugriff auf den Beginn des Termins. | 2 | ||||||||||||||||||||||||||
calendarType
|
String | Typ der Wiederholung des Termins
|
2 | ||||||||||||||||||||||||||
isRepeat
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isDaily
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isWeekly
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isMonthlyByDay
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isMonthlyByOccurrence
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isYearlyByDay
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isYearlyByOccurrence
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
isYearlyByMonth
|
Boolean | Hilfsfunktion zur Abfrage des Kalendartyps. | 2 | ||||||||||||||||||||||||||
calendarInterval
|
Number | Intervall der Wiederholungen (z.B. jeden 2. Tag) | 2 | ||||||||||||||||||||||||||
calendarAllDay
|
Boolean | Zeigt an, ob es sich um einen ganztägigen Termin handelt. | 2 | ||||||||||||||||||||||||||
calendarRepetitionCount
|
Number | Zeigt die Anzahl der Wiederholungen an. Wurde lediglich ein Termin zum Ende der Wiederholungen eingeben, so steht dieser Wert nicht zur Verfügung. | 2 | ||||||||||||||||||||||||||
calendarRepetitionDate
|
Number | Gibt den Zeitpunkt an dem die Wiederholung endet als Long-Wert zurück. Wurde eine Anzahl an Wiederholungen konfiguriert, so ist dieses Datum automatisch berechnet worden und steht somit zur Verfügung. | 2 | ||||||||||||||||||||||||||
calendarDow
|
String | Gibt die Tage der Woche des Termins als Liste mit folgenden Werten aus
|
2 | ||||||||||||||||||||||||||
calendarDom
|
Number | Gibt den Tag des Monats zurück. | 2 | ||||||||||||||||||||||||||
calendarDoy
|
Number | Gibt den Tag des Jahres zurück. | 2 | ||||||||||||||||||||||||||
calendarOom
|
Number | Vorkommen innerhalb des Monats.
z.B. 30.7.2007 (Montag) = 5. Montag eines Monats. |
2 | ||||||||||||||||||||||||||
calendarMoy
|
Number | Gibt den Monat des Jahres zurück.
|
2 | ||||||||||||||||||||||||||
range
|
Number | Anzahl der Tage zwischen Anfang und Ende des Termins | 2 | ||||||||||||||||||||||||||
allDays
|
Collection | liefert eine Collection mit allen Tagen zurück, an denen der Termin stattfindet. | 2 | ||||||||||||||||||||||||||
allStartDays
|
Collection | liefert eine Collection mit allen Start-Tagen eines Termins zurück. Eine sinnvolle Anwendung findet sich für Wiederholtermine, die über mehrere Tage gehen. | 2.0.4 |
Methoden
Methode | Rückgabewert | Beschreibung | ab IES Version |
---|---|---|---|
relativeStartDay(Number date)
|
Number | Bei Wiederholterminen, die über mehrere Tage gehen, liefert diese Methode den relativen Start-Tag zurück, in das angegebene Datum liegt. | 2.0.4 |
days(Number from, Number to [,"all"|"start"])
|
Number | Bei Wiederholterminen, die über mehrere Tage gehen, liefert diese Methode alle (Start-)Tage in dem angegebenen Zeitraum. | 2.15 |