Abrir archivo Excel
Abre un archivo Excel.
Disponibilidad de mandatos: IBM RPA SaaS e IBM RPA local
Descripción
Abre un archivo Excel. Este mandato también puede crear un nuevo archivo Excel. Para ello, debe hacer referencia a una vía de acceso de archivo no existente en el parámetro Vía de acceso de archivo , utilice el mandato Establecer valor en Excel (excelSet) o Insertar tabla de datos en archivo Excel (excelSetTable) para establecer un valor en el archivo, y utilice el mandato Cerrar Excel (excelClose) para guardar y cerrar el archivo.
Sintaxis de script
El lenguaje de script de propiedad de IBM RPA tiene una sintaxis similar a otros lenguajes de programación. La sintaxis del script define la sintaxis del mandato en el archivo de script. Puede trabajar con esta sintaxis en la modalidad Script de IBM RPA Studio.
excelOpen --file(String) [--passwordtopen(String)] [--passwordtomodify(String)] [--usetemplate(Boolean)] --template(String) [--savechanges(Boolean)] [--notcalculate(Boolean)] (Boolean)=success (String)=reason (Excel)=value
Dependencias
- Este mandato sólo da soporte a archivos con la extensión de archivo
.xlsx. Si tiene un archivo.xls, utilice el mandato Convertir Excel de XLS a XLSX (excelToXlsx) para convertir el archivo antes de abrirlo. - Utilice el mandato Cerrar archivo Excel (
excelclose) para cerrar los archivos Excel que ha abierto utilizando el mandato Abrir archivo Excel .
Parámetros de entrada
La tabla siguiente muestra la lista de parámetros de entrada disponibles en este mandato. En la tabla, puede ver el nombre de parámetro al trabajar en la modalidad de script de IBM RPA Studioy su etiqueta equivalente de modalidad de diseñador.
| Etiqueta de modalidad de Diseñador | Nombre de modalidad de Script | Obligatorio | Tipos de variable aceptados | Descripción |
|---|---|---|---|---|
| Vía de acceso de archivo | file |
Required |
Text |
Ruta de archivo de Excel. |
| Contraseña de lectura | passwordtopen |
Optional |
Text |
Contraseña que solo permite leer el contenido del archivo. |
| Contraseña de modificación | passwordtomodify |
Optional |
Text |
Contraseña que le permite modificar el contenido del archivo. |
| Utilizar plantilla | usetemplate |
Optional |
Boolean |
Opción para utilizar una plantilla existente al abrir el archivo Excel. |
| Plantilla | template |
Required when the Use template parameter is enabled |
Text |
Establece una nueva plantilla para la interfaz de archivo de Excel. |
| Guardar cambios | savechanges |
Optional |
Boolean |
Guarda el archivo Excel de acuerdo con cada cambio que se produce en el tiempo de ejecución. |
| No calcular | notcalculate |
Optional |
Boolean |
No calcule las fórmulas contenidas en el archivo Excel antes de guardar los cambios. |
Parámetros de salida
| Etiqueta de modalidad de Diseñador | Nombre de modalidad de Script | Tipos de variable aceptados | Descripción |
|---|---|---|---|
| Correcto | success | Boolean |
Devuelve True si el archivo se ha abierto o False de lo contrario. |
| Razón | razón | Text |
Razón que justifica la salida del parámetro Success. |
| Instancia de Excel | valor | Excel |
Devuelve una variable con el archivo Excel utilizado. |
Ejemplo
Ejemplo 1: El siguiente ejemplo de código muestra cómo abrir un archivo Excel.
defVar --name excelFile --type Excel
excelOpen --file "samplefile" excelFile=value
// Result: Stores the opened excel file in the excelFile variable to use it in the script.
❕ Importante: Para ejecutar el script de ejemplo, cree el archivo de Excel.
Ejemplo 2: El ejemplo siguiente muestra cómo el mandato crea un archivo nuevo, al tiempo que añade contenido y guarda el archivo.
defVar --name excelFile --type Excel
defVar --name desktopPath --type String
defVar --name sampleFile --type String
defVar --name dataTableSample --type DataTable
// Gets the path to the Desktop folder.
getSpecialFolder --folder "Desktop" desktopPath=value
// Sets the path to the sample Excel file.
setVar --name "${sampleFile}" --value "${desktopPath}\\sample_file.xlsx "
// Adds a column called "Fruit" to the sample data table.
addColumn --dataTable ${dataTableSample} --columnname Fruit --type String
// Adds a row with the "Apple" value in the Fruit column.
addRow --valuesmapping "Fruit=Apple" --dataTable ${dataTableSample}
// Opens the Excel file based on the path in the ${sampleFile} variable. Itcreates a file called "sample_file", if it doens't exist in the file path provided.
excelOpen --file "${sampleFile}" excelFile=value
// Sets the value in the ${dataTableSample} variable to the Excel file.
excelSetTable --dataTable ${dataTableSample} --headers --file ${excelFile} --getfirstsheet --row 1 --column 1
// Closes and saves the Excel file.
excelClose --file ${excelFile} --save
// Check if the file was successfully created in your Desktop area.