HTMPL-Tags

Dieser Artikel enthält die folgenden Themen:
casm173
Dieser Artikel enthält die folgenden Themen:
Dieser Abschnitt beschreibt PDM-Befehle, um HTMPL-Tags hinzuzufügen.
PDM_EVAL – Einfügen des Werts einer Präprozessorvariablen
Das pdm_eval-Tag wird verwendet, um den Wert einer Vorverarbeitungvariablen in die Eingabe des Webmodul-Parsers einzufügen. Wenn das Tag in einem Makro verwendet wird, wird es erst wirksam, wenn das Makro abgeschlossen ist.
Das pdm_eval-Tag ähnelt pdm_include oder pdm_macro in seiner Funktionsweise. Es fügt den Text exakt an dem Punkt des Tags in die Analyse ein, so als ob der Wert der Variablen anstelle des Tags kodiert wurde..
pdm_eval weist die folgende Syntax auf:
<PDM_EVAL TEXT=PRE.name>
  • Name
    (Erforderlich) Der Name der Vorverarbeitungsvariablen, dessen Wert in die Eingabe des Webmoduls einzufügen ist.
PDM_FORM – Starten eines HTML-Formulars mit einer Sitzungs-ID
Die Tags und können zu jeder beliebigen Web-Schnittstellen-HTML-Vorlage hinzugefügt werden, um ein HTML-Formular mit zwei ausgeblendeten Feldern für die Servervariablen SID (Sitzungs-ID) und FID (Formular-ID) zu erstellen. Der optional OP-Operand erstellt wie mit dem PDM_LINK-Tag ein zusätzliches ausgeblendetes Feld für eine der unterstützten Operationen . Mit Ausnahme der automatisch generierten ausgeblendeten Felder werden die Tags <PDM_FORM> und </PDM_FORM> auf dieselbe Weise wie die Standard-HTML-Tags <form> und </form> verwendet (und als Teil ihrer Erweiterung generiert).
PDM_FMT – Formatieren von Text einer Servervariablen
Die Tags <PDM_FMT> und </PDM_FMT> werden zum Formatieren von Textblöcken verwendet, die von Servervariablen ($args.xxx) anhand von Argumenten eingefügt werden.
<PDM_FMT> wird für Literale einschließlich der Variablen "$prop.xxx" ignoriert.
In der nachstehenden Tabelle werden die folgenden Tags erläutert:
Eigenschaft
Beschreibung
ESC_STYLE=
NONE
|
C |
HTML
JS |
JS2 |
URL
Gibt den Umwandlungstyp des formatierten Texts an. Gültige Werte sind:
KEINE
Standardeinstellung. Gibt an, dass für kein Zeichen im Textkörper eine besondere Behandlung erforderlich ist.
C
Behandeln Sie die in C-Programmen bedeutungsvollen Zeichen ', ", \, \r, ` und \n auf besondere Weise. Diese Zeichen werden umgewandelt.
HTML
Folgende Zeichen sind in HTML-Text von besonderer Bedeutung und erfordern daher eine besondere Behandlung:
& wird &amp;
' wird zu '
” wird zu "
< wird <
> wird &gt;
JS
Folgende Zeichen sind in JavaScript-Text von besonderer Bedeutung und erfordern daher eine besondere Behandlung:
' wird zu %27
" wird zu %22
/ wird zu %2F
\ wird zu %5C
\r wird zu %0D
\n wird zu %0A
JS2
Entspricht JS, keine besondere Behandlung des Zeichens, /, und besondere Behandlung von zwei zusätzlichen Zeichen:
- % wird zu %25
- Zeilenumbrüche erhalten das Suffix %0A.
URL
Übersetzen Sie alle Zeichen, die keine Buchstaben oder Ziffern sind, sowie '@*-_.#' bis '%xx', wobei xx eine hexadezimale Kodierung des übersetzten Zeichens ist.
JUSTIFY=LEFT |
CENTER |
RIGHT |
TRUNCATE
|
WRAP |
LIN
Gibt die Ausrichtung des formatierten Textes an. Gültige Werte lauten:
TRUNCATE
Standardeinstellung. Entfernt die HTML-Formatierung, indem "<" und ">" durch "<" und ">" ersetzt werden.
Hinweis:
Weitere Informationen finden Sie unter KEEPLINKS und KEEPTAGS.
LEFT|CENTER|RIGHT
Stellt genau die durch das Argument WIDTH angegebene Breite an Zeichen her, je nach Bedarf gekürzt oder mit Leerzeichen aufgefüllt, wobei eingebettete neue Zeilen durch ein Leerzeichen ersetzt werden und der Ausgabetext durch die Tags <pre> und </pre> begrenzt wird. Das Argument WIDTH muss als positive Ganzzahl angegeben werden.
WRAP
Gleiche Eigenschaft wie LEFT, mit Ausnahme dass beim Textumbruch Wörter berücksichtigt werden (d. h. kein Zeilenumbruch innerhalb eines Worts).
LINE
Entspricht TRUNCATE mit der Ausnahme, dass alle eingebetteten Zeilenumbrüche durch das Tag <br> ersetzt werden.
KEEPLINKS=YES|
NO
Wenn KEEPLINKS=YES angegeben ist, wird die Aktion JUSTIFY=LINE oder JUSTIFY=TRUNCATE geändert, um die HTML-Anchor-Tags () zu bewahren, während alle anderen „<“- und „>“-Zeichen konvertiert werden. Gegenseitig austauschbar mit KEEPTAGS.
KEEPNL=YES|
NO
Die normale Aktion von PDM_FMT soll alle eingebetteten Zeilenvorschübe und alle folgenden Leerzeichen in ein einzelnes Leerzeichen umwandeln. Wenn KEEPNL=YES angegeben ist, werden eingebettete Zeilenvorschübe beibehalten. Dieses Argument wird für JUSTIFY=LINE ignoriert.
KEEPTAGS=YES|
NO
Wenn KEEPTAGS=YES angegeben ist, wird die Aktion JUSTIFY=LINE oder JUSTIFY=TRUNCATE modifiziert, sodass alle HTML-Tags zu beibehalten werden. Gegenseitig austauschbar mit KEEPLINKS.
PAD=
YES
|NO
Wenn PAD=NO angegeben ist, wandelt PDM_FMT leere Zeichenfolgen nicht zu einem einzelnen Leerzeichen um. Dies ist die normale Aktion, wenn WIDTH nicht null ist, oder JUSTIFY TRUNCATE oder WRAP ist.
WIDTH=
nn
Wenn diese Eigenschaft nicht null ist, gibt sie an, dass der Text genau auf die für WIDTH angegeben Zeichen formatiert werden soll.
ohne WIDTH oder JUSTIFY führt keine Formatierung an dem eingeschlossenen Text durch, umgibt den Text jedoch mit den Tags [set the pre variable for your book] und .
Um z. B eine mehrzeilige Beschreibung zu erstellen, geben Sie Folgendes ein:
<PDM_FMT WIDTH=50 JUSTIFY=WRAP>$args.description</PDM_FMT>
Um eine Ausgabe mit mehreren Spalten zu erstellen, geben Sie Folgendes ein:
<PDM_FMT><PDM_FMT WIDTH=20 JUSTIFY=LEFT>$cst.last_name</PDM_FMT> <PDM_FMT WIDTH=20 JUSTIFY=LEFT>$cst.first_name</PDM_FMT> <PDM_FMT WIDTH=20 JUSTIFY=TRUNCATE>$cst.middle_name</PDM_FMT> </PDM_FMT>
PDM_IF – Bedingte Verarbeitung
Diese Tags werden für das bedingte Einfügen von Text verwendet. -Blöcke können an beliebiger Stelle in HTMPL-Dateien eingefügt werden – in HTML, in JavaScript und sogar innerhalb von HTML-Tags. und (else If) übernehmen beide einen einfachen Bedingungssatz als Eigenschaften anstelle Name-Wert-Paare. Wenn die Klausel wahr ist, wird der Text nach dem schließenden Tag in die Datei eingeschlossen. Wenn die Klausel falsch ist, verwirft der Server den Text zwischen dem Tag und dem schließenden Tag. Das schließende Tag kann <PDM_ELIF>, <PDM_ELSE> oder </PDM_IF> sein.
Die Tags <PDM_ELSE> und <PDM_ELIF> sind optional. Wenn beide angegeben sind, müssen die <PDM_ELIF>-Tags dem <PDM_ELSE>-Tag voranstehen. Zwischen den Tags <PDM_IF> und <PDM_ELSE> (oder </PDM_IF>, wenn <PDM_ELSE> ausgelassen wird) kann eine beliebige Anzahl an <PDM_ELIF>-Tags stehen.
Die Syntax der Bedingung in <PDM_IF> und <PDM_ELIF> lautet folgendermaßen:
  • 0 is false; any other number is true
  • ““ ist "false"; “
    any
    -
    string
    ” ist "true"
  • "
    value op value
    " vergleicht den linken und den rechten Wert gemäß
    Operator
    . Wenn beide Werte aus Ziffern bestehen (der optional - oder + vorausgeht), wird der Vergleich auf numerische Weise ausgeführt. Andernfalls wird er lexikalisch (ASCII-Sortierreihenfolge) ausgeführt. Zu den gültigen
    Operator
    werten gehören:
