Grupos de acciones con parámetros

www.altova.com Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Acciones > Grupos de acciones >

Grupos de acciones con parámetros

Este es el funcionamiento de los parámetros en los grupos de acciones:

 

Los parámetros se declaran en un grupo de acciones y después se definen las acciones (dentro del grupo de acciones) que utilizan dichos parámetros.
Los valores de los parámetros se pasan a los parámetros cuando se llama al grupo de acciones desde la acción Ejecutar grupo de acciones.

 

Declarar parámetros en grupos de acciones y definir qué acciones utilizan dicho parámetros

En el grupo de acciones declare los parámetros necesarios para generar el resultado deseado. Esto se hace con el icono Agregar parámetro (imagen siguiente). Después de añadir un parámetro nuevo, haga doble clic a la derecha del símbolo $ y escriba el nombre del parámetro.

 

Por ejemplo, en la imagen siguiente tenemos un grupo de acciones llamado RectangleArea donde declaramos dos parámetros llamados $length y $width. Observe que no se marcó la casilla Opcional de los parámetros. Esto significa que cuando se llame al grupo de acciones en tiempo de ejecución, será obligatorio suministrar los valores de estos parámetros. De lo contrario, se generará un mensaje de error.

MTDActionGroupParams

El grupo de acciones está compuesto por dos acciones:

 

Una acción Actualizar nodos que multiplica los dos parámetros ($length y $width) para generar un valor que actualiza el nodo Area.
Una acción Cuadro de mensaje que muestra un cuadro de mensaje con el valor obtenido de la multiplicación de los dos parámetros.

 

Observe que en el grupo de acciones declaramos los parámetros y definimos las acciones que utilizan estos parámetros. El valor de los parámetros se suministra en tiempo de ejecución a través de la acción Ejecutar grupo de acciones.

 

Suministrar el valor de los parámetros

El valor de los parámetros de un grupo de acciones se suministra al grupo de acciones a través de la acción Ejecutar grupo de acciones. Esta acción se define para el evento y se procesa cuando éste se desencandena. Es decir, cuando se desencadene el evento, los valores de parámetro se pasan al grupo de acciones. El grupo de acciones utiliza estos valores cuando lleve a cabo las acciones definidas en el grupo.

 

Para crear una acción Ejecutar grupo de acciones arrastre el grupo de acciones correspondiente (desde el panel Grupos de acciones) y colóquelo en la definición de acciones del evento. El grupo de acciones aparece como una acción Ejecutar grupo de acciones. Por ejemplo, en la imagen siguiente se definió una acción Ejecutar grupo de acciones para un evento AlHacerClicEnBotón. Para ello arrastramos el grupo de acciones RectangleArea y lo colocamos justo debajo del evento Al hacer clic. Puede elegir el grupo de acciones que se ejecutará en el cuadro combinado de la acción Ejecutar grupo de acciones (marcado con un círculo rojo).

MTDActionGroupParamsExecute

Si se declararon parámetros en el grupo de acciones que está seleccionado, entonces dichos parámetros aparecerán en la acción Ejecutar grupo de acciones. Aquí es donde debe suministrar los valores que se deben pasar a los parámetros en tiempo de ejecución. Observe que, en el ejemplo de la imagen anterior, el grupo de acciones RectangleArea tiene dos parámetros ($length y $width). En el ejemplo se definieron valores estáticos simples(3 y 4) en las expresiones XPath que se utilizan para generar el valor de estos dos parámetros. Sin embargo, también puede obtener valores dinámicos de las fuentes de datos o especificar cálculos XPath complejos. Si los parámetros se declararon como obligatorios en el grupo de acciones y no se suministró un valor, los parámetros aparecen en rojo.

 

Esto es lo que ocurrirá en tiempo de ejecución:

 

1.Cuando se desencadene el evento, los valores de parámetro (tal y como se definieran en la acción Ejecutar grupo de acciones) se pasan a los parámetros correspondientes en el grupo de acciones.
2.Se procesan las acciones que componen el grupo de acciones. Cuando estas utilicen los parámetros declarados, el valor de parámetro se utiliza.

 


© 2019 Altova GmbH