Etiquetas HTMPL

Este artículo contiene los siguientes temas:
casm173
Este artículo contiene los siguientes temas:
En esta sección se describen los comandos PDM a los que agregar etiquetas HTMPL.
PDM_EVAL: inserción del valor de una variable de procesamiento previo
La etiqueta PDM_EVAL se utiliza para insertar el valor de una variable de procesamiento previo en la entrada del analizador del motor Web. Si se utiliza dentro de una macro, surte efecto una vez que la macro finaliza.
La etiqueta PDM_EVAL funciona de forma similar a PDM_INCLUDE o PDM_MACRO. Inserta el texto en el analizador en el punto donde se encuentre la etiqueta, exactamente igual que si el valor de su variable se hubiera codificado en lugar de la etiqueta.
La sintaxis de PDM_EVAL es la siguiente:
<PDM_EVAL TEXT=PRE.name>
  • name
    (Obligatorio) El nombre de la variable de procesamiento previo cuyo valor se debe insertar en la entrada del motor Web.
PDM_FORM: inicio de un formulario HTML con un ID de sesión
y se pueden agregar a cualquier plantilla HTML de la interfaz web para crear un formulario HTML que incluya dos campos ocultos para el SID (ID de la sesión) y el FID (ID del formulario) de las variables del servidor. El operando opcional OP crea otro campo oculto más para una de las operaciones compatibles, como con la etiqueta PDM_LINK. Excepto en el caso de los campos ocultos generados automáticamente, <PDM_FORM> y </PDM_FORM> se utilizan de la misma forma que las etiquetas HTML <form> y </form> estándar (y generan estas etiquetas como parte de su ampliación).
PDM_FMT: formato del texto desde las variables del servidor
Las etiquetas <PDM_FMT> y </PDM_FMT> se utilizan para aplicar formato a bloques de texto insertados por variables de servidor ($args.xxx) de acuerdo con las instrucciones proporcionadas por sus argumentos.
<PDM_FMT> se omite en los literales, incluidas las variables $prop.xxx.
En la tabla siguiente se describen estas etiquetas:
Propiedad
Descripción
ESC_STYLE=
NONE
|
C |
HTML |
JS |
JS2 |
URL
Especifica el tipo de sustitución del texto con formato. Los valores válidos son:
NINGUNO
Es el valor predeterminado. Especifica que no se aplicará ningún tratamiento especial a ningún carácter del cuerpo del contenido.
C
Otorga un tratamiento especial a los caracteres ', ", \, \r, `, y \n, que tienen un significado en los programas en C. Estos caracteres se sustituirán.
HTML
aplica un tratamiento especial a los caracteres siguientes, que tienen significado en el texto HTML:
& pasa a ser &amp;
' pasa a ser &apos;
" pasa a ser &quot;
< pasa a ser <
> pasa a ser %gt;
JS
aplica un tratamiento especial a los caracteres siguientes, que tienen significado en el texto JavaScript:
' pasa a ser %27
" pasa a ser %22
/ pasa a ser %2F
\ pasa a ser %5C
\r pasa a ser %0D
\n pasa a ser %0A
JS2
Igual que JS, pero no se aplica ningún tratamiento especial al carácter / y se otorga un tratamiento especial a otros dos caracteres:
- % pasa a ser %25
- A los saltos de línea se les aplica el sufijo %0A
URL
Se traducen todos los caracteres que no sean letras, dígitos y “@*-_.#” a “%xx”, donde xx es la codificación hexadecimal del carácter traducido.
JUSTIFY=LEFT |
CENTER |
RIGHT |
TRUNCATE
|
WRAP |
LIN
Especifica la justificación del texto con formato. Los valores válidos son:
TRUNCATE
Es el valor predeterminado. Elimina el formato HTML al sustituir "<" y ">" por < y >
Nota
: Para obtener más información, consulte la siguiente información sobre KEEPLINKS y KEEPTAGS.
LEFT|CENTER|RIGHT
Produce exactamente los caracteres de WIDTH, truncados o rellenados con espacios según proceda, con las líneas nuevas incrustadas reemplazadas por un único espacio y el texto de salida delimitado por las etiquetas [establezca la variable para el libro] y </pre>. El argumento WIDTH se debe especificar como un número entero positivo.
WRAP
Igual que LEFT, excepto por el hecho de que el ajuste de texto respeta los límites de las palabras (no se colocan saltos de línea dentro de las palabras).
LINE
Igual que TRUNCATE, excepto por el hecho de que también reemplaza todos los saltos de línea incrustados por etiquetas <br>.
KEEPLINKS=YES|
NO
Si se especifica KEEPLINKS=YES, la acción de JUSTIFY=LINE o JUSTIFY=TRUNCATE se modifica para conservar las etiquetas de anclaje HTML (Acción: ) mientras se convierte el resto de caracteres “<” y “>”. Esta propiedad y KEEPTAGS se excluyen mutuamente.
KEEPNL=YES|
NO
La acción normal de PDM_FMT es convertir todas las líneas nuevas incrustadas y los espacios siguientes en un único espacio. Si se especifica KEEPNL=YES, las líneas nuevas incrustadas se conservan. Este argumento se omite en el caso de JUSTIFY=LINE.
KEEPTAGS=YES|
NO
Si se especifica KEEPTAGS=YES, la acción de JUSTIFY=LINE o JUSTIFY=TRUNCATE se modifica para conservar todas las etiquetas HTML. Esta propiedad y KEEPLINKS se excluyen mutuamente.
PAD=
YES
|NO
Si se especifica PAD=NO, PDM_FMT no convierte las cadenas vacías en un único espacio. Ésta es la acción normal cuando WIDTH tiene un valor distinto de cero, o bien cuando JUSTIFY es TRUNCATE o WRAP.
WIDTH=
nn
Cuando el valor es distinto de cero, especifica que se debe aplicar formato al texto hasta el carácter indicado por WIDTH.
<PDM_FMT> sin WIDTH ni JUSTIFY no aplica formato al texto delimitado, sino que rodea el texto con [establezca la variable previa para el libro] y </pre>.
Por ejemplo, para producir una descripción de varias líneas, introduzca lo siguiente:
<PDM_FMT WIDTH=50 JUSTIFY=WRAP>$args.description</PDM_FMT>
Para producir una salida con varias columnas, introduzca lo siguiente:
<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: procesamiento condicional
Estas etiquetas se utilizan para incluir texto de manera condicional. Los bloques se pueden colocar en cualquier parte de los archivos HTMPL (en HTML, en JavaScript e incluso dentro de etiquetas HTML). Tanto como (else if) usan cláusulas condicionales simples como sus propiedades en lugar de pares nombre-valor. Si la cláusula es verdadera, el texto situado entre ambas etiquetas se incluye en el archivo; si la cláusula es falsa, el servidor descarta el texto situado entre la etiqueta de apertura y la de cierre. La etiqueta de cierre puede ser <PDM_ELIF>, <PDM_ELSE> o </PDM_IF>.
Las etiquetas <PDM_ELSE> y <PDM_ELIF> son opcionales. Si se especifican las dos, todas las etiquetas <PDM_ELIF> deben ir seguidas por <PDM_ELSE>. Puede existir cualquier número de etiquetas <PDM_ELIF> entre <PDM_IF> y <PDM_ELSE> (o </PDM_IF> si se omite <PDM_ELSE>).
La sintaxis condicional para <PDM_IF> y <PDM_ELIF> es la siguiente:
  • 0 es falso; cualquier otro número es verdadero.
  • ""es falso; "
    cualquier
    -
    cadena
    " es verdadero
  • value op value
    ” compara los valores de la izquierda y la derecha según
    op
    . Si ambos valores son dígitos (de forma opcional, precedidos por - o +), las comparaciones serán numéricas. De lo contrario, serán léxicas (intercalación ASCII). Los valores
    op
    válidos incluyen:
