Adaptador Ficheros de Texto

A través del Adaptador de Ficheros o Archivos de Texto, TAST puede administrar archivos de texto plano y utilizarlos en las pruebas. Los archivos de texto plano son archivos formados solo por texto. Es decir, carecen de información destinada a generar formatos, como pueden ser negritas, subrayado, cursivas, tamaño de letra, tipos de letra, etc. No requieren ser interpretados para leerse, son más directos, sin la distracción de los colores, fuentes y links, lo que hace posible la gran variedad de pruebas que podemos realizar con ellos gracias a TAST.

El programa Bloc de notas (Notepad) de Windows maneja exclusivamente el texto plano. Nosotros trabajaremos con la versión Notepad ++.

Como hemo visto con otros adaptadores, TAST puede realizar pruebas individuales con este adaptador o también puede realizar pruebas de extremo a extremo conectando con el resto de los adaptadores que nos ofrece.

Cuando incluimos este adaptador en un caso de prueba, debemos proporcionarle la información necesaria para establecer la conexión y poder hacer uso de él. Sería la siguiente:

• FilePath: la ruta completa, incluido el nombre del archivo representado por el adaptador en el diagrama.
• CharSet: el conjunto de caracteres usados en el archivo a tratar. Por ejemplo, si usas ficheros para probar ficheros Webservices, el charset suele ser UTF-8. Si usas ficheros de Windows descargados a través de FTP/SFTP el charset suele ser CP1252. El Cp1047 es usado por defecto.
  
  NOTA: es muy importante seleccionar correctamente el charset del fichero, porque el retorno de carro se interpreta de forma diferente según el charset seleccionado y esto puede impactar en todas las funciones predefinidas que gestionan el fichero de texto en TAST.
  
  Para seleccionar el charset correcto del fichero puedes identificarlo en el editor de texto de la siguiente forma:

• Create/Overwrite: cuando el check está seleccionado, TAST creará un nuevo fichero o lo sobrescribirá si ya existe.

• closeFile(): cierra el archivo y libera los recursos asociados. Devuelve true si el archivo puede cerrarse correctamente o falso de lo contrario. No requiere parámetros de entrada.

• containsText(SearchString): devuelve verdadero si el valor de la cadena de texto del parámetro searchString existe en el archivo, de lo contrario es falso.

• countFileLine(): devuelve el número de líneas del fichero. No requiere parámetros de entrada.

• countTextFile(): la función cuenta el número de veces que una string aparece en un fichero. Cuenta con un parámetro searchString para buscar y realizar la comparación.

• deleteFtpFile(): borra un fichero de un servidor Ftp. Devuelve si la operación ha tenido éxito o no. Como parámetros de entrada tenemos:
  • El parámetro Host indica la dirección de la máquina remota donde reside el archivo.
  • El parámetro User indica el usuario de la conexión al sistema remoto.
  • El parámetro Password indica la contraseña del usuario en el sistema remoto.
  • El parámetro RemotePath indica la ruta en el sistema remoto del archivo que queremos transferir.
  • El parámetro LocalPath representa la ruta donde queremos transferir el archivo.
  • El parámetro Port determina el puerto del servidor.

• deleteSftpFile(): borra un fichero de un servidor Sftp. Devuelve si la operación ha tenido éxito o no. Como parámetros de entrada tenemos:
  • El parámetro Host indica la dirección de la máquina remota donde reside el archivo.
  • El parámetro User indica el usuario de la conexión al sistema remoto.
  • El parámetro Password indica la contraseña del usuario en el sistema remoto.
  • El parámetro RemotePath indica la ruta en el sistema remoto del archivo que queremos transferir.
  • El parámetro LocalPath representa la ruta donde queremos transferir el archivo.
  • El parámetro Port determina el puerto del servidor.

• formatFileByLenghtLine: formatea fichero con longitud introducida como parámetro.

• generateFileAsEvidence(): la función genera una copia del fichero txt en su estado actual, para ser añadido como evidencia.

• getFileText(): lee el contenido del fichero y lo retorna como una variable TastDataString. No requiere parámetros de entrada.

• getFtpFile(Host, User, Password, RemotePath, LocalPath): permite transferir un archivo a través del protocolo Ftp de un sistema remoto al sistema local en el que se ejecuta el diagrama.
  • Devuelve verdadero si la operación finaliza con éxito, de lo contrario, falso.
  • El parámetro Host indica la dirección de la máquina remota donde reside el archivo.
  • El parámetro User indica el usuario de la conexión al sistema remoto.
  • El parámetro Password indica la contraseña del usuario en el sistema remoto.
  • El parámetro RemotePath indica la ruta en el sistema remoto del archivo que queremos transferir.
  • El parámetro LocalPath representa la ruta donde queremos transferir el archivo.

• getLineLength(lineNum): devuelve la longitud de la línea de archivo indicada por el parámetro lineNum.

• getNumColumns(): devuelve el número de columnas contenidas en TastTableData que fue generado mediante la ejecución de la función loadCsvFile. Requiere la ejecución de la función loadCsvFile en los pasos anteriores del diagrama.

