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. In this example we choose the option to download an XML file. We will also generate the same XML file as evidence. 

Statement of the exercise 

In this example we start from an XML file. 

 

 


We will ask H-TEST to perform a search for values in this XML, replace elements in the file, both by tagName and count the number of times some elements appear both by  tagName.
We will also generate the same XML file as evidence. And we will save this file in the path that we indicate.

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. 

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

Solving the test case

As initialization parameter we will indicate the complete path of the file (File Path)

  • FilePath: complete path of the file.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. We have to add at the beginning a /.
  • getElementTextByTagName(TagName, Position): returns the text of the element, searching by TagName and Position. We have to add at the beginning a /.
  • replaceElementTextByTagName(Tag Name, Position, New Text): replaces the element´s text, searching by Tag Name and Position.
  • saveAs(Path, FileName): saves XML to the user path. Saves to the log folder if the path is not specified.

Files 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