Skip to main content

XML Adaptor example

Description

The XML adapter allows you to interact with an .xml file, offering a set of Predefined Functions so that you can retrieve, review and modify the contents of the file. It also allows you to save the modified document. 

Statement of the exercise 

In this example we start from an XML file. We will ask H-TEST to generate a copy of this file in its current state, to add it as a test. Then return the number of occurrences of an element, searching by its TagName and also by its XPath obtaining the same result; then retrieve the text string of the array elements, searching by XPath and by its TagName; replace the element text, searching by Tag Name and Position. Finally we will save this new XML file with the changes, in the path and with the name that we indicate. If the path is not specified, it will be saved in the log folder.

Solving the test case

As a part of the mapping process, you should provide the adaptor’s information, regarding to connect and use it. As initialization parameter we will indicate the complete path of the file (File Path)

  • FilePath: complete path of the file: C:\temp\XML\Example2.xml 

Example2.xml 

Example2.png

 

This is the link to the following diagram: https://app.htest.testautomationsystemtool.com/opendiagram?id=205

Diagram.1.png

Functions we have used with XML Adaptor:

  • generateFileAsEvidence(): the function generates a copy of the XML file in its current state, to be added as evidence. It does not require an input parameter.
  • getElementsCountByTagName(TagName): returns the number of occurrences of the element, searching by TagName. We will return four
  • getElementsCountByXPath(XPath): returns the number of occurrences of the element, searching by XPath. We have to add at the beginning a /. It will also return four which is the number of times Customer appears.

Example3.png

  • getElementTextByTagName(TagName, Position): returns the text of the element, searching by TagName and Position. 
  • replaceElementTextByXPath(Xpath, Position, New Text): replaces the element´s text, searching by XPath and Position. We have to add at the beginning a /.
  • saveAs(Path, FileName): saves XML to the user path. Saves to the log folder if the path is not specified.

Diagram.png

You can also make the search by its XPath. We can do it either by pressing (Ctrl + Shift + P) or through the Plugins > XML Tools > Current XML Path tab. 

Example5.png

It will be copied to the Clipboard, until we add it in the Mapping tab of the object.

Example6.png

Test Set Execution

When we finish executing this test case, we see if it has been executed correctly:

Example7.png

Capture of results

We then open the icon on the right (marked with a red arrow) and we have as a result the evidence folder, where both the log of the execution is stored, as well as all the screenshots, files, etc... if we have checked the "Evidence" box in the general settings of the diagram.

Evidence folder

Example7.1.png

Log of the execution   

Example7.2.png

Results2.xml

Example7.3.png

When returning the results, H-TEST returns a Word document, detailing the steps we have taken, the results obtained from each step, the links to the diagram and the test set, if we have clicked on download document in the Results box.

Example8.png


No Comments
Back to top