This shows you the differences between two versions of the page.
es:excel_file_adaptor [2024/12/04 10:26] montse [Parámetros de Inicialización] |
es:excel_file_adaptor [2025/03/14 10:52] (current) ale |
||
---|---|---|---|
Line 3: | Line 3: | ||
===== Configuración ===== | ===== Configuración ===== | ||
+ | |||
+ | A través del Adaptador de Excel, TAST puede administrar archivos de Excel (de tipo.xls y.xlsx) y probarlos. Es posible realizar pruebas individuales con este adaptador o pruebas de extremo a extremo conectando con otros adaptadores. | ||
En el proceso de inicialización, el Adaptador de Excel intentará leer y analizar la hoja de Excel indicada por el parámetro NumSheet. | En el proceso de inicialización, el Adaptador de Excel intentará leer y analizar la hoja de Excel indicada por el parámetro NumSheet. | ||
Line 34: | Line 36: | ||
* **generateFileAsEvidence()**: genera una copia del archivo Excel en su estado actual para añadirlo como evidencia. | * **generateFileAsEvidence()**: genera una copia del archivo Excel en su estado actual para añadirlo como evidencia. | ||
- | * **getActiveSheetIndex**: nos devuelve la pestaña que está activa en ese momento. | + | * **generateSheetFromTastRow**: la función copia los TastRowValues recibidos bajo el parámetro Input Row sobre la hoja activa o sobre una nueva hoja creada con el nombre dado por el parámetro New Sheet Name, si se ha rellenado. En ese caso la nueva hoja permanecerá como hoja activa en el libro. La copia se realizará sobre el número de línea especificado por el parámetro Línea de destino cuando el parámetro Primera línea para cabecera (que anulará el indicador Utilizar primera línea como nombres de columna en el adaptador) esté desactivado, pero en la línea siguiente si está activado. |
+ | |||
+ | * **generateSheetFromTastTable**: la función copia el TastTableData recibido bajo el parámetro Input Table sobre una nueva hoja creada con el nombre dado por el parámetro New Sheet Name. Esta nueva hoja permanecerá como hoja activa en el libro. El parámetro Primera Línea para Cabecera anulará el check Usar primera línea como nombres de columna en el adaptador y, si el parámetro está activo la copia se realizará desde la primera línea de la hoja, pero si no lo está la copia se realizará desde la segunda línea de la hoja. | ||
+ | |||
+ | * **getActiveSheetIndex**: permite recuperar el índice de la hoja activa del fichero Excel. | ||
* **getCellValue(CellReference):** esta función devuelve el valor de una celda con la referencia de dicha celda (por ejemplo: C7, C12, D2…); acepta la referencia de la celda tanto en minúsculas como mayúsculas. | * **getCellValue(CellReference):** esta función devuelve el valor de una celda con la referencia de dicha celda (por ejemplo: C7, C12, D2…); acepta la referencia de la celda tanto en minúsculas como mayúsculas. | ||
Line 48: | Line 54: | ||
* **getNumValueSearchOnColumn:** permite al usuario buscar un valor en la columna seleccionada y devuelve el número de veces que el valor aparece en la columna. En el mapeo el usuario pone el valor a buscar en el campo SearchValue y el número de columna en el campo Columna. | * **getNumValueSearchOnColumn:** permite al usuario buscar un valor en la columna seleccionada y devuelve el número de veces que el valor aparece en la columna. En el mapeo el usuario pone el valor a buscar en el campo SearchValue y el número de columna en el campo Columna. | ||
- | * **getNumberOfSheets**: nos devuelve el número de hojas. | + | * **getNumberOfSheets**: permite recuperar el número de hojas de un fichero Excel. |
* **getRowByColumnSearch():** devuelve un TastTableData, que contiene el subconjunto de filas en las que la columna tiene el valor indicado. Como parámetros de entrada contamos con un SearchColumn para buscar la columna y el valor con un SearchValue. | * **getRowByColumnSearch():** devuelve un TastTableData, que contiene el subconjunto de filas en las que la columna tiene el valor indicado. Como parámetros de entrada contamos con un SearchColumn para buscar la columna y el valor con un SearchValue. | ||
Line 54: | Line 60: | ||
* **getTableValue(RowNum, ColNum):** devuelve el valor contenido en la celda indicada por el parámetro Posición que se llena con los valores RowNum y ColNum. | * **getTableValue(RowNum, ColNum):** devuelve el valor contenido en la celda indicada por el parámetro Posición que se llena con los valores RowNum y ColNum. | ||
- | * **getTableValueByColumnName():** Permite recuperar el valor de una celda de la hoja Excel, indicando como parámetros el nombre de la columna (ColName) y el número de fila a recuperar (RowNum). | + | * **getTableValueByColumnName():** permite recuperar el valor de una celda de la hoja Excel, indicando como parámetros el nombre de la columna (ColName) y el número de fila a recuperar (RowNum). |
* **getValuesByPosition():** devuelve un array de valores correspondientes a las posiciones de las celdas indicadas por los parámetros. | * **getValuesByPosition():** devuelve un array de valores correspondientes a las posiciones de las celdas indicadas por los parámetros. | ||
* **newFile(FilePath):** crea o sobrescribe un archivo, con la ruta y el nombre indicados por el parámetro filePath.\\ Si el archivo no existe, TAST lo creará, como un archivo vacío.\\ Si el archivo existe, TAST eliminará el archivo actual y creará uno nuevo vacío. | * **newFile(FilePath):** crea o sobrescribe un archivo, con la ruta y el nombre indicados por el parámetro filePath.\\ Si el archivo no existe, TAST lo creará, como un archivo vacío.\\ Si el archivo existe, TAST eliminará el archivo actual y creará uno nuevo vacío. | ||
+ | |||
+ | * **renameSheet**: la función cambia el nombre de la hoja especificada por el parámetro Nombre de hoja anterior (que puede contener un nombre de hoja existente en el libro o su ordinal), o la hoja actual si no se ha rellenado este parámetro. El nuevo nombre dado a la hoja se tomará del parámetro Nuevo nombre de hoja, y la hoja renombrada permanecerá como hoja activa en el libro. | ||
* **setCellValue(CellReference, value):** esta función introduce el valor en una celda con la referencia de dicha celda (por ejemplo: C7, C12, D2...), acepta la referencia tanto en minúsculas como mayúsculas. | * **setCellValue(CellReference, value):** esta función introduce el valor en una celda con la referencia de dicha celda (por ejemplo: C7, C12, D2...), acepta la referencia tanto en minúsculas como mayúsculas. |