Das sd:calendar- Element

• » Home
• »Server-Daten
• »Ausgabeseiten / sd-Elemente
• » sd:calendar

Typ

Attribute

sd:name *

Legt den Namen des Objektes fest. Dieses Attribut ist immer ein Pflicht-Attribut.

sd:table-type *

Legt den Grundtyp des Kalenderelements fest. Gültige Werte sind

absolute-table
week-table
hour-table
absolute-max-registrations
absolute-query
hour-list

sd:start-date *

Legt das Startdatum für den Kalender fest. Das Datum wird einmalig beim Speichern der Seite ausgelesen und gesondert in der Datenbank im Datumsformat gespeichert. Wird für das Startdatum '2006-01-01' und für das Enddatum '2006-03-31' angegeben, so werden die drei Monate Januar / Februar / März 2006 verarbeitet.

sd:end-date *

Legt das Enddatum für den Kalender fest.

sd:table *

Legt den Namen der Tabelle fest, welche für den Kalender ausgewertet wird. Die Tabelle muß die beiden mit sd:begin-col / sd:end-col festgelegten Spalten, gegebenenfalls die sd:filter-col-Spalte enthalten.

sd:begin-col

Dieses Attribut muß mit dem Namen der ersten Datumsspalte belegt werden. Bsp.: 'Urlaubsbeginn'.

sd:end-col

Dieses Attribut muß mit dem Namen der zweiten Datumsspalte belegt werden. Bsp.: 'Urlaubsende'. Fehlt dieses Attribut, so werden nur die Werte aus der mit sd:begin-col bezeichneten Spalte gesondert formatiert ausgegeben. In diesem Fall findet keine Berechnung von Bereichen statt.

sd:filter-col

Falls dieses Attribut belegt ist, muß der Wert gleich dem Spaltennamen in der zugeordneten Tabelle sein. Diese Spalte muß vom Typ Integer sein. Es wird nun nicht die gesamte Tabelle, sondern nur die Zeilen verarbeitet, welche in der 'sd:filter-col'-Spalte den Wert haben, welcher durch das sd:with-param -Element übergeben wurde. Falls eine solche sd:filter-col-Spalte definiert wurde, jedoch kein Wert übergeben wurde, so wird keine Zeile der Kalendertabelle verarbeitet. Der Kalender bleibt ohne Hervorhebungen.

sd:week-day

Bezeichnet eine Spalte innerhalb der durch sd:table festgelegten Tabelle, welche die Information zum Wochentag bereitstellt. Diese Spalte muß als 'int'-Spalte mit den Werten

2;Montag;3;Dienstag;4;Mittwoch;5;Donnerstag;6;Freitag;7;Samstag;1;Sonntag

deklariert sein. Die Kombination 1;Sonntag kann auch an den Anfang der Liste gestellt werden.

sd:months-per-row

Legt fest, wieviele Monate pro Zeile ausgegeben werden. Ist der Wert gleich 1, so werden keine zusätzlichen Html-Elemente eingefügt. Ein Wert größer 1 erzeugt eine passende Blindtabelle und trägt die Monatselemente entsprechend ein.

sd:skip-table

Name einer Sperrtabelle

sd:skip-begin-col

Das Attribut muß eine Spalte benennen, welche den Beginn eines Sperrzeitraums festlegt. Fehlt ein Wert in der durch sd:skip-end-col bezeichneten Spalte, so wird nur der einzelne Tag des Sperrzeitraums blockiert.

sd:skip-end-col

Das Attribut benennt eine Spalte, die das Ende des Sperrzeitraumes festlegt.

sd:skip-filter-col

Mögliche Filterspalte, falls bsp. zwischen globaler Praxisschließung und einer Fortbildung eines einzelnen Mitarbeiters unterschieden werden soll.

sd:duration-table

Wird für die beiden Typen week-table/hour-table genutzt und erfordert den Namen einer Zeitdauer/Termintyp-Tabelle.

sd:duration-col

Hier ist der Name einer Spalte in der sd:duration-table notwendig. Diese Spalte muß die Länge des Termins als Ganzzahl in Viertelstunden-Einheiten enthalten.

sd:appointment-table

Name der Tabelle mit den tatsächlich vereinbarten Terminen. Enthält diese Tabelle keine Zeilen, so werden alle Tage bzw. alle Stunden als 'frei' ausgegeben.

sd:appointment-begin-col

Name einer Datumsspalte innerhalb der sd:appointment-table . Dies markiert den Beginn des Termins.

sd:appointment-duration-col

Name einer Fremdschlüsselspalte innerhalb der sd:appointment-table , die auf eine Zeile in der Termintypen / sd:duration-table - Tabelle verweist. Anhand des zugeordneten Wertes in der sd:duration-col -Spalte wird die Zeitdauer des Termins ermittelt.

sd:appointment-filter-col

Name einer Filterspalte innerhalb der sd:appointment-table . Diese kann bsp. auf eine Personentabelle verweisen, um Termine von verschiedenen Personen zu unterscheiden.

sd:appointment-expression

Ausdruck, der dem Namen einer Textspalte oder eines komplexeren Ausdrucks entsprechen kann. Die Spalten müssen innerhalb der sd:appointment-table definiert sein. Der Wert wird ausgegeben, falls das Kalenderelement vom Typ 'hour-list' ist.

sd:appointment-expression-2

Weitere Ausgabespalte

sd:appointment-expression-3

Weitere Ausgabespalte

sd:flag-expression

Sonderausdruck

sd:appointment-day-col

Benennt die Spalte in der Appointment-Tabelle, welche die Tagesangabe enthält.

