|
<< Click to Display Table of Contents >> Navigation: Konfigurierung Webinterface > Individuelles Maskenlayout > Elemente im individuellen Maskenlayout > Element "Datum-Filter" |
Dieses Eingabeelement ermöglich Eingabe von Datumbereich (d.h. ohne Zeit).
Es gibt drei Arten von Bereichen:
-Letzte XY Tage
-konkreter Bereich (von – bis)
-alles (d.h. nicht filtern)
Standardmäßig sind diese Optionen vordefiniert:
„(bitte auswählen)“: gemeint nicht finltern, d.h. „alles“
„Letzte 7 Tage“: Fix 7 Tage
„Letzte 30 Tage“: Fix 30 Tage
„Letzte“: Konkrete Anzahl gibt der Endbenutzer ein
„Bereich“: Konkreter Bereich gibt der Endbenutzer ein
Über Funktionen ist es möglich eigene vordefinierte Möglichkeiten vordefinieren:
-konkreter Bereich (siehe addConstDefinedDateRange)
-konkrete Anzahl von „Letzte Tage“ (siehe addConstDefinedLastDays)
-konkreter Monat und Jahr (siehe addConstDefinedMonth)
-konkretes Quartal und Jahr (siehe addConstDefinedQuarter)
-konkretes Jahr (siehe addConstDefinedYear)
-freier Bereich mit eigenem Text (siehe addUserDefinedDateRange)
-freie Anzahl von „Letzte Tage“ mit eigenem Text (siehe addUserDefinedLastDays)
Attribute
links, oben, Breite
Position und Breite
visible
Legt fest, ob das Element nach Initiierung der Maske angezeigt wird.
Funktionen
addAll(customText)
Fügt die Option “alles” ein.
addConstDefinedDateRange(customText, dateFrom, dateTo)
Fügt ein konkreter Bereich ein. Parameter dateFrom/dateTo sind Javascript-Date-Objekte.
addConstDefinedLastDays(customText, days)
Fügt die Option „Letzte xyz Tage“ ein.
addConstDefinedMonth(customText, year, month)
Fügt ein konkreter konkreter Monat ein.
addConstDefinedQuarter(customText, year, quarter)
Fügt ein konkretes Quartal ein.
addConstDefinedYear(customText, year)
Fügt ein konkretes Jahr ein.
addUserDefinedDateRange(customText)
Fügt die Option, freier Bereich auszuwählen ein. Diese Option ist standardmäßog vordefiniert.
addUserDefinedLastDays(customText)
Fügt die Option, freie Anzahl von „Letzte Tage“ einzugeben ein.
clearFilterTypes()
Löscht alle Optionen. Anschließlich ist es möchlich eigene Optionen definieren.
focus()
Aktiviert das Element.
getDateFrom(), getDateTo()
Diese Funktionen geben Start und Enddatum als Javascript-Date-Objekt zurück.
Dies ist gültig, wenn isFilterDateRange() === true, d.h. die aktuelle Option ist:
-freier Bereich
-oder konkreter Monat
-oder konkretes Quartal
-oder konkretes Jahr
getDOMObject()
Gibt das Javascript-DOM-Objekt zurück.
getHeight(), getLeft(),getPosition(),getSize(), getTop(), getWidth(),setLeft(left),setPosition(left, top), setTop(top), setWidth(width)
getLastDays()
Gibt Anzahl von aktuellen „Letzte Tage“ Tagen.
Dies ist gültig, wenn isFilterLastDays() === true, d.h. die aktuellen Optionen sind:
-„Letzte Tage“ – fix vordefiniert
-„Letzte Tage“ – frei definiert
isFilterAll()
Gibt true zurück, wenn die aktuelle Option “alles” ist.
isFilterDateRange()
Gibt zurück, ob die aktuelle Option einen Datumbereich (frei, fix, Monat, Quartal, Jahr) ist.
isFilterLastDays()
Gibt zurück, ob die aktuelle Option von Art „Letzte Tage“ (fix oder frei) ist
show(bShow)
Zeigt oder versteckt das Objekt.
validateInputAndApply()
Diese Funktion kontroliert die Eingabe des Endbenutzers (sofern aktuell notwendig) und gibt entweder Javascript-null zurück, wenn alles korrekt ist oder gibt die fehlerhafte Eingabe zurück.
Ereignisse
onApply
Wird aufgerufen, wenn der Endbenutzer die Auswahl ändert.
Bei Optionen, die keine Endbenutzerinteraktion benötigen, wird es sofort aufgerufen.
Bei Optionen, die „Anzahl von letzten Tagen“ fordern, wird es nach drucken der Eingabetaste.
Beim freien Bereich wird es nach Auswahl von beiden Datume.