Customizen von Datumslistboxen

• Customizen von Datumslistboxen (Kalenderlistboxen) mit der Calendar Control-Funktion

Information

• Mit der Funktion Calendar Control können für Termindatenfelder spezielle Datumslistboxen(Kalenderlistboxen) gecustomized werden. Diese bieten die Möglichkeiten zum Navigieren an.
• Im PLANTA-Standard-System sind auf allen Eingabe-Terminfeldern Datumslistboxen mit Calendar Control hinterlegt

Vorgehensweise

• Den gewünschten Datenbereich im Modul Datenbereiche aufrufen.
• Für das gewünschte Terminfeld
  • DF-Verhalten = cc auswählen.
  • Es erscheint die Meldung Möchten Sie ein Template für das cc-Datenfeld einkopieren?
    • Ja: Es wird automatisch eine Vorlage einkopiert. Die Parameter im Feld Datenfeld-Konfiguration können angepasst werden.
    • Nein: Die Baumdarstellung des Datenfelds öffnen und im Feld Datenfeld-Konfiguration folgende Parameter definieren:

Befehl	Beschreibung	Zulässige Werte	Nicht zulässige Werte
def_start_date	Default-Anfangstermin	absolute Werte (Bsp.: "14.08.2009") Systemvariablen mit/ohne Operationen (Bsp.: "@123" oder "@123+10")	Dynamische Variablen Python-IDs
start_date	Anfangstermin	absolute Werte (z.B.: 14.08.2009) Systemvariablen mit/ohne Operationen dynamische Variablen mit/ohne Operationen (z.B.:@D123+15) Python-ID des Anfangstermin-Datenfeldes
def_end_date	Default-Endtermin	absolute Werte (Bsp.: "14.08.2009") Systemvariablen mit/ohne Operationen (Bsp.: "@123" oder "@123+10")	Dynamische Variablen Python-IDs
end_date	Endtermin	absolute Werte (z.B.: "14.08.2009") Systemvariablen mit/ohne Operationen dynamische Variablen mit/ohne Operationen (z.B.: "@D123+15") Python-ID des Endtermin-Datenfeldes
def_calendar	Default-Kalender-ID	Werte aus dem DI000305 Kalender aus der DT418 Kalender (Bsp: "BK") Systemvariablen (Bsp.: "@123")	Dynamische Variablen Python-IDs
calendar	Kalender-ID	Werte (Wert aus DI000305 Kalender aus der DT418 Kalender) Systemvariablen dynamischen Variablen (z.B.:@D123) Python-ID des Datenfeldes, das den Kalender bestimmt
def_selection_mode	Default-Auswahlmodus	Werte ("working", "non_working", "all") Systemvariablen	Dynamische Variablen oder Python-IDs
selection_mode	Auswahlmodus	Python-ID des Datenfeldes, das den Auswahlmodus bestimmt dynamische Variablen (z.B.:@D123) Systemvariablen Werte ("working", "non_working", "all")
xaml	XML-Dokument, mit einem Root-Element, welches XAML mit Einstellungen für Calendar Control enthält.

Details

• Jeder Parameter wird in einer neuen Zeile eingetragen.
• Aufbauschema: param_name=Wert
• Bei Default-Parametern gilt der eingetragene Wert für die gesamte Spalte.
• Bei Nicht-Default-Parametern gilt der eingetragene Wert ausschließlich für den entsprechenden Datensatz.
  • Falls beides eingetragen ist, übersteuern die Nicht-Default-Parameter die Default-Parameter.
• Alle Customizing-Einstellungen werden in einem String gespeichert: "attr1=Wert1;attr2=Wert2;..."
• Arbeitet man bei den Werten mit Variablen und addiert oder subtrahiert bestimmte Tageszahlen, muss darauf geachtet werden, dass vor und nach den Operatoren keine Leerzeichen eingetragen werden.
  • Bsp.: Der Eintrag "@D123 + 10" wird interpretiert wie "@D123", weil auf den Eintrag @D123 im ersten Fall ein Leerzeichen folgt.
• DI/DF-Python-IDs können nicht mit anderen Werten kombiniert werden.
  • Z.B.: "end_date=requested_end+10" wird nicht unterstützt, "end_date=requested_end" dagegen schon.

Beispiel

def_start_date=01.01.2009
def_end_date=01.01.2020
start_date = requested_start
end_date = 31.12.3000
xaml = <StackPanel 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <toolkit:Calendar xmlns:toolkit="clr-namespace:Microsoft.Windows.Controls;assembly=WPFToolkit" 
    Name="Calendar" 
    Margin ="0,-3, 0, -2" 
    DisplayDate="1/1/2009"
    DisplayDateEnd="1/31/2009"
    xmlns:sys="clr-namespace:System;assembly=mscorlib">
      <toolkit:Calendar.BlackoutDates>
        <toolkit:CalendarDateRange Start="1/2/2009" End="1/4/2009"/>
        <toolkit:CalendarDateRange Start="1/9/2009" End="1/9/2009"/>
        <toolkit:CalendarDateRange Start="1/16/2009" End="1/16/2009"/>
        <toolkit:CalendarDateRange Start="1/23/2009" End="1/25/2009"/>
        <toolkit:CalendarDateRange Start="1/30/2009" End="1/30/2009"/>
      </toolkit:Calendar.BlackoutDates>
    </toolkit:Calendar>
  </StackPanel>

Hinweise

• Vollständige Dokumentation zu Calendar Control finden sie unter: http://msdn.microsoft.com/en-us/library/system.windows.controls.calendar(VS.100).aspx

Listboxzwang

Information

• Genauso wie bei normalen Listboxen kann der Customizer bei den Datumslistboxen über den Parameter Listboxzwang bestimmen, dass nur Daten aus der Listbox übernommen werden können.
  • Das Programm prüft in diesem Fall die Gültigkeit.
    • Falls der Datenfeldeintrag nicht in der Listbox enthalten ist, wird es aus dem Feld entfernt. Der Benutzer muss die Eingabe wiederholen oder die Listbox öffnen und einen gültigen Wert auswählen.
    • Falls der Datenfeldeintrag in der Listbox enthalten ist, wird er übernommen.