# 1C Factura de entrada (COM)
Consideremos un ejemplo de un robot que crea una factura de entrada en el programa 1C. Los datos de entrada para este proyecto son el archivo "Pedido al proveedor". El trabajo se basa en el uso de una conexión COM a la aplicación 1C.
Este proyecto muestra la carga de datos desde PDF o desde Excel. Para ver cómo se trabaja con PDF, debe conectar los bloques "Iniciar proceso" y el bloque izquierdo "Obtener ruta al archivo".
Para verificar el trabajo con la carga desde un archivo de Excel, debe conectar los bloques "Iniciar proceso" y el bloque derecho "Obtener ruta al archivo".
El proyecto del robot consta de cuatro diagramas y cuatro archivos: dos txt, pdf y xlsx. En el archivo “QueryTemplate.txt” se encuentra la plantilla de consulta escrita en el lenguaje 1C. Para cargar datos desde archivos pdf y xlsx, hay un diagrama propio.
**Diagrama principal** se ve así (para mayor comodidad, los bloques del diagrama están numerados):
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Obtener ruta al archivo”** obtiene la ruta completa al archivo con el nombre especificado. Para estos bloques se han indicado las siguientes propiedades:
* Ruta a la carpeta (ruta a la carpeta donde se encuentra el archivo necesario; si la propiedad está vacía, se tomará la carpeta donde se encuentra este proyecto);
* Nombre del archivo (nombre del archivo junto con su formato).
En este caso, se han utilizado paralelamente dos bloques “Obtener ruta al archivo”: uno para el archivo en formato pdf, y el otro para el archivo en formato xlsx.
3. **Bloque “Proceso”** permite crear escenarios que consisten en varios diagramas. La ejecución del escenario continuará desde el bloque “Inicio” del diagrama especificado del proyecto. 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 indicado la propiedad “Nombre del diagrama” (nombre del archivo del diagrama en el que continuará la ejecución del escenario).
En este caso, como en el anterior, se han utilizado paralelamente dos bloques “Proceso”: uno para cargar datos desde el archivo pdf, y el otro para cargar datos desde el archivo xlsx.
4. **Bloque “Proceso”** ubicado más abajo permite crear otro escenario que es común para los dos escenarios descritos anteriormente. Este proceso se encarga de agregar la factura en 1C. Para el bloque “Proceso” aquí también se ha indicado la propiedad “Nombre del diagrama” (nombre del archivo del diagrama en el que continuará la ejecución del escenario).
**Diagrama "CargarDatosDesdePDF"**
1. **Bloque “Inicio”** (desde este bloque comienza cualquier diagrama).
2. **Bloque “Log”** permite imprimir en el log mensajes arbitrarios y/o valores de variables durante la ejecución del escenario del robot. Para este bloque se ha indicado 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 la carga del archivo seleccionado, indicado mediante la variable.
3. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso se utilizan dos expresiones.
4. **Bloque “Extraer tabla”** permite extraer la tabla especificada de un archivo pdf. Para este bloque se han indicado las siguientes propiedades:
* Nombre del archivo;
* Número de página (número de la página desde la cual se extraerá el texto de la tabla);
* Número de tabla en la página (número de la tabla en la página de la que se debe extraer el texto).
5. **Bloque “Ciclo para cada uno”** itera sobre todas las filas de la tabla de datos.
6. **Bloque “Obtener texto de la página”** permite leer el texto de la página especificada de un archivo pdf. Para este bloque se han indicado las siguientes propiedades:
* Nombre del archivo;
* Número de página (número de la página desde la cual se extraerá el texto);
* Resultado (devuelve el texto extraído de la página).
7. **Bloque “Encontrar subcadena entre dos subcadenas”** permite encontrar en el texto una subcadena que se encuentra entre dos otras subcadenas. Debe haber tantos bloques como subcadenas se necesiten encontrar. En este caso se utilizan dos bloques “Encontrar subcadena entre dos subcadenas”: para la subcadena “Ejecutor” y la subcadena “Pedido”. En las propiedades de los bloques se indican:
* Texto (cadena de entrada);
* Parte izquierda (subcadena buscada a la izquierda);
* Parte derecha (subcadena buscada a la derecha).
8. **El 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 no se cumple la condición).
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 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, como condición se establece: $Row \[0] == $index, es decir, si el valor de la celda 0 es igual a la variable $index, entonces salida "Sí", de lo contrario – salida "No".
9. **El bloque "Agregar fila"** permite agregar una fila a la tabla de datos. En este caso se especifican las siguientes propiedades:
* Tabla (tabla de datos a la que se agrega la fila);
* Número de fila (devuelve el número de la fila agregada, la numeración comienza desde 0).
10. **El bloque "Escribir valor en celda"** permite escribir un valor en una celda de la tabla de datos. En este caso se utilizan tres de tales bloques para diferentes variables: $Row\[2], $Row\[3] y $Row\[5].
11. **El bloque "Ejecutar expresión"** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso se utiliza una expresión.
12. **El bloque "Ejecutar expresión"** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso se utiliza una expresión.
13. **El bloque "Fin"** (este bloque finaliza la ejecución del script o devuelve el diagrama del subproceso al proceso principal).
**Diagrama "CargarDatosDesdeXLSX"**
1. **El bloque "Inicio"** (cualquier diagrama comienza con este bloque).
2. **El 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 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 sobre la carga del archivo seleccionado, indicado mediante la variable.
3. **El bloque "Abrir documento"** permite abrir un documento de Excel. Para este bloque se especifican las siguientes propiedades:
* Ruta del archivo (ruta al documento de Excel que se debe abrir);
* Enlace a Excel (devuelve un enlace al proceso de procesamiento del documento de Excel);
* Enlace al documento (devuelve un enlace al documento de Excel abierto, en el que se está trabajando en ese momento).
4. **El bloque "Obtener valor de celda"** permite leer el valor de una celda del documento de Excel. En este caso se utilizan dos bloques "Obtener valor de celda" para diferentes filas y columnas. Para este bloque se especifican las siguientes propiedades:
* Enlace al documento (devuelve un enlace al documento de Excel abierto, en el que se está trabajando en ese momento);
* Hoja (número de orden o nombre de la hoja en la que se encuentra la celda requerida);
* Fila (número de la fila en la que se encuentra la celda requerida);
* Columna (número de la columna en la que se encuentra la celda requerida);
* Resultado (devuelve el contenido de la celda del mismo tipo de datos que en el documento de Excel).
5. **El bloque "Encontrar subcadena entre dos subcadenas"** permite encontrar en el texto una subcadena que se encuentra entre dos otras subcadenas. Debe haber tantos bloques como subcadenas se necesiten encontrar. En este caso se utilizan dos bloques "Encontrar subcadena entre dos subcadenas": para la subcadena "Ejecutor" y la subcadena "Pedido". En las propiedades de los bloques se especifican:
* Texto (cadena de entrada);
* Parte izquierda (subcadena buscada a la izquierda);\* Parte derecha (subcadena buscada a la derecha).
6. **El bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso, se utiliza una expresión.
7. **El bloque “Obtener valor de celda”** permite leer el valor de una celda en un documento de Excel. Para este bloque se especifican las siguientes propiedades:
* Enlace al documento (devuelve un enlace al documento de Excel abierto en el que se está trabajando actualmente);
* Hoja (número de orden o nombre de la hoja donde se encuentra la celda requerida);
* Fila (número de fila donde se encuentra la celda requerida);
* Columna (número de columna donde se encuentra la celda requerida);
* Resultado (devuelve el contenido de la celda del mismo tipo de datos que en el documento de Excel).
8. **El 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 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”.
9. **El bloque “Cerrar documento”** permite cerrar el documento de Excel. Para este bloque se especifican las siguientes propiedades:
* Enlace a Excel (devuelve un enlace al proceso de manejo del documento de Excel);
* Enlace al documento (devuelve un enlace al documento de Excel abierto en el que se está trabajando actualmente).
10. **Los bloques “Obtener valor de celda”** permiten leer el valor de una celda en un documento de Excel. En este caso se utilizan dos bloques “Obtener valor de celda” para diferentes filas y columnas. Para este bloque se especifican las siguientes propiedades:
* Enlace al documento (devuelve un enlace al documento de Excel abierto en el que se está trabajando actualmente);
* Hoja (número de orden o nombre de la hoja donde se encuentra la celda requerida);
* Fila (número de fila donde se encuentra la celda requerida);
* Columna (número de columna donde se encuentra la celda requerida);
* Resultado (devuelve el contenido de la celda del mismo tipo de datos que en el documento de Excel).
11. **El bloque “Agregar fila”** permite agregar una fila a una tabla de datos. Para este bloque se especifican las siguientes propiedades:
* Tabla (tabla de datos a la que se agrega la fila);
* Número de fila (devuelve el número de la fila agregada).
12. **El bloque “Escribir valor en celda”** permite escribir un valor en una celda de la tabla de datos. En este caso se utilizan tres de estos bloques para diferentes columnas y valores. Para este bloque se especifican las siguientes propiedades:
* Tabla (tabla de datos en la que se debe escribir el valor);
* Fila (número de fila);
* Columna (número de columna, la numeración comienza desde 0);
* Valor (valor que se debe escribir).
13. **El bloque “Ejecutar expresión”** inicia la ejecución de uno o varios expresiones en un lenguaje compatible con PowerShell. En este caso se utiliza una expresión.
14. **El bloque “Fin”** (este bloque finaliza la ejecución del script o devuelve el diagrama del subproceso al proceso principal).
**Diagrama “AgregarFactura”**
1. **El bloque “Inicio”** (cualquier diagrama comienza con este bloque).
2. **El 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”. Aquí este bloque registra en el log del robot el mensaje “Agregando factura”.
3. **Bloque “Leer archivo”** permite leer el contenido de un archivo de texto en una variable. Para este bloque se especifican las siguientes propiedades:
* Nombre del archivo (nombre del archivo de texto cuyo contenido se debe leer);
* Codificación (codificación del archivo);
* Resultado (devuelve el contenido del archivo).
4. **Bloque “Reemplazo de subcadena”** permite reemplazar en el texto una subcadena por otra. En este caso se utilizan dos bloques “Reemplazo de subcadena”: para “Cliente” y para “Proveedor”. Para estos bloques se especifican las siguientes propiedades:
* Texto (cadena de entrada);
* Subcadena buscada (cadena que se debe reemplazar);
* Subcadena a insertar (cadena para reemplazar todas las ocurrencias de la subcadena buscada);
* Resultado (nueva cadena en la que todas las ocurrencias de la cadena dada son reemplazadas por otra cadena dada).
5. **Bloque “Ciclo para cada uno”** recorre cíclicamente todas las filas de la tabla de datos.
6. **Bloque “Unir texto”** permite unir todos los elementos de las cadenas, colocando entre ellos un separador dado. Para este bloque se especifican las siguientes propiedades:
* Lista de partes de texto (lista de cadenas que se deben unir en una cadena de texto);
* Separador (texto utilizado como separador);
* Nueva línea (bandera establecida que activa la función en la que se utilizará una nueva línea como separador);
* Resultado (cadena resultante).
7. **Bloque “Reemplazo de subcadena”** permite reemplazar en el texto una subcadena por otra. Para este bloque se especifican las siguientes propiedades:
* Texto (cadena de entrada);
* Subcadena buscada (cadena que se debe reemplazar);
* Subcadena a insertar (cadena para reemplazar todas las ocurrencias de la subcadena buscada);
* Resultado (nueva cadena en la que todas las ocurrencias de la cadena dada son reemplazadas por otra cadena dada).
8. **Bloque “Conectar”** permite crear una conexión. Para este bloque se especifican las siguientes propiedades:
* Cadena de conexión (cadena de conexión a 1C);
* Usuario (nombre de usuario para la autorización);
* Contraseña (contraseña para la autorización);
* Visibilidad (bandera establecida que activa la visibilidad de la ventana de 1C para el usuario);
* Conexión (devuelve el objeto de conexión a 1C).
9. **Bloque “Ejecutar código”** permite ejecutar código en el servidor. Para este bloque se especifican las siguientes propiedades:
* Conexión (objeto de conexión a 1C);
* Consulta (consulta ejecutada en el lenguaje de 1C).
10. **Bloque “Cerrar conexión”** permite cerrar la conexión con el servidor 1C. Para este bloque se especifica la propiedad “Conexión” (objeto de conexión a 1C).
11. **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": $ErrorMassage. Es decir, se registra en el log del robot un mensaje de error.
12. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso se utilizan dos expresiones.
13. **Bloque “Agregar elemento a la lista”** permite agregar el elemento especificado al final de la lista. Para este bloque se especifican las siguientes propiedades:
* Lista (lista a la que se debe agregar un nuevo elemento);
* Elemento (constante, variable o resultado de cálculos que se debe agregar a la lista).
14. **Bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso se utilizan dos expresiones.
15. **Bloque “Agregar elemento a la lista”** permite agregar el elemento especificado al final de la lista. Para este bloque se especifican las siguientes propiedades:
* Lista (lista a la que se debe agregar un nuevo elemento);
* Elemento (constante, variable o resultado de cálculos que se debe agregar a la lista).
16. **El bloque “Ejecutar expresión”** inicia la ejecución de una o varias expresiones en un lenguaje compatible con PowerShell. En este caso, se utilizan dos expresiones.
17. **El bloque “Agregar elemento a la lista”** permite añadir el elemento especificado al final de la lista. Para este bloque se especifican las siguientes propiedades:
* Lista (la lista a la que se debe agregar el nuevo elemento);
* Elemento (constante, variable o resultado de cálculos que se debe agregar a la lista).
18. y 19. **El bloque “Fin”** (este bloque finaliza la ejecución del guion o 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/1s-prikhodnaya-nakladnaya-com.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.