Valor op
Descripción
==
Igual a
!=
No igual a
>=
Igual a o mayor que (escrito como \>= o >=)
<
Menor que (escrito como \< o <)
>
Mayor que (escrito como \> o >)
<=
Igual a o menor que (escrito como \<= o <=)
&
Realiza una función bit-and de los valores de la derecha y de la izquierda. Verdadero, si hay bits establecidos; falso, si no los hay.
%
Devuelve true si el valor de la izquierda es un número par múltiplo del valor de la derecha. De lo contrario, devuelve false. Esto resulta útil para crear tablas de dos dimensiones.
:
Realiza una comparación de patrones basada en bytes, como el comando grep de UNIX. Devuelve verdadero si el valor izquierdo contiene la expresión regular definida por el valor derecho.
Ejemplo:
<PDM_IF $count \>= 10> . . . <PDM_ELIF $count &#60; 5> . . . <PDM_ELSE> . . . </PDM_IF>
Pueden existir varios condicionales en las instrucciones PDM_IF. Los condicionales están separados por conectores, ya sea && (y) o || (o). No hay precedencia para estos conectores. El motor Web examina los condicionales de izquierda a derecha hasta que encuentra un conector. Si la condición inicial es verdadera y el conector es ||, la totalidad de la condición se considerará verdadera y no se llevará a cabo ninguna otra comprobación. Si la condición inicial es falsa y el conector es &&, la totalidad de la condición se considerará falsa y no se llevará a cabo ninguna otra comprobación. De lo contrario, la condición se considerará indeterminada y la evaluación del condicional tendrá lugar a partir del conector.
PDM_INCLUDE: inserción desde un archivo diferente
La etiqueta <PDM_INCLUDE> se utiliza para insertar texto de otros archivos en archivos HTMPL. El servidor reemplaza la etiqueta <PDM_INCLUDE> por el contenido del segundo archivo.
Los archivos incluidos pueden contener etiquetas <PDM_INCLUDE>. No hay límite en cuanto a los niveles de anidación.
La etiqueta <PDM_INCLUDE> admite las siguientes propiedades:
Propiedad
Descripción
FILE=filename
(Obligatoria) Especifica el archivo que se incluirá. El motor Web realiza una búsqueda en los directorios utilizados para los archivos HTMPL, definidos en el tipo de acceso del usuario actual.
FIXUP=[
YES
|NO]
(Opcional) Indica si la interfaz web debe interpretar el archivo como un archivo de plantillas HTML normal, como a la hora de expandir las variables que empiezan con signos de dólar ($) y de interpretar otras etiquetas de CA SDM como PDM_LIST y PDM_FORMAT. El valor YES indica que el archivo se debe tratar como un archivo de plantillas HTML normal, mientras que el valor NO significa que el archivo incluido se debe considerar como texto literal. El valor predeterminado es YES.
Nota:
Para la compatibilidad con versiones anteriores, los valores TRUE o 1 se pueden sustituir por YES y los valores FALSE o 0 se pueden sustituir por NO. Estos valores se desechan y no se deben utilizar en páginas nuevas.
propname=value
Especifica que la propiedad propname debe tener el valor indicado. Es posible acceder al valor de la propiedad dentro del archivo incluido si se aplica el prefijo $prop a propname. Por ejemplo, la siguiente especificación permitiría al archivo incluido hacer referencia a $prop.menubar: .
Las propiedades globales también se pueden especificar en el archivo de configuración web.cfg. Para obtener más información sobre web.cfg, consulte Cómo configurar la interfaz Web.
Nota
: Para permitir la compatibilidad con versiones anteriores, es posible hacer referencia a los valores de propiedad especificados en <PDM_INCLUDE> sin precederlos de "prop.", con el formato $propname. Este uso es obsoleto y no se debe emplear en las páginas nuevas.
PDM_JSCRIPT: inclusión condicional de un archivo JavaScript
La etiqueta <PDM_JSCRIPT> se utiliza para incluir de forma condicional archivos JavaScript en los formularios. Esta etiqueta tiene dos formas:
<PDM_JSCRIPT file=xxxx.js [include=yes|no]>
PDM_JSCRIPT con file=xxx.js especifica que el archivo JavaScript xxx.js es necesario para este formulario. El motor Web agrega el archivo a una lista de archivos JavaScript necesarios para el formulario. El procesamiento de esta etiqueta tiene lugar mientras se analiza el formulario y no se ve afectada por PDM_IF. Es decir, una etiqueta PDM_JSCRIPT que hace referencia a un archivo agrega dicho archivo a la lista de archivos JavaScript si se encuentra en cualquier parte del archivo, de un archivo incluido o de una macro.
El argumento opcional
include=no
se puede especificar para indicar al motor Web que omita la etiqueta. Este argumento proporciona procesamiento condicional para la etiqueta y resulta especialmente útil cuando se invoca la etiqueta en una macro. Por ejemplo, la macro dtlTextbox especifica lo siguiente:
<PDM_JSCRIPT file=spellcheck.js include=&{spellchk}>
Esto indica que cualquier formulario que incluya una macro dtlTextbox que especifique spellchk=yes requerirá el archivo JavaScript spellcheck.js.
La segunda forma de la etiqueta pdm_jscript es:
<PDM_JSCRIPT insert=here>
Pdm_jscript con insert=here solicita al motor Web la inserción de etiquetas <script> estándar de HTML para todos los archivos JavaScript necesarios. El motor Web procesa esta forma de la etiqueta durante la fase de generación de HTML, de forma que se ve afectada por PDM_IF. Una etiqueta PDM_JSCRIPT con insert=here forma parte de std_head_include.htmpl, así que está presente prácticamente en todos los formularios.
El motor web solo inserta las etiquetas de script la primera vez que encuentra pdm_jscript insert=here.
PDM_LINK: creación de un hipervínculo para invocar una operación HTMPL
y se pueden agregar a cualquier plantilla HTML de la interfaz web para crear vínculos que invoquen operaciones HTMPL. La etiqueta <PDM_LINK> genera la etiqueta <a href=...> estándar de HTML y tiene argumentos similares, excepto por el hecho de que permite la especificación de una operación de CA SDM en lugar de una dirección URL.
El formato es el indicado a continuación, donde
operación
es una de las operaciones compatibles:
<PDM_LINK OP=operation> ... </PDM_LINK>
Ejemplo:
<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: formato de una lista de filas de la base de datos
Las etiquetas <PDM_LIST> y </PDM_LIST> se utilizan para delimitar secciones repetidas de HTML para las salidas con varios registros. Todo lo que se encuentra entre <PDM_LIST> y </PDM_LIST> se repite una vez por cada registro de salida. Existen dos tipos de listas PDM_LIST:
  • Listas tomadas del atributo de un objeto que implica una lista. Por ejemplo, el atributo de propiedades del objeto de solicitud es la lista de las propiedades asociadas a la solicitud. Este tipo de PDM_LIST siempre incluye una propiedad SOURCE.
  • Listas con una cláusula WHERE explícita. Este tipo de PDM_LIST siempre incluye una propiedad WHERE.
