Referencia a objetos en cálculos y secuencias de comandos

A pesar de que tanto los cálculos de FormCalc como las secuencias de comandos de JavaScript disponen de reglas para estructurar el código, ambos se basan en la misma sintaxis de referencia al acceder a las propiedades y los valores de los objetos de formulario. El Modelo de objeto de formulario XML proporciona un modo estructurado de acceder a las propiedades y los valores de los objetos a través de una convención de nomenclatura compuesta que incluye cada objeto, propiedad y método separados por el carácter de punto (.).

En general, cada sintaxis de referencia presenta una estructura similar dividida en las siguientes secciones:

  • Los nombres de los objetos principales en la jerarquía del formulario que se emplea para acceder a un campo o un objeto específicos. Se pueden utilizar las paletas Jerarquía y Vista de datos para determinar la ubicación de un objeto en relación con otros objetos del formulario o de cualquier dato asociado.

  • El nombre del objeto al que se hace referencia.

  • El nombre de la propiedad o el método a los que se quiere acceder. Esta sección puede incluir además objetos del Modelo de objetos de formulario XML que preceden a la propiedad o el método en la estructura, pero que no aparecen como objetos en la paleta Jerarquía.

Por ejemplo, la siguiente ilustración muestra la sintaxis de referencia para acceder al valor de un campo de texto en un diseño de formulario que emplea las convenciones de nomenclatura de objetos predeterminadas:

A.
Objetos de la jerarquía de formularios

B.
Nombre de objeto

C.
Nombre de propiedad o método

Nota: de forma predeterminada, el objeto de subformulario que representa la primera página de un formulario nuevo no tiene nombre. En la sintaxis de referencia anterior, el subformulario sin nombre se representa mediante #subform.

La estructura de notación de la sintaxis de referencia variará ligeramente según la situación específica. Por ejemplo, la sintaxis de referencia completa funciona en cualquier situación; sin embargo, en algunos casos, se puede utilizar una sintaxis de referencia abreviada o un método abreviado de sintaxis de referencia para reducir el tamaño de la sintaxis.