op-Wert
Beschreibung
==
Gleich
!=
Ungleich
>=
Gleich oder größer als (muss als \>= oder >= geschrieben werden)
<
Weniger als (muss als \< oder < geschrieben werden)
>
Größer als (muss als \> oder > geschrieben werden)
<=
Gleich oder kleiner als (muss als \<= oder <= geschrieben werden)
&
Führt die Funktion Bit-And des linken und rechten Wertes aus. Wahr, wenn Bits festgelegt sind, falsch, wenn keine festgelegt sind.
%
Gibt "true" zurück, wenn der linke Wert ein gerades Vielfaches des rechten Wertes ist. Andernfalls wird "false" zurückgegeben (nützlich für das Erstellen von zweidimensionalen Tabellen).
:
Führt einen byteorientierten Suchmustervergleich wie den Grep-Befehl unter UNIX durch. Gibt „true“ zurück, wenn der linke Wert den regulären Ausdruck enthält, der vom rechten Wert definiert wird.
Beispiel:
<PDM_IF $count \>= 10> . . . <PDM_ELIF $count &#60; 5> . . . <PDM_ELSE> . . . </PDM_IF>
In PDM_IF_Anweisungen können mehrere Bedingungen angegeben sein. Bedingungen werden durch Konnektoren (entweder && (und) oder || (oder)) voneinander getrennt. Beiden Verbindungen muss nichts vorausgehen. Die Web-Engine untersucht Bedingungen von links nach rechts, bis eine Verbindung erreicht wird. Wenn die Ausgangsbedingung wahr und der Verbinder || ist, gilt die gesamte Bedingung ohne weitere Auswertung als wahr. Wenn die Ausgangsbedingung falsch und der Verbinder && ist, gilt die gesamte Bedingung ohne weitere Auswertung als falsch. Andernfalls gilt die Bedingung für das Webmodul als unbestimmt. In diesem Fall wertet das Webmodul die Bedingung ab dem Konnektor aus.
PDM_INCLUDE – Einfügen aus einer anderen Datei
Das <PDM_INCLUDE>-Tag wird verwendet, um Text aus einer zweiten Datei in eine HTMPL-Datei einzufügen. Der Server ersetzt das <PDM_INCLUDE>-Tag durch den Inhalt der zweiten Datei.
Eingeschlossene Dateien können <PDM_INCLUDE>-Tags enthalten. Es gibt keine Einschränkung für die Tiefe der Verschachtelung.
Das <PDM_INCLUDE>-Tag unterstützt die folgenden Eigenschaften:
Eigenschaft
Beschreibung
FILE=filename
(Erforderlich) Gibt die einzuschließende Datei an. Das Webmodul durchsucht die für HTMPL-Dateien verwendeten Verzeichnisse, die für den Zugriffstyp des aktuellen Anwenders definiert sind.
FIXUP=[
YES|
NO]
(Optional) Gibt an, ob die Datei von der Web-Schnittstelle als normale HTML-Vorlagendatei interpretiert werden soll, sodass Variablen, die mit einem Dollarzeichen ($) beginnen, erweitert und andere CA SDM -Tags wie PDM_LIST und PDM_FORMAT interpretiert werden. Der Wert YES gibt an, dass die Datei als reguläre HTML-Vorlagendatei behandelt werden soll, und der Wert NO gibt an, dass die eingeschlossene Datei wie Text behandelt werden soll. Der Standardwert lautet YES.
Hinweis:
Damit diese Version mit vorherigen Versionen kompatibel ist, kann der Wert JA durch WAHR oder 1 und der Wert NEIN durch FALSCH oder 0 ersetzt werden. Diese Werte sind veraltet und sollten nicht in neuen Seiten verwendet werden.
propname=value
Gibt an, dass die Eigenschaft „propname“ den angegebenen Wert aufweisen sollte. Auf den Wert der Eigenschaft kann innerhalb der eingeschlossenen Datei zugegriffen werden, indem propname das Präfix $prop vorangestellt wird. Mit der folgenden Spezifikation kann z. B. die eingeschlossene Datei auf $prop.menubar: verweisen:
Globale Eigenschaften können auch in der web.cfg-Konfigurationsdatei angegeben werden. Informationen zu "web.cfg" finden Sie unter Konfigurieren der Webschnittstelle.
Hinweis:
Damit diese Version mit vorherigen Versionen kompatibel ist, können die in <PDM_INCLUDE> angegebenen Eigenschaftswerte ohne das vorangehende "prop" im Format $propname referenziert werden. Diese Verwendung ist veraltet und sollte nicht auf neuen Seiten verwendet werden.
PDM_JSCRIPT – Bedingtes Einschließen von JavaScript-Dateien
Das <PDM_JSCRIPT>-Tag wird verwendet, um eine JavaScript-Datei bedingt in ein Formular einzuschließen. Dieses Tag weist zwei Formate auf:
<PDM_JSCRIPT file=xxxx.js [include=yes|no]>
Pdm_jscript mit file=xxx.js gibt an, dass die JavaScript-Datei "xxx.js" in diesem Formular erforderlich ist. Das Webmodul fügt diese Datei zu einer Liste von JavaScript-Dateien hinzu, die für das Formular erforderlich sind. Die Verarbeitung des Tags findet statt, während das Formular geprüft wird. Sie wird von pdm_if nicht beeinflusst. Ein pdm_jscript-Tag, das auf eine Datei verweist, fügt diese Datei zu der Liste von JavaScript-Dateien hinzu, wenn sie irgendwo in der Datei oder in einer eingeschlossenen Datei oder in einem Makro auftritt.
Das optionale Argument
include=no
kann angegeben werden, wenn die Web-Engine das Tag ignorieren soll. Dieses Argument führt zu einer bedingten Verarbeitung des Tags und ist in erster Linie hilfreich, wenn das Tag in einem Makro aufgerufen wird. Das Makro "dtlTextbox" gibt z. B Folgendes an:
<PDM_JSCRIPT file=spellcheck.js include=&{spellchk}>
Hiermit wird angegeben, dass für jedes beliebige Formular, das ein dtlTextbox-Makro enthält, das spellchk=yes angibt, die JavaScript Datei "spellcheck.js" erforderlich ist.
Das zweite Format des Tags "pdm_jscript" lautet:
<PDM_JSCRIPT insert=here>
"Pdm_jscript" mit "insert=here" fordert die Web-Engine auf, Standard-HTML-<script>-Tags für alle erforderlichen JavaScript-Dateien einzufügen. Das Webmodul verarbeitet diese Form von Tag während der Phase der HTML-Generierung, so dass es von pdm_if beeinflusst wird. Ein pdm_jscript-Tag mit insert=here ist Teil der Datei "std_head_include.htmpl", so dass es auf praktisch jedem Formular verfügbar ist.
Die Web-Engine fügt Skripttags nur ein, wenn es das erste Mal auf "pdm_jscript insert=here" stößt.
PDM_LINK – Erstellen eines Hyperlinks, der einen HTMPL-Vorgang aufruft
und kann zu jeder beliebigen HTML-Vorlage für Web-Schnittstellen hinzugefügt werden, um Verknüpfungen zu erstellen, die einen HTMPL-Vorgang aufrufen. Das <PDM_LINK>-Tag generiert das Standard-HTML-Tag <a href=...> und weist identische Argumente auf, mit der Ausnahme, dass die Spezifikation eines CA SDM-Vorgangs anstelle einer URL möglich ist.
Das Format lautet folgendermaßen, wobei
operation
einer der unterstützten Operationen entspricht:
<PDM_LINK OP=operation> ... </PDM_LINK>
Beispiel:
<PDM_LINK OP=MENU> Menu </PDM_LINK> <PDM_LINK OP=CREATE_NEW FACTORY=iss> Submit Issue </PDM_LINK> <PDM_LINK OP=LOGOUT> Logout </PDM_LINK>
PDM_LIST – Formatieren einer Liste mit Datenbankzeilen
Die Tags <PDM_LIST> and </PDM_LIST> werden verwendet, um sich wiederholende HTML-Abschnitte für die Ausgabe von mehreren Datensätzen voneinander zu trennen. Alles zwischen den Tags <PDM_LIST> und </PDM_LIST> wird einmal für jeden auszugebenden Datensatz wiederholt. Es gibt zwei Arten des Tags PDM_LIST:
  • Listen von einem Objektattribut, das eine Liste impliziert. So entspricht z. B. das Eigenschaftsattribut des Request-Objekts der Liste mit Eigenschaften, die dem Request zugeordnet sind. Dieser Typ des Tags PDM_LIST verfügt immer über eine SOURCE-Eigenschaft.
  • Listen mit einer expliziten WHERE-Klausel. Dieser Typ des Tags PDM_LIST verfügt immer über eine WHERE-Eigenschaft.
