Crear una calculadora en tiempo real

Información general

Para observar la comunicación instantánea entre UiPath Apps y UiPath Robot, deberás:

• Cree un proyecto en UiPath Studio que consista en:

  • Main.Xaml: el flujo de trabajo principal utilizado para ejecutar los desencadenadores
  • Varios flujos de trabajo desencadenados por aplicación: utilizados para operaciones aritmáticas básicas. Estos flujos de trabajo se configurarán como puntos de entrada.

  Operación aritmética	Flujo de trabajo de Studio
  adición	Sum.xaml
  Sustracción	Subtract.xaml
  Multiplicación	Multiply.xaml
  División	Divide.xaml

  • El flujo de trabajo del desencadenador: este flujo de trabajo está disponible como plantilla, pero también puede crearlo y personalizarlo según las necesidades de su negocio.

• Cree una aplicación en UiPath Apps que consista en:

  • Dos controles de entrada: donde introduce sus números
  • Controles de cuatro botones: configurados con la regla Flujo de trabajo de desencadenador , para vincular el botón a una operación aritmética específica, que está representada por un flujo de trabajo de Studio
  • Cuatro controles de cuadros de texto: donde se envía el resultado de las operaciones aritméticos

Crear el proyecto de Uipath Studio

Nota:

Asegúrate de utilizar las versiones 2023.4 y posteriores de UiPath Studio, y las versiones 2023.4 y posteriores de UiPath Robot.

Si es posible, recomendamos configurar el proyecto de Studio para Iniciar como proceso en segundo plano. Esto es útil para tener la misma aplicación ejecutándose simultáneamente en varias ventanas del navegador, sin arrojar errores.

Crear el flujo de trabajo del desencadenador (plantilla)

1. Abra UiPath Studio y cree un nuevo proceso.

   1. Selecciona el idioma.
   2. Selecciona Windows como Compatibilidad.

2. Asegúrese de tener las siguientes versiones de paquetes de actividades:

   • UiPath.WorkflowEvents.Activities 2.0
   • UiPath.System.Activities 23.4+

3. Comienza desde la plantilla llamada Comunicación Apps-Flujo de trabajo/ En el panel Proyecto , añade un nuevo flujo de trabajo. Esto contendrá las actividades que habilitan el canal de comunicación entre UiPath Apps y UiPath Robot: las actividades Desencadenador de solicitud de Apps y Gestionar solicitud de Apps .

   Si utilizas la plantilla de comunicación Apps-Workflow , pasa a Crear los flujos de trabajo de la calculadora.

4. Añade la actividad Desencadenador de solicitud de Apps . Esta debe ser la primera actividad del flujo de trabajo.

   Cuando añades la actividad Desencadenador de solicitud de Apps a tu flujo de trabajo, el argumento TriggerEventArgs se crea automáticamente. Úsalo en la actividad Gestionar solicitud de aplicaciones para acceder a los datos de la carga útil de respuesta recibida después de la ejecución del flujo de trabajo.

5. Añade una actividad Si para detectar el caso de perder la conexión con el cliente de Apps. Cuando el usuario cierra el cliente de Apps, deben detenerse todos los desencadenadores.

   1. En el campo Condición , escribe la siguiente expresión: ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. En la sección Entonces , añade la actividad Detener desencadenadores locales .
   3. En la sección Else , añade la actividad Gestionar solicitud de Apps .
   4. En los campos Argumentos de la actividad Gestionar solicitud de Apps , utiliza el argumento TriggerEventArgs que fue creado automáticamente por la actividad Desencadenador de solicitud de Apps . Este argumento contiene la carga útil del flujo de trabajo recibida de la actividad Desencadenador de solicitud de aplicaciones y la pasa a la actividad Gestionar solicitud de aplicaciones . Mientras se ejecuta el flujo de trabajo, la actividad Gestionar solicitud de aplicaciones utiliza la información de la carga útil para invocar el flujo de trabajo y luego devuelve los resultados de salida del flujo de trabajo cuando se completa el flujo de trabajo.
      Nota:

      La actividad Gestionar solicitud de aplicaciones debe utilizarse dentro de la sección Else de la condición para la pérdida de conexión. Esto garantiza que la actividad se invoque durante una conexión activa entre UiPath Apps y UiPath Robot. Por lo tanto, cuando se pierde la conexión, la ejecución del proceso finaliza.

Crear flujos de trabajo de la calculadora

1. Cree una carpeta en su proyecto y asígnele el nombre "Calculadora". Aquí es donde almacena los flujos de trabajo de la calculadora.

2. Dentro de la carpeta, cree un flujo de trabajo para cada operación aritmética:

   Operación aritmética	Flujo de trabajo de Studio
   adición	Sum.xaml
   Sustracción	Subtract.xaml
   Multiplicación	Multiply.xaml
   División	Divide.xaml

