Versions Compared

Old Version 48

changes.mady.by.user Dhiraj Chandanshive

Saved on

compared with

New Version 49

changes.mady.by.user Dhiraj Chandanshive

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Qualitia Automation Studio classifies web services actions as:

...

REST.Request.SetHeaders                 "H1"                   "If-Match"                        "a8f34"

REST.Request.SetHeaders                 "H2"                   "accept"                        "application/xml"

...

Parameter Name

Parameter Description

Mandatory

Data Types

Username

Enter the username for authentication.

Yes

String

Password

Enter the password for authentication.

Password should be given in the specific format to be encrypted. 

Format: Encrypt(<PASSWORD>)

Yes

String

Example:

REST.Auth.Basic                          "Qualitia"                        "Encrypt(Qualitia123)"

When the focus is moved away from the parameter, Qualitia will automatically encrypt the data ABC and result in a secured text like "vHpmlfI4R3PQkCN4sZnuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="

...

Parameter Name

Parameter Description

Mandatory

Data Types

Username

Enter the username for authentication.

Yes

String

Password

Enter the password for authentication.

Password should be given in the specific format to be encrypted. 

Format: Encrypt(<PASSWORD>)

Yes

String

Example:

REST.Auth.Digest                          "Qualitia"                        "Encrypt(Qualitia123)"

When the focus is moved away from the parameter, Qualitia will automatically encrypt the data ABC and result in a secured text like "vHpmlfI4R3PQkCN4sZnuqw==þNWE3ZDdkNjE3N2JmNDM2ODgxMzQwYWI1MTA3YWNjMDc="

...

REST.Request.WaitForAttribute            “$.address.postalCode”         ""                     "20"                  "seconds" 

  • XML: 

REST.Request.WaitForAttribute            “//actors/actor[@id='1']”         ""                     "20"                  "seconds"

REST.Request.SetFormUrlEncodedParameters

This action helps you to add the request body data as key value pair in the form of URL encoded format. Qualitia converts the given data into the URL encoded form data. You can give multiple pairs using the test data. In order to use this action to add form data while executing any API service action, you must use this action prior to API service.

...

Parameter Name

Parameter Description

Mandatory

Data Type

key

Enter the key name. 

Yes

String

Value

Enter the value for the key mentioned above.

Yes

String

Example:

REST.Request.SetFormUrlEncodedParameters                        "id"                "23950329"

REST.Request.ImportSSLCertificate

...

For more information on how to export the SSL certificate, click here.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Type

CertificatePath

Enter the absolute path to the certificate file which you have exported. 

No

String

Alias

Enter an alternative name or label that refers to the certificate file which can be used to locate or access it.

Yes

String

Password

Enter the authentication password to access the certificate file. Default password is changeit.

No

String

...

This action supports XML or JSON application file types. 

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed. File types supported are XML, HTML, TXT, and JSON. 

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.GET.ExecuteAPI         “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               ""                "False"             "C:\Users\Qualitia\Request-Cust_List.xml"            "200"

REST.GET.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               "HeaderLebel"                "False"             "C:\Users\Qualitia\Request-Cust_List.json"              "4xx"

REST.POST.ExecuteAPI

This action helps to add the desired data using POST method while executing the API service. 

...

This action supports XML or JSON application file types. 

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

Optional

String

RequestFilepath

Enter the absolute path to the file from which you want to post the data. File types supported are XML, HTML, TXT, and JSON.

Optional

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

Optional

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

Optional

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

Optional

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed. File types supported are XML, HTML, TXT, and JSON.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

Optional

String

...

Info

Important Notes:

If the response file extension is XML and response is in JSON, the system converts XML response into JSON and vice versa.

To store HTML responses, ReponseFilePath should contain file path to .html file. In case the response file extension is not matching with the file format provided by the API, the system stores the response in the file without extension. You can open such files with the help of any text editor like Notepad.

Example:

REST.POST.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               ""                "False"             "C:\Users\Qualitia\Request-Cust_List.xml"        "2xx,3xx"

REST.POST.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               "HeaderLebel"                "False"             "C:\Users\Qualitia\Request-Cust_List.json"       "200,300"