Los atributos de objeto <PDM_LIST> admiten las siguientes propiedades:
Propiedad
Descripción
ESC_STYLE=
NONE
|
C |
HTML |
JS |
JS2 |
URL
Especifica el tipo de sustitución del texto con formato. Los valores válidos son:
NONE
Configuración predeterminada. Especifica que no se aplicará ningún tratamiento especial a ningún carácter del cuerpo del contenido.
C
otorga un tratamiento especial a los caracteres ', “, \, \r, ' y \n, que tienen significado en los programas C. Estos caracteres se sustituirán.
HTML
aplica un tratamiento especial a los caracteres siguientes, que tienen significado en el texto HTML:
& se convierte en&amp;' se convierte en &apos;" se convierte en &quot;< se convierte en &lt;> se convierte en %gt;
JS
aplica un tratamiento especial a los caracteres siguientes, que tienen significado en el texto JavaScript:
' pasa a ser %27" pasa a ser %22/ pasa a ser %2F\ pasa a ser %5C\r pasa a ser %0D\n pasa a ser %0A
JS2
Igual que JS, pero no se aplica ningún tratamiento especial al carácter / y se otorga un tratamiento especial a otros dos caracteres:
- % pasa a ser %25
- A los saltos de línea se les aplica el sufijo %0A
URL
Se traducen todos los caracteres que no sean letras, dígitos y “@*-_.#” a “%xx”, donde xx es la codificación hexadecimal del carácter traducido.
LENGTH=
nn
Especifica el número de filas de la salida (de forma predeterminada, todas).
PREFIX=
prefijo
Especifica el prefijo de las referencias a atributos de los registros de la lista. Se hace referencia a ellos con el formato
$prefijo.nombre_atributo
en el texto situado entre y . La propiedad PREFIX es opcional en las listas de variables de objeto. Si se omite PREFIX, el valor de SOURCE también se utiliza en el prefijo.
SEARCH_TYPE=DISPLAY|
GET_DOB
Especifica el método que debe utilizar el servidor para crear el formulario de lista:
DISPLAY especifica que el servidor debe emitir una única consulta para todo el formulario.
GET_DOB especifica que el servidor debe emitir consultas distintas para cada fila del formulario.
La selección afecta al rendimiento de la lista y depende de su complejidad (el número de uniones necesarias para mostrarla) y de las características del DBMS. GET_DOB tiene un rendimiento más predecible que DISPLAY y constituye la opción predeterminada.
SORT =
nombre
-
índice
Especifica el nombre del índice que se utilizará para la ordenación. El valor predeterminado de este argumento es DEFAULT (que indica el primer índice de ordenación de la fábrica subyacente).
SOURCE=
origen
Especifica la variable de objeto que define la lista. Este campo es obligatorio. No coloque un signo de dólar ($) delante de
origen
en la propia instrucción PDM_LIST. Si la propiedad PREFIX no se especifica,
source
también se utiliza como prefijo para las referencias a atributos de los registros de la lista, con referencias de la forma
$source
.attr_name
. Cuando se utiliza en una referencia,
source
necesita un signo de dólar precedido.
START=
nn
Especifica la primera fila de la salida (el valor predeterminado es cero).
Ejemplo:
<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>
Ya que no se especifica ningún prefijo, se utilizará el prefijo $args.children para las referencias a atributos de los registros de la lista, que es el valor del origen.
PDM_LIST admite las siguientes propiedades en las cláusulas WHERE:
Propiedad
Descripción
FACTORY=
nombre
Especifica la clase de objeto que hay que buscar. Esta propiedad es obligatoria.
LENGTH=
nn
Especifica el número de filas de la salida (de forma predeterminada, todas).
ORDER_BY=
nombre-atributo
Especifica el nombre el atributo que se utilizará para la ordenación. Puede contener los modificadores DESC (descendente) o ASC (ascendente).
PREFIX=
prefijo
Especifica el prefijo de las referencias a atributos de los registros de la lista. Se hace referencia a ellos con el formato
$prefijo
.
nombre_atributo
en el texto situado entre and . La propiedad PREFIX es obligatoria en las listas de las cláusulas WHERE.
START=
nn
Especifica la primera fila de la salida (el valor predeterminado es cero).
WHERE=
cláusula-where
Especifica la cláusula WHERE para la búsqueda. Puede contener atributos (con puntos). Esta propiedad es obligatoria.
Por ejemplo:
<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: creación de un bloc de notas
Varios de los formularios de la interfaz de analistas de CA SDM utilizan fichas anidadas (bloc de notas). Las fichas anidadas muestran varias series de campos en la misma área física de la pantalla. Sólo una serie de estos campos se mostrará visible cada vez. Para seleccionar la serie de campos que se mostrará, el usuario hace clic en una ficha concreta situada en la parte superior del bloc de notas, o bien pulsa la combinación de teclas de acceso Alt+
n
, donde
n
es el número de la ficha. Un ejemplo de formulario con bloc de notas es el formulario Detalles de incidencia (detail_iss.htmpl). Se recomienda utilizar WSP para modificar el contenido de los blocs de notas o bien para insertar blocs de notas en formularios que no contengan ya uno.
La siguiente etiqueta marca el fin de un bloc de notas:
<PDM_MACRO name=endNotebook>
PDM_PRAGMA: especificación de la información del servidor
La etiqueta <PDM_PRAGMA> se utiliza para especificar información utilizada por el motor Web, como por ejemplo la versión de un formulario. No genera ningún código HTML y se puede colocar en cualquier parte de los formularios. Los argumentos posibles son:
Argumento
Descripción
RELEASE=value
Especifica el número de versión de CA SDM correspondiente al formulario. Este valor es 110 en todos los formularios de CA Service Desk Manager r11.0. Se puede acceder a él dentro del formulario mediante la variable $prop.release.
SITEMOD=value
Especifica una cadena definida por el departamento que identifica las modificaciones aplicadas al formulario. Se puede acceder a él dentro del formulario mediante la variable $prop.sitemod.
VERSION=value
Especifica una cadena definida por CA Technologies que identifica el número de versión del formulario. Se puede acceder a él dentro del formulario mediante la variable $prop.version.
OVERIDE=YES|
NO
Especifica si los valores de la instrucción PDM_PRAGMA sustituyen o no los valores de las instrucciones PDM_PRAGMA anteriores.
CA Technologies utiliza instrucciones PDM_PRAGMA para documentar las versiones del formulario. Todos los formularios de la versión r11.0 de CA Service Desk Manager incluyen la siguiente instrucción PDM_PRAGMA:
<PDM_PRAGMA RELEASE=110>
Además, el formulario std_head.htmpl incluye la siguiente instrucción JavaScript:
cfgFormRelease = "$prop.release" - 0;
La instrucción PDM_PRAGMA y la variable cfgFormRelease permiten a la interfaz web de CA SDM distinguir los formularios de la versión r11.0 de CA Service Desk Manager de los de las versiones anteriores. Las versiones anteriores a CA Service Desk Manager r6.0 no admitían la instrucción PDM_PRAGMA.
Normalmente, sólo se utilizan las instrucciones PDM_PRAGMA del archivo de nivel superior de los formularios (es decir, un archivo no introducido por PDM_INCLUDE) para establecer $prop.release, $prop.sitemod y $prop.version. Asimismo, una instrucción PDM_PRAGMA no sustituirá un valor no vacío establecido por una instrucción PDM_PRAGMA anterior. Puede especificar OVERRIDE=YES para indicar que una instrucción PDM_PRAGMA puede sustituir instrucciones PDM_PRAGMA anteriores, o bien que se puede utilizar una instrucción PDM_PRAGMA de un archivo incluido.
PDM_SCOREBOARD: creación de un árbol del panel de resultados
La etiqueta <PDM_SCOREBOARD> se utiliza para generar el panel de resultados que aparece en la parte izquierda del formulario principal. Admite la siguiente propiedad:
  • TARGET=
    valor
    Especifica el nombre del marco de destino para las listas solicitadas al hacer clic en un nodo del panel de resultados. Las listas se cargan en el destino especificado, que puede ser cualquier valor admitido por el atributo de destino de un vínculo. El valor predeterminado es
    _self
    (la ventana que contiene la etiqueta PDM_SCOREBOARD).
