# Encontrar Proveedores
Consideremos un ejemplo de un robot que demuestra la automatización de la búsqueda de proveedores.
El proyecto del robot consta de 4 diagramas y 7 archivos en formatos xlsx, txt y docx.
Así, si se describe paso a paso, este robot funciona de la siguiente manera:
1. Revisa el correo y al recibir un mensaje (el cual está definido en el archivo “WorkBodyEmail.txt”) hace una solicitud para buscar un producto en Yandex.
2. Recorre los enlaces del resultado de la búsqueda y recopila correos electrónicos.
3. Filtra los enlaces utilizando los datos del archivo “BlockEmails.xlsx”.
4. Realiza un envío a las direcciones de correo electrónico especificadas, tomando el asunto del correo del archivo “RequestSubjectEmail.txt” y el cuerpo del correo del archivo “RequestBodyEmail.txt”; se adjuntan dos archivos a los correos: la primera es la solicitud del archivo “RequestWordTemplate.docx”, y la segunda son los detalles de la empresa del archivo “CompanyDetails.xlsx”.
El diagrama principal del proyecto se ve así (para mayor comodidad, los bloques del diagrama están numerados):
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Proceso”** permite crear escenarios que constan de varios diagramas. La ejecución del escenario continuará desde el bloque “Inicio” del diagrama del proyecto especificado. La ejecución del escenario volverá al bloque actual y continuará en el diagrama actual tan pronto como se alcance el bloque “Fin” en el diagrama externo. Para el bloque “Proceso” se ha especificado la propiedad “Nombre del diagrama” (el nombre del archivo del diagrama en el que continuará la ejecución del escenario).
3. **Bloque “Pausa”** detiene la ejecución del trabajo del escenario durante un tiempo determinado. En este caso, durante 10 segundos.
4. **Bloque “Obtener correos a través de POP3”** permite recibir correos utilizando el protocolo POP3. Para este bloque se han especificado las siguientes propiedades:
* Servidor (servidor);
* Login (login necesario para la autorización en el servidor);
* Contraseña (contraseña necesaria para la autorización en el servidor);
* Tiempo de espera (tiempo de espera de respuesta del servidor en segundos);
* SSL (si se activa, se utiliza una conexión segura);
* Cantidad de correos (número de los últimos correos que se recibirán del servidor).
5. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del escenario del robot. Para este bloque se ha especificado la propiedad “Valor”. En las comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot un mensaje de error.
6. **Bloque “Ciclo para cada (Lista)”** recorre todos los elementos en una lista dada, en cada iteración del ciclo asigna el elemento actual a la variable que se indica en la propiedad “Elemento”, y luego la ejecución del escenario continúa hacia la salida del Elemento de este bloque (en lo que se llama “cuerpo del ciclo”). Después de recorrer todos los elementos de la lista, la ejecución del escenario continúa hacia la salida inferior del bloque. No olvide conectar la salida del último bloque en el cuerpo del ciclo con la entrada de este bloque. Para este bloque se ha especificado una propiedad: “Lista” (lista cuyos elementos deben ser recorridos en el ciclo).
**¡Importante!** *Para que el ciclo se reinicie, debe dirigirse no al propio ciclo, sino al bloque superior noг*о.
7. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se han indicado dos valores que deben asignarse a dos variables, respectivamente.
8. **Bloque “Codificar en Base64”** permite codificar una cadena en Base64. Para este bloque se ha especificado una propiedad: “Texto” (cadena de entrada).
9. **Bloque “Verificar la existencia de un elemento en la lista”** realiza una búsqueda en la lista y determina: si el elemento buscado está presente en la lista o no. Para este bloque se han especificado las siguientes propiedades:
* Lista (lista en la que se debe verificar la existencia del elemento buscado);
* Elemento (elemento cuyo hecho de existencia se debe verificar);
* Tipo de verificación (selección del tipo de verificación).
10. **Bloque “Agregar elemento a la lista”** añade el elemento especificado al final de la lista. Para este bloque se han especificado las siguientes propiedades:
* Lista (lista a la que se debe agregar un nuevo elemento);
* Elemento (variable que se debe agregar a la lista).
11. **Bloque “Dividir texto”** divide una cadena en subcadenas basándose en el símbolo delimitador especificado. Para este bloque se han especificado las siguientes propiedades:
* Texto (cadena de entrada);
* Nueva línea (si se activa, la división se realizará por nueva línea);
* Eliminar subcadenas vacías (si se activa, se eliminarán las cadenas vacías del resultado);
* Recortar (si se activa, cada línea en el resultado será recortada).
12\. \*\*Bloque "Condición"\*\* verifica la veracidad de la condición especificada, después de lo cual la ejecución del escenario continúa hacia la salida "Sí" (si se cumple la condición) o hacia la salida "No" (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[0] == "SherpaRPA". Es decir, en el cuerpo del correo debe estar la palabra clave "SherpaRPA".
13. **Bloque "Log"** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del escenario del robot. Para este bloque se ha especificado la propiedad “Valor”. En comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot el mensaje “No hay palabra clave SherpaRPA en el correo”.
14. **Bloque "Ciclo"** permite repetir una cadena de acciones (bloques) varias veces y, al mismo tiempo, contar el número de iteraciones del ciclo, registrando el número actual en una variable especial (especificada en la propiedad “Ciclo”), que luego se puede utilizar en otros bloques. En la primera entrada al bloque, el valor de la variable de la propiedad “Ciclo” se iguala a “Valor inicial” (en este caso es 1), y luego la ejecución del escenario continúa hacia la salida “Ciclo” de este bloque (en el llamado “cuerpo del ciclo”). Tan pronto como la ejecución del escenario vuelva a este bloque, el valor de la variable “Ciclo” aumentará en el valor de “Paso” (en este caso, es 1), y nuevamente se producirá la transición hacia la salida “Ciclo”. Una vez que el valor de la variable “Ciclo” sea mayor o igual a “Valor final” (en este caso, está dado por la variable $listbody.Count - 1), la ejecución del escenario continuará hacia la salida inferior del bloque. No olvide conectar la salida del último bloque en el cuerpo del ciclo con la entrada de este bloque o de alguno de los bloques anteriores.
15. **Bloque "Proceso"** permite crear escenarios compuestos por varios diagramas. La ejecución del escenario continuará desde el bloque “Inicio” del diagrama del proyecto especificado. La ejecución del escenario volverá al bloque actual y continuará en el diagrama actual, tan pronto como se alcance el bloque “Fin” en el diagrama externo. Para el bloque “Proceso” se ha especificado la propiedad “Nombre del diagrama” (nombre del archivo del diagrama en el que continuará la ejecución del escenario).
16. **Bloque "Proceso"** permite crear escenarios compuestos por varios diagramas. La ejecución del escenario continuará desde el bloque “Inicio” del diagrama del proyecto especificado. La ejecución del escenario volverá al bloque actual y continuará en el diagrama actual, tan pronto como se alcance el bloque “Fin” en el diagrama externo. Para el bloque “Proceso” se ha especificado la propiedad “Nombre del diagrama” (nombre del archivo del diagrama en el que continuará la ejecución del escenario).
17. **Bloque "Condición"** verifica la veracidad de la condición especificada, después de lo cual la ejecución del escenario continúa hacia la salida "Sí" (si se cumple la condición) o hacia la salida "No" (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Pedido:". Es decir, en el cuerpo del correo debe estar "Pedido:".
18. **Bloque "Asignar valor a variable"** establece nuevos valores para una o varias variables. En este caso, en las propiedades se ha indicado un valor que debe asignarse a una variable, respectivamente.
19. **Bloque "Condición"** verifica la veracidad de la condición especificada, después de lo cual la ejecución del escenario continúa hacia la salida "Sí" (si se cumple la condición) o hacia la salida "No" (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Gerente:". Es decir, en el cuerpo del correo debe estar "Gerente:"
20. **Bloque "Asignar valor a variable"** establece nuevos valores para una o varias variables. En este caso, en las propiedades se ha indicado un valor que debe asignarse a una variable, respectivamente.
21. **Bloque "Condición"** verifica la veracidad de la condición especificada, después de lo cual la ejecución del escenario continúa hacia la salida "Sí" (si se cumple la condición) o hacia la salida "No" (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Producto:". Es decir, en el cuerpo del correo debe estar "Producto:"
22. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
23. **Bloque “Condición”** verifica la condición especificada para su veracidad, después de lo cual la ejecución del guion continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Cantidad:". Es decir, en el cuerpo del correo debe haber "Cantidad:".
24. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
25. **Bloque “Condición”** verifica la condición especificada para su veracidad, después de lo cual la ejecución del guion continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Dirección:". Es decir, en el cuerpo del correo debe haber "Dirección:".
26. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
27. **Bloque “Condición”** verifica la condición especificada para su veracidad, después de lo cual la ejecución del guion continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "De la empresa:". Es decir, en el cuerpo del correo debe haber "De la empresa:"
28. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
29. **Bloque “Condición”** verifica la condición especificada para su veracidad, después de lo cual la ejecución del guion continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual a (==)/ mayor que (>)/ menor que (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces la salida es “Sí”, de lo contrario – la salida es “No”.
En este caso, como condición se establece: $listbody\[$Index] == "Descripción del producto:". Es decir, en el cuerpo del correo debe haber la palabra clave "Descripción del producto:".
30. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
31. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell.
**Diagrama “ProcessCreateWord”**
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Abrir documento”** permite abrir un documento de Word. Para este bloque se especifican las siguientes propiedades:
* Usar COM (con la bandera activada, el trabajo se realiza a través de Word instalado);
* Ruta al archivo (ruta al documento de Word que se debe abrir).
3. **Bloque “Reemplazar todas las variables en el texto (Word)”** permite reemplazar todas las variables %variable% en un documento de Word. Para este bloque se especifican las siguientes propiedades:
* Enlace a Word (enlace al proceso de procesamiento del documento de Word. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace a Word", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento);
* Enlace al documento (enlace al documento de Word abierto, en el que actualmente se está trabajando. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace al documento", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento).
4. **Bloque “Nuevo archivo”**
5. **Bloque “Guardar documento”** permite guardar un documento de Word. Para este bloque se especifican las siguientes propiedades:
* Enlace a Word (enlace al proceso de procesamiento del documento de Word. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace a Word", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento);
* Enlace al documento (enlace al documento que se debe guardar. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace al documento", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento);
* Ruta al archivo (ruta al documento de Word).
**¡Importante!** *Para guardar el documento en el mismo archivo, deje el valor vacío. De lo contrario, ingrese una nueva ruta al archivo. Si el archivo especificado existe, será sobrescrito. Formatos disponibles: ".docx", ".pdf".*
6. **Bloque “Cerrar documento”** permite cerrar un documento de Word. Para este bloque se especifican las siguientes propiedades:
* Enlace a Word (enlace al proceso de procesamiento del documento de Word. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace a Word", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento);
* Enlace al documento (enlace al documento que se debe cerrar. El nombre de la variable en esta propiedad debe coincidir con el nombre de la variable en la propiedad "Enlace al documento", bloques "Crear documento" o "Abrir documento" del grupo Word, que se utilizaron anteriormente para crear o abrir este documento).
7. **Bloque “Fin”** (este bloque finaliza la ejecución del script o devuelve el diagrama del subproceso al proceso principal).
**Diagrama “ProcessGetEmails”**
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del script del robot. Para este bloque se especifica la propiedad “Valor”. En comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot “Búsqueda:” y el nombre del producto buscado.
3. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso, se ejecutan dos expresiones.
4. **Bloque “Búsqueda de Yandex”** permite obtener una lista de enlaces en respuesta a una consulta en el motor de búsqueda Yandex. Para este bloque se especifican las siguientes propiedades:
* Consulta (consulta que se debe enviar al motor de búsqueda Yandex);
* Máximo de páginas (número máximo de páginas de las que se deben obtener enlaces en respuesta a la consulta en el motor de búsqueda Yandex);
* Tiempo de espera (tiempo de espera para la respuesta del motor de búsqueda Yandex en milisegundos, si se supera el valor especificado, la operación se cancela).
5. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del script del robot. Para este bloque se especifica la propiedad “Valor”. En comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot un mensaje de error.
6. **Bloque “Reconocimiento de CAPTCHA”** realiza el reconocimiento automatizado de bloques CAPTCHA.
7\. \*\*Bloque “Ciclo para cada (Lista)”\*\* itera sobre todos los elementos en la lista dada, en cada iteración del ciclo asigna el elemento actual a la variable que se indica en la propiedad “Elemento”, y luego la ejecución del script continúa hacia la salida Elemento de este bloque (en el llamado “cuerpo del ciclo”). Después de iterar sobre todos los elementos de la lista, la ejecución del script continúa hacia la salida inferior del bloque. No olvide conectar la salida del último bloque en el cuerpo del ciclo con la entrada de este bloque. Para este bloque se ha especificado una propiedad: “Lista” (lista cuyos elementos deben ser iterados en el ciclo).
**¡Importante!** *Para que el ciclo se reinicie, debe dirigirse no al propio ciclo, sino al bloque que está por encima de él.*
8. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del script del robot. Para este bloque se ha especificado la propiedad “Valor”. En las comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot la URL del producto.
9. **Bloque “Ejecutar solicitud GET”** envía una solicitud GET y obtiene el código de la página devuelta. Para este bloque se han especificado las siguientes propiedades:
* URL (enlace a la página web a la que se debe enviar la solicitud GET);
* Codificación (codificación de la página web);
* UserAgent (UserAgent que se debe utilizar al acceder a la página web necesaria);
* TLS 12 (si se activa la bandera, se utilizará el protocolo seguro TLS 12 al acceder a la página web).
10. **Bloque “Obtener lista de subcadenas por expresión regular”** permite obtener una lista de subcadenas de un texto mediante la búsqueda con una expresión regular. Para este bloque se han especificado las siguientes propiedades:
* Texto (cadena de entrada);
* Patrón (expresión regular por la cual se dividirá la cadena);
* Tiempo de espera (tiempo máximo de espera para completar la operación en segundos).
11. **Bloque “Ciclo para cada (Lista)”** itera sobre todos los elementos en la lista dada, en cada iteración del ciclo asigna el elemento actual a la variable que se indica en la propiedad “Elemento”, y luego la ejecución del script continúa hacia la salida Elemento de este bloque (en el llamado “cuerpo del ciclo”). Después de iterar sobre todos los elementos de la lista, la ejecución del script continúa hacia la salida inferior del bloque. No olvide conectar la salida del último bloque en el cuerpo del ciclo con la entrada de este bloque. Para este bloque se ha especificado una propiedad: “Lista” (lista cuyos elementos deben ser iterados en el ciclo).
**¡Importante!** *Para que el ciclo se reinicie, debe dirigirse no al propio ciclo, sino al bloque que está por encima de él.*
12. **Bloque “Eliminar duplicados en la lista”** elimina de la lista todos los elementos repetidos. Para este bloque se ha especificado una propiedad “Lista” (lista en la que se deben dejar solo elementos únicos, eliminando todos los duplicados).
13. **Bloque “Condición”** verifica la veracidad de la condición especificada, después de lo cual la ejecución del script continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual (==)/ mayor (>)/ menor (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces salida “Sí”, de lo contrario – salida “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces salida “Sí”, de lo contrario – salida “No”.
En este caso, se ha establecido como condición: $ListEmails.Count >= 5. Es decir, el valor de la lista de correos electrónicos debe ser mayor o igual a 5.
14. **Bloque “Verificar existencia de valor”** verifica la existencia de un valor en toda la tabla o en una columna dada. Para este bloque se han especificado las siguientes propiedades:
* Tabla (tabla de datos en la que se verifica el valor);
* Valor (valor que se verifica en la tabla);
* Columna (número de columna en la que se verifica el valor. La numeración comienza desde 0);
* Tipo de verificación (selección del tipo de verificación).
15. **Bloque “Condición”** verifica la veracidad de la condición especificada, después de lo cual la ejecución del script continúa hacia la salida “Sí” (si se cumple la condición) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual (==)/ mayor (>)/ menor (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces salida “Sí”, de lo contrario – salida “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces salida “Sí”, de lo contrario – salida “No”. En este caso, se ha establecido como condición: $Result. Es decir, si se ha obtenido el resultado.
16. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell.
17. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del script del robot. Para este bloque se ha especificado la propiedad “Valor”. En las comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot “Cantidad de correos electrónicos encontrados:” y la cantidad misma.
18. **Bloque “Ciclo para cada (Lista)”** itera sobre todos los elementos en la lista dada, en cada iteración del ciclo asigna el elemento actual a la variable que se indica en la propiedad “Elemento”, y luego la ejecución del script continúa hacia la salida Elemento de este bloque (en el llamado “cuerpo del ciclo”). Después de iterar sobre todos los elementos de la lista, la ejecución del script continúa hacia la salida inferior del bloque. No olvide conectar la salida del último bloque en el cuerpo del ciclo con la entrada de este bloque. Para este bloque se indica una propiedad: “Lista” (la lista cuyos elementos deben ser iterados en el ciclo).
**¡Importante!** *Para que el ciclo se reinicie, debe ir no al mismo ciclo, sino al bloque superior н*его.
19. **Bloque “Enviar correo”** permite enviar un correo utilizando el protocolo POP3. Para este bloque se indican las siguientes propiedades:
* Servidor (servidor);
* Login (login necesario para la autorización en el servidor);
* Contraseña (contraseña necesaria para la autorización en el servidor);
* SSL (si la bandera está activada, se utiliza una conexión segura);
* Email del remitente (E-mail desde el cual se enviará el correo);
* Email del destinatario (dirección de correo del destinatario a quien se debe enviar el correo);
* Asunto del correo (asunto del correo);
* Texto del correo (contenido del correo);
* Marcado HTML (si la bandera está activada, el contenido del correo se enviará como una página HTML y puede contener etiquetas);
* Timeout/Tiempo de espera (tiempo de espera para la respuesta del servidor en segundos).
20. **Bloque “Log”** permite registrar mensajes arbitrarios y/o valores de variables durante la ejecución del script del robot. Para este bloque se indica la propiedad “Valor”. En comillas se indica una constante de texto, y el nombre de la variable comienza con el símbolo $. Es decir, este bloque registra en el log del robot un mensaje sobre el envío de un E-mail.
21. **Bloque “Reemplazar todas las variables en el texto”** realiza la sustitución de todas las variables %variable% en el texto. Para este bloque se indica una propiedad “Texto” (cadena de entrada).
22. **Bloque “Reemplazar todas las variables en el texto”** realiza la sustitución de todas las variables %variable% en el texto. Para este bloque se indica una propiedad “Texto” (cadena de entrada).
23. **Bloque “Asignar valor a la variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
24. **Bloque “Buscar fila”** realiza una búsqueda en la tabla comparando con un valor dado y devuelve la primera fila que coincida. Para este bloque se indican las siguientes propiedades:
* Tabla (tabla de datos en la que se realiza la búsqueda de la fila);
* Valor buscado (valor que se busca en la tabla);
* Columna (número o nombre de la columna en la que se verifica el valor, la numeración comienza desde 0).
25. **Bloque “Condición”** verifica la condición especificada para su veracidad, después de lo cual la ejecución del script continúa hacia la salida “Sí” (si la condición se cumple) o hacia la salida “No” (si la condición no se cumple).
La condición se escribe en el formato: “variable” es igual (==)/ mayor (>)/ menor (<) “valor”.
Por ejemplo: $a == “Hola”, es decir, si el valor de la variable $a es igual a “Hola”, entonces salida “Sí”, de lo contrario – salida “No”.
$Result > 5, es decir, si el valor de la variable $Result es menor que 5, entonces salida “Sí”, de lo contrario – salida “No”. En este caso, se establece como condición: $RowOrganization == $null. Es decir, la fila “Organización” debe ser igual a nulo.
26. **Bloque “Agregar elemento a la lista”** agrega al final de la lista el elemento especificado. Para este bloque se indican las siguientes propiedades:
* Lista (lista a la que se debe agregar un nuevo elemento);
* Elemento (variable que se debe agregar a la lista).
27. **Bloque “Agregar elemento a la lista”** agrega al final de la lista el elemento especificado. Para este bloque se indican las siguientes propiedades:
* Lista (lista a la que se debe agregar un nuevo elemento);
* Elemento (variable que se debe agregar a la lista).
28. **Bloque “Enviar correo”** permite enviar un correo utilizando el protocolo POP3. Para este bloque se indican las siguientes propiedades:
* Servidor (servidor);
* Contraseña (contraseña necesaria para la autorización en el servidor);
* SSL (si la bandera está activada, se utiliza una conexión segura);
* Email del remitente (E-mail desde el cual se enviará el correo);
* Email del destinatario (dirección de correo del destinatario a quien se debe enviar el correo);
* Asunto del correo (asunto del correo);
* Texto del correo (contenido del correo);
* Marcado HTML (si la bandera está activada, el contenido del correo se enviará como una página HTML y puede contener etiquetas);
* Archivos adjuntos (ruta al archivo / Lista de rutas a archivos / Diccionario con archivos que se adjuntarán al correo (clave - nombre, valor - ruta al archivo));
* Timeout/Tiempo de espera (tiempo de espera para la respuesta del servidor en segundos).
29. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell.
30. **Bloque “Asignar valor a variable”** establece nuevos valores para una o varias variables. En este caso, en las propiedades se indica un valor que debe asignarse a una variable, respectivamente.
31. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indican las siguientes propiedades:
* Ruta de la carpeta (ruta de la carpeta donde se encuentra el archivo necesario);
* Nombre del archivo (nombre del archivo).
32. y 33. **Bloques “Fin”** (con estos bloques se finaliza la ejecución del script o se devuelve el diagrama del subproceso al proceso principal).
**Diagrama “ProcessSetting”**
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indica una propiedad: “Nombre del archivo”.
3. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indica una propiedad: “Nombre del archivo”.
4. **Bloque “Leer archivo”** permite leer el contenido de un archivo de texto en una variable. Para este bloque se indican las siguientes propiedades:
* Nombre del archivo (nombre del archivo de texto cuyo contenido se requiere leer);
* Codificación (codificación del archivo).
5. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indica una propiedad: “Nombre del archivo”.
6. **Bloque “Leer archivo”** permite leer el contenido de un archivo de texto en una variable. Para este bloque se indican las siguientes propiedades:
* Nombre del archivo (nombre del archivo de texto cuyo contenido se requiere leer);
* Codificación (codificación del archivo).
7. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indica una propiedad: “Nombre del archivo”.
8. **Bloque “Cargar Tabla de Datos”** permite cargar una “Tabla de Datos” desde un documento de Excel. Para este bloque se indican las siguientes propiedades:
* Ruta del archivo (tabla de datos en la que se cargarán los datos desde el documento de Excel);
* Hoja (número de la hoja de la que se deben leer los datos en la Tabla de Datos).
9. **Bloque “Obtener ruta de archivo”** permite conocer la ruta completa de un archivo. Para este bloque se indica una propiedad: “Nombre del archivo”.
10. **Bloque “Cargar Tabla de Datos”** permite cargar una “Tabla de Datos” desde un documento de Excel. Para este bloque se indican las siguientes propiedades:
* Ruta del archivo (tabla de datos en la que se cargarán los datos desde el documento de Excel);
* Hoja (número de la hoja de la que se deben leer los datos en la Tabla de Datos).
11. **Bloque “Fin”** (con este bloque se finaliza la ejecución del script o se devuelve el diagrama del subproceso al proceso principal).
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.sherparpa.ru/es/sherpa-rpa/sherpa-designer/primery-robotov/find-suppliers.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
