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 make a search of values in this XML, by its tagName; to count the number of times that some elements appear, and to replace certain elements also by their tagName. We will save this new XML file with these changes in the path that we indicate. We will also generate the initial XML file, as a test. 

Solving the test case

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 

As a part of the mapping process, you should provide the adaptor’s information, regarding to connect and use it.

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.
  • getElementsCountByXPath(XPath): returns the number of occurrences of the element, searching by XPath. We have to add at the beginning a /.
  • 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
 
File needed to run the case

Example2.png


Test Set Execution

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

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.

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.

Back to top