Tema anterior: Variables simplesTema siguiente: Variables de entorno


Variables de propiedad

Las variables de propiedad representan una propiedad del archivo de configuración, web.cfg. Puede acceder a cualquier entrada del archivo web.cfg (incluidas las entradas definidas por el usuario) en un archivo de plantilla HTML si le agrega el prefijo con "$prop."

Por ejemplo, una de las líneas de web.cfg, la cual especifica el número de entradas que se muestran en una única página de un formulario de lista, tiene este aspecto:

ListPageLength 10

Se puede hacer referencia a esta variable en las plantillas HTML con la especificación:

$prop.ListPageLength

Si utiliza la etiqueta especial <PDM_INCLUDE> para incorporar otro archivo en un archivo de plantillas, puede especificar otras propiedades como atributos de la etiqueta <PDM_INCLUDE>. A las propiedades del archivo incluido se hace referencia de la misma forma que en el caso de las propiedades de web.cfg. Si se especifica una propiedad como atributo de <PDM_INCLUDE> y tiene el mismo nombre que una propiedad de web.cfg, sustituirá la propiedad de web.cfg dentro del archivo incluido.

Por ejemplo, la siguiente etiqueta <PDM_INCLUDE> crea una propiedad llamada $prop.menubar a la que se puede hacer referencia dentro del archivo std_body.htmpl:

<PDM_INCLUDE FILE=std_body.htmpl menubar=no>

Nota: Se puede hacer referencia a la propiedad xxx del archivo de configuración de dos maneras: $prop.xxx o $SESSION.xxx. Ambos devuelven el mismo valor. Sin embargo, se prefiere la sintaxis $prop.xxx, ya que implica menos carga para el servidor.

Además de las propiedades de web.cfg, existen varias propiedades predefinidas a las que se puede acceder mediante $prop. Son las siguientes:

$prop.browser

Una cadena que identifica el explorador en uso. Será “IE” en el caso de Internet Explorer.

$prop.combo_name

Una cadena que contiene el nombre del usuario actual con el formato “apellidos, nombre y segundo nombre”.

$prop.factory

Una cadena que contiene la fábrica asociada al formulario actual, como “cr” para las solicitudes o “iss” para las incidencias.

$prop.FID

Una cadena que contiene el ID de formulario numérico del formulario actual.

$prop.form_name

Una cadena que contiene el nombre de la plantilla HTML actual, con el formato xxx.htmpl.

$prop.form_name_1

Una cadena que contiene la subcadena del nombre del formulario situada antes del primer guión bajo. Por ejemplo, en el caso del formulario detail_chg_edit.htmpl, form_name_1 sería “detail”.

$prop.form_name_2

Una cadena que contiene la subcadena del nombre del formulario situada después del primer guión bajo y antes del último guión bajo (o punto). Por ejemplo, en el caso del formulario detail_chg_edit.htmpl, form_name_2 sería “chg”.

$prop.form_name_3

Una cadena que contiene la subcadena del nombre del formulario situada después del último guión bajo y antes del punto. Por ejemplo, para el formulario detail_chg_edit.htmpl, form_name_3 sería "edit". Para el formulario de detalle de combinación, que tiene un nombre de archivo con el formato detail_xxx.htmpl, $prop.form_name_3 se establece según la vista actual, ya sea "ro" o "edit".

$prop.release

Una cadena que contiene el nivel de versión del formulario. La declaración PDM_PRAGMA contiene más detalles sobre esta propiedad.

$prop.SID

Una cadena que contiene el ID de sesión numérico de la sesión actual.

$prop.sitemod

Una cadena que contiene el nombre de modificación definido por el sitio del formulario. La declaración PDM_PRAGMA contiene más detalles sobre esta propiedad.

$prop.user_type

Una cadena que contiene “analyst”, “customer”, “employee” o “guest”.

$prop.version

Una cadena que contiene la versión del formulario. La declaración PDM_PRAGMA contiene más detalles sobre esta propiedad.

Más información:

PDM_PRAGMA: especificación de información de servidor