Objektattribute vom Typ <PDM_LIST> weisen folgende Eigenschaften auf:
Eigenschaft
Beschreibung
ESC_STYLE=
NONE
|
C |
HTML
JS |
JS2 |
URL
Gibt den Umwandlungstyp des formatierten Texts an. Gültige Werte sind:
NONE
Standardeinstellung. Gibt an, dass für kein Zeichen im Textkörper eine besondere Behandlung erforderlich ist.
C
Behandeln Sie die in C-Programmen bedeutungsvollen Zeichen ', ", \, \r, ` und \n auf besondere Weise. Diese Zeichen werden umgewandelt.
HTML
Folgende Zeichen sind in HTML-Text von besonderer Bedeutung und erfordern daher eine besondere Behandlung:
& wird zu &amp; -- ' wird zu &apos; -- " wird zu &quot; -- < wird zu &lt; -- > wird zu &gt;
JS
Folgende Zeichen sind in JavaScript-Text von besonderer Bedeutung und erfordern daher eine besondere Behandlung:
' wird zu %27" wird zu %22/ wird zu %2F\ wird zu %5C\r wird zu %0D\n wird zu %0A
JS2
Entspricht JS, keine besondere Behandlung des Zeichens, /, und besondere Behandlung von zwei zusätzlichen Zeichen:
- % wird zu %25
- Zeilenumbrüche erhalten das Suffix %0A.
URL
Übersetzen Sie alle Zeichen, die keine Buchstaben oder Ziffern sind, sowie '@*-_.#' bis '%xx', wobei xx eine hexadezimale Kodierung des übersetzten Zeichens ist.
LENGTH=
nn
Gibt die Anzahl der Zeilen der Ausgabe an (wird standardmäßig auf „alle“ gesetzt).
PREFIX=
prefix
Gibt das Präfix zu Referenzen auf Attribute aus Datensätzen in der Liste an. Diese werden in der Form
$prefix.attr_name
im Text zwischen <PDM_LIST> und </PDM_LIST> referenziert. Die Eigenschaft PREFIX ist in Listen mit Objektvariablen optional. Wenn PREFIX ausgelassen ist, wird der Wert von SOURCE auch für das Präfix verwendet.
SEARCH_TYPE=DISPLAY|
GET_DOB
Gibt die Methode an, die der Server zum Erstellen des Listenformulars verwenden soll:
DISPLAY gibt an, dass der Server nur eine Abfrage für das gesamte Formular ausgeben soll.
GET_DOB gibt an, dass der Server separate Abfragen für jede Zeile des Formulars ausgeben soll.
Die Auswahl beeinflusst die Listenleistung, die ebenfalls von der Komplexität (der Anzahl an Verbindungen, die für die Anzeige erforderlich sind) der Liste und den Merkmalen der DBMS abhängt. GET_DOB hat eine voraussagbarere Leistung als DISPLAY und ist der Standardwert.
SORT=
index
-
name
Gibt den Indexnamen an, der zum Sortieren verwendet wird. Der Standardwert für dieses Argument lautet DEFAULT (d. h., der erste Sortierindex für die zu Grunde liegende Factory).
SOURCE=
source
Gibt die Objektvariable an, die diese Liste definiert. Dieses Feld erfordert eine Eingabe. Fügen Sie in der PDM_LIST-Anweisung kein Dollarzeichen ($) vor
source
ein. Wenn die Eigenschaft PREFIX nicht angegeben ist, wird
source
auch als Präfix für Verweise auf Attribute von Datensätzen in der Liste verwendet, in Verweisen mit dem Format
$source
.
attr_name
. Wenn
source
in einem Verweis verwendet wird, ist ein vorangestelltes Dollarzeichen erforderlich.
START=
nn
Gibt die erste Ausgabezeile an (wird standardmäßig auf null gesetzt).
Beispiel:
<table border> <tr> <th>Child Change Order Number</th> <th>Summary</th> </tr> <PDM_LIST SOURCE=args.children> <tr> [assign the value for TD in your book]$args.children.chg_ref_num</td> [assign the value for TD in your book]$args.children.summary</td> </tr> </PDM_LIST> </table>
Da kein Präfix angegeben wurde, wird Referenzen auf Attribute der aufgeführten Datensätze das Präfix $args.children, der Quellwert, vorangestellt.
In einer WHERE-Klausel weist PDM_LIST die folgenden Eigenschaften auf:
Eigenschaft
Beschreibung
FACTORY=
name
Gibt eine zu suchende Objektklasse an. Diese Eigenschaft ist erforderlich.
LENGTH=
nn
Gibt die Anzahl der Zeilen der Ausgabe an (wird standardmäßig auf „alle“ gesetzt).
ORDER_BY=
attr-name
Geben Sie den Attributnamen an, nach dem sortiert werden soll. Es kann den Modifizierer DESC (absteigend) oder ASC (aufsteigend) enthalten.
PREFIX=
prefix
Gibt das Präfix zu Referenzen auf Attribute aus Datensätzen in der Liste an. Diese werden in der Form
$prefix
.
attr_name
im Text zwischen <PDM_LIST> und </PDM_LIST> referenziert. Die Eigenschaft PREFIX ist in einer WHERE-Klausel-Liste erforderlich.
START=
nn
Gibt die erste Ausgabezeile an (wird standardmäßig auf null gesetzt).
WHERE=
where-clause
Geben Sie die WHERE-Klausel für die Suche an. Sie kann Attribute (mit Punkten) enthalten. Diese Eigenschaft ist erforderlich.
Beispiel:
<table> <tr> <th>Child Change Order Number</th> <th>Summary</th> </tr> <PDM_LIST PREFIX=list FACTORY=chg WHERE="status = 'OP'"> <tr> [assign the value for TD in your book]$list.chg_ref_num</td> [assign the value for TD in your book]$list.summary</td> </tr> </PDM_LIST> </table>
PDM_NOTEBOOK – Erstellen eines Notizbuchs
In zahlreichen Formularen in der CA SDM-Analytikerschnittstelle werden verschachtelte Registerkarten (Notizbücher) verwendet. Mit verschachtelten Registerkarten können Sie mehrere Gruppen von Feldern in demselben physischen Bereich des Bildschirms anzeigen, wobei immer nur eine Gruppe zu sehen ist. Der Anwender wählt die Feldergruppe aus, die sichtbar ist, indem er oben im Notizbuch auf eine Registerkarte klickt oder indem er die Tastenkombination Alt+
n
drückt, wobei
n
der Nummer der Registerkarte entspricht. Ein Beispiel für ein Formular, in dem ein Notizbuch verwendet wird, ist "Issue-Detail" (detail_iss.htmpl). Es wird empfohlen, für Änderungen am Inhalt der Notizbücher den WSP zu verwenden oder ein Notizbuch in ein Formular einzufügen, das noch kein Notizbuch enthält.
Das folgende Tag markiert das Ende eines Notizbuchs:
<PDM_MACRO name=endNotebook>
PDM_PRAGMA – Angeben von Serverinformationen
Das <PDM_PRAGMA>-Tag wird zum Angeben von Informationen verwendet, die vom Webmodul verwendet werden (z. B. die Version). Es generiert keinen HTML-Code, und kann in einem Formular an einer beliebigen Stelle platziert werden. Mögliche Argumente sind:
Argument
Beschreibung
RELEASE=value
Gibt die CA SDM-Versionsnummer an, die diesem Formular entspricht. Dieser Wert ist "110" für alle Formulare von CA Service Desk Manager r11.0. Im Formular kann mit der Variablen „$prop.release“ auf diesen Wert zugegriffen werden.
SITEMOD=value
Gibt eine standortdefinierte Zeichenfolge an, welche die Änderungen identifiziert, die in diesem Formular durchgeführt wurden. Im Formular kann mit der Variablen „$prop.sitemod“ auf diesen Wert zugegriffen werden.
VERSION=value
Gibt eine von CA Technologies definierte Zeichenfolge an, welche die Versionsnummer des Formulars identifiziert. Im Formular kann mit der Variablen „$prop.version“ auf diesen Wert zugegriffen werden.
OVERIDE=YES|
NO
Gibt an, ob Werte in dieser PDM_PRAGMA-Anweisung die Werte in vorherigen PDM_PRAGMA-Anweisungen außer Kraft setzen.
CA Technologies verwendet PDM_PRAGMA-Anweisungen, um Formularversionen zu dokumentieren. Alle Formulare von CA Service Desk Manager r11.0 enthalten die folgende PDM_PRAGMA-Anweisung:
<PDM_PRAGMA RELEASE=110>
Darüber hinaus schließt das Formular std_head.htmpl die folgende JavaScript-Anweisung ein:
cfgFormRelease = "$prop.release" - 0;
Mithilfe der PDM_PRAGMA-Anweisung und der Variablen "cfgFormRelease" kann die CA SDM-Web-Schnittstelle Formulare von CA Service Desk Manager r11.0 von Formularen früherer Versionen unterscheiden. Versionen vor CA Service Desk Manager r6.0 haben die PDM_PRAGMA-Anweisung nicht unterstützt.
Normalerweise werden nur PDM_PRAGMA-Anweisungen auf der höchsten Ebene einer Datei im Formular (d. h. eine, die nich mit PDM_INCLUDE eingefügt wurde) verwendet, um "$prop.release", "$prop.sitemod" und "$prop.version" festzulegen. Darüber hinaus setzt keine PDM_PRAGMA-Anweisung einen nicht leeren Wertesatz einer vorherigen PDM_PRAGMA-Anweisung außer Kraft. Sie können OVERRIDE=YES angeben, um festzulegen, dass eine PDM_PRAGMA-Anweisung vorherige PDM_PRAGMA-Anweisungen außer Kraft setzen kann oder dass eine PDM_PRAGMA-Anweisung in einer eingeschlossenen Datei verwendet werden kann.
PDM_SCOREBOARD – Erstellen einer Scoreboard-Struktur
Das <PDM_SCOREBOARD>-Tag wird verwendet, um das Scoreboard zu generieren, das auf der linken Seite des Hauptformulars angezeigt wird. Es nimmt folgende Eigenschaften an:
  • TARGET=
    value
    Gibt den Namen des Ziel-Frames für Listen an, der durch Klicken auf einen Knoten im Scoreboard angefordert wird. Listen werden im angegebenen Ziel geladen, wobei es sich um einen beliebigen Wert handeln kann, der für das Zielattribut einer Verknüpfung unterstützt wird. Der Standardwert ist
    _self
    (das Fenster, das das PDM_SCOREBOARD-Tag enthält).
