Tag HTMPL

Questo articolo contiene i seguenti argomenti:
casm173
Questo articolo contiene i seguenti argomenti:
Questa sezione illustra i comanPDM per aggiungere i tag HTMPL.
PDM_EVAL: inserimento del valore di una variabile di preelaborazione
Il tag pdm_eval è usato per inserire il valore di una variabile di preelaborazione nell'input del parser del motore Web. Se usata all'interno di una macro, l'effetto viene ritardato fino al completamento della macro.
Il tag pdm_eval funziona in modo simile a pdm_include o pdm_macro. Inserisce il testo nel parser in corrispondenza del tag, esattamente come se il valore della variabile fosse stato codificato al posto del tag.
La sintassi di pdm_eval è la seguente:
<PDM_EVAL TEXT=PRE.name>
  • name
    Obbligatorio; il nome della variabile di preelaborazione il cui valore deve essere inserito nell'input del motore Web.
PDM_FORM: avvio di un modulo HTML con un ID sessione
I tag e possono essere aggiunti a qualsiasi modello HTML dell'interfaccia Web per creare un modulo HTML che includa due campi nascosti per le variabili del server SID (ID sessione) e il FID (ID modulo). L'operando OP crea un altro campo nascosto per una delle operazioni supportate, come con il tag PDM_LINK. Tranne nel caso dei campi nascosti generati automaticamente, <PDM_FORM> e </PDM_FORM> vengono usati allo stesso modo dei tag HTML standard <form> e </form> e generano questi tag come parte della loro espansione.
PDM_FMT: formattazione del testo inserito da una variabile del server
I tag <PDM_FMT> e </PDM_FMT> sono usati per formattare blocchi di testo inseriti dalle variabili del server ($args.xxx) nel modo indicato dai relativi argomenti.
<PDM_FMT> viene ignorato per i valori letterali, comprese le variabili $prop.xxx.
La seguente tabella descrive questi tag:
Proprietà
Descrizione
ESC_STYLE=
NONE
|
C |
HTML |
JS |
JS2 |
URL
Specifica il tipo di escape del testo formattato. I valori validi sono:
NESSUNO
Impostazione predefinita. Specifica che non verrà applicato alcun trattamento speciale a nessun carattere nel corpo del contenuto.
C
Applica un trattamento speciale ai caratteri ', ", \, \r, `, e \n, che hanno un significato nei programmi in C. Questi caratteri verranno ignorati.
HTML
Applica un trattamento speciale ai caratteri seguenti, significativi nel testo HTML:
& diventa &amp;
' diventa &apos;
" diventa &quot;
< diventa &lt;
> diventa %gt;
JS
Applica un trattamento speciale ai caratteri seguenti, significativi nel testo JavaScript:
' diventa %27
" diventa %22
/ diventa %2F
\ diventa %5C
\r diventa %0D
\n diventa %0A
JS2
Come JS, ma non applica alcun trattamento speciale al carattere / mentre applica un trattamento speciale ad altri due caratteri:
- % diventa %25
- Le interruzioni di riga hanno %0A come suffisso
URL
Converte tutti i caratteri diversi da lettere, cifre e '@*-_.#' in '%xx', dove xx è la codifica esadecimale del carattere convertito.
JUSTIFY=LEFT |
CENTER |
RIGHT |
TRUNCATE
|
WRAP |
LIN
Specifica la giustificazione del testo formattato. I valori validi includono:
TRUNCATE
Impostazione predefinita. Elimina la formattazione HTML sostituendo '<' e '>' con < e >
Nota:
per ulteriori informazioni, consultare le seguenti informazioni riguardo a KEEPLINKS e KEEPTAGS.
LEFT|CENTER|RIGHT
Produce esattamente i caratteri indicati da WIDTH, applicando troncamento o riempimento con spazi se necessario, sostituisce eventuali righe nuove incorporate con un solo spazio e delimita il testo di output con i tag [impostare la variabile pre della documentazione] e </pre>. L'argomento WIDTH deve essere specificato come numero intero positivo.
WRAP
Come LEFT, tranne per il fatto che il testo viene portato a capo mantenendo intere le parole (le interruzioni di riga non vengono inserite all'interno delle parole).
LINE
Come TRUNCATE, tranne per il fatto che sostituisce anche tutte le interruzioni di riga incorporate con tag <br>.
KEEPLINKS=YES|
NO
Se si specifica KEEPLINKS=YES, l'azione di JUSTIFY=LINE o JUSTIFY=TRUNCATE viene modificata per conservare i tag di ancoraggio HTML (Azione:) mentre vengono convertiti tutti gli altri caratteri '<' e '>'. KEEPLINKS e KEEPTAGS si escludono a vicenda.
KEEPNL=YES|
NO
L'azione normale di PDM_FMT consiste nel convertire in uno spazio singolo tutte le nuove righe incorporate e qualsiasi spazio successivo. Se viene specificato KEEPNL=YES, le nuove righe incorporate verranno conservate. Questo argomento è ignorato da JUSTIFY=LINE.
KEEPTAGS=YES|
NO
Se si specifica KEEPTAGS=YES, l'azione di JUSTIFY=LINE o di JUSTIFY=TRUNCATE viene modificata per conservare tutti i tag HTML. KEEPTAGS e KEEPLINKS si escludono a vicenda.
PAD=
YES
|NO
Se si specifica PAD=NO, PDM_FMT non converte le stringhe vuote in un singolo spazio. Questa è l'azione normale quando il valore di WIDTH è diverso da zero o JUSTIFY è TRUNCATE o WRAP.
WIDTH=
nn
Quando il valore è diverso da zero, specifica che il testo deve essere formattato esattamente con i caratteri indicati da WIDTH.
senza WIDTH o JUSTIFY non formatta il testo racchiuso ma lo delimita il testo con [imposta la variabile pre della documentazione] e .
Ad esempio, per generare una descrizione su più righe, specificare:
<PDM_FMT WIDTH=50 JUSTIFY=WRAP>$args.description</PDM_FMT>
Per generare un output a più colonne, specificare:
<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: elaborazione condizionale
Questi tag sono usati per includere testo sotto determinate condizioni. I blocchi possono essere inseriti ovunque in un file HTMPL, nel codice HTML, nel codice JavaScript e perfino all'interno dei tag HTML. e (else if) prendono una semplice clausola condizionale come proprietà invece che coppie nome-valore. Se la clausola è True, il testo racchiuso dai tag viene inserito nel file; se la clausola è False, il server ignora il testo racchiuso tra i tag. Il tag di chiusura può essere <PDM_ELIF>, <PDM_ELSE> o </PDM_IF>.
I tag <PDM_ELSE> e <PDM_ELIF> sono opzionali. Se vengono specificati entrambi, tutti i tag <PDM_ELIF> devono precedere i tag <PDM_ELSE>. È possibile inserire un numero qualsiasi di tag <PDM_ELIF> tra <PDM_IF> e <PDM_ELSE> (oppure </PDM_IF> e <PDM_ELSE> è omesso).
La sintassi dell'espressione condizionale in <PDM_IF> e <PDM_ELIF> è la seguente:
  • 0 è False; qualsiasi altro numero è True
  • ““ è False; “
    qualsiasi
    -
    stringa
    ” è True
  • "
    valore op valore
    " confronta tra loro i valori a sinistra e a destra secondo
    op
    . Se entrambi i valori sono costituiti da numeri (opzionalmente preceduti da - o +), i confronti vengono eseguiti numericamente. In caso contrario, il confronto è di tipo lessicale (confronto ASCII). I valori
    op
    validi includono:
Valore op
Descrizione
==
Uguale a
!=
Diverso da
>=
Uguale a o maggiore di (deve essere scritto \>= o >=)
<
Minore di (deve essere scritto \< o <)
>
Maggiore di (deve essere scritto \> o >)
<=
Uguale a o minore di (deve essere scritto \<= o <=)
&
Esegue un'operazione di tipo bitand dei valori di destra e di sinistra. Il valore è True se sono impostati dei bit; False se non sono impostati bit.
%
Restituisce il valore True se il valore di sinistra è un multiplo pari del valore di destra e False nel caso contrario (utile per la creazione di tabelle bidimensionali).
:
Consente di eseguire una corrispondenza motivo orientata ai byte simile al comando grep di UNIX. Restituisce il valore True se il valore di sinistra contiene l'espressione regolare definita dal valore di destra.
Esempio:
<PDM_IF $count \>= 10> . . . <PDM_ELIF $count &#60; 5> . . . <PDM_ELSE> . . . </PDM_IF>
In un'istruzione PDM_IF può esserci più di un'espressione condizionale. Le espressioni condizionali sono separate dai connettori && (and) o || (or). Per l'utilizzo dei connettori non è necessario rispettare alcuna precedenza. Il motore Web esamina un'espressione condizionale da sinistra a destra finché non raggiunge il connettore. Se la condizione iniziale è True e il connettore è ||, il motore considera come True l'intera condizione senza eseguire altre valutazioni. Se la condizione iniziale è False e il connettore è &&, il motore considera come False l'intera condizione, senza eseguire altre valutazioni. In caso contrario, considera la condizione non determinata e valuta l'espressione condizionale dalla posizione del connettore in avanti.
PDM_INCLUDE: inserimento di testo da un file diverso
Il tag <PDM_INCLUDE> è usato per inserire testo da un secondo file in un file HTMPL. Il server sostituisce il tag <PDM_INCLUDE> con il contenuto del secondo file.
I file inclusi possono a loro volta contenere tag <PDM_INCLUDE>. Non c'è limite al livello di nidificazione.
Il tag <PDM_INCLUDE> supporta le proprietà seguenti:
Proprietà
Descrizione
FILE=filename
Obbligatoria; specifica il file da includere. Il motore Web esegue la ricerca nelle directory usate per i file HTMPL, come definito nel tipo di accesso dell'utente corrente.
FIXUP=[
YES
|NO]
(Facoltativo) Indica se il file deve essere interpretato dall'interfaccia Web come un normale file modello HTML, ad esempio che espande le variabili che iniziano con il simbolo del dollaro ($) e interpreta altri tag di CA SDM, come PDM_LIST e PDM_FORMAT. Il valore YES indica che il file deve essere considerato come un normale file modello HTML mentre il valore NO significa che il file incluso deve essere considerato come testo normale. Il valore predefinito è YES.
Nota:
per assicurare la compatibilità con le release precedenti, è possibile sostituire YES con TRUE o 1 e NO con FALSE o 0. Comunque non è opportuno usare questi valori nelle pagine nuove.
propname=value
Indica che la proprietà propname deve avere il valore specificato. È possibile accedere al valore della proprietà all'interno del file incluso aggiungendo a propname il prefisso $prop. Ad esempio, la specifica seguente consente al file incluso di fare riferimento a $prop.menubar:
Le proprietà globali possono anche essere specificate nel file di configurazione web.cfg. Per informazioni su web.cfg, consultare la sezione Modalità di configurazione dell'interfaccia Web.
Nota:
per assicurare la compatibilità con le release precedenti, i valori della proprietà specificati in <PDM_INCLUDE> possono essere richiamati senza il prefisso 'prop.', nella forma $propname. Tuttavia si tratta di un metodo obsoleto che non dovrebbe essere usato nelle nuove pagine.
PDM_JSCRIPT: inclusione condizionale di un file JavaScript
Il tag <PDM_JSCRIPT> è usato per includere un file JavaScript in un modulo, sotto determinate condizioni. Questo tag ha due formati:
<PDM_JSCRIPT file=xxxx.js [include=yes|no]>
La specifica pdm_jscript file=xxx.js indica che il file JavaScript xxx.js è richiesto da questo modulo. Il motore Web aggiunge il file a un elenco di file JavaScript richiesti dal modulo. L'elaborazione del tag avviene quando il modulo viene analizzato e non è interessata da pdm_if. Cioè, un tag pdm_jscript che fa riferimento a un file aggiunge quel file all'elenco dei file JavaScript se è presente in un punto qualsiasi del file, di un file incluso o di una macro.
È possibile specificare l'argomento opzionale
include=no
per indicare di ignorare il tag. Questo argomento fornisce l'elaborazione condizionale per il tag ed è utile soprattutto quando il tag viene richiamato in una macro. Ad esempio, la macro dtlTextbox specifica:
<PDM_JSCRIPT file=spellcheck.js include=&{spellchk}>
Ciò indica che qualsiasi modulo contenente una macro dtlTextbox che specifica spellchk=yes richiede il file JavaScript spellcheck.js.
Il secondo formato del tag pdm_jscript è:
<PDM_JSCRIPT insert=here>
Pdm_jscript con insert=here chiede al motore Web di inserire i tag HTML <script> standard per tutti i file JavaScript richiesti. Il motore Web elabora questo formato del tag durante la fase di generazione HTML, in modo che sia interessato da pdm_if. Un tag pdm_jscript insert=here è parte di std_head_include.htmpl, pertanto è presente praticamente in ogni modulo.
Il motore Web inserisce i tag script solo la prima volta che incontra pdm_jscript insert=here.
PDM_LINK: creazione di un collegamento ipertestuale che richiama un'operazione HTMPL
È possibile aggiungere i tag e a qualsiasi modello HTML di interfaccia Web per creare collegamenti che richiamano un'operazione HTMPL. Il tag <PDM_LINK> genera il tag HTML <a href=...> standard e presenta argomenti simili tranne per il fatto che consente la specifica di un'operazione di CA SDM invece di un URL.
Il formato è il seguente, dove
operazione
è una delle operazioni supportate:
<PDM_LINK OP=operation> ... </PDM_LINK>
Esempio:
<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: formattazione di un elenco di righe del database
I tag <PDM_LIST> e </PDM_LIST> sono usati per delimitare le sezioni HTML che si ripetono per generare un output a più record. Tutti gli elementi compresi tra <PDM_LIST> e </PDM_LIST> vengono ripetuti una sola volta per ogni record da generare. Esistono due tipi di PDM_LIST:
  • Elenchi ricavati da un attributo di un oggetto che implica un elenco. Ad esempio, l'attributo properties dell'oggetto request è l'elenco delle proprietà associate a quella richiesta. Questo tipo di PDM_LIST ha sempre la proprietà SOURCE.
  • Elenchi con una clausola WHERE esplicita. Questo tipo di PDM_LIST ha sempre la proprietà WHERE.
Un attributo di oggetto <PDM_LIST> presenta le seguenti proprietà:
Proprietà
Descrizione
ESC_STYLE=
NONE
|
C |
HTML |
JS |
JS2 |
URL
Specifica il tipo di escape del testo formattato. I valori validi sono:
NONE
Impostazione predefinita. Specifica che non verrà applicato alcun trattamento speciale a nessun carattere nel corpo del contenuto.
C
Applica un trattamento speciale ai caratteri ', ", \, \r, ' e \n, che hanno un significato nei programmi in C. Questi caratteri verranno ignorati.
HTML
Applica un trattamento speciale ai caratteri seguenti, significativi nel testo HTML:
& diventa &amp;' diventa &apos;" diventa &quot;< diventa &lt;> diventa %gt;
JS
Applica un trattamento speciale ai caratteri seguenti, significativi nel testo JavaScript:
' diventa %27" diventa %22/ diventa %2F\ diventa %5C\r diventa %0D\n diventa %0A
JS2
Come JS, ma non applica alcun trattamento speciale al carattere / mentre applica un trattamento speciale ad altri due caratteri:
- % diventa %25
- Le interruzioni di riga hanno %0A come suffisso
URL
Converte tutti i caratteri diversi da lettere, cifre e '@*-_.#' in '%xx', dove xx è la codifica esadecimale del carattere convertito.
LENGTH=
nn
Specifica il numero di righe dell'output (il valore predefinito è tutto).
PREFIX=
prefisso
Specifica il prefisso nei riferimenti agli attributi nei record dell'elenco. I riferimenti hanno il formato
$prefix.attr_name
nel testo compreso tra <PDM_LIST> e </PDM_LIST> . La proprietà PREFIX è opzionale in un elenco di variabili degli oggetti. Se si omette PREFIX, viene usato anche il valore di SOURCE per il prefisso.
SEARCH_TYPE=DISPLAY|
GET_DOB
Specifica il metodo che il server deve usare per generare il modulo elenco:
DISPLAY specifica che il server deve emettere una singola query per tutto il modulo
GET_DOB specifica che il server deve emettere query separate per ogni riga del modulo
La scelta influenza le prestazioni dell'elenco e dipende dalla complessità dell'elenco (il numero di unioni richieste per visualizzarlo) e dalle caratteristiche del DBMS. Le prestazioni di GET_DOB sono più controllabili di quelle di DISPLAY e infatti costituisce il valore predefinito.
SORT =
nome
-
indice
Specifica il nome dell'indice da usare per l'ordinamento. Il valore predefinito di questo argomento è DEFAULT (che indica il primo indice di ordinamento per il factory sottostante).
SOURCE=
fonte
Specifica la variabile dell'oggetto che definisce questo elenco. Questo campo è obbligatorio. Non inserire il simbolo del dollaro ($) davanti a
origine
nell'istruzione PDM_LIST. Se non è specificata la proprietà PREFIX, il valore
origine
è usato anche come prefisso per i riferimenti agli attributi nei record dell'elenco, nei riferimenti nel formato
$origine
.
nome_attr
. Se usato in un riferimento,
origine
non richiede il simbolo del dollaro.
START=
nn
Specifica la prima riga dell'output (zero è il valore predefinito).
Esempio:
<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>
Poiché non sono stati specificati prefissi, i riferimenti agli attributi dei record nell'elenco hanno il prefisso $args.children, il valore origine.
Un PDM_LIST di una clausola WHERE ha le proprietà seguenti:
Proprietà
Descrizione
FACTORY=
nome
Specifica una classe dell'oggetto da ricercare. Questa proprietà è obbligatoria.
LENGTH=
nn
Specifica il numero di righe dell'output (il valore predefinito è tutto).
ORDER_BY=
nome-attr
Specifica il nome dell'attributo in base al quale effettuare l'ordinamento. Può contenere i modificatori DESC (decrescente) o ASC (crescente).
PREFIX=
prefisso
Specifica il prefisso nei riferimenti agli attributi nei record dell'elenco. I riferimenti hanno il formato
$prefix
.
attr_name
nel testo compreso tra <PDM_LIST> e </PDM_LIST>. La proprietà PREFIX è obbligatoria in un elenco della clausola WHERE.
START=
nn
Specifica la prima riga dell'output (zero è il valore predefinito).
WHERE=
clausola-WHERE
Specifica la clausola WHERE per la ricerca. Può contenere attributi (notazione a punti). Questa proprietà è obbligatoria.
Ad esempio:
<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: creazione di un notebook
Diversi moduli nell'interfaccia Analista di CA SDM usano le schede nidificate (notebook). Le schede nidificate mostrano in una stessa area dello schermo di più insiemi di campi, ma si può visualizzare un solo insieme alla volta. L'utente seleziona il set di campi visibile facendo clic su una determinata scheda nella parte superiore del notebook o premendo la combinazione di tasti Alt+
n
, dove
n
è il numero della scheda. Dettagli Issue (detail_iss.htmpl) è un esempio di modulo che usa un notebook. È consigliato l'utilizzo di WSP per modificare i contenuti dei notebook o inserire un notebook in un modulo che non ne contenga già uno.
Il tag seguente contrassegna la fine di un notebook.
<PDM_MACRO name=endNotebook>
PDM_PRAGMA: specificazione delle informazioni sul server
Il tag <PDM_PRAGMA> è usato per specificare informazioni usate dal motore Web, ad esempio il rilascio e la release di un modulo. Non genera codice HTML e può essere inserito ovunque in un modulo. Gli argomenti utilizzabili sono:
Argomento
Descrizione
RELEASE=value
Specifica il numero di release di CA SDM corrispondente a questo modulo. Questo valore è “110” in tutti i moduli CA Service Desk Manager r11.0. È accessibile all'interno del modulo, nella variabile $prop.release.
SITEMOD=value
Specifica una stringa definita a livello di sito che identifica le modifiche applicate a questo modulo. È accessibile all'interno del modulo, nella variabile $prop.sitemod.
VERSION=value
Specifica una stringa definita da CA Technologies che identifica il numero di versione di questo modulo. È accessibile all'interno del modulo, nella variabile $prop.version.
OVERIDE=YES|
NO
Specifica se i valori in questa istruzione PDM_PRAGMA devono sostituire i valori nelle precedenti istruzioni PDM_PRAGMA.
CA Technologies usa le istruzioni PDM_PRAGMA per documentare le versioni dei moduli. Tutti i moduli CA Service Desk Manager r11.0 includono l'istruzione PDM_PRAGMA seguente:
<PDM_PRAGMA RELEASE=110>
Inoltre, il modulo std_head.htmpl include l'istruzione JavaScript seguente:
cfgFormRelease = "$prop.release" - 0;
L'istruzione PDM_PRAGMA e la variabile cfgFormRelease consentono all'interfaccia Web di CA SDM di distinguere i moduli CA Service Desk Manager r11.0 da quelli delle release precedenti. Le release precedenti a CA Service Desk Manager r6.0 non supportavano l'istruzione PDM_PRAGMA.
Normalmente, per impostare set $prop.release, $prop.sitemod e $prop.version vengono usate solo le istruzioni PDM_PRAGMA nel file di livello massimo di un modulo (cioè un file non richiamato da PDM_INCLUDE). Inoltre, un'istruzione PDM_PRAGMA non sostituisce un valore non vuoto impostato da una precedente istruzione PDM_PRAGMA. È possibile impostare OVERRIDE=YES per specificare che un'istruzione PDM_PRAGMA può sostituire precedenti istruzioni PDM_PRAGMA o che è possibile usare un'istruzione PDM_PRAGMA in un file incluso.
PDM_SCOREBOARD: creazione di una struttura del contatore
Il tag <PDM_SCOREBOARD> viene utilizzato per generare il contatore mostrato sul lato sinistro del modulo principale. Ha la proprietà seguente:
  • TARGET=
    valore
    Specifica il nome del frame di destinazione per gli elenchi richiesti facendo clic su un nodo presente nel contatore. Gli elenchi vengono caricati nella destinazione specificata, che può essere qualsiasi valore supportato per l'attributo di destinazione di un collegamento. Il valore predefinito è
    _self
    (la finestra contenente il tag PDM_SCOREBOARD).
Qualsiasi modulo HTMPL che include un tag <PDM_SCOREBOARD> deve includere anche il file fldrtree.js JavaScript. Questo file può essere incluso tramite l'istruzione seguente nella sezione <HEAD> del modulo:
<SCRIPT LANGUAGE="JavaScript" SRC="$CAisd/CAisd/fldrtree.js"></SCRIPT>
Inoltre, è opportuno includere un collegamento chiamato scoreboard_asof_data per visualizzare la data di validità dei numeri nella struttura. Per un esempio dell'uso di questo tag, consultare il file scoreboard.htmpl distribuito.
Le query incluse nel contatore sono definite dal contenuto della tabella User_Query (con nome oggetto usq) per l'utente corrente. Un record in questa tabella definisce ogni riga nella struttura (cartella o nodo).
Inizialmente, gli utenti non hanno voci associate nella tabella User_Query. Un utente senza voci User_Query riceve il set predefinito di query contatore associato al tipo di accesso assegnato. Un utente con autorizzazione di amministratore può anche personalizzare il contatore predefinito per un tipo di accesso.
PDM_SET: impostazione del valore di una variabile del server
Il
tag <PDM_SET>
non è supportato per le operazioni aritmetiche basate su valori interi come l'addizione (ad esempio:
<PDM_SET args.z_counter=$args.z_counter + 1>
).
È supportato soltanto per l'impostazione di una proprietà di stringa e l'operazione di concatenazione di stringa.
Il tag <PDM_SET> è usato per assegnare un valore a una variabile del server. La sintassi è la seguente:
<PDM_SET arg.name[+]=value>
  • arg
    Obbligatorio; specifica il tipo di variabile e deve essere arg per l'uso normale.
    Non vi sono caratteri $.
  • Nome
    Obbligatotio; specifica il nome della variabile.
  • +
    Opzionale; specifica che il valore deve essere aggiunto alla fine del valore esistente della variabile. Non sono ammessi spazi né prima né dopo.
  • =
    Obbligatorio; deve essere specificato esattamente come indicato, senza spazi né prima né dopo.
  • value
    Obbligatorio; specifica il testo da assegnare o aggiungere alla fine della variabile.