Cualquier formulario HTMPL que incluya una etiqueta <PDM_SCOREBOARD> también debe incluir el archivo JavaScript fldrtree.js. Este archivo se puede incluir con la siguiente instrucción en la sección <HEAD> del formulario:
<SCRIPT LANGUAGE="JavaScript" SRC="$CAisd/CAisd/fldrtree.js"></SCRIPT>
Además, es recomendable incluir un vínculo con el nombre scoreboard_asof_data para mostrar la fecha efectiva de los números del árbol. Consulte el archivo distribuido scoreboard.htmpl para ver un ejemplo del uso de esta etiqueta.
Las consultas incluidas en el panel de resultados se definen según el contenido de la tabla User_Query (nombre de objeto: usq) correspondiente al usuario actual. Cada línea del árbol (carpeta o nodo) está definida por un registro de esta tabla.
Inicialmente, los usuarios no tienen entradas en la tabla User_Query. Los usuarios sin entradas en User_Query reciben el conjunto predeterminado de consultas del panel de resultados asociadas a su tipo de acceso. Los usuarios con autoridad administrativa también pueden personalizar el panel de resultados predeterminado para un tipo de acceso en particular.
PDM_SET: establecimiento del valor de una variable del servidor
La etiqueta
<PDM_SET>
no es compatible con operaciones aritméticas basadas en números enteros como la suma (por ejemplo:
<PDM_SET args.z_counter=$args.z_counter + 1>
).
Solo es compatible para establecer una propiedad de cadena y una operación de concatenación de cadena.
La etiqueta <PDM_SET> se utiliza para asignar valores a las variables de servidor. La sintaxis es la siguiente:
<PDM_SET arg.name[+]=value>
  • arg
    (Obligatorio) Especifica el tipo de variable, y debe ser arg para el uso normal.
    No hay carácter $.
  • Nombre
    (Obligatorio) Especifica el nombre de la variable.
  • +
    (Opcional) Especifica que el valor debe agregarse al valor existente de la variable. No puede haber espacios ni delante ni detrás.
  • =
    (Obligatorio) Se debe especificar exactamente como se muestra, sin espacios antes ni después.
  • value
    (Obligatorio) Especifica el texto que se asignará o agregará a la variable.