Jedes beliebige HTMPL-Formular, das ein <PDM_SCOREBOARD>-Tag einschließt, muss auch die JavaScript-Datei "fldrtree. js" einschließen. Diese Datei kann mit der folgenden Anweisung im <HEAD-Abschnitt des Formulars eingeschlossen werden:
<SCRIPT LANGUAGE="JavaScript" SRC="$CAisd/CAisd/fldrtree.js"></SCRIPT>
Darüber hinaus ist es wünschenswert, die Verknüpfung scoreboard_asof_data einzuschließen, um die Datierung der Zahlen in der Baumstruktur anzuzeigen. Ein Beispiel für die Verwendung dieses Tags finden Sie in der verteilten Datei "scoreboard.htmpl".
Die Abfragen, die in das Scoreboard eingeschlossen werden, werden durch den Inhalt der Tabelle „User_Query“ (Objektname usq) für den aktuellen Anwender definiert. Ein Datensatz in dieser Tabelle definiert jede Zeile im Baum (Ordner oder Knoten).
Ursprünglich weisen Anwender keine Einträge in der Tabelle „User_Query“ auf. Ein Anwender ohne Einträge in der Tabelle „User_Query“ empfängt den Standardsatz der Scoreboard-Abfragen, die seinem Zugriffstyp zugeordnet sind. Ein Anwender mit administrativer Autorität kann auch das Standard-Scoreboard für einen Zugriffstyp anpassen.
PDM_SET – Einstellen des Werts einer Servervariablen
Das
<PDM_SET>
-Tag wird für Ganzzahl-basierte arithmetische Operationen wie Hinzufügungen (Beispiel:
<PDM_SET args.z_counter=$args.z_counter + 1>
) nicht unterstützt.
Es wird nur unterstützt, um eine Zeichenfolgeneigenschaft und eine Zeichenfolgenverkettungsoperation festzulegen.
Das <PDM_SET>-Tag wird verwendet, um einer Servervariablen einen Wert zuzuordnen. Sie hat die folgende Syntax:
<PDM_SET arg.name[+]=value>
  • Argument
    (Erforderlich) Gibt den veränderlichen Typ an und muss arg zur normalen Verwendung sein.
    Es ist kein $-Zeichen vorhanden.
  • Name
    (Erforderlich) Gibt den Namen der Variablen an.
  • +
    (Optional) Gibt an, dass der Wert an den vorhandenen Wert der Variablen angehängt werden sollte. Davor und danach dürfen keine Leerzeichen sein.
  • =
    (Erforderlich) Muss genau wie gezeigt angegeben werden, ohne Leerzeichen davor und danach.
  • Wert
    (Erforderlich) Gibt den Text an, welcher der Variablen zugeordnet oder daran angehängt wird.
