Permitir
La acción Permitir (imagen siguiente) define una variable cuyo valor se establece por medio (i) de una expresión XPath, (ii) del resultado de un grupo de acciones o (iii) del resultado de una subpágina.
•Para escribir el nombre de la variable haga doble clic a la derecha del signo $ y escriba el nombre de variable (marcado con un círculo verde en la imagen siguiente).
•Seleccione si desea establecer el valor de la variable por medio (i) de una expresión XPath, (ii) del resultado de un grupo de acciones o (iii) del resultado de una subpágina.
•Defina las acciones secundarias de la acción Permitir. Por ejemplo, en el ejemplo de la imagen siguiente la acción Permitir contiene la acción secundaria Actualizar nodo(s), que actualiza el nodo con el valor de la variable definida en la acción Permitir.
| Nota: | La variable que se define en una acción Permitir está dentro del ámbito de la acción Permitir solamente. Esto quiere decir que solamente se puede utilizar en las acciones secundarias de la acción Permitir. |
| Nota: | Si una variable contiene un conjunto de nodos y este se modifica durante el proceso, la variable queda invalidada y ya no se puede usar. Sin embargo, esto no ocurre si solamente se modifican los valores de las variables de un conjunto de nodos. |
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 será el valor de la variable ($area). Esta variable se utiliza después para actualizar el contenido de un nodo de la estructura XML.
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 Devolver valor (imagen siguiente). Observe que en el diseño se declararon dos parámetros ($length y $width). En la acción Devolver valor multiplicamos los valores de los dos parámetros. Recuerde que los valores de los parámetros se obtienen en tiempo de ejecución a partir de los nodos XML especificados en la acción Permitir (imagen anterior) como valores de los parámetros de la acción Permitir.
Opción Resultado de la subpágina
Si marca la opción Resultado de la subpágina (imagen siguiente), el valor de la variable será el resultado de una subpágina. Esto permite realizar un cálculo en otra página y, cuando se cierre la subpágina, existirá la opción de 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 Permitir. Por ejemplo, en el diseño de la imagen siguiente la acción Permitir define una variable llamada $area y establece que su valor es el resultado de la subpágina llamada RectangleArea (marcada con un círculo rojo).
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.