La etiqueta PDM_SET también se puede utilizar en la fase de procesamiento previo para crear o actualizar variables de procesamiento previo.
PDM_TAB: creación de una ficha dentro de un bloc de notas
La etiqueta <PDM_MACRO name=startNotebook hdr=cng_nb> se utiliza para definir fichas de blocs de notas. Se recomienda utilizar WSP para modificar el contenido de los blocs de notas o bien para insertar blocs de notas en formularios que no contengan ya uno.
PDM_WSP: control de la vista previa de WSP
La etiqueta <PDM_WSP> se utiliza para controlar la función de vista previa de WSP. No genera ningún código HTML y se puede colocar en cualquier parte de los formularios.
De forma predeterminada, Web Screen Painter determina cómo será la vista previa de los formularios mediante el examen de sus nombres:
  • En el caso de los formularios de detalles (cuyo nombre es detail_
    fábrica
    .htmpl), Web Screen Painter muestra el formulario en la vista de edición, con datos de la fila creada más recientemente en la tabla apropiada. Si no hay datos que el usuario pueda ver en la tabla, WSP muestra la configuración del formulario para crear una fila. Las sesiones de vista previa de WSP normalmente no permiten la actualización de la base de datos. Web Screen Painter muestra los formularios en la vista de edición para permitir la vista previa de todas las funciones. Sin embargo, CA SDM hace caso omiso de las solicitudes de guardado procedentes de sesiones de vista previa de solo lectura. El motor Web cambia el texto del botón Guardar por noGuardar para recordar este hecho de forma visual.
  • En el caso de los formularios de lista (cuyo nombre es list_
    fábrica
    .htmpl), WSP muestra el formulario en la vista de lista y la lista muestra los datos de la fila creada más recientemente en la tabla apropiada. Si no hay datos que el usuario pueda ver en la tabla, Web Screen Painter muestra el formulario en la vista de búsqueda con el filtro abierto.
  • En el caso de otros formularios, WSP muestra el formulario sin contexto de la base de datos.