Das PDM_SET-Tag kann auch in der Vorverarbeitungsphase verwendet werden, um eine Vorverarbeitungsvariable zu erstellen oder zu aktualisieren.
PDM_TAB – Erstellen einer Registerkarte in einem Notizbuch
Das <PDM_MACRO name=startNotebook hdr=cng_nb>-Tag wird verwendet, um eine Notizbuchregisterkarte zu definieren. Es wird empfohlen, für Änderungen am Inhalt der Notizbücher den WSP zu verwenden oder ein Notizbuch in ein Formular einzufügen, das noch kein Notizbuch enthält.
PDM_WSP – Steuern der WSP-Vorschau
Das <PDM_WSP>-Tag wird verwendet, um die Vorschaufunktion von WSP zu steuern. Es generiert keinen HTML-Code, und kann in einem Formular an einer beliebigen Stelle platziert werden.
Standardmäßig bestimmt WSP, wie eine Vorschau eines Formulars durch Überprüfen des Formularnamens angezeigt werden kann:
  • Bei Detailformularen (mit dem Formularnamen detail_
    factory
    .htmpl) zeigt WSP das Formular in der Bearbeitungsansicht mit den Daten der Zeile an, die zuletzt in der entsprechenden Tabelle erstellt wurden. Wenn keine Daten in der Tabelle verfügbar sind, zu deren Anzeige Sie berechtigt sind, zeigt WSP die Formularseite zum Erstellen einer neuen Zeile an. In WSP-Vorschausitzungen kann die Datenbank normalerweise nicht aktualisiert werden. WSP zeigt die Formulare in der Bearbeitungsansicht an, damit Sie alle Funktionen im Voraus sehen können. CA SDM ignoriert jedoch eine Speicheranforderung von einer schreibgeschützten Vorschausitzung. Das Webmodul ändert den Text auf der Schaltfläche „Speichern“ in „Schreibgeschützt“, um visuell darauf hinzuweisen.
  • Bei Listenformularen (mit dem Formularnamen list_
    factory
    .htmpl) zeigt WSP das Formular in der Listenansicht mit den Daten der Zeile an, die zuletzt in der entsprechenden Tabelle erstellt wurde. Wenn keine Daten in der Tabelle verfügbar sind, zu deren Anzeige Sie berechtigt sind, zeigt WSP das Formular in der Suchansicht mit offenem Filter an.
  • Bei anderen Formularen zeigt WSP einfach das Formular ohne Datenbankinhalt an.
