Excel

Las acciones de Excel te permiten leer, actualizar y crear archivos de Excel en tus automatizaciones. Todas las acciones de Excel admiten los formatos de archivo.xlsx y .xlsm. Los identificadores de los libros de trabajo mantienen las referencias de varias operaciones.

nota

Si bien los valores se pueden leer en archivos.xlsm, no se admite la ejecución de macros.

Crear un nuevo libro de trabajo

Crea un archivo de Excel en blanco. Genera un identificador de libro de trabajo que puede utilizar para actualizar la hoja de cálculo en los pasos siguientes.

Propiedades:

• Identificador del libro de trabajo (salida): nombre de la variable que almacena la referencia del libro de trabajo para acciones futuras (predeterminado:) workbook_id

Abrir un libro de trabajo existente

Carga un archivo de Excel existente. Devuelve un identificador de libro de trabajo que puede utilizar para actualizar la hoja de cálculo en los pasos siguientes. Solo admite archivos de Excel (.xlsx).

Propiedades:

• Archivo de Excel (obligatorio): el archivo.xlsx que se va a abrir, normalmente almacenado en una variable (por ejemplo,) my_file

• Identificador del libro de trabajo (salida): nombre de la variable que almacena la referencia del libro de trabajo (predeterminado:) workbook_id

Requisitos de archivo:

• Debe ser un archivo Excel (.xlsx) válido

• El archivo debe estar accesible como un objeto de archivo multimedia

Guarde el libro de trabajo

Guarda las actualizaciones en un archivo de Excel. Le permite actualizar el nombre y el tipo de archivo del libro guardado.

Propiedades:

• Nombre de archivo (obligatorio): nombre del archivo guardado sin extensión (por ejemplo, «Informe mensual»)

• Tipo de archivo (desplegable): formato de salida; actualmente es compatible con XLSX (predeterminado: XLSX)

• Archivo guardado (salida): variable que almacena el objeto de archivo guardado (predeterminado:) saved_file

Leer hoja

Obtiene datos de un rango de celdas. La acción almacena el resultado en una variable de tabla de datos.

Propiedades:

