====== XML Adaptor ======
=====Introduction=====
XML adaptor allow you to interact with a .xml file, offering a set of Predefined Functions so that you can retrieve, check and modify the content of the file. It also allows to save the modified document.

===== Initilization Parameters =====

  * ** FilePath:** complete path of the file

===== Predefined functions =====

  

  * **generateFileAsEvidence()**: the function generates a copy of the XML file in that moment, to be added as evidence. It does not require input parameters.

  * **getElementAttrTextByXPath(XPath,Attribute Name)**: returns element attribute text, searching by XPath and attribute name.

  * **getElementTextByTagName(Tag Name, Position)**: returns element text, searching by Tag name and Position.

  * **getElementTextByXPath(XPath, Position)**: returns element text, searching by XPath and Position.

  * **getElementsCountByTagName(Tag Name)**: returns the number of occurrences of the element, searching by Tag name.

  * **getElementsCountByXPath(XPath)**: returns the number of occurrences of the element, searching by XPath.

  * **getElementsTextByTagName(Tag Name)**: returns array string of elements text, searching by Tag name.

  * **getElementsTextByXPath(XPath)**: returns array string of elements text, searching by XPath.

  * **replaceElementAttrTextByXPath**: replaces the element attribute text, searching by Xpath and attribute name.

  * **replaceElementTextByTagName(Tag Name, Position, New Text)**: replaces the element's text, searching by Tag Name and Position.

  * **replaceElementTextByXPath**: replaces the element text, searching by Xpath and Position.

  * **saveAs**: saves XML to the user path. Saves to the log folder if the path is not specified.

  * **saveXML()**: saves the .xml file in the original path.

  * **xmlToString**: saves XML from the application memory to a String.