Versions Compared

Old Version 16

changes.mady.by.user Sagar Dubewar

Saved on

compared with

New Version Current

changes.mady.by.user ravi.chandran

Saved on

Key

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

Anchor
XMLExample
XMLExample

Table of Contents


XML.UpdateNodeValue

This action reads the specified XML file and updates the inner value of the specified node.

Input Parameters:


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.

YesString
value

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

YesString

Example: (Refer to the image above.)

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

If you execute this action in the XML mentioned above, this John Doe will be replaced by Abraham Kennedy.

XML.StoreNodeValue

This action reads the specified XML file and stores the inner value of the specified node under the specified key. The key value can be retrieved using the key name.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

Enter the absolute path to the XML file from which you want to get and store the value.

Yes

String

Xpath

Enter the path to the node (XPath) from which you want to read and store the inner text.

YesString

strKey

Enter the key name under which you want to store the node value (inner text from the node).

YesString

Example: (Refer to the image above.)

XML.StoreNodeValue         “C:\Users\Qualitia\Actors_List.xml”        "//actors/actor[@id="3"]"             “ActorName”

If you execute this action in the XML mentioned above, this William Kennedy will be stored under the key name ActorName. You can use the value stored under the ActorName key in the test case execution flow.

XML.StoreAttributeValue

This action reads the XML file and stores the value of the specified attribute under the key. The key value can be retrieved using the key name.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

Key_ResultEnter the key name under which you want to store the attribute value.YesString

XmlFilePath

Enter the absolute path to the XML file from which you want to get and store the value.

Yes

String

Xpath

Enter the path to the attribute (XPath) from which you want to read and store the value.

YesString

AttributeName

Enter the attribute name whose value you want to store.

YesString

Example: (Refer to the image above.)

XML.StoreAttributeValue         “Key”        “C:\Users\Qualitia\Actors_List.xml”       "//actors/actor"            “id”

In this example above, as there are multiple nodes available under the specified xpath,  value of the first node will be stored under the specified key. 

XML.StoreNodeCount

This action reads the XML file and stores the count of the specified node under the key. The key value can be retrieved using the key name.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

Key_NodeCount

Enter the key name under which you want to store the node count.

YesString

XmlFilePath

Enter the absolute path to the XML file from which you want to get and store the node count.

Yes

String

Xpath

Enter the path to the node (XPath) from which you want to store the count. 

YesString

Example: (Refer to the image above.)

XML.StoreNodeCount          “Key”        “C:\Users\Qualitia\Actors_List.xml”       "//actors"

In this example mentioned above, node count of the node actors will be stored in the specified key.

XML.VerifyIfNodeExists

This action reads the XML file and verifies whether the specified node exists in the XML document.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

Enter the absolute path to the XML file from which you want to get and store the existence of the node.

Yes

String

Xpath

Enter the path to the node (XPath) whose existence you want to verify. 

YesString
Existence

Value for this parameter can be either True or False.

  • Set True if you want to check the existence.
  • Set False if you want to check the non-existence.
NoYesString

Example: (Refer to the image above.)

Xml.VerifyIfNodeExists           “C:\Users\Qualitia\Actors_List.xml”       "//actors/actor"             "True"

This action will verify whether the specified node exists in the XML file.

XML.VerifyIfAttributeExists

This action reads the XML file and verifies whether the specified attribute exists in the XML document.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

Enter the absolute path to the XML file from which you want to get and store the existence of the attribute.

Yes

String

Xpath

Enter the path to the attribute (XPath) whose existence you want to verify. 

YesString
AttributeNameEnter the attribute name whose existence you want to verify.        Yes
Existence

Value for this parameter can be either True or False.

  • Set True if you want to check the existence.
  • Set False if you want to check the non-existence.
NoYesString

Example: (Refer to the image above.)

Xml.VerifyIfAttributeExists                 “C:\Users\Qualitia\Actors_List.xml”         "//actors/actor[@id=1]"       "True"

This action will verify whether the specified ID attribute exists in the XML file.

XML.UpdateAttributeValue

This action reads the specified XML file and updates the inner value of the specified attribute.

Input Parameters:


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.

YesString
AttributeNameEnter the attribute name whose value you want to update.YesString
value

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

YesString

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

This action stores the result of the requested xpath under the specified key. The result can be anything including (but not limited to) inner value of the node and attribute and so forth. You must create request XML based on the required result.

The result stored under the key can be retrieved using key name.

(info) If the requested Xpath is returning multiple sets of values, Qualitia stores these values under key provided by user. Also, if there is no value to store under the key, Qualitia stores blank space.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

XmlFilePath

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

Yes

String

Xpath

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

YesString
Key

Enter the key name under which you want to store the result of the requested xpath.

YesString

Example: (Refer to the image above.)

XML.StoreEvaluatedXPathResult         “C:\Users\Qualitia\Actors_List.xml”         "//actors/text()"            "Key"

Here, this action will store the empty space in the specified key, because there is no inner text present for the node <actors>.

XML.StoreEvaluatedXPathResult         “C:\Users\Qualitia\Actors_List.xml”         "//actors"            "Key"

