Para gestionar libros de Microsoft Excel® como parte de una cadena, añade una etapa que incluya un comando de conexión a Microsoft Excel.
Nota: El conector Microsoft Excel admite archivos de libros de Excel (XLSM) habilitados para macros, pero no ejecuta ninguna macro de Virtual Basic para Aplicaciones (VBA) ni macros basadas en eventos, como Abrir libro, Antes de guardar u HojaCalcular.
Para habilitar estos comandos, un administrador informático crea primero un conector de Microsoft Excel.
Crear libro de trabajo a partir de archivos
Para crear o actualizar un libro de Excel con hojas basadas en datos de archivos de valores separados por delimitadores, utiliza un comando Crear libro de trabajo a partir de archivos.
Ten en cuenta que tienes dos opciones de salida en función de cómo esté configurado tu conector:
- Si utilizas un GroundRunner, introduce un objeto de Javascript Object Notation (JSON).
- Si utilizas un CloudRunner, especifica sus salidas de comando o recursos dentro de la cadena.
Propiedades
| Propiedad |
Detalle |
| Archivos |
Especifica los Archivos para crear hojas separadas en el libro de trabajo:
- Para Archivos basados en salidas o recursos dentro de la cadena, haz clic en Agregar para cada Archivo, selecciona su salida o recurso e introduce el nombre de su hoja (hasta 31 caracteres).
Consejo: Para recuperar un archivo desde una ubicación de red, utiliza el conector Utilidades de Archivos 's Obtener archivo comando anterior en la cadena.
- Para especificar los Archivos como JSON, selecciona Habilitar variable, e introduce el JSON o selecciona el objeto JSON de la salida de un comando anterior. Formatea el JSON como:
[
{"archivo": "fullPathToFile_1", "nombre": "hojaNombre_1"},
{"archivo": "fullPathToFile_2", "nombre": "hojaNombre_2"}
] Nota: Para incluir el archivo de salida de un comando anterior en el JSON, introduce la ruta completa a su ubicación en la carpeta de procesamiento de GroundRunner.
|
| Delimitador |
Selecciona el delimitador utilizado en los archivos. |
| Nombre del Libro de ejercicios |
Para crear un nuevo libro de trabajo basado en los archivos, introduce un nombre que sea único para ayudar a identificarlo. Nota: El comando crea automáticamente una extensión .xlsx si no se proporciona. |
| Libro de trabajo existente |
Para añadir los datos de los archivos a un libro de trabajo existente en lugar de a uno nuevo, selecciona el archivo del libro de trabajo que quieras actualizar. Cualquier hoja con un nombre introducido en Archivos se sobrescribe. Importante: Cuando utilices este comando en un archivo protegido, el libro de trabajo resultante no estará protegido. Esto significa que debes volver a añadir manualmente el cifrado cuando trabajes con un archivo protegido. |
Resultados
| Resultado |
Tipo de resultado |
| Libro de trabajo XLSX |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Comando ejecutado |
| 1 |
Se ha producido un error |
Fallo general |
Lista de hojas
Para crear una lista JSON de todas las hojas de un libro de Excel, utiliza el comando Listar Hojas.
Propiedades
| Propiedad |
Detalle |
| Archivo del Libro de Trabajo |
Introduce el libro de trabajo XLS o XLSX para listar las hojas de. |
| Contraseña |
Si el archivo Libro de trabajo es un libro de trabajo XLSX protegido con contraseña, introduce su contraseña. |
Resultados
| Resultado |
Tipo de resultado |
| Hojas JSON |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Comando ejecutado |
| 1 |
Se ha producido un error |
Fallo general |
Hoja de cálculo a CSV
Para convertir los datos de la hoja de un libro de Excel en un archivo tabular, utiliza un comando Hoja de cálculo a CSV.
Nota: El comando De hoja de cálculo a CSV extrae los últimos valores calculados en la hoja de cálculo. Para las hojas de cálculo con los Cálculos Automáticos deshabilitados, calcula manualmente y guarda los valores antes de que se ejecute la cadena para garantizar la precisión.
Propiedades
| Propiedad |
Detalle |
| Archivo del Libro de Trabajo |
Introduce el libro de trabajo XLS o XLSX con la hoja a convertir en un archivo tabular. |
| Contraseña |
Si el archivo Libro de trabajo es un libro de trabajo XLSX protegido con contraseña, introduce su contraseña. |
| Delimitador |
Selecciona el Delimitador a utilizar en el Archivo de salida. |
| Nombre de hoja |
Introduce el nombre de la hoja del libro a convertir. Si, en su lugar, quieres identificar la hoja por su índice, déjala en blanco. |
| Índice de hoja |
Introduce la posición del índice de la hoja del libro a convertir, con 1 para la primera hoja, y -1 para la última. Si, en su lugar, quieres identificar la hoja por su nombre, déjala en blanco. |
| Célula de inicio |
Introduce la celda tanto en la primera fila como en la primera columna de los datos de la hoja a convertir. |
| Finalizar columna |
En notación A1, introduce la letra de la columna -como A, B o C, sin el número de fila- donde finalizan los datos a convertir. Nota: El comando ignora cualquier dato de la hoja posterior a esta columna. |
| Finalizar fila |
En notación A1, introduce el número de la fila -como 10, 200, 3000, sin la letra de la columna- donde finalizan los datos a convertir. Para ignorar la fila, introduce 0. Nota: El comando ignora cualquier dato de la columna posterior a esta fila. |
| Utilizar valores de celda con formato |
Para convertir los valores de visualización de las celdas en lugar de sus valores brutos, como para el tratamiento de la fecha/hora, marca esta casilla. |
| Vista previa de los resultados |
Para activar una vista previa del archivo de salida, marca esta casilla. |
| Modo Streaming |
Solo aplicable a archivos XLSX grandes. Recomendado para archivos de más de 20 mb. Lee el archivo en ventanas más pequeñas de datos para reducir el uso de memoria. Algunas fórmulas, especialmente las que hacen referencia a celdas más alejadas en el archivo, pueden no funcionar correctamente cuando este ajuste está activado junto con la opción de valores formateados. |
Resultados
| Resultado |
Tipo de resultado |
| Resultado CSV |
Archivo |
Códigos de salida
| Código |
Tipo |
Detalle |
| 0 |
Correcto |
Comando ejecutado |
| 1 |
Se ha producido un error |
Fallo general |