Las variables de objeto de negocio representan objetos de CA SDM, como incidencias o solicitudes. Para acceder a un objeto, es necesario empezar por el nombre de la variable, seguido de un punto (.), seguido de los nombres de atributos que desee ver. Por ejemplo, en una incidencia en la que, por convención, el objeto se representa mediante los argumentos de variable, se puede mostrar la descripción, la fecha de apertura, el número de teléfono del asignatario, el número de actividades de la incidencia y la descripción de la primera actividad tal y como se muestra a continuación:
$args.description $args.open_date $args.assignee.phone_number $args.act_log.length $args.act_log.0.description
Se pueden utilizar llaves para delimitar el nombre de la variable, en caso de que no esté rodeado por espacios en blanco. Por ejemplo, tanto $foo bar como ${foo}bar son válidos. También se pueden usar los argumentos de variable para acceder a valores sin atributos (por ejemplo, $args.KEEP.nombre, tal y como se explica en Operaciones compatibles).
Es posible que una variable sin atributos no esté definida. Por ejemplo, es posible llegar a un formulario desde dos lugares distintos, de los cuales sólo uno proporciona un valor para $args.KEEP.foo. Se puede proporcionar un valor predeterminado para una referencia $args con la siguiente sintaxis, donde la cadena situada después de los dos puntos se sustituye por la referencia si variable no se ha definido:
${args.variable:default}
Las variables de fecha de huso horario son un caso especial de variables de objeto de negocio. Proporcionan una forma de convertir las fechas universales (UTC) representadas como números enteros en fechas de cadena ajustadas de acuerdo con el huso horario del explorador correspondiente al usuario. La variable para representar fechas como enteros es:
$args.nombre_atributo_INT_DATE
Ejemplo: $args.fecha_creación_INT_DATE
Las variables de datos de fábrica son un caso especial de variables de objeto de negocio. Las variables de datos de fábrica se reemplazan por información acerca del objeto al que se hace referencia. Existen siete variables de este tipo disponibles:
El nombre común (cadena que se puede leer de forma externa) de la tabla a la que hace referencia el atributo. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.assignee.COMMON_NAME es el nombre combinado del asignatario (“apellidos, nombre y segundo nombre”).
El nombre de atributo del nombre común de la tabla a la que hace referencia el atributo. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.assignee.COMMON_NAME_ATTR es “combo_name”.
El nombre de la fábrica asociada al atributo especificado. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.FACTORY_assignee es “agt”.
La longitud máxima del atributo. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.LENGTH_summary es 240.
El atributo de relación (clave externa) del atributo. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.assignee.REL_ATTR es el valor del campo del ID del asignatario.
El nombre de atributo del atributo de relación de la tabla a la que hace referencia el atributo. Por ejemplo, en el formulario Detalles de solicitud, el valor de $args.assignee.REL_ATTR_ATTR es “id”.
Una cadena, ya sea “0” o “1”, que indica si el atributo al que se hace referencia es obligatorio o no.
Una lista de selecciones válidas para nombre_atributo. Este valor es una cadena vacía si nombre_atributo no es una referencia a otra tabla, o bien si el tamaño de la tabla a la que se hace referencia mediante nombre_atributo supera el valor de la propiedad SelListCacheMax del archivo de configuración. De lo contrario, la variable SELECTIONS es una cadena que contiene el nombre común y el atributo de relación de todas las entradas de la tabla a la que se hace referencia. Los valores sucesivos están separados por la cadena “@,@”, así que el valor de la variable tiene este formato:
"cname1@,@rel_attr1@,@cname2@,@rel_attr2"
Una cadena, que puede ser “0” o “1”, que indica si el número actual de filas de la tabla correspondiente a fábrica es inferior al valor de la propiedad SelListCacheMax del archivo de configuración. Esta variable ha quedado obsoleta en favor de la variable SELECTIONS, la cual se debe utilizar en todos los formularios nuevos.
Las referencias con puntos de las variables de datos de fábrica que contienen este tipo de referencias (COMMON_NAME, REL_ATTR y SELECTIONS) pueden tener cualquier longitud. Por ejemplo, en el formulario Detalles de solicitud, $args.assignee.organization.COMMON_NAME se reemplaza por el nombre externo de la organización del asignatario.
|
Copyright © 2013 CA.
Todos los derechos reservados.
|
|