• Identificador del libro de trabajo (obligatorio): el libro de trabajo del que se va a leer (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): nombre de la hoja de trabajo o pestaña (predeterminado: «Hoja1")

• Rango de celdas (opcional): especificación de rango: admite varios formatos:

  • Celda inicial: «A2" (lee todos los datos del punto de anclaje)

  • Rango exacto: «A1: B10"

  • Rango de columnas: «A:B»

  • Rango de filas: "1:3»

  • Vacío: lee toda la hoja

• Incluir encabezados (casilla de verificación): trata la primera fila como encabezados de columna cuando está habilitada. Cuando está deshabilitado, usa el nombre predeterminado (Column0, Column1, etc.) (predeterminado: TRUE)

• Tabla de datos (salida): variable que almacena los datos extraídos (predeterminado:excel_table)

Manejo de fórmulas:

• La acción calcula automáticamente las fórmulas y almacena los resultados en la tabla de datos.

Lea la celda

Obtiene el valor de una celda. Se utiliza para leer el valor de una celda individual de una hoja de cálculo.

Propiedades:

• Identificador del libro de trabajo (obligatorio): el libro de trabajo del que se va a leer (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): nombre de la hoja de trabajo (predeterminado: «Sheet1")

• Referencia de celda (obligatoria): ubicación de la celda (por ejemplo, «A1")

• Valor de celda (salida): variable que almacena el contenido de la celda (predeterminado:cell_value)

Escribir en la hoja

Transmite una tabla de datos a una hoja. Se usa para escribir un rango de filas y columnas en una hoja de trabajo.

Propiedades:

• Tabla de datos (obligatoria): la tabla de datos que se va a escribir (por ejemplo,my_table)

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (predeterminado: «Sheet1")

• Comenzar en la celda (opcional): posición inicial para la ubicación de los datos (predeterminado: «A1")

• Incluir encabezados (casilla de verificación): escribe los encabezados de las columnas cuando está activado (predeterminado: TRUE)

Escribir en la celda

Envía un valor a una celda. Se utiliza para actualizar celdas individuales de una hoja de trabajo.

Propiedades:

• Valor a escribir (obligatorio): contenido de la celda (p. ej., «Orden #12345 «)

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (predeterminado: «Sheet1")

• Referencia de celda (obligatoria): ubicación de la celda de destino (por ejemplo, «A1")

Escribe una nueva fila

Añade una fila de datos a la hoja. La nueva fila se añade al final de los datos existentes.

Propiedades:

• Valores de fila (obligatorio): matriz de valores para la nueva fila, empezando por la primera columna (p. ej., ["Q1", «Sales», 100])

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (predeterminado: «Sheet1")

Validación de datos:

• Debe proporcionar valores en formato de matriz

• Los valores se escriben secuencialmente a partir de la primera columna

Crear nueva hoja

Añade una hoja de trabajo en blanco. La nueva hoja se agrega al final del libro de trabajo.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): nombre de la nueva hoja de trabajo (por ejemplo, «Datos de ventas»)

Copiar hoja

Crea una copia de la hoja de trabajo. La nueva hoja se crea en el mismo libro de trabajo.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja a copiar (obligatorio): nombre de la hoja de trabajo de origen (por ejemplo, «Hoja original»)

• Nombre de la nueva hoja (obligatorio): nombre de la hoja duplicada (por ejemplo, «Hoja original (copia)»)

Cambiar el nombre de la hoja

Actualiza el nombre de una hoja de trabajo existente.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja actual (obligatorio): nombre de la hoja de trabajo existente (por ejemplo, «Sheet1")

• Nombre de la hoja actualizada (obligatorio): nuevo nombre para la hoja de trabajo (por ejemplo, «Datos del primer trimestre»)

Eliminar hoja

Elimina una hoja de un libro de trabajo. No se puede eliminar la última hoja restante de un libro de trabajo.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja que se va a eliminar (obligatorio): hoja de trabajo que se va a eliminar (por ejemplo, «Hoja1")

Restricciones:

• No se puede eliminar la última hoja restante de un libro de trabajo

Defina el color de la celda

Actualiza el color de fondo de la celda. Se utiliza para resaltar un rango específico de celdas.

Propiedades:

• Color de celda (obligatorio): formato de código hexadecimal RGB (por ejemplo, FF0000 «" para rojo)

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (por ejemplo, «Sheet1")

• Rango de celdas (obligatorio): Rango a formatear; admite:

  • Celda única: «A1"

  • Rango exacto: «A1: B10"

  • Rango de columnas: «A:B»

  • Rango de filas: "1:3»

Obtenga el color de la celda

Lee el color de fondo de la celda. Muestra el color en formato de código hexadecimal RGB (por ejemplo, FF0000 «" para rojo).

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de origen (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de origen (por ejemplo, «Sheet1")

• Referencia de celda (obligatoria): celda para leer (por ejemplo, «A1")

• Color de celda (salida): variable que almacena el código hexadecimal RGB (predeterminado:cell_color)

Ocultar filas

Hace que las filas se oculten en la hoja. Los datos permanecen intactos pero no son visibles.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (por ejemplo, «Sheet1")

• Fila de inicio (obligatoria): número de la primera fila que se debe ocultar (la numeración de Excel comienza en 1)

• Fila final (opcional): último número de fila que se debe ocultar. Si está vacío, solo se oculta la fila inicial

Numeración de filas:

• Los números de fila de Excel comienzan en 1 (no en 0)

• Debe proporcionar valores enteros

Mostrar filas

Hace visibles las filas ocultas. Se usa para mostrar filas previamente ocultas.

Propiedades:

• Identificador del libro de trabajo (obligatorio): libro de trabajo de destino (por ejemplo,) workbook_id

• Nombre de la hoja (obligatorio): hoja de trabajo de destino (por ejemplo, «Sheet1")

• Fila de inicio (obligatoria): número de la primera fila que se va a mostrar (la numeración de Excel comienza en 1)

• Fila final (opcional): último número de fila que se va a mostrar. Si está vacío, solo se hace visible la fila inicial

Mejores prácticas y limitaciones

Administración de identificadores de libros de trabajo

• Guarde los identificadores del libro de trabajo en variables descriptivas (por ejemplo,) sales_workbook report_file

• Reutilice el mismo identificador en varias acciones del mismo libro de trabajo

• Cree o abra siempre un libro de trabajo antes de realizar operaciones de datos

Especificaciones de rango

• Utilice rangos exactos («A1: B10") para operaciones de datos precisas

• Utilice rangos de columnas («A:B») cuando trabaje con columnas enteras

• Utilice rangos de filas (» 1:3 «) para las operaciones de encabezado o resumen

• Deje el rango vacío para procesar hojas enteras

Optimización del desempeño

• Lea rangos completos cuando sea posible en lugar de celdas individuales

• Operaciones de escritura por lotes mediante tablas de datos en lugar de escrituras de celdas individuales

• Guarde los libros de trabajo solo cuando se hayan completado todas las modificaciones

Limitación

La compatibilidad de los archivos se limita únicamente al formato Excel (.xlsx) moderno; no se admiten los archivos Excel (.xls) antiguos.