Il tag PDM_SET può essere usato anche nella fase di preelaborazione per creare o aggiornare una variabile di preelaborazione.
PDM_TAB: creazione di una scheda in un notebook
Il tag <PDM_MACRO name=startNotebook hdr=cng_nb> viene usato per definire una scheda del notebook. È consigliato l'utilizzo di WSP per modificare i contenuti dei notebook o inserire un notebook in un modulo che non ne contenga già uno.
PDM_WSP: controllo dell'anteprima Web Screen Painter
Il tag <PDM_WSP> viene usato per controllare la funzionalità di anteprima di WSP. Non genera codice HTML e può essere inserito ovunque in un modulo.
Per impostazione predefinita, WSP determina il tipo di anteprima di un modulo dal nome del modulo:
  • Per i moduli dettagli (detail_
    factory
    .htmpl), WSP visualizza il modulo nella visualizzazione di modifica, con i dati ricavati dalla riga creata per ultima della tabella appropriata. Se non vi sono dati che si possono visualizzare nella tabella, WSP mostra il modulo predisposto per creare una nuova riga. Notare che le sessioni di anteprima di WSP normalmente non possono aggiornare il database. WSP mostra i moduli nella visualizzazione di modifica per consentire di vedere in anteprima tutte le funzioni. Tuttavia, CA SDM ignora le richieste di salvataggio da una sessione di anteprima di sola lettura. Per questo il motore Web cambia il testo del pulsante Salva in noSave.
  • Per i moduli elenco (list_
    factory
    htmpl), WSP visualizza il modulo nella modalità di elenco, con i dati ricavati dalla riga creata per ultima della tabella appropriata. Se non vi sono dati che si possono visualizzare nella tabella, Screen Painter Web visualizza il modulo nella modalità di di ricerca, con il filtro aperto.
  • Per gli altri moduli, WSP visualizza semplicemente il modulo, senza contesto del database.
