primeros pasos con desktop studio
TRANSCRIPT
PUBLIC (PÚBLICO)2022-03-15
Primeros pasos con Desktop Studio
© 2
022
SAP
SE o
una
em
pres
a filial d
e SA
P. R
eser
vado
s to
dos
los
dere
chos
.
THE BEST RUN
Contenido
1 Hello World. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31.1 Crear un proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31.2 Crear un workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51.3 Reorganizar la disposición de Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.4 Añadir una actividad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.5 Configurar la actividad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.6 Generar el escenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.7 Testar el escenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.8 Exportar su proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151.9 Importar el proyecto a Factory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161.10 Añadir un desencadenador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
2 Ejecutar y controlar CALC.EXE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.1 Crear un proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.2 Añadir una aplicación nueva. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.3 Capturar la página. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.4 Capturar elementos de IU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262.5 Crear un workflow nuevo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302.6 Añadir la actividad de inicio de aplicación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.7 Añadir una actividad de página. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322.8 Configurar la actividad de página. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332.9 Generar el escenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342.10 Testar el escenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3 Búsqueda Web y salida de hoja de cálculo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403.1 Captura de aplicación web inicial. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413.2 Configurar la aplicación Página. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443.3 Capturar y añadir elementos de IU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463.4 Crear el workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493.5 Configurar la página dentro del workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .523.6 Test preliminar de Tu escenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553.7 Configurar otra página de aplicación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .583.8 Identificar elementos de la IU para los resultados de búsqueda. . . . . . . . . . . . . . . . . . . . . . . . . . . . 613.9 Modificar el workflow y agregar los resultados de la búsqueda. . . . . . . . . . . . . . . . . . . . . . . . . . . . 693.10 Añadir actividades de Excel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733.11 Corrección de URLs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783.12 Test final. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
2PUBLICPÚBLICO
Primeros pasos con Desktop StudioContenido
1 Hello World
Requisitos previos
NotaAntes de hacer este tutorial, asegúrese de que el agente se ha conectado correctamente a un arrendatario. De lo contrario, no podrá completar el tutorial. Para obtener más información, consulte la sección correspondiente en la Guía de instalación.
Procedimiento
En este tutorial breve, recorreremos los diferentes pasos que debe seguir para crear su primer proyecto básico. Estos son:
1. Iniciar el Studio2. Crear un proyecto3. Crear un workflow4. Añadir una actividad al canvas de workflow5. Configurar la actividad6. Build7. Testar en modo de depuración
Al final de este tutorial, podrá crear y testar un escenario en modo de depuración.
1.1 Crear un proyecto
Procedimiento
1. En la barra de menús, haga clic en Archivo Proyecto nuevo...
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 3
2. Indique las propiedades para el proyecto.
Resultados
Studio crea e inicializa su proyecto.
4PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
1.2 Crear un workflow
Procedimiento
1. Vaya a la perspectiva Workflow.
2. Haga clic con el botón derecho y seleccione Workflow nuevo.
3. En la ventana de diálogo Workflow nuevo, cambie el nombre a HelloWorkflow y haga clic en OK.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 5
Resultados
El workflow se visualiza con la actividad inicial representada en verde.
Información relacionada
The Workflow Perspective
1.3 Reorganizar la disposición de Studio
Se recomienda reorganizar la disposición de Desktop Studio para ayudarle a trabajar de forma más eficiente.
6PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
Procedimiento
Arrastre la línea de separación a la izquierda para crear más espacio para las áreas de ventana de la derecha.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 7
8PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
1.4 Añadir una actividad
Procedimiento
A continuación, añada la primera actividad que desea ejecutar en su workflow.1. Vaya al panel Actividades situado en la parte inferior derecha de la pantalla.
2. Desplácese hacia abajo hasta encontrar la categoría Popup y despliéguela.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 9
3. Seleccione la actividad MsgBox y arrástrela y suéltela en el canvas.
4. Utilice los programas de control en el arco de la actividad de inicio para conectarlos a la actividad MsgBox.
10PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
SugerenciasPuede modificar la posición de las actividades en el canvas si es preciso.
1.5 Configurar la actividad
Contexto
Después de haber añadido y conectado la actividad, deberá fijar algunos parámetros.
Procedimiento
1. Seleccione la actividad MsgBox y abra el área de ventana Propiedades .2. Indique un nombre (sin espacio en blanco), un título y un mensaje.3. Deje la propiedad Modelo fijada en OK y seleccione Esperar cierre.4. Seleccione la propiedad Es paso.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 11
1.6 Generar el escenario
El escenario se genera mediante la ejecución de un build.
Procedimiento
1. Haga clic en el pulsador Build .
2. Cambie a la perspectiva Editor y despliegue y abra el escenario.
12PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
1.7 Testar el escenario
Requisitos previos
Para testar su escenario, primero debe ejecutar el Registro de arrendatario de Desktop Agent.
Contexto
Ahora que ha creado su primero escenario, vamos a testarlo.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 13
Procedimiento
1. Active el modo Depurar.
Studio se minimiza y aparece el depurador. El agente carga los escenarios y se visualizan algunos eventos.2. Haga clic en el icono Agente en la bandeja de sistema y haga clic en Testar HelloWorkflow.
A continuación, se ejecuta el escenario y se visualiza el resultado.
3. Haga clic en OK.
El evento se inicia y se puede visualizar en la ventana de depurador.
14PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
1.8 Exportar su proyecto
Procedimiento
En la barra de menús, haga clic en Archivo Exportar proyecto .
Resultados
Su proyecto se exporta como un archivo ZIP. Si no modifica la ubicación en la que se ha archivado el archivo, la podrá encontrar en C:\Users\<your user>\Documents\SAP\Intelligent RPA\Desktop Studio\<your project>\export.
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 15
1.9 Importar el proyecto a Factory
Procedimiento
1. Inicie el explorador Web y conéctelo a SAP Intelligent Robotic Process Automation Factory (mediante el mismo URL que ha utilizado para registrar Desktop Agent).
2. Vaya a la pestaña Paquetes y haga clic en Importar.3. Seleccione el fichero comprimido que ha exportado antes.
Si no ha modificado la ubicación en la que se ha archivado, la puede encontrar en C:\Users\<your user>\Documents\SAP\Intelligent RPA\Desktop Studio\<your project>\export
4. El sistema propone un nombre para un proyecto en la nube que se generará automáticamente al importar el paquete de escritorio. Haga clic en Importar.
Resultados
Ahora que ha importado un paquete, debe añadirlo a un entorno y crear un desencadenador.
16PUBLICPÚBLICO
Primeros pasos con Desktop StudioHello World
1.10 Añadir un desencadenador
Contexto
Una vez importado el paquete, puede añadir un desencadenador de tipo programado.
Procedimiento
1. En la pestaña Paquetes, haga clic en Añadir desencadenador a la derecha del paquete.2. Seleccione su entorno y haga clic en Siguiente.
El paquete se despliega automáticamente en el entorno.3. Seleccione el modo Programado y haga clic en Siguiente.4. Escriba un nombre.5. Opcional: Introduzca una descripción.6. Seleccione el escenario.7. Seleccione la prioridad del desencadenador: Conservar la selección estándar (baja).8. Seleccione un intervalo de fechas y una repetición.9. Haga clic en Crear.
Resultados
Ahora ha añadido un desencadenador.
NotaDespués de añadir un desencadenador, puede esperar a que se inicie automáticamente o puede desencadenarlo manualmente. Siga estos pasos:
1. Haga clic en el desencadenador para visualizar todas las opciones.2. Haga clic en Ejecutar ahora .
Primeros pasos con Desktop StudioHello World
PUBLICPÚBLICO 17
2 Ejecutar y controlar CALC.EXE
En este escenario aprenderá a declarar o capturar su primera aplicación. Utilizará una calculadora como ejemplo.
Los pasos que trataremos son los siguientes:
1. Crear un proyecto [página 18]2. Añadir una aplicación nueva [página 19]3. Capturar la página [página 22]4. Capturar elementos de IU [página 26]5. Crear un workflow nuevo [página 30]6. Añadir la actividad de inicio de aplicación [página 32]7. Añadir una actividad de página [página 32]8. Configurar la actividad de página [página 33]9. Generar el escenario [página 34]10. Testar el escenario [página 35]
2.1 Crear un proyecto
Procedimiento
1. En la barra de menús, seleccione Archivo Proyecto nuevo...
2. Introduzca las propiedades para el proyecto y haga clic en Guardar.
18PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea siguiente: Añadir una aplicación nueva [página 19]
2.2 Añadir una aplicación nueva
Procedimiento
1. En Windows, inicie la calculadora (calc.exe).
2. En Desktop Studio, cambie a la perspectiva Explorador y seleccione Añadir una aplicación nueva... desde el menú contextual.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 19
3. En la ventana Capturar aplicación , seleccione UIAutomation como el conector de tecnología y seleccione Calculadora.
RecomendaciónSi el área en la que debe aparecer la calculadora es negra, asegúrese de que la aplicación Calculadora está en un primer plano. A continuación seleccione el botón de selección Captura de pantalla, en el área Modo de captura. Por último haga clic en el icono Actualizar y seleccione la aplicación de la lista.
4. Opcional: Modifique el nombre de la aplicación y la descripción.5. Haga clic en Guardar y capturar página o Guardar.
20PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Resultados
La aplicación Calculadora se ha añadido a su proyecto.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 21
Pasos siguientes
En las propiedades, introduzca calc.exe como vía de acceso de lanzamiento para finalizar.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Crear un proyecto [página 18]
Tarea siguiente: Capturar la página [página 22]
2.3 Capturar la página
22PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Requisitos previos
El cuadro de diálogo Capturar página debe estar abierto. Si no lo está,
● Haga doble clic en el cuadro de página nueva
● o haga clic con el botón derecho en la aplicación Calculadora y seleccione Capturar una página nueva ... del menú contextual
Procedimiento
1. Asegúrese de que la calculadora se encuentra en primer plano, selecciónela manteniendo pulsada la tecla Ctrl y coloque el cursor sobre la aplicación.
Aparece un rectángulo rojo alrededor de la calculadora y se muestra una lista de nombres de página en la sección Páginas.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 23
2. Seleccione Ventana - Calculadora en la parte superior de la lista y haga clic en Escanear y capturar.3. En la pantalla Datos capturados, seleccione Name=Calculator y haga clic en el icono del signo más (+) en
la pantalla de criterios.
4. En la ventana Parámetros, establezca el Modo de actualización en Sondeo.
Esto garantiza que el bot reconozca la aplicación cuando se inicie.
Resultados
Su página está ahora lista para que pueda añadir elementos de IU.
24PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Pasos siguientes
No olvide añadir calc.exe a las propiedades.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Añadir una aplicación nueva [página 19]
Tarea siguiente: Capturar elementos de IU [página 26]
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 25
2.4 Capturar elementos de IU
Contexto
Ahora que ha capturado la página, puede empezar a buscar los pulsadores. Empezaremos con el pulsador 4. Dependiendo de dónde hace clic en la calculadora, puede capturar la etiqueta o el pulsador:
Etiqueta capturada Pulsador capturado
Procedimiento
1. Seleccione el pulsador 4 y haga doble clic en él.
El pulsador btNum4Button aparecerá en rojo. Se requiere un criterio para garantizar un reconocimiento correcto.
2. En el ámbito de imagen Datos capturados, haga clic en la propiedad AutomationID=num4Button y luego haga clic en el icono del signo más (+) situado en el área de criterios para añadir este criterio.
26PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
btNum4Button ahora aparece en verde.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 27
3. Repita el proceso para el pulsador 2.
28PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Esta vez, haga doble clic en la propiedad AutomationID=num2Button. De este modo se añadirá el pulsador y el criterio en un paso.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 29
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Capturar la página [página 22]
Tarea siguiente: Crear un workflow nuevo [página 30]
2.5 Crear un workflow nuevo
30PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Procedimiento
1. Guarde su proyecto.2. Vaya a la perspectiva Workflow, marque la aplicación y seleccione Workflow nuevo... del menú contextual.
3. Introduzca un nombre.
Resultados
El workflow se ha creado ahora.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Capturar elementos de IU [página 26]
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 31
Tarea siguiente: Añadir la actividad de inicio de aplicación [página 32]
2.6 Añadir la actividad de inicio de aplicación
Contexto
El workflow que ha creado debe comenzar con una actividad que inicie la aplicación de calculadora.
Procedimiento
1. En la ficha Actividades, arrastre y suelte Inicio (en Aplicación) en la zona de diseño situada junto a Inicio.2. Busque la actividad de aplicación en la ventana Propiedades y seleccione Calculadora en la lista
desplegable.
El cuadro de actividades del área de diseño se actualiza automáticamente para visualizar "Iniciar calculadora".
3. Opcional: Fije la propiedad de actividad Esperar inicio para evitar un timeout.4. Haga clic con el botón derecho en este cuadro de actividad y seleccione fijar como Nodo de inicio.
Aparece una flecha de Inicio en la actividad "Iniciar calculadora".
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Crear un workflow nuevo [página 30]
Tarea siguiente: Añadir una actividad de página [página 32]
2.7 Añadir una actividad de página
Contexto
El workflow que ha creado puede utilizar páginas de aplicación que se han declarado.
32PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Procedimiento
1. En la ventana Actividades, haga clic en la pestaña Páginas, haga clic en la flecha situada junto a Calculadora y, a continuación, arrastre y suelte la página pWindowCalculator en el canvas junto a la actividad inicial.
2. Utilice los handles para conectar las dos cajas.
Resultados
Su workflow tiene ahora una actividad de página.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Añadir la actividad de inicio de aplicación [página 32]
Tarea siguiente: Configurar la actividad de página [página 33]
2.8 Configurar la actividad de página
Procedimiento
A continuación, debe configurar la actividad de página.1. Haga doble clic en la actividad de página para tratarla.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 33
2. En la ventana Actividades, busque la actividad Esperar existencia en Elemento - Esperar y arrástrela y suéltela en el botón 4.
3. Arrastre y suelte la actividad Hacer clic en el botón 4.
4. Repita el proceso con el pulsador 2 para definir la segunda acción.
Pasos siguientes
Ahora es el momento de compilar y probar su flujo de trabajo.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Añadir una actividad de página [página 32]
Tarea siguiente: Generar el escenario [página 34]
2.9 Generar el escenario
34PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Procedimiento
Haga clic en el pulsador Crear .
Resultados
Si su workflow crea correctamente, debería ver la pantalla sin errores.
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Configurar la actividad de página [página 33]
Tarea siguiente: Testar el escenario [página 35]
2.10 Testar el escenario
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 35
Requisitos previos
Para testar su escenario, primero debe ejecutar el Registro de arrendatario de Desktop Agent.
Procedimiento
1. Inicie el modo de depuración.
Desktop Studio se minimiza y aparece el depurador.
36PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Desktop Agent carga el escenario y se visualizan algunos eventos. Puede observar que la calculadora se identifica en los eventos.
2. Haga clic en Desktop Agent y seleccione Testar calcWorkflow.
El depurador proporciona datos a los eventos adicionales.
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 37
Resultados
¡Felicidades! La calculadora debería mostrarle ahora la respuesta correcta.
38PUBLICPÚBLICO
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
Resumen de tarea: Ejecutar y controlar CALC.EXE [página 18]
Tarea anterior: Generar el escenario [página 34]
Primeros pasos con Desktop StudioEjecutar y controlar CALC.EXE
PUBLICPÚBLICO 39
3 Búsqueda Web y salida de hoja de cálculo
En este tutorial le mostraremos cómo capturar una aplicación Web y utilizar los resultados para proporcionar datos a una hoja de cálculo. Cuando haya terminado el tutorial, habrá definido y ejecutado un workflow correspondiente.
Procedimiento
Los pasos que seguirá en este tutorial son:1. Crear un proyecto nuevo.2. Capturar su aplicación.3. Definir un workflow.4. Probar su workflow.
Resultados
Al final del tutorial, verá el resultado en la perspectiva Explorador y en el diseñador de workflow.
Resultado en la perspectiva Explorador
40PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Resultado en el diseñador de workflow
3.1 Captura de aplicación web inicial
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 41
Procedimiento
1. Inicie Internet Explorer e introduzca el URL de su buscador favorito.
En este tutorial utilizaremos https://www.lilo.org/en como ejemplo.
2. Inicie Desktop Studio y cree un proyecto nuevo.3. En la perspectiva del Explorador, haga clic en + Añadir aplicación4. En la ventana Capturar aplicación, seleccione WEB como el conector de tecnología y seleccione la página
de buscador desde la lista de aplicaciones.
5. Introduzca un nombre y una descripción y haga clic en Guardar y capturar página para capturar inmediatamente una página, o Guardar.
42PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
La aplicación se ha añadido a su proyecto.
6. Si es necesario, haga doble clic para iniciar la captura de páginas o haga clic con el botón derecho en el nombre de la aplicación y seleccione Capturar una página nueva ....
7. Cuando la ventana Capturar página esté abierta, seleccione la página que desea capturar. Para ello, mantenga pulsada la tecla Ctrl y coloque el cursor sobre la página del motor de búsqueda en el navegador.
Aparece un rectángulo rojo alrededor de la página y aparece un nombre predeterminado en el campo Nombre y la URL en el campo Descripción.
8. Modifique el nombre de propuesta a pHome y haga clic en Escanear y capturar.
Después de unos segundos, la página estará incluida en su proyecto.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 43
3.2 Configurar la aplicación Página
Contexto
Por el momento ha capturado la página, pero todavía no se reconoce completamente. Esto se indica con el color rojo.
44PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Para reconocerla se debe añadir un criterio. El ámbito de imagen Datos capturados contiene información que puede utilizar como criterio para definir el mecanismo de reconocimiento.
Procedimiento
1. Seleccione el URL.
El área Criterios ahora está actualizada.
2. Haga clic en el icono del signo más (+) para añadir el criterio como está.
Resultados
El URL se ha añadido ahora como criterio principal y la página se reconoce completamente.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 45
3.3 Capturar y añadir elementos de IU
Contexto
La siguiente fase de nuestro escenario consiste en introducir un string de búsqueda e iniciar la búsqueda. Para ello, es necesario buscar el campo de entrada y el botón Buscar. Por el momento, la página no tiene ningún elemento de IU que podamos utilizar, de modo que se debe añadir.
Procedimiento
1. Haga clic en la entrada de búsqueda en la parte superior de la pantalla y preste atención a las propiedades situadas en el subscreen Datos capturados.
46PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
2. Haga doble clic o haga clic con el botón derecho para añadir el campo de búsqueda como elemento nuevo.3. El elemento oQ se añade en verde debajo de la página y el subscreen de criterios tiene el valor INPUT
name="q".
4. Abra el menú contextual para oQ y renómbrelo a oQuery.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 47
Ahora se debe añadir al campo de entrada el icono de la lupa a la derecha del campo de búsqueda.
5. Haga doble clic en el botón Buscar.El elemento se añade al proyecto pero se visualiza en rojo. Ahora se debe añadir un criterio para que podamos utilizarlo más tarde.
6. En el subscreen Datos capturados, seleccione class=bg-white pointer.
7. En el subscreen de criterios, haga clic en el icono más (+) para añadir el criterio.
El pulsador se reconoce ahora.
48PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
8. Renombre el pulsador de oIMG a btSearch9. Guarde el proyecto.
Resultados
Ha definido correctamente el campo de entrada y el botón de búsqueda.
3.4 Crear el workflow
Contexto
Nuestro siguiente objetivo es crear un workflow que cubra tanto la búsqueda web como la creación de una hoja de cálculo. Utilizaremos la posición GLOBAL para añadir el workflow.
Procedimiento
1. Abra la perspectiva Workflow y haga clic con el botón derecho dentro de la posición GLOBAL para añadir un workflow nuevo.
2. Llame el workflow.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 49
Se crea el workflow.3. Vaya a Actividades y arrastre y suelte la actividad de la aplicación Inicio que se encuentra debajo del inicio
de workflow.
La actividad de la aplicación Inicio se ha añadido y se ha vinculado al inicio del workflow. Si no es el caso, utilice los vínculos de la aplicación Inicio para enlazar los dos elementos.
4. Haga clic en el icono Editar parámetros o haga doble clic en la aplicación Inicio para mostrar sus propiedades.
50PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
5. Dentro de las propiedades de la aplicación, vaya al campo Aplicación en Actividad.
6. Haga clic para visualizar las aplicaciones y seleccione appLilo.
Su aplicación ahora está definida.
7. Vaya a Páginas, despliegue la aplicación, y arrastre y suelte la página pHome en el canvas. Asegúrese de que esté conectada correctamente a la actividad anterior.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 51
3.5 Configurar la página dentro del workflow
Procedimiento
1. Desde el workflow haga doble clic para abrir pHome.
52PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Aparecerá la pantalla siguiente:
Para introducir texto en el campo de búsqueda utilizaremos la actividad Fijar. Esta actividad se encuentra en la categoría Elemento - Fijar; sin embargo, también debe aparecer en Más utilizados.
2. Arrastre y suelte la actividad Fijar en el campo de búsqueda.
Se genera una descripción predeterminada.3. Haga clic en la descripción predeterminada para editar sus propiedades.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 53
4. Busque la propiedad Datos de origen y el valor de propuesta $data$.
5. Cambie $data$ a 'SAP Intelligent RPA’.
RecuerdeAsegúrese de incluir las comillas simples; de lo contrario su creación fallará.
A continuación, se debe proceder del mismo modo para iniciar el pulsador, pero en lugar de Fijar, utilizaremos la actividad Hacer clic.6. Arrastre y suelte la actividad Hacer clic en el pulsador.
54PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Resultados
Su página tiene ahora dos actividades y está lista para el test.
3.6 Test preliminar de Tu escenario
Requisitos previos
Para probar el escenario, primero debe declarar el Desktop Agent donde se va a ejecutar el escenario en un grupo de agentes utilizando SAP Intelligent Robotic Process Automation Factory. Para obtener más información, consulte Crear un grupo de agentes.
Contexto
Es una buena práctica para verificar su escenario en esta etapa antes de continuar.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 55
Procedimiento
1. Si no lo ha hecho ya, guarde el proyecto.2. Haga clic en Crear.
Si aparece un error, verifique que ha realizado los pasos anteriores correctamente.
3. Lance su proyecto en modo de depuración
Aparecerá el depurador.
4. Haga clic en el systray Desktop Agent.
5. Haga clic en el correspondiente workflow.
56PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Algunos eventos se visualizarán en el depurador.
El navegador Web también aparece y muestra los resultados de la búsqueda.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 57
3.7 Configurar otra página de aplicación
Contexto
Tras ejecutar el escenario, conserve el explorador Web y los resultados correspondientes. Los utilizaremos como fuente para la página siguiente.
Procedimiento
1. Abra la perspectiva Explorador, haga clic con el botón derecho del ratón en la aplicación y seleccione Capturar una nueva página...
58PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
2. En el diálogo Capturar página, haga clic en Explorar y seleccione los resultados de búsqueda de lilo para SAP Intelligent RPA.
3. Haga clic en Capturar y editar.4. Modifique el nombre de propuesta a pResults y haga clic en Iniciar captura.
Unos momentos después se habrá capturado completamente la página y aparecerá como elemento inferior de la aplicación. Es necesario fijar el comportamiento de reconocimiento.5. En el subscreen Datos capturados, busque la propiedad «URL».6. Seleccione la propiedad URL.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 59
Aparece en el subscreen de criterios.
7. Conserve solo el inicio del URL, es decir, https://search.lilo.org/results.php?.
8. Cambie el operador de Completo a Se inicia.
9. Haga clic en el icono del signo más (+) para añadir el criterio.
60PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
El URL de inicio se añade como criterio principal y la página se reconoce ahora completamente.
3.8 Identificar elementos de la IU para los resultados de búsqueda
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 61
Contexto
Ahora queremos recuperar los resultados. Vamos a seleccionar todos los resultados DIV para ver qué sucede. Seleccionando el DIV (id=results) no podremos recuperar los resultados pero resultará más fácil seleccionar un resultado de DIV (class=result).
DIV con id=results
62PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
DIV con class=result
Abramos el primer DIV (class=result).
Procedimiento
1. Haga doble clic para añadir este DIV.En estos momentos, el DIV no se reconoce.
2. Añada el criterio class=result.
El DIV se reconoce ahora.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 63
Sin embargo, solamente el primer DIV puede utilizarse, por tanto, hay que solucionarlo.3. Utilice la propiedad Ocurre del subscreen de criterios. Este patrón reconocerá todos los elementos DIV que
tengan los mismos criterios.
64PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
4. Renombre oDIV a oResult.Seleccione el botón de selección Ambos para cambiar al modo combinado, ver qué se ha reconocido y buscar los elementos anidados. En la captura de pantalla de abajo, el objeto oResult se repite y cada elemento va seguido de []. Esto representa un índice que empieza por cero. El primer bloque (DIV class=resultthumbnail) contiene la descripción del resultado del proceso de búsqueda web.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 65
5. Haga clic en el segundo bloque (DIV class=resulturl). Contiene el URL de la página web encontrada por el buscador.
66PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
6. Haga doble clic en el primer bloque (DIV class=resultthumbnail) para añadirlo.
Por ahora, no se reconocerá.
7. Vaya al panel Parámetros y en la propiedad Predecesor seleccione oResult.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 67
8. Renombre el elemento de oDIV a oResults.
9. Para seleccionar el segundo bloque (DIV class=resulturl), seleccione la propiedad Ocurre en el subscreen de criterios.
Puede observar que el DIV va seguido de [] []. Esto representa una matriz con varias filas y dos columnas.
oResults se ha completado ahora. El acceso a la propiedad Ocurre también está disponible en el panel de propiedades.
68PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
3.9 Modificar el workflow y agregar los resultados de la búsqueda
Contexto
En este paso utilizaremos pResults en nuestro workflow y proporcionaremos datos a una tabla (o a una matriz).
Procedimiento
1. Verifique si ha guardado su proyecto.2. Vaya a la perspectiva Workflow y abra el workflow.3. Arrastre y suelte la nueva página en el canvas.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 69
4. Haga doble clic para abrir pResults.
70PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Utilizaremos la actividad getTable para recuperar todos los resultados.
5. Arrastre y suelte la actividad getTable en el bloque oResults.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 71
La actividad getTable ahora está asociada al bloque oResults.
Si selecciona las propiedades, verá que la propiedad Datos se ha actualizado.
72PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
El contexto correspondiente también se ha actualizado.
3.10 Añadir actividades de Excel
Contexto
En el paso Modificar el workflow y agregar los resultados de la búsqueda [página 69], proporcionamos datos a una tabla o matriz. Ahora utilizaremos esta tabla para proporcionar datos a una hoja de cálculo.
Procedimiento
1. Expanda la categoría de actividades Excel Lib.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 73
2. Añada y conecte las actividades siguientes en este orden: Iniciar Excel, Crear Excel, Fijar tabla de ranges y Liberar Excel.
74PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
3. Iniciar Excel inicia Microsoft Excel. Conserve las opciones por defecto.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 75
4. Crear Excel crea una hoja de cálculo de Excel. No se requiere ninguna propiedad específica para ello.
5. Fijar tabla de ranges prepara los datos que desea copiar de la página Web.
6. Fije la columna de inicio en 'B' (no se olvide de las comillas simples antes y después del valor), fije la fila de inicio en 2, y seleccione los datos contextuales expandiendo el contexto (oResults).
76PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Ahora sus propiedades deben tener la apariencia siguiente:
7. Asegúrese de que la integración de Excel está activada para su proyecto. Para ello, seleccione ArchivoEditar proyecto... y en la etiqueta Bibliotecas seleccione Integración de Excel en Microsoft Office.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 77
3.11 Corrección de URLs
Contexto
Quizá haya observado que los URLs para las dos páginas no son los mismos: Uno es www.lilo.org y el otro es búsqueda.lilo.org. Ya que esto podría conducir a problemas a la hora de ejecutar el escenario, procedamos a solucionarlo.
Abra la perspectiva Explorador, seleccione la aplicación y fíjese en los criterios definidos. Debido a la modificación del subdominio (de www.* a search.*), debemos modificar el operador de criterio.
78PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Procedimiento
1. En el subscreen de criterios elimine el subdominio.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 79
2. Cambie el operador de Completo a Finaliza.
3. Actualice los criterios.
80PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
El criterio definido a nivel de aplicación ahora está OK.
Los distintos criterios para cada elemento deben tener la apariencia siguiente:
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 81
3.12 Test final
Contexto
Ha completado con éxito todos los pasos anteriores. Vamos a hacer un test posterior del escenario.
Procedimiento
1. Haga clic en Crear.
Si aparece un error, verifique que ha realizado los pasos anteriores correctamente.
2. Inicie su proyecto en modo de depuración
Aparecerá el depurador.
82PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
3. Haga clic en el systray Desktop Agent.
4. Haga clic en el correspondiente workflow.
Algunos eventos se visualizarán en el depurador.
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
PUBLICPÚBLICO 83
Resultados
Se visualiza un Microsoft Excel que enumera los resultados de búsqueda de su búsqueda en la Web.
¡Felicidades! Ha finalizado este tutorial.
84PUBLICPÚBLICO
Primeros pasos con Desktop StudioBúsqueda Web y salida de hoja de cálculo
Limitaciones de responsabilidad y aspectos legales
HiperenlacesAlgunos enlaces se clasifican con un icono y/o con un texto al pasar el puntero del ratón. Estos enlaces proporcionan información adicional.Acerca de los iconos:
● Enlaces con el icono Está entrando en una página Web que no está alojada por SAP. Al usar este tipo de enlaces, manifiesta su acuerdo (a no ser que se indique expresamente lo contrario en sus contratos con SAP) con lo siguiente:
● El contenido del sitio al que se accede a través del enlace no es documentación SAP. No puede realizar ninguna reclamación de producto contra SAP en base a esta información.
● SAP no manifiesta su acuerdo o desacuerdo con el contenido del sitio al que se accede a través del enlace, ni garantiza su disponibilidad o exactitud. SAP no es responsable de ningún daño causado por el uso de este contenido a menos que los daños se hayan causado por una imprudencia grave o por una conducta fraudulenta dolosa por parte de SAP.
● Enlaces con el icono Está dejando la documentación para este producto o servicio de SAP en concreto y está entrando en un sitio Web alojado por SAP. Al usar este tipo de enlaces, manifiesta su acuerdo (a no ser que se indique expresamente lo contrario en sus contratos con SAP) a no realizar ninguna reclamación de producto contra SAP en base a esta información.
Vídeos alojados en plataformas externasAlgunos vídeos pueden dirigir a plataformas de hospedaje de vídeos de terceros. SAP no puede garantizar la disponibilidad futura de vídeos almacenados en estas plataformas. Además, cualquier anuncio u otro contenido alojado en estas plataformas (p. ej., vídeos sugeridos o la navegación a otros vídeos alojados en el mismo sitio), no se encuentra bajo el control o la responsabilidad de SAP.
Beta y otras funciones experimentalesLas funciones experimentales no forman parte del alcance de la entrega oficial que SAP garantiza para futuras versiones. Esto significa que SAP puede modificar las funciones experimentales en cualquier momento, por cualquier motivo y sin previo aviso. Las funciones experimentales no están previstas para su uso productivo. No podrá mostrar, probar, examinar, evaluar las funciones experimentales o realizar cualquier otro uso de ellas en un entorno operativo en directo o con datos que no estén suficientemente fundamentados.El propósito de las funciones experimentales es obtener de manera anticipada comentarios que permitan a los clientes y partners influir en el producto futuro en consecuencia. Al proporcionar su opinión (p. ej. en la Comunidad SAP), acepta que los derechos de propiedad intelectual de las contribuciones o de las tareas derivadas seguirán siendo propiedad exclusiva de SAP.
Código de ejemploCualquier codificación de software y/o fragmentos de código son ejemplos. No están previstos para su uso productivo. El código de ejemplo tiene el único propósito de explicar y permitir la visualización de las reglas de sintaxis y de redacción SAP no garantiza la exactitud ni la integridad de los códigos de ejemplo. SAP no es responsable de ningún error o daño causado por el uso de código de ejemplo a menos que los daños se hayan causado por una imprudencia grave o por una conducta fraudulenta dolosa por parte de SAP.
Lenguaje sin sesgosSAP apoya una cultura de diversidad e inclusión. Siempre que sea posible, utilizamos un lenguaje imparcial en nuestra documentación para referirnos a personas de todas las culturas, etnias, géneros y habilidades.
Primeros pasos con Desktop StudioLimitaciones de responsabilidad y aspectos legales
PUBLICPÚBLICO 85
www.sap.com/contactsap
© 2022 SAP SE o una empresa filial de SAP. Reservados todos los derechos.
Queda prohibida la reproducción o transmisión de cualquier parte de esta publicación, en cualquier forma o para cualquier fin, sin el permiso expreso de SAP SE o de una empresa filial de SAP. La información que aquí se incluye puede modificarse sin previo aviso.
Algunos productos de software comercializados por SAP SE y sus distribuidores contienen componentes de software con derechos de autor de otros proveedores de software. Las especificaciones de productos en cada país pueden ser diferentes.
SAP SE o una empresa filial de SAP SE proporcionan estos materiales con fines meramente informativos, sin manifestación ni garantía de ningún tipo. Ni SAP SE ni sus empresas filiales se hacen responsables de los errores u omisiones en relación con los materiales. Las únicas garantías para los productos y servicios de SAP SE o de sus empresas filiales son aquellas especificadas en las cláusulas expresas de garantía que acompañan a dichos productos y servicios, si las hubiera. Nada de lo que se incluye en este documento debe interpretarse como garantía adicional.
SAP y los productos y servicios de SAP mencionados, así como sus respectivos logotipos, son marcas comerciales o marcas registradas de SAP SE (o de una empresa filial de SAP) en Alemania y en otros países. Todos los nombres y servicios de productos son las marcas comerciales de sus respectivas empresas.
Consulte https://www.sap.com/spain/about/legal/trademark.html para obtener información y avisos adicionales sobre marcas comerciales.
THE BEST RUN