3. En todos los flujos de trabajo creados anteriormente, defina los siguientes argumentos:

   Nombre de Argumento	Dirección	Tipo de argumento
   number1	En	Int32
   number2	En	Int32
   Resultado	Salida	Int32 Double: para la división

   Los argumentos "número1" y "número2" son los datos que introduce el usuario de Apps.

   El "resultado" de argumento es la salida recibida después de la ejecución del flujo de trabajo.

4. En todos los flujos de trabajo creados anteriormente, añade la actividad Asignar . Configúralo de la siguiente manera:

   Flujo de trabajo	Guardar en campo	Valor para guardar el campo
   Sum.xaml	Resultado	number1 + number2
   Subtract.xaml	Resultado	number1 - number2
   Multiply.xaml	Resultado	number1 * number2
   Divide.xaml	Resultado	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. Guarde sus flujos de trabajo.

6. Marca los flujos de trabajo de la calculadora como puntos de entrada: haz clic con el botón derecho en cada flujo de trabajo y selecciona la opción Habilitar punto de entrada . Esto garantiza que tus XAML se muestren en tu aplicación.

Creación del flujo de trabajo principal

Nota:

Si utilizas la plantilla de comunicación Apps-Workflow , omite este paso.

En el archivo Main.xaml, simplemente añade la actividad Ejecutar desencadenadores locales y luego guarda el archivo.

Gestionar el proyecto en Orchestrator

1. En Studio, publica tu paquete de proyecto en una carpeta de Orchestrator.
   Nota:

   Si publicas el proyecto en un espacio de trabajo personal, se crea automáticamente el proceso correspondiente. Pasa a Crear el proyecto de Apps.

2. En tu tenant de Orchestrator, ve a la carpeta donde has publicado el paquete de Studio.
3. Dirígete a Automatización > Procesos y haz clic en Añadir proceso.
4. En el menú desplegable Nombre de origen del paquete , selecciona el proyecto de Studio.
5. En el menú desplegable Punto de entrada , selecciona Main.xaml.
6. En las siguientes páginas, configura tu proceso como desees y luego haz clic en Crear. Tu proyecto de Studio ya está disponible como proceso de Orchestrator.

Creación del proyecto de Apps

Nota:

Asegúrate de utilizar UiPath Apps con la opción Expresiones VB habilitada.

Añadir los controles

1. En la página de inicio de UiPath Apps > pestaña Crear , haz clic en Crear nueva aplicación.

2. Introduce el nombre de tu aplicación. Por ejemplo, "Calculadora en tiempo real".

3. Para Lenguaje de expresión, selecciona VB.

4. En la página principal, añade los siguientes controles con las siguientes propiedades generales :

   Control	Propiedad general: valor	Descripción
   1. Etiqueta	Texto: "Calculadora en tiempo real"	Agrega un título a su aplicación.
   2. Cuadro de texto (Número): cámbiele el nombre a "número1"	Etiqueta: "Primer número" Texto de sugerencia: "Introduzca el primer número entero"	Permite a los usuarios introducir sus datos.
   3. Cuadro de texto (Número): cámbiele el nombre a "número2"	Etiqueta: "Segundo número" Texto de sugerencia: "Introduzca el segundo número entero"	Permite a los usuarios introducir sus datos.
   4. Botón - cámbiele el nombre a "suma"	Texto: "Sum"	Desencadena la ejecución del archivo Sum.xaml.
   5. Texbox: cambiarle el nombre a "suma_resultado"	N/A	Genera la respuesta del archivo Sum.xaml.
   6. Botón: cámbiele el nombre a "restar"	Texto: "Sustraer"	Desencadena la ejecución del archivo Subtract.xaml.
   7. Texbox: cambiarle el nombre a "subtract_result"	N/A	Genera la respuesta del archivo Subtract.xaml.
   8. Botón: cámbiele el nombre a "Multiplicar"	Texto: "Multiplicar"	Desencadena la ejecución del archivo Multiply.xaml.
   9. Texbox: cámbiele el nombre a "multiplica_resultado"	N/A	Genera la respuesta del archivo Multiply.xaml.
   10. Botón: cámbiele el nombre a "Dividir"	Texto: "Dividir"	Desencadena la ejecución del archivo Divide.xaml.
   11. Texbox: cambiarle el nombre a "divid_result"	N/A	Genera la respuesta del archivo Divide.xaml.

Añadir el proceso

Agrega el proceso como un recurso para vincular los flujos de trabajo de Studio a los controles de Apps.