REST.PUT.ExecuteAPI

This action helps to update the desired data using PUT method while executing the API service. 

...

This action supports XML or JSON application file types.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

RequestFilepath

Enter the absolute path to the file from which you want to post the data. File types supported are XML, HTML, TXT, and JSON.

No

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed. File types supported are XML, HTML, TXT, and JSON.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

Info

Important Notes:

If the response file extension is XML and response is in JSON, the system converts XML response into JSON and vice versa.

To store HTML responses, ReponseFilePath should contain file path to .html file. In case the response file extension is not matching with the file format provided by the API, the system stores the response in the file without extension. You can open such files with the help of any text editor like Notepad.

Example:

REST.PUT.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               ""                "False"             "C:\Users\Qualitia\Request-Cust_List.xml"                   "400"

REST.PUT.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               "HeaderLebel"                "False"             "C:\Users\Qualitia\Request-Cust_List.json"            "2xx,400"

REST.PATCH.ExecuteAPI

Info

This action is supported on Qualitia Automation Studio v8.0.2 and above.

...

This action supports XML or JSON application file types. 

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

RequestFilepath

Enter the absolute path to the file from which you want to post the data. File types supported are XML, HTML, TXT, and JSON.

No

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed. File types supported are XML, HTML, TXT, and JSON.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.DELETE.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               ""                "False"             "C:\Users\Qualitia\Request-Cust_List.xml"            "300"

REST.DELETE.ExecuteAPI          “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”       "ProjectMapping/OAT"            "Basic"               "HeaderLebel"                "False"             "C:\Users\Qualitia\Request-Cust_List.json"            "500,2xx"

REST.GET.ExecuteAPIFormData

This action helps to pull the desired information using GET method while executing the API service with the help of form-data. The form-data can contain one or multiple sets of key-value pairs which will eventually help in executing the specified request method. 

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.GET.ExecuteAPIFormData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "ProjectMapping/OAT”            “Bearer”         "HeaderLabel1”    "True"     “C:\Users\Qualitia\Reponse-Cust_List.json”          "3xx"

REST.POST.ExecuteAPIFormData

This action helps to add desired information using POST method while executing the API service with the help of form-data. The form-data can contain one or multiple sets of key-value pairs which will eventually help in executing the specified request method. 

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

FormData

Enter the key value pairs of the form data to be used while executing the service. Multiple pairs should be separated by a caret sign (^).

If you want to use file to provide form data, add all the form data in some file and provide absolute path to that file as a parameter. Data in the file should be well formatted.

No

Array

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

Optional

String

...

REST.POST.ExecuteAPIFormData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "ProjectMapping/OAT”           "File=C:\Users\Qualitia\Request-Cust_List.json"        “Bearer”         "HeaderLabel1”    "True"     “C:\Users\Qualitia\Reponse-Cust_List.json”           "3xx"

REST.PUT.ExecuteAPIFormData

This action helps to update desired information using PUT method while executing the API service with the help of form-data. The form-data can contain one or multiple sets of key-value pairs which will eventually help in executing the specified request method. 

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the base URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

FormData

Enter the key value pairs of the form data to be used while executing the service. Multiple pairs should be separated by a caret sign (^). 

If you want to use file to provide form data, add all the form data in some file and provide absolute path to that file as a parameter. Data in the file should be well formatted.

No

Array

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.PUT.ExecuteAPIFormData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "ProjectMapping/OAT”           "File=C:\Users\Qualitia\Request-Cust_List.json"       “Bearer”         "HeaderLabel1”    "True"     “C:\Users\Qualitia\Reponse-Cust_List.json”              "3xx"

REST.DELETE.ExecuteAPIFormData

This action helps to remove desired information using DELETE method while executing the API service with the help of form-data. The form-data can contain one or multiple sets of key-value pairs which will eventually help in executing the specified request method. 

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the base URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

FormData

Enter the key value pairs of the form data to be used while executing the service. Multiple pairs should be separated by a caret sign (^).

If you want to use file to provide form data, add all the form data in some file and provide absolute path to that file as a parameter. Data in the file should be well formatted.

No

