Vorheriges Thema: Einfache Variablen

Nächstes Thema: Umgebungsvariablen

Eigenschaftsvariablen

Eigenschaftsvariablen stellen eine Eigenschaft der Konfigurationsdatei "web.cfg" dar. In einer HTML-Vorlagendatei können Sie auf alle Einträge in der Datei "web.cfg" zugreifen (einschließlich anwenderspezifische Einträge), indem Sie das Präfix "$prop" voranstellen.

Eine der Zeilen in der Datei "web.cfg", die z. B. die Anzahl an Einträgen angibt, die auf einer einzelnen Seite in einem Listenformular angezeigt werden, lautet folgendermaßen:

ListPageLength 10

Sie können in einer HTML-Vorlage auf diese Variable mit der folgenden Spezifikation verweisen:

$prop.ListPageLength

Wenn Sie das besondere Tag <PDM_INCLUDE> verwenden, um eine andere Datei in eine Vorlagendatei zu integrieren, können Sie zusätzliche Eigenschaften als Attribute des <PDM_INCLUDE>-Tags angeben. Sie können auf diese Eigenschaften in der eingeschlossenen Datei auf dieselbe Art verweisen wie auf die Eigenschaften in der Datei "web.cfg". Eine Eigenschaft, die als <PDM_INCLUDE>-Attribut angegeben wird, das denselben Namen wie die Eigenschaft web.cfg aufweist, setzt die Eigenschaft web.cfg in der eingeschlossenen Datei außer Kraft.

So erstellt z. B. das folgende <PDM_INCLUDE>-Tag die Eigenschaft $prop.menubar, auf die innerhalb der Datei "std_body.htmpl" verwiesen werden kann:

<PDM_INCLUDE FILE=std_body.htmpl menubar=no>

Hinweis: Zum Referenzieren auf die Konfigurationsdateieigenschaft xxx gibt es zwei Möglichkeiten: $prop.xxx oder $SESSION.xxx. Beide geben den gleichen Wert zurück. Die Syntax $prop.xxx Syntax wird jedoch bevorzugt, da weniger Serveraufwand anfällt.

Neben den Eigenschaften in der Datei "web.cfg" sind mehrere vordefinierte Eigenschaften verfügbar, auf die mit $prop zugegriffen werden kann. Diese sind:

$prop.browser

Eine Zeichenfolge, die den verwendeten Server identifiziert. Für den Internet Explorer lautet diese Zeichenfolge „IE“.

$prop.combo_name

Eine Zeichenfolge im Format „last_name, first_name middle_name“, die den Namen des aktuellen Anwenders enthält.

$prop.factory

Eine Zeichenfolge, welche die Factory enthält, die dem aktuellen Formular zugeordnet ist, wie z. B. "cr" für Requests und "Iss" für Issues.

$prop.FID

Eine Zeichenfolge, welche die numerische Formular-ID des aktuellen Formulars enthält.

$prop.form_name

Eine Zeichenfolge, die den Namen der aktuellen HTML-Vorlage im Format xxx.htmpl enthält.

$prop.form_name_1

Eine Zeichenfolge, welche die Teilkette des Formularnamens vor dem ersten Unterstrich enthält. Für das Formular detail_chg_edit.htmpl würde form_name_1 beispielsweise „detail“ lauten.

$prop.form_name_2

Eine Zeichenfolge, welche die Teilkette des Formularnamens nach dem ersten und vor dem letzten Unterstrich (oder Punkt) enthält. Für das Formular detail_chg_edit.htmpl würde form_name_2 beispielsweise „chg“ lauten.

$prop.form_name_3

Eine Zeichenfolge, welche die Teilkette des Formularnamens nach dem letzten Unterstrich und vor dem Punkt enthält. Für das Formular "detail_chg_edit.htmpl" würde "form_name_3" beispielsweise "edit" lauten. Für das kombinierte Detailformular, dessen Dateiname das Format "detail_ hatxxx.htmpl" aufweist, ist "$prop.form_name_3" auf die aktuelle Ansicht eingestellt (entweder "ro" oder "edit".

$prop.release

Eine Zeichenfolge, welche die Versionsstufe des Formulars enthält. Die Anweisung PDM_PRAGMA enthält weitere Details zu dieser Eigenschaft.

$prop.SID

Eine Zeichenfolge, welche die numerische Sitzungs-ID der aktuellen Sitzung enthält.

$prop.sitemod

Eine Zeichenfolge, die den standortdefinierten Änderungsnamen des Formulars enthält. Die Anweisung PDM_PRAGMA enthält weitere Details zu dieser Eigenschaft.

$prop.user_type

Eine Zeichenfolge, die „analyst“, „customer“, „employee“ oder „guest“ enthält.

$prop.version

Eine Zeichenfolge, welche die Version des Formulars enthält. Die Anweisung PDM_PRAGMA enthält weitere Details zu dieser Eigenschaft.

Weitere Informationen:

PDM_PRAGMA: Angeben von Serverinformationen