Here, this action will return all the values from the actors node, including child nodes. In this example above, Qualitia stores John Doe Jane Doe William Kennedy inside the key.

Anchor
JSONExample
JSONExample

JSON.StoreValue

This action reads JSON file, navigates to the JSON path, and stores the value of the specified attribute in the key. The key value can be retrieved using the key name.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

JsonFilePath

Enter the absolute path to the JSON file from which you want to store the value.

Yes

String

Jsonpath

Enter the path to the node (J Path) from which you want to read and store the value.

YesString
strKey

Enter the key name under which you want to store the value.

YesString

Example: Refer to the example above.

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

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

JSON.UpdateValue

This action reads JSON file and updates the attribute value as per the given parameter.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

jsonFilePath

Enter the absolute path to the JSON file in which you want to set the value.

Yes

String

Jsonpath

Enter the path to the node (J Path) to which you want to set the value.

YesString
value

Enter the value which you want to set against the specified attribute.

YesString

Example: Refer to the example above.

JSON.UpdateValue     “C:\Users\Qualitia\Cust_Details.json”        “$.address.postalCode”         “630-0194”

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

JSON.StoreJsonPathCount

This action stores the count of specified JSON node under the key. The key value can be retrieved using the key name.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

jsonFilePath

Enter the absolute path to the JSON file in which you want to set the value.

Yes

String

Jsonpath

Enter the path to the node (J Path) to which you want to set the value.

YesString
value

Enter the value which you want to set against the specified attribute.

YesString

Example: Refer to the example above.

JSON.StoreJsonPathCount     “C:\Users\Qualitia\Cust_Details.json”        “$.address.postalCode”         “630-0194”

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


Multiexcerpt macro
nameRESTandSOAPActions

REST.ExecuteService

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.

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

URLs with invalid/expired SSL certificates are not supported.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

BaseUrl

Enter the base URL where you want to execute the request.

Yes

String

ApiMethod

Enter the API method you want to execute on the specified URL.

Yes

String

RequestMethodEnter the method you want to execute on the API url mentioned above.YesString
RequestJsonFilePath

Enter the absolute path to the file which has REST request related information in the JSON format. In this file, you can enter the details which you want to Get, Push and so forth.

NoString
ResultJsonFilePathEnter the absolute path to the file in which you want to store the REST result.NoString
AuthenticationType

Enter the authentication type you want to use when executing the REST request. Qualitia supports Basic authentication types.

YesString
UserNameEnter the username if the authentication type selected is Basic.NoString
PasswordEnter the password if the authentication type selected is Basic.NoString
RequestHeaderEnter the request headers you want to pass when executing the REST request. Multiple headers should be separated by semi colon (;).NoString


Example:

REST.ExecuteService                “https://<HOST_NAME>:<PORT_NUMBER>/rest/1.0/api/”  <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"

SOAP.ExecuteService

This action executes the SOAP request in the specified XML file. You can also store response in the XML file, if required.

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

URLs with invalid/expired SSL certificates are not supported.

Input Parameters:


Parameter Name

Parameter Description

Mandatory

Data Type

ServiceUrl

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

Yes

String

SoapActionSpecify the method from your SOAP requests which you want to execute here. NoString

RequestMethod

Enter method you want to execute on the specified URL.

Yes

String

RequestXmlPathEnter the absolute path to the file which has REST request related information in the JSON format. In this file, you can enter the details which you want to Get, Push and so forth.NoString
ResponseXmlPath

Enter the absolute path to the XML file where the results will be stored.

YesString
requestHeadersEnter the request headers you want to pass when executing the REST request. Multiple headers should be separated by semi colon (;).NoString


Example:

SOAP.ExecuteService      “https://<HOST_NAME>:<PORT_NUMBER>/rest/1.0/api/”  <REST_URL>”       "ProjectMapping/OAT"            “POST”         “C:\Users\Qualitia\Request-Cust_List.xml”        “C:\Users\Qualitia\Response-Cust_List.xml”         "Content-Type=application/x-www-;Authentication=Basic fasdhlsdv"

REST.ExecuteAPIService

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

You can store the information related to HTTP Status 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 Type

URL

Enter the complete REST URL.

Yes

String

RequestMethodEnter the method you want to execute on the API url mentioned above.YesString
RequestJsonFilePath

Enter the absolute path to the file which has REST request related information in the JSON format. In this file, you can enter the details which you want to Get, Push and so forth.

NoString
ResultJsonFilePathEnter the absolute path to the file in which you want to store the REST result.NoString
AuthenticationType

Enter the authentication type you want to use when executing the REST request. Qualitia supports Basic authentication types.

YesString
UserNameEnter the username if the authentication type selected is Basic.NoString
PasswordEnter the password if the authentication type selected is Basic.NoString
RequestHeaderEnter the request headers you want to pass when executing the REST request. Multiple headers should be separated by semi colon (;).NoString
SSLCertificateVerification

You can use this parameter to enable or disable the SSL certificate while executing this action.

  • Use True to use SSL certificate. (Default)
  • Use False to ignore SSL certificate.
NoString


Example:

REST.ExecuteAPIService                “https://<HOST_NAME>:<PORT_NUMBER>/<REST_URL>”      "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"             "True"