Array

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.DELETE.ExecuteAPIFormData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "ProjectMapping/OAT”          "File=C:\Users\Qualitia\Request-Cust_List.json"          “Bearer”         "HeaderLabel1”    "True"     “C:\Users\Qualitia\Reponse-Cust_List.json”             "400"

REST.GET.ExecuteAPIDownloadRawData

This action helps to pull the desired information using GET method. You can download raw data file after executing the action giving the desired download location.

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

DownloadLocation

Enter the folder directory location where you want to store the raw data after executing the test case.

No

String


ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.GET.ExecuteAPIDownloadRawData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”        "ProjectMapping/OAT”         “Bearer”         "HeaderLabel1”        "True"       “C:\Users\Qualitia\Reponse-Cust_List.json”            "D:\New Folder\RawDataFiles"               "300"

REST.PUT.ExecuteAPIDownloadRawData

This action helps to update desired information using PUT method. It uses raw data while executing API service. You can download raw data file after executing the action giving desired download location.

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

No

String

RequestFilepath

Enter the absolute path to the file which has REST request-related information. In this file, you can specify the details which you want to update.

No


AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

No

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

No

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

No

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

DownloadLocation

Enter the folder directory location where you want to store the raw data after executing the test case.

No

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

No

String

...

REST.PUT.ExecuteAPIDownloadRawData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”        "ProjectMapping/OAT”         “C:\Users\Qualitia\Request-Cust_List.json”         “Bearer”         "HeaderLabel1”        "True"       “C:\Users\Qualitia\Reponse-Cust_List.json”          "D:\New Folder\RawDataFiles"                      "300"

REST.POST.ExecuteAPIDownloadRawData

This action helps to add desired information using POST method. It uses raw data while executing API service. You can download raw data file after executing the action giving desired download location.

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

Optional

String

RequestFilepath

Enter the absolute path to the file which has REST request-related information. In this file, you can specify the details which you want to add.



AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

Optional

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

Optional

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

Optional

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

DownloadLocation

Enter the folder directory location where you want to store the raw data after executing the test case.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

Optional

String

...

REST.POST.ExecuteAPIDownloadRawData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”        "ProjectMapping/OAT”         “C:\Users\Qualitia\Request-Cust_List.json”         “Bearer”         "HeaderLabel1”        "True"       “C:\Users\Qualitia\Reponse-Cust_List.json”          "D:\New Folder\RawDataFiles"                  "300"

REST.DELETE.ExecuteAPIDownloadRawData

This action helps to delete desired information using DELETE method. It uses raw data while executing API service. You can download raw data file after executing the action giving desired download location.

This action can work independently or it can be used in a combination of other REST actions like REST.Request.SetGenericHeaders, REST.Request.SetHeaders, REST.Request.SetQueryParameters, REST.Auth.Basic/Digest/Bearer/JWT, based on the test case requirements.

You can also store the information related to HTTP Status, HTTP REQUEST TIME, and Header into the variable and use these values to develop test case flow after executing this action.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

BaseURL

Enter the URL where you want to execute the API service.

Yes

String

BasePath

Enter the base path where you want to execute API service. You can include path in the BaseURL parameter itself. In that case, you may keep this parameter blank.

Optional

String

RequestFilepath

Enter the absolute path to the file which has REST request-related information. In this file, you can specify the details which you want to DELETE.



AuthenticationType

Enter authentication type you want to use while executing the API service. Values for this field can be either: Basic, Bearer, JWT, or Digest. Keeping this field blank will be taken as no authentication. For Basic, Bearer, JWT, and Digest authentication types, details will be taken from the previous steps where details are provided.

Optional

String

HeaderLabel

Enter the header label in case you have specified it earlier in the test case/task.  

Optional

String

SSLFlag

Using this parameter, you can decide whether you want to consider SSL certificate while executing the API service.  

  • Use True to consider SSL certificate (default).

  • Use False to ignore SSL certificate.

(warning) External certificate files are not supported.

Optional

String

ResponseFilepath

Enter the absolute path to the file where you want to store the response you get after the service is executed.

Yes

String

DownloadLocation

Enter the folder directory location where you want to store the raw data after executing the test case.

