Tutorial VPL. Creación de tu propia Actividad

El presente tutorial utiliza el anterior apartado para ilustrar cómo crear su propia actividad y de esta forma crear aplicaciones modulares.

Este tutorial se encuentra en la carpeta de instalación de MSRDS bajo la subcarpeta “Samples\VPLTutorials\Tutorial3”.

Para empezar, cree un nuevo proyecto seleccionando “New” del menú “File”. A continuación, inserte (arrastrar o doble clic) una actividad “Variable” de la caja de herramientas/ventana de actividades. Cree una nueva actividad insertando un bloque de actividad en el diagrama, haga clic en su título y reemplácelo por “ContarHasta10”. Abra la actividad con doble clic o en el menú contextual (botón derecho) seleccione “Open”. Aparecerá una nueva lengüeta o tab con el contenido de esta actividad. Seleccione el botón “Action” en la parte superior de la lengüeta y seleccione “Action” del menú desplegable, cambiando al manejador de acción de la actividad. Aunque la lengüeta de la nueva actividad es similar a la de nivel superior, se pueden observar a ambos lados del nuevo diagrama los pines de conexión (entrada/salida) con los que se conectará el flujo externo a esta actividad con su propio flujo interno.

En el menú “Edit” seleccione “Actions and Notifications” o presiones el botón siguiente a la lista desplegable de “Action” cuyo icono es . Seleccione la lengüeta “Action”, una acción llamada “Action” y un valor de entrada para la acción. Este valor será el valor de entrada que se utilizará para realizar el conteo. Cambie el valor del nombre de la entrada a “StarValue” y establezca su tipo de dato a entero “Int”. Para estas acciones deberá utilizar los botones “Add” que le permitirán añadir nuevas acciones, valores y tipos. Al terminar, presione “Ok”.

Figura 74: Creación de una nueva actividad y establecimiento de valores de

Dentro del flujo de la nueva actividad inserte todo los bloques contenidos en el tutorial anterior. En esta ocasión, será necesario cambiar levemente los enlaces entre los distintos bloques para que funcione apropiadamente en este nuevo escenario. Comenzaremos insertando un bloque “Calculate” y conectando su pin de entrada al pin de entrada de la actividad con “StartValue”. Esto extraerá “StartValue” de la acción del mensaje de entrada.

Inserte una actividad “Merge” a la derecha del bloque anterior “Calculate” y conecte su salida a la entrada del bloque “Merge”. Conecte la salida del bloque “Merge” a la entrada de un nuevo bloque “Variable” con “SetValue”. Cree una variable dentro del bloque “Variable” llamada “Test2” de tipo entero.

Ahora Inserte un bloque “If” con la única condición “Test2 = 10” y conecte su entrada al pin de salida del bloque “Variable”. La salida de la cláusula “Else” del bloque “If” se conectará a un bloque “Calculate”. La salida del bloque “Calculate” se conectará a la entrada del nuevo bloque “Merge” insertado anteriormente, eliminando la necesidad del bloque “Variable” que existía en el diagrama antiguo del tutorial anterior.

Figura 75: Inserción y configuración de los bloques “Data”, “Merge”, “Variable”

Inserte un bloque “Calculate” conectando su entrada a la salida del bloque variable. En este nuevo bloque inserte en la caja de texto de expresiones la siguiente cadena entre guiones -“The number is “ + Test2- (incluidas las dobles comillas).

Ahora inserte un bloque “Data” y conecte su entrada a la salida de la única condición del bloque “If”, seleccionando “String” para el tipo y en la caja de texto introduzca el siguiente texto entre guiones –All Done!-

Inserte un bloque “Merge” a la derecha del último bloque y conecte a sus entradas las salidas de los bloques “Data” y “Calculate”. Esto simplificará las conexiones de la actividad que se está creando.

En el menú “Edit” seleccione “Actions and Notifications” o presiones el botón siguiente a la lista desplegable de “Action” cuyo icono es . Seleccione la lengüeta “Notifications” y con los botones “Add” añada el valor “Text” de tipo “String”. Al terminar presione “Ok”.

Figura 76: Configurando el Pin de salida de notificaciones de la actividad.

Ahora puede conectar la salida del último bloque “Merge” al círculo del pin de salida de notificaciones de la actividad. En la ventana de diálogo que aparecerá, seleccione la notificación que creó en el paso anterior.

Figura 77: Conexión del flujo de la actividad al pin de salida de notificaciones de la actividad.

En la ventana que se le mostrará seguidamente de datos de las conexiones seleccione los valores siguientes:

Figura 78: Datos de la conexión para la salida de la actividad desde el bloque Merge

Vuelva a la lengüeta de la actividad principal de la aplicación que está creando e inserte una actividad “Data”. Conecte el pin de salida de la actividad “Data” al pin de entrada de la actividad recién creada. Añada el valor 1 en la caja de texto del bloque “Data” y seleccione “Int” para su tipo de dato.

Marque con el cursor el bloque de la actividad creada “ContarHasta10” y realice la operación de copiar y pegar sobre el diagrama (basta con pulsar Ctrl-C seguido de Ctrl-V). Inserte un servicio “TesttoSpeechTTS2” de la caja de herramientas o ventana de servicios. Enlace el pin de salida de notificaciones de la copia realizada a la actividad “ContarHasta10” con el pin de entrada del servicio “TexttoSpeechTTS” y configure la conexión con la notificación creada y el valor “SayText”. En la ventana de datos de la conexión seleccione “Text” tal y como se aprecia en la siguiente figura.

Figura 79: Datos de la conexión para la salida de la actividad al bloque TexttoSpeechTTS

En la mayoría de los casos, no son necesarios bucles ni tantas variables. A continuación se muestra el diagrama de la actividad “ContarHasta10” modificado para eliminar el bucle y las variables.

Figura 80: Segundo diseño para el tutorial “Creación de su propia actividad” sin bucle ni variables

Aunque no se explicará paso a paso ya que es semejante al anterior diseño, cabe resaltar dos puntos que se consideran de interés:

1. Se recomienda IR al diagrama principal, marcar y copiar con Ctrl-C el bloque de la actividad que estamos creando e ir dentro de dicha actividad y pegarla con Ctrl-V, dotando de recursividad a esta actividad.

2. La conexión entre el bloque “Calculate” y el bloque de la actividad “ContarHasta10” se debe configurar con “value” en la ventana de datos de la conexión. De esta forma pasará el valor obtenido en “Calculate” que es un entero.