• getOwner(): devuelve el propietario del fichero en el sistema de archivos. No requiere parámetros de entrada.

• getReadLine(lineNum): devuelve una variable de tipo String al ejecutor con el contenido del número de línea indicado por el parámetro lineNum.

• getSftpFile(Host, Port, User, Password, RemotePath, LocalPath): permite transferir un archivo a través del protocolo Sftp de un sistema remoto al sistema local en el que se ejecuta el diagrama.
  • Devuelve verdadero si la operación finaliza con éxito, de lo contrario, falso.
  • El parámetro Host representa la dirección del equipo remoto donde reside el archivo.
  • El parámetro Port representa el número de puerto en el que el servidor Sftp escucha las conexiones entrantes. El Sftp toma el puerto 22 por defecto.
  • El parámetro User representa el usuario de la conexión al sistema remoto.
  • El parámetro Password representa la contraseña del usuario en el sistema remoto
  • El parámetro RemotePath representa la ruta en el sistema remoto al archivo que queremos transferir.
  • El parámetro LocalPath representa la ruta, en el sistema de archivos local, donde queremos transferir el archivo.

• getSize(): devuelve el tamaño del fichero en KiloBytes. No requiere parámetros de entrada.

• getTableValue(RowNum, ColNum): devuelve el valor contenido de la celda indicada por los parámetros RowNum y ColNum. Requiere la ejecución de la función loadCsvFile en los pasos anteriores del diagrama.

• getTextFileData(): almacena el contenido del fichero en un array y otro fichero para futuras operaciones. No requiere parámetros de entrada.

• lineContainsText(lineNum, StringToSearch): devuelve verdadero si la cadena de texto introducida en el parámetro StringToSearch existe en la línea del archivo indicada por el parámetro lineNum, y falso en caso contrario.

• loadCsvFile(Separator): lee el contenido de un archivo de tipo csv y lo transforma en una variable TastTableData con la que podamos operar sobre los datos en los siguientes pasos del diagrama. El parámetro separator indica el carácter separador de los campos en el archivo.

• newFile(FilePath): crea o anula 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 borrará el archivo actual y creará un nuevo archivo.

• openFile(): comprueba la existencia del archivo en el sistema de ficheros y los permisos de lectura/escritura del mismo. Devuelve verdadero si al archivo se puede acceder correctamente o falso en caso contrario. No requiere parámetros de entrada.

• openNewFile(): restablece el contenido del archivo configurado a vacío. Este archivo debe existir. No requiere parámetros de entrada.

• putFtpFile(Host, User, Pasword, LocalFileName, RemoteFileName, HostDirectory): permite transferir un archivo, mediante el protocolo Ftp, del sistema local en el que se ejecuta el diagrama al sistema remoto.
  • Devuelve verdadero si la operación finaliza con éxito, de lo contrario, falso.
  • El parámetro Host representa la dirección del equipo remoto donde reside el archivo.
  • El parámetro User indica el usuario de la conexión al sistema remoto.
  • El parámetro Password indica la contraseña del usuario en el sistema remoto.
  • El parámetro LocalFileName representa la ruta completa al archivo en el sistema local.
  • El parámetro RemoteFileName representa el nombre del archivo en el sistema remoto.
  • El parámetro HostDirectory representa el directorio, en el sistema de archivos remoto, donde queremos transferir el archivo.

• putSftpFile(Host, Port, User, Password, LocalPath, RemotePathFormed): permite transferir un archivo, mediante el protocolo Sftp, del sistema local en el que se ejecuta el diagrama al sistema remoto.
  • Devuelve verdadero si la operación finaliza con éxito, de lo contrario, falso.
  • El parámetro Host indica la dirección de la máquina remota donde reside el archivo.
  • El parámetro Port representa el número de puerto en el que el servidor Sftp escucha las conexiones entrantes. El Sftp utiliza el puerto 22 por defecto.
  • El parámetro User indica el usuario de la conexión al sistema remoto.
  • El parámetro Password indica la contraseña del usuario en el sistema remoto.
  • El parámetro LocalPath representa la ruta completa y el nombre del archivo en el sistema local.
  • El parámetro RemotePathFormed representa la ruta completa y el nombre del archivo en el sistema remoto.

• replaceText(From_Str, To_Str): permite sustituir todas las ocurrencias de la cadena “From_Str” por la cadena “To_Str”, y guardará el archivo de nuevo.

• searchText: devuelve lista con las líneas que contienen los textos introducidos como parámetros de entrada.

• writeEnter: la función añade un salto de línea al fichero. No requiere parámetros de entrada.

• writeTo(StringToWrite): escriba la cadena de texto en el archivo, al final del mismo.
  • Devuelve verdadero si la operación de escritura fue exitosa, de lo contrario, falsa. Los parámetros de entrada son StringToWrite para recibir la cadena de texto y addBreakLine para saltar o no la línea (siendo un Boolean).