Este comportamiento predeterminado se puede cambiar si se coloca una etiqueta PDM_WSP en cualquier parte del formulario. Por ejemplo, es posible mostrar un formulario de ficha de bloc de notas en su formulario de detalles asociado, o bien proporcionar argumentos de requisitos previos para formularios normalmente invocados con un entorno proporcionado por otro formulario. Los argumentos posibles son los siguientes:
Propiedad
Descripción
FACTORY=
valor
Especifica la fábrica del motor de objetos utilizada por el formulario.
PREVIEW=
nombre
.htmpl |
valor
|
no
Especifica la dirección URL de vista previa. Puede tratarse de un nombre de archivo HTMPL con el formato xxxx.htmpl, de una dirección URL de CA SDM (utilizada sin cambios siempre que empiece por “OP=”) o de la palabra clave “no”, que indica que la vista previa del formulario no está disponible. Los valores que no empiezan por OP= se modifican mediante la sustitución del formulario {
factory
} o {
factory:
} por un ID o un ID persistente (respectivamente) de la última fila creada en la fábrica que el usuario actual tiene autorización para ver.
WHERE=
valor
Especifica una cláusula WHERE que se utiliza para buscar filas representativas que mostrar en la vista previa del formulario.
MODE=
valor
Especifica el modo de la dirección URL generada. Puede ser los siguientes:
GENERAL Formato general. Examine el argumento de vista previa para determinar el modo:
detail_xxxx.htmpl - READONLY
list_xxxx.htmpl - LIST
Cualquier otro - GRONK
READONLY. Archivo de detalle en la vista de sólo lectura.
EDIT Archivo de detalle en editar vista.
LIST. Archivo de lista.
GRONK. Archivo sin especificar. En esta situación, haga gronk en el archivo.