1. En tu aplicación, expande el menú desplegable Añadir control y selecciona Proceso.
2. Se muestra una lista de tenants para la cuenta actual. Elige el que aloja los procesos que necesitas y haz clic en Siguiente.
3. En el panel lateral izquierdo, expande la carpeta de Orchestrator donde creaste tu proceso, selecciona el proceso y luego haz clic en Añadir. Por ejemplo, selecciona el proceso "Calculadora".

Una vez que agregas el proceso en tu aplicación, muestra el flujo de trabajo principal y los flujos de trabajo marcados como puntos de entrada, junto con sus argumentos de entrada y salida, tal como se define en el proyecto de Studio.

Agregar reglas a los controles de botones

Al añadir la regla TriggerWorkflow a cada control Botón , instruyes a la aplicación para que ejecute un flujo de trabajo específico cada vez que el usuario de Apps haga clic en el botón.

Repita los siguientes pasos para cada control de botón:

1. Selecciona el control de botón.

2. A la derecha, en el panel Eventos , haz clic en Crear regla. Se abre el asistente Configurar regla .

3. Busca la regla TriggerWorkflow y selecciónala.

4. En el campo Archivo de flujo de trabajo , expande el proceso añadido anteriormente ("Calculadora") y selecciona el flujo de trabajo correspondiente (archivo .xaml). Por ejemplo, el botón Suma debe hacer referencia al archivo "calculator_Sum_xaml".

5. Haz clic en el campo Anular entrada y luego expande el flujo de trabajo previamente seleccionado.

   1. Haz doble clic en "número1" para seleccionarlo como primer argumento de entrada.

   2. Para el campo Introducir valor , haz clic en el icono "sintonizar" para abrir el editor de expresiones y escribe la siguiente expresión VB: MainPage.number1.Value

   3. Haga doble clic en "número2" para seleccionarlo como segundo argumento de entrada.

   4. Para el campo Introducir valor , haz clic en el icono "sintonizar" para abrir el editor de expresiones y escribe la siguiente expresión VB: MainPage.number2.Value

      Nota:

      "número1" y "número2" en la expresión hacen referencia a los controles Cuadro de texto(número) , que se renombraron como "número1" y "número2" respectivamente. Al establecer el valor de estos controles como los valores para los argumentos de entrada, pasas las entradas del usuario de Apps al flujo de trabajo de Studio.

   

6. Expande el campo Cuando esté completo y añade la regla Establecer valor .

   1. Para el campo Elemento a establecer , haz clic en el icono "sintonizar" para abrir el editor de expresiones y hacer referencia al control de resultado. Por ejemplo, para el resultado de la suma, escribe la siguiente expresión VB: MainPage.sum_result.Value

   2. Para el campo Valor , haz clic en el icono "sintonizar" para abrir el editor de expresiones y hacer referencia al resultado del flujo de trabajo. Por ejemplo, para la operación de suma, escribe la siguiente expresión VB: Processes.Calculator.calculator_Sum_xaml.result.ToString.

      Nota:

      Añadir la regla Establecer valor en el campo Cuando se complete garantiza que el valor utilizado para vincular el resultado del flujo de trabajo al control de resultado correspondiente sea correcto, ya que utiliza los valores devueltos como salida después de que se complete la ejecución del flujo de trabajo.

      

7. Repita los pasos anteriores para los botones restantes:

   Control de botones	Archivo de flujo de trabajo
   Restar	calculator_Subtract_xaml
   Multiplicar	calculator_Multiply_xaml
   Dividir	calculator_Divide_xaml

Publicar e implementar su aplicación en Orchestrator

Para preparar tu aplicación para su ejecución, debes publicarla en la fuente del tenant de Orchestrator y luego implementarla.

1. En Apps, haz clic en Publicar en la barra de navegación superior.
2. Cambie a Orchestrator y navegue hasta la carpeta deseada.
3. Ve a Automatizaciones > Apps y haz clic en Implementar aplicación. Se abre el asistente Implementar aplicación .
4. En el menú desplegable Aplicación , selecciona la aplicación publicada anteriormente.
5. Haz clic en Implementar. Ahora tu aplicación está disponible en tu carpeta de Orchestrator para ejecutarse.

Ejecutar su aplicación

Ya está listo para ejecutar su aplicación.

1. En UiPath Assistant, en el panel Inicio , busca tu aplicación en la categoría Aplicaciones .
2. Haz clic en Ejecutar. Se te pedirá que concedas acceso a UiPath Robot Assistant.
3. Introduzca dos números.
4. Haga clic en un botón para la operación aritmética deseada.

El primer cálculo tarda más porque es la primera instancia del trabajo. Después de eso, el trabajo sigue ejecutándose y devuelve los resultados al instante. Cuando cierra la sesión de Apps, el trabajo termina.