Yes

String

ExpectedHTTPStatusCode

You can give the http status code that you expect at the end of the API service execution. From all the available forty different status code, you can provide any value that you expect. In case you are not sure about the exact expected value, you can also give the category of http status code. For example, 1xx, 2xx, and so forth. Multiple codes or code ranges can be given separated by comma (,).

Optional

String

...

REST.DELETE.ExecuteAPIDownloadRawData           “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”        "ProjectMapping/OAT”         “C:\Users\Qualitia\Request-Cust_List.json”         “Bearer”         "HeaderLabel1”        "True"       “C:\Users\Qualitia\Reponse-Cust_List.json”          "D:\New Folder\RawDataFiles"                  "300"

REST.Response.StoreStatusCode

...

Parameter Name

Parameter Description

Mandatory

Data Types

Key

This takes key-value pair .

Example: Content-Type=text/html

Yes

String

 HeaderKey

This is the key from key-value pair that is provided in 1st parameter.

Example: Content-Type

              Yes

            String 

HeaderValue

This is the value from key-value pair that is provided in 1st parameter.

Example: text/html

Yes

String

...

End of the test case, if the response time in the key is lesser than 20 seconds, test case passes, otherwise test case will report the defect.


...


REST.ExecuteService (Deprecated)

This action executes the specified REST request. Qualitia gives you provision to store the response at the specified file path location in the JSON format, if required.

...

REST.ExecuteService                “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "ProjectMapping/OAT"        “POST”            “C:\Users\Qualitia\Request-Cust_List.json”        “C:\Users\Qualitia\Response-Cust_List.json”         "Basic"        “john.doe@gmail.com”  “john.doe@123”     "Content-Type=application/x-www-;Authentication=Basic fasdhlsdv"

REST.ExecuteAPIService (Deprecated)

This action executes the specified REST request. You can enable or disable the SSL certificate while executing this action. Qualitia gives you the provision to store the response at the specified file path location in the JSON format, if required.

...

JSON.AddNode              “C:\Users\Qualitia\Cust_Details.json”        “$.address”         “PostalCode”        "6932331"        "Numeric"

End of the execution, this action add a new node as state and value as California under the node address.

  • Adding node with an array:

JSON.AddNode              “C:\Users\Qualitia\Cust_Details.json”        “$.address”         “StateCode”        "["CA" , "California"]"        ""

End of the execution, this action add a new node as state and value as CA and California under the node address.

JSON.AddNode              “C:\Users\Qualitia\Cust_Details.json”        “$.phoneNumbers”         “ ”        "~{ "type" : "landline", "number": "0123-4567-3263" ~}"        ""

End of the execution, this action add a new node as to display landline number inside the node phoneNumbers.

...

JSON.RemoveNode              “C:\Users\Qualitia\Cust_Details.json”        “$.address.postalCode”

End of the execution, the node postalCode will be removed from the JSON file.

JSON.ConvertStringToFile

...

Parameter Name

Parameter Description

Mandatory

Data Types

JSONString

Enter the JSON string which you want to add in the JSON file.

Yes

String

OutputJSONFilePath

Enter the directory where you want to store the JSON file. 

Yes

String

Example: 

JSON.ConvertStringToFile              "~{ "firstName": "John", "lastName" : "doe", "age" : 26 ~}"         “C:\Users\Qualitia\Cust_list.json” 

End of the execution, a JSON new file will be added under the specified location with data as provided here.

JSON.ValidateStringSyntax

...

Parameter Name

Parameter Description

Mandatory

Data Types

JSONString

Enter the JSON string which you want to validate.

Yes

String

Example: 

JSON.ValidateStringSyntax           "~{ "firstName": "John", "lastName" : "doe", "age" : 26 ~}" 

End of the execution, if the data is valid, action will pass, else action will fail. 

JSON.StoreArray

This action stores the array data from the specified JSON path under the specified key. The key value can be retrieved using the key name.

Input Parameters:

Parameter Name

Parameter Description

Mandatory

Data Types

FilePath

Enter the absolute path to the JSON file from which you want to get and store array data.

Yes

String

JSONPath

Enter the JSON path whose data you want to get and store under the specified key.