Sie können dieses Standardverhalten ändern, indem Sie das PDM_WSP-Tag an einer beliebigen Stelle im Formular einfügen. Sie können z. B. ein Formular mit einer Notizbuchregisterkarte im zugehörigen Detailformular anzeigen oder Voraussetzungen für Formulare angeben, die normalerweise in der Umgebung eines anderen Formulars aufgerufen werden. Folgende Argumente sind möglich:
Eigenschaft
Beschreibung
FACTORY=
value
Gibt die Objekt-Engine-Factory an, die von diesem Formular verwendet wird.
PREVIEW=
name
.htmpl |
value
|
nein
Gibt den URL der Vorschau an. Hierbei kann es sich um den Namen einer HTMPL-Datei im Format „xxxx.htmpl“, einen CA SDM-URL (wird unverändert verwendet, wenn er mit „OP=“ beginnt) oder das Schlüsselwort „nein“ handeln, das angibt, dass von dem Formular keine Vorschau angezeigt werden kann. Ein Wert, der nicht mit "OP=" beginnt, wird durch Ersetzen einer Referenz des Formulars {
factory
} oder {
factory
:} durch eine ID bzw. permanente ID der zuletzt erstellten Zeile aus der entsprechenden Factory geändert, zu deren Anzeige der aktuelle Anwender berechtigt ist.
WHERE=
value
Gibt eine WHERE-Klausel an, die für die Suche nach einer oder mehreren darstellenden Zeilen verwendet wird, um sie in der Vorschau im Formular anzuzeigen.
MODE=
value
Gibt den Modus der erstellten URL an. Folgende Modi sind möglich:
GENERAL: Allgemeines Format. Der Modus wird durch das Argument für die Vorschau bestimmt:
detail_xxxx.htmpl – READONLY
list_xxxx.htmpl – LIST
alle anderen – GRONK
READONLY: Detaildatei in der schreibgeschützten Ansicht.
EDIT: Detaildatei in der Bearbeitungsansicht.
LIST: Listendatei.
GRONK: Nicht spezifizierte Datei. In diesem Fall vergeben Sie das Argument "Gronk".