Feldkonstanten¶

calServer stellt Platzhalter-Konstanten bereit, die in Feldvorgaben, Berichtsvorlagen und Mailer-Templates verwendet werden koennen. Die Konstanten werden zur Laufzeit durch die aktuellen Werte ersetzt.

Datum und Uhrzeit¶

Grundlegende Zeitstempel fuer die automatische Vorbelegung von Feldern:

Konstante	Beschreibung	Beispielwert
`[CURRENT_DATE]`	Aktuelles Datum	`2026-02-26`
`[CURRENT_TIME]`	Aktuelle Uhrzeit	`14:30:00`
`[CURRENT_DATETIME]`	Datum und Uhrzeit	`2026-02-26 14:30:00`
`[DUE_DATE]`	Faelligkeitsdatum (aus Konfiguration)	`2026-06-26`

Datumskomponenten¶

Einzelne Bestandteile des aktuellen Datums:

Konstante	Beschreibung
`[YYYY]`	Aktuelles Jahr (vierstellig)
`[MM]`	Aktueller Monat (zweistellig)
`[DD]`	Aktueller Tag (zweistellig)

Zeitraum-Konstanten¶

Vordefinierte Anfangs- und Enddaten fuer Berichtszeitraeume:

Konstante	Beschreibung
`[CURRENTMONTH_STARTDAY]`	Erster Tag des aktuellen Monats
`[CURRENTMONTH_ENDDAY]`	Letzter Tag des aktuellen Monats
`[LASTMONTH_STARTDAY]`	Erster Tag des Vormonats
`[LASTMONTH_ENDDAY]`	Letzter Tag des Vormonats
`[MONTHBEFORE_LASTMONTH_STARTDAY]`	Erster Tag des Vor-Vormonats
`[MONTHBEFORE_LASTMONTH_ENDDAY]`	Letzter Tag des Vor-Vormonats
`[CURRENTYEAR_STARTDAY]`	Erster Tag des aktuellen Jahres
`[CURRENTYEAR_ENDDAY]`	Letzter Tag des aktuellen Jahres

Datumsberechnungen¶

Das aktuelle Datum kann mit Offsets kombiniert werden. Die Syntax lautet:

[CURRENT_DATE]+[<Anzahl><Einheit>]
[CURRENT_DATE]-[<Anzahl><Einheit>]

Unterstuetzte Einheiten:

Einheit	Bedeutung	Beispiel
`D`	Tage	`[CURRENT_DATE]+[14D]` -- 14 Tage in der Zukunft
`M`	Monate	`[CURRENT_DATE]-[2M]` -- 2 Monate in der Vergangenheit
`Y`	Jahre	`[CURRENT_DATE]+[1Y]` -- 1 Jahr in der Zukunft

Status-Konstanten¶

Platzhalter fuer den aktuellen Status eines Datensatzes:

Konstante	Beschreibung
`[STATUS_NAME]`	Bezeichnung des Status
`[STATUS_SHORT]`	Kurzform des Status
`[STATUS_COUNT]`	Zaehler des Status

Zusaetzlich stehen Kategorie-Konstanten zur Verfuegung:

Konstante	Beschreibung
`[CATEGORY_NAME]`	Bezeichnung der Kategorie
`[CATEGORY_SHORT]`	Kurzform der Kategorie
`[CATEGORY_COUNT]`	Zaehler der Kategorie

Zaehler-Konstanten¶

Zwei globale Zaehler fuer fortlaufende Nummerierung:

Konstante	Beschreibung
`[GLOBAL_COUNTER_1]`	Globaler Zaehler 1
`[GLOBAL_COUNTER_2]`	Globaler Zaehler 2

Die Zaehler koennen ueber den CLI-Befehl ./yiic resetcounter run zurueckgesetzt werden.

Benutzer-Konstante¶

Konstante	Beschreibung
`[CURRENT_USER]`	Benutzername des aktuell angemeldeten Benutzers

Feldreferenz-Konstanten¶

Ueber Feldreferenz-Konstanten kann der Wert eines anderen Feldes desselben Datensatzes als Standardwert uebernommen werden.

I-Serie (Inventarfelder)¶

Die Konstanten [I4201] bis [I4262] referenzieren die konfigurierbaren Inventarfelder. Der Platzhalter wird durch den aktuellen Wert des jeweiligen Feldes im zugehoerigen Inventardatensatz ersetzt.

Beispiel: Wird [I4201] als Standardwert in einem Kalibrierfeld hinterlegt, wird bei der Anlage einer neuen Kalibrierung automatisch der Wert des Inventarfeldes I4201 (ueblicherweise die Geraetebezeichnung) uebernommen.

C-Serie (Kalibrierfelder)¶

Die Konstanten [C2301] bis [C2396] referenzieren die konfigurierbaren Kalibrierfelder nach demselben Prinzip.

E-Mail-Vorlagen-Konstanten¶

In E-Mail-Vorlagen stehen zusaetzliche Platzhalter bereit:

Konstante	Beschreibung
`[EMAIL]`	E-Mail-Adresse des Empfaengers
`[NAME]`	Benutzername
`[FIRSTNAME]`	Vorname
`[LASTNAME]`	Nachname
`[FULLNAME]`	Vollstaendiger Name
`[FIRM]`	Firmenbezeichnung
`[NUMBER]`	Geraete- oder Auftragsnummer
`[STATUS]`	Aktueller Status
`[DOMAIN]`	Domain der calServer-Instanz

Verwendung¶

Konstanten werden in folgenden Bereichen eingesetzt:

Feldvorgaben -- Standardwerte in der Feldkonfiguration (Administration > Feldverwaltung)
Berichtsvorlagen -- Parameter in JasperReports-Vorlagen
E-Mail-Vorlagen -- Platzhalter in Betreff und Nachrichtentext von Mailer-Aktionen
Regeln -- Bedingungen und Aktionen in der Regelverarbeitung

Die Konfiguration der Feldkonstanten erfolgt in httpdocs/protected/config/constants.php im Array field_configuration_default_value.