È possibile modificare questo comportamento predefinito inserendo un tag PDM_WSP in un punto qualsiasi del modulo. Ad esempio, è possibile visualizzare una scheda del notebook nel relativo modulo dettagli o fornire argomenti obbligatori per i moduli normalmente richiamati con un ambiente fornito da un altro modulo. Sono possibili i seguenti argomenti:
Proprietà
Descrizione
FACTORY=
valore
Specifica il factory del motore oggetti usato da questo modulo.
PREVIEW=
nome
.htmpl |
valore
|
no
Specifica l'URL di anteprima. Può essere il nome di un file HTMPL, nel formato xxxx.htmpl, un URL di CA SDM (usato senza modifiche se inizia con "OP=") o la parola chiave "no" che indica che il modulo non può essere visualizzato in anteprima. Un valore che non inizia con OP= viene modificato sostituendo un riferimento del modulo {
factory
} o {
factory
:} rispettivamente con un ID o con un ID persistente della riga creata per ultima del factory a cui si fa riferimento e che può essere visto dall'utente corrente.
WHERE=
valore
Specifica una clausola WHERE usata per cercare una o più righe rappresentative da mostrare nel modulo in anteprima.
MODE=
valore
Specifica la posizione dell'URL costruita. Può avere questa forma:
GENERAL. Formato generale: Determina la modalità esaminando l'argomento anteprima:
detail_xxxx.htmpl - READONLY
list_xxxx.htmpl - LIST
qualsiasi altro - GRONK
READONLY. File dettaglio visualizzato in sola lettura.
EDIT. File dettaglio visualizzato in modifica.
LIST. File elenco.
GRONK. File non specificato. In questa situazione, disabilitare il file.