Actualizar variable
Esta acción (imagen siguiente) actualiza el valor de una variable definida por el usuario a la que se identifica seleccionándola en la acción ($area en la imagen siguiente). El valor nuevo con el que se actualiza es uno de estos:
•el resultado de evaluar la expresión XPath que utilice
•el resultado de un Grupo de acciones
•el resultado de una subpágina
La variable que se actualiza puede ser cualquier variable definida por el usuario que esté dentro del alcance en el momento en que se desencadena la acción Actualizar variable. estas variables se encuentran: variables globales definidas por el usuario; variables definidas en las acciones Permitir y Probar/Capturar excepciones; las variables de los grupos de acciones, los parámetros de una subpágina y los parámetros y las variables de las plantillas de controles. (Recuerde que la acción Actualizar variable no se puede aplicar a las variables de bucle.)
Haga doble clic en el campo (en un círculo verde) e introduzca el nombre de la variable definida por el usuario o selecciónela de la lista que aparece.
En tiempo de ejecución, si no se encuentra ninguna variable con ese nombre se genera un mensaje de error a este efecto junto con una lista de las variables disponibles en ese momento y que se podrían actualizar.
| Nota: | Las variables definidas en la aplicación (como las variables globales dinámicas y las variables globales estáticas) no pueden modificarse con la acción Actualizar variable. |
Opción XPath
Si marca la opción XPath podrá introducir un valor estático o generar un valor dinámico. Por ejemplo, en el diseño de la imagen siguiente se multiplican los valores de dos nodos (marcado con un círculo rojo). El valor resultante se pasa a la variable definida por el usuario $area.
Opción Resultado del grupo de acciones
Si marca la opción Resultado del grupo de acciones (imagen siguiente), el valor de la variable será el valor del resultado de un grupo de acciones. Por ejemplo, en el diseño de la imagen siguiente la variable recibe el nombre $area y se definió que su valor sea el resultado de un grupo de acciones llamado RectangleArea (marcado con un círculo rojo). (Todos los grupos de acciones del diseño se enumeran en el cuadro combinado de la variable.) Para editar el grupo de acciones haga clic en el botón Editar (marcado con un círculo verde). También se definió que el valor de los dos parámetros sea un valor dinámico, es decir, los parámetros toman su valor de los nodos de la estructura XML.
El grupo de acciones devuelve un resultado a través de la acción Valor devuelto (imagen siguiente). En la imagen siguiente, por ejemplo, se declaramos dos parámetros ($length y $width); en la acción Valor devuelto se multiplican los valores de los dos parámetros. Recuerde que los valores de los parámetros se obtienen en tiempo de ejecución de los nodos de la estructura XML que se hayan definido como los valores de la acción Permitir (imagen anterior).
La opción Resultado de la subpágina
La opción Resultado de la subpágina (imagen siguiente) define el valor de la variable coo el resultado de la subpágina. Esto permite realizar el cálculo en una página distinta. Cuando se cierra una subpágina puede optar por devolver un resultado. Este resultado es el "resultado de la subpágina" que se utilizará como valor de la variable definida en la acción Actualizar variable. Por ejemplo, en el diseño de la imagen siguiente la acción Actualizar variable define una variable llamada $area y establece que su valor es el resultado de la subpágina llamada RectangleArea.
Las propiedades de la opción Resultado de la subpágina son las mismas que las de la acción Ir a la subpágina.
En tiempo de ejecución, cuando se ejecute la acción Permitir, la subpágina se abre y se procesa según lo definido en su diseño. La subpágina se cerrará cuando se ejecute la acción Cerrar la subpágina. Esta acción tiene un valor devuelto opcional que se calcula por medio de una expresión XPath (imagen siguiente). Este valor devuelto se pasará a la acción Permitir y se convertirá en el valor de la variable definida en dicha acción.
Funciones de extensión de MobileTogether
MobileTogether cuenta con distintas funciones de extensión XPath creadas específicamente para usarlas en los diseños de MobileTogether. Algunas de ellas son especialmente útiles para ciertas acciones en concreto. Por ejemplo, mt-available-languages() devuelve los idiomas en que está disponible la solución y se podría usar, por ejemplo, con la acción Cuadro de mensaje. Si alguna función es especialmente relevante para esta acción, aparece a continuación. Para ver una lista completa de funciones de extensión y sus descripciones consulte Funciones de extensión de MobileTogether.