If JSON path contains array, ensure you use an [] with index. Index starts from 0.

Yes

String

Key

Enter the key under which you want to store the array data.

Yes

String

Example: 

JSON.StoreArray           "C:\Users\Qualitia\Cust_Details.json"           "$.phoneNumbers"             "PhoneNumbers"

End of the execution, the array data present under the phoneNumbers JSON key will be stored under the PhoneNumbers key. 

JSON.StoreAllUniqueKey

This action stores all the keys present in the JSON file. Multiple keys are stored separated by comma.

...

Parameter Name

Parameter Description

Mandatory

Data Types

FilePath

Enter the absolute path to the JSON file from which you want to get and store keys.

Yes

String

Key

Enter the key under which you want to store the JSON keys.

Yes

String

Example: 

JSON.StoreAllUniqueKey           "C:\Users\Qualitia\Cust_Details.json"           "AllKeys"

End of the execution, the complete list of JSON keys will be stored under the AllKeys key. Here AllKeys will store "firstName","lastName","age","address","streetAddress","city","postalCode","phoneNumbers","type","number".

...

Parameter Name

Parameter Description

Mandatory

Data Types

FilePath

Enter the absolute path to the JSON file from which you want to get and store total key count.

Yes

String

Key

Enter the key under which you want to store the JSON key count.

Yes

String

Example: 

JSON.StoreTotalKeyCount           "C:\Users\Qualitia\Cust_Details.json"           "TotalKeyCount"

End of the execution, the total number of keys will be stored under the TotalKeyCount (here, 10) key.

JSON.StoreSpecificKeyCount

...

Parameter Name

Parameter Description

Mandatory

Data Types

FilePath

Enter the absolute path to the JSON file from which you want to get and store total number of instances of the specified key.

Yes

String

JSONKey

Enter the key name for which you want to store the count. 

Yes

String

Key

Enter the key under which you want to store the JSON key count. (case-sensitive)

Yes

String

Example: 

JSON.StoreSpecificKeyCount           "C:\Users\Qualitia\Cust_Details.json"           "TotalKeyCount"          "type"

End of the execution, the total number of instances of the key type will be stored under the variable TotalKeyCount. Here, number 2 will be stored.

...

This action will store the value present under the attribute postalCode under the key PostalCode. 

JSON.StoreJsonPathCount

...

This action will update the value of the attribute postalCode to the value given in the parameter (here 630-0194).

...

The report also displays the consolidated number of Missing properties, Incorrect values, Unequal values.

  • Missing properties: Gives the number of missing entities in one of the files.

  • Incorrect values: Gives the number of instances where JSON key is the same in both the files but value type is different.

  • Unequal values: Gives the number of instances where key and value type are same in both the files but value data is different.

...

This action will update the value of the attribute postalCode to the value given in the parameter (here, 6300194).

  • Updating value from the array: (see the example below)

.UpdateValueInJson    “C:\Users\Qualitia\Cust_Details.json”        “$[0].address.postalCode”         “6300194”

 View image


XML Actions

Qualitia Automation Studio contains the following actions to perform operations on the XML files.

...

Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

Enter the absolute path to the XML file from which you want to update the value.

Yes

String

Xpath

Enter the path to the node (Xpath) whose value you want to update.

Yes

String

value

Enter the value which you want to add in the specified node.

Yes

String

...


Example: Refer to the above image

XML.UpdateNodeValue         “C:\Users\Qualitia\Actors_List.xml”        "//actors/actor[@id='1']"         “Abraham Kennedy”

...

Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

Enter the absolute path to the XML file in which you want to update the value.

Yes

String

Xpath

Enter the path to the attribute (Xpath) whose value you want to update.

Yes

String

AttributeName

Enter the attribute name whose value you want to update.

Yes

String

value

Enter the value which you want to add in the specified attribute.

Yes

String

Example: Refer to the image above

XML.UpdateAttributeValue         “C:\Users\Qualitia\Actors_List.xml”         "//actors/actor[@id=1]"            "id"              “4”

This action will update the attribute value of the specified attribute to the given value (here 4).

XML.StoreEvaluatedXPathResult

...