La sintaxis de referencia se abrevia bien porque se indica la posición relativa del cálculo o la secuencia de comandos que contienen la sintaxis de referencia y de las referencias de la sintaxis de objeto o bien porque se emplean métodos abreviados. En general, aunque las sintaxis de referencia abreviadas se crean más rápidamente, presentan la desventaja de que sólo funcionan mientras los objetos permanezcan en la misma posición relativa.Por ejemplo, la siguiente ilustración muestra la jerarquía de un formulario de orden de compra de ejemplo.
Esta ilustración muestra una sintaxis de referencia completa, para FormCalc y JavaScript, que permite acceder al valor del campo txtCondition. Esta sintaxis de referencia se puede utilizar como parte de un cálculo o una secuencia de comandos con cualquier objeto del formulario.
- A.
- Nodo raíz
- B.
- Modelo
- C.
- Nodo raíz de diseño de formulario
- D.
- Objeto de página
- E.
- Nombre de subformulario
- F.
- Nombre de objeto
- G.
- Nombre de propiedad o método
Nota: aunque la sintaxis de referencia es común para FormCalc y JavaScript, se deben respetar las convenciones de cada lenguaje de secuencias de comandos. Por ejemplo, la sintaxis de referencia del ejemplo anterior funciona en FormCalc; sin embargo, se debería incluir un carácter de punto y coma (;) final para JavaScript.
Si los dos objetos se encuentran en el mismo contenedor, como un subformulario, se hace referencia a ellos indicando que comparten el mismo contexto. Si los objetos existen en el mismo contexto, se puede utilizar una sintaxis de referencia abreviada que incluya sólo el nombre del objeto seguido de la propiedad o el método a los que se quiera acceder. Por ejemplo, si tomamos el ejemplo anterior, con la siguiente sintaxis abreviada se accede al valor del campo txtCondition desde cualquiera de los campos del subformulario total:
txtCondition.rawValue
Si los dos objetos se encuentran en contenedores distintos, no comparten el mismo contexto. En ese caso, se puede seguir utilizando una sintaxis de referencia abreviada; sin embargo, la sintaxis debe comenzar con el nombre del objeto de contenedor de nivel superior que no tengan en común ambos objetos. Por ejemplo, si se usa la jerarquía anterior, con la siguiente sintaxis de referencia abreviada se accede al valor del campo address desde el campo txtCondition:
header.address.rawValue
Debido a la forma en la que está estructurado el Modelo de objetos de formulario XML, algunas propiedades y métodos de objetos se encuentran en objetos secundarios de los objetos del formulario. Estos objetos secundarios sólo existen como parte del Modelo de objetos de formulario XML, pero no se muestran en la paleta Jerarquía ni en la paleta Vista de datos. Para acceder a esas propiedades y métodos, se deben incluir los objetos secundarios en la sintaxis de referencia. Por ejemplo, con la siguiente sintaxis de referencia se define el texto de información del objeto para el campo txtCondition:
txtCondition.assist.toolTip.value = "Conditions of purchase." // FormCalc
txtCondition.assist.toolTip.value = "Conditions of purchase."; // JavaScript
Para obtener más información sobre los objetos del modelo de objetos de formulario XML y su estructura, consulte Referencia de secuencias de comandos.
