GXtest UI Commands - File Upload

Official Content
This documentation is valid for:

These commands family allows interacting with upload file controls, check the Fileupload examples. Note that they can be combined with File Upload Base Path property usage.

FileUpload

fileUpload_png

Allows uploading a file for a control present on the page.

Parameters:

  • ControlName: name of the control as defined in the KB
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUpload("&blobVar", "pathToFile/fileName.extension")

FileUpload

FileUploadGrid_png

Allows uploading a file for a control inside a grid present on the page.

Parameters:

  • ControlName: name of the control as defined in the KB
  • Row: row number inside the grid
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUpload("&blobVar", 2, "pathToFile/fileName.extension")

 

Also, four HTML selectors are available for this command: ID, Name, CSS, and XPath.

FileUploadByID

image_2020929182953_1_png

Allows uploading a file to an input file element using its ID.

Parameters:

  • ID: target input file element's ID
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUploadByID("fileUploadID", "pathToFile/fileName.extension")

FileUploadByName

image_2020929183026_1_png

Allows uploading a file to an input file element using its name attribute.

Parameters:

  • Name: target input file element's Name
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUploadByName("fileUploadName", "pathToFile/fileName.extension")

FileUploadByCSS

image_2020929183048_1_png

Allows uploading a file to an input file element using a CSS selector.

Parameters:

  • CSS: a CSS selector for target input file element
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUploadByCSS("#vATTACHEBLOB", "pathToFile/fileName.extension")

FileUploadByXPath

image_2020929183227_1_png

Allows uploading a file to an input file element using an XPath selector.

Parameters:

  • XPath: an XPath selector for target input file element
  • FilePath: the path to the file to be uploaded

Example:

&driver.FileUploadByXPath("//*[@id='vATTACHEBLOB']", "pathToFile/fileName.extension")

 

Additionally, with this new commands, there is another new command useful to set a base folder where GXtest will use to select files in case you want to use only file names or relative paths in your FileUploadBy commands.

SetFileUploadBasePath

image_202092918349_1_png

Goal: to set a default base directory where FileUpload commands will be looking at files for upload when a relative path is used as FileName parameter.

Parameters:

  • BasePath: a directory path where testing resources are placed.

Example:

&driver.SetFileUploadBasePath("C:\\testingFiles\\")

&driver.FileUploadByName("fileUploadName", "fileName.extension")

 

Notes:

- File upload base path is set automatically through its corresponding environment level property but also you can use this command for a specific test. 

-  "File Upload Base Path" property, "SetFileUploadBasePath" and "FileUploadBy" commands does not validate if the path set is valid. For this, it is necessary to carry out validations (Assertions, GetValue, Verify, Contains, EndsWith, etc.) to verify that the file uploaded correctly or not. For Example:

&driver.FileUploadByName("fileUploadVar", "C:\testingResources\userForm.pdf")

if (&driver.GetValueByName("fileUploadVar").EndsWith("userForm.pdf")) 
    // File loaded successfully
else
    // File not loaded
endif