CalendarEntryInformation (Objekt): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Sed (Diskussion | Beiträge) |
|||
(10 dazwischenliegende Versionen von 2 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== | ||
Zeile 18: | Zeile 34: | ||
|- 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]] | ||
+ | | 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> | | <code>calendarFrom</code> | ||
| [[Number]] | | [[Number]] | ||
− | | Startzeitpunkt inkl. Tag und Uhrzeit als Long-Wert | + | | Startzeitpunkt inkl. Tag und Uhrzeit als Long-Wert. Diese Methode erlaubt den einfachen Zugriff auf den Beginn des Termins. |
| 2 | | 2 | ||
|- | |- | ||
| <code>calendarTo</code> | | <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 | ||
|- | |- | ||
Zeile 63: | Zeile 94: | ||
|- | |- | ||
| <code>isRepeat</code> | | <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. | ||
Zeile 99: | Zeile 135: | ||
| <code>calendarInterval</code> | | <code>calendarInterval</code> | ||
| [[Number]] | | [[Number]] | ||
− | | Wiederholungen (z.B. jeden 2. Tag) | + | | Intervall der Wiederholungen (z.B. jeden 2. Tag) |
| 2 | | 2 | ||
|- | |- | ||
Zeile 109: | Zeile 145: | ||
| <code>calendarRepetitionCount</code> | | <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 | ||
|- | |- | ||
| <code>calendarRepetitionDate</code> | | <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 | ||
|- | |- | ||
Zeile 207: | Zeile 243: | ||
|} | |} | ||
| 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 |