sd:appointment-min-user-col

Falls der Kalender eine Anmeldung ermöglichen soll und falls pro Termin minimal viele Teilnehmer notwendig sind, wird dieses Attribut mit dem Namen der Spalte belegt, welche diesen Minimalwert bereitstellt.

sd:appointment-max-user-col

Ermöglicht der Kalender eine Anmeldung und gibt es für einen Termin eine Maximalzahl von Teilnehmern, dann wird dieses Attribut mit dem Spaltennamen belegt, der den Maximalwert bereitstellt.

sd:appointment-max-waiting-col

Bei Kalendern zur Anmeldung kann hier eine Spalte angegeben werden, die einen Wert zur maximalen Länge der Warteliste enthält.

sd:registration-main-table-col

Falls der Kalender vom Typ 'absolute-max-registrations' ist, dann benennt das Pflichtattribut sd:table die Tabelle mit den Einzelanmeldungen. Die im sd:registration-main-table-col benannte Spalte enthält den Fremdschlüssel für die im sd:appointment-table -Attribut benannte Tabelle.

sd:registration-user-id-col

Für den Kalender vom Typ 'absolute-max-registrations' benennt diese Spalte die Spalte mit User-IDs in der durch sd:table festgelegten Tabelle.

sd:as-rs

Falls dieses Attribut mit dem Wert 'true' belegt ist, wird der Inhalt des sd:calendar -Elements wie der Inhalt eines sd:rs -Elements ausgegeben.

sd:additional-tables

Ermöglicht das Festlegen zusätzlicher Tabellen, die in der Kalenderabfrage mit ausgewertet werden können.

sd:additional-columns

Ermöglicht das Festlegen zusätzlicher Ausgabespalten, die in der Kalenderabfrage mit ausgewertet werden können.

sd:with-client-search

Benennt eine Spalte (derzeit nur 'thisHour'), die genutzt wird, um nach den zu dieser Ausgabezeile passenden Zeilen der zurückgegebenen Tabelle zu suchen.

sd:minutes-difference

Falls belegt, werden die Zeilen vom Datenbank-Server mit diesem Abstand (15, 30 oder 60 Minuten) zurückgegeben.

sd:remove-when-saved

Falls dieses Attribut mit 'true' belegt und irgendeine Zeile in der Seite gespeichert wird, dann wird das übergeordnete Ergebnis gelöscht und anschließend neu von der Datenbank geladen. Das ist nützlich, falls es Abhängigkeiten zwischen Eingaben und Ausgaben gibt, die sich nicht über andere Möglichkeiten deklarieren lassen.
Fehlt das Attribut und existieren solche Abhängigkeiten, so kann es zu Fehlanzeigen kommen. Das System nutzt - absichtlich - umfangreiche Caching-Techniken, so daß Kalender- und Ausgabetabellen nur neu geladen werden, falls innerhalb der Ausgabeseite ein Grund dafür vorliegt (geändertes Datum, Klick auf den Such-Button).

sd:refresh-explicit

Wenn das Attribut mit 'true' belegt ist, dann wird diese Ausgabe bei jedem Aufruf aktualisiert. Das ist im Allgemeinen nicht sinnvoll, kann aber notwendig sein, falls bsp. Zufallsbilder angezeigt werden sollen.

sd:start-time

Dieses Attribut erhält den Zeitpunkt, ab dem ein Kalender vom Typ 'hour-list' die Zeitpunkte ausgibt. Beispiel:

sd:start-time='08:00'

Es werden die Zeitpunkte ab 08:00 ausgegeben.

sd:end-time

Dieses Attribut enthält den Zeitpunkt, bis zu welchem ein 'hour-list' - Kalender die Zeitpunkte ausgibt:

sd:end-time='20:00'

Child-Elemente

Beispiele

<sd:param sd:name="myParam"
  sd:relation="fk_zimmerbelegungen_zimmerliste"
  sd:datatype="int" />
<sd:form sd:name="myForm">
  <div class="sd-input-part">
    <div class="sd-input">
      <sd:input-text sd:param-name="myParam" />
      <div class="sd-button-list">
        <span style="padding:3px">
          <sd:button sd:name="myButton">
            <sd:label-standard>Ausführen</sd:label-standard>
          </sd:button>
        </span>
        <span style="padding:3px">
          <sd:button sd:name="reset">
            <sd:label-reset>Reset</sd:label-reset>
          </sd:button>
        </span>
      </div>
      <p />
        <span class="sd-error"><sd:err-message /></span>
        <p />
    </div>
  </div>

  <sd:calendar sd:name="myCalendar" sd:table="zimmerbelegungen"
    sd:begin-col="belegungbeginn" sd:end-col="belegungende"
    sd:months-per-row="2" sd:filter-col="zimmerlisteId"
    sd:start-date="2005-01-01" sd:end-date="2005-03-31">

    <sd:with-param sd:sql-param="@zimmerlisteId"
      sd:param-name="myParam" />

    <sd:month-row>
      <sd:month-element style="vertical-align:top;">
        <div
          style="text-align:center;font-weight:bold;margin-bottom:6px;">
          <sd:month-name sd:month-format="MMMM" />
        </div>
        <sd:day-list sd:month-style="as-week">
          <sd:single-day sd:element-type='free'
            style="background-color:#da0000;text-align:center;">
            <sd:day />
          </sd:single-day>
          <sd:single-day sd:element-type='other'>
            <sd:day />
          </sd:single-day>
        </sd:day-list>
      </sd:month-element>
    </sd:month-row>
  </sd:calendar>

</sd:form>

Link zur hiesigen Seite als QR-Code