Adaptador XML

English

Introducción

El Adaptador XML nos permite interactuar con un archivo .xml, ofreciendo un conjunto de funciones para que pueda recuperar, revisar, modificar el contenido del archivo y guardar el documento modificado. También podemos utilizarlo como entrada de datos al diagrama.

Parámetros de inicialización

La información que le proporcionaremos a este Adaptador, en el proceso de inicialización, es la siguiente:

• FilePath: la ruta completa, incluyendo el nombre del archivo representado por el adaptador en el diagrama.
• Create/Overwrite: cuando la casilla de verificación está marcada, TAST creará un nuevo archivo o lo sobrescribirá si el archivo ya existe.
• Charset(Opt.): nos indica el tipo de codificación de nuestro archivo XML, o lo que es lo mismo el conjunto de caracteres usados en el archivo con el que vamos a trabajar. Este dato es opcional.

Funciones Predefinidas (PF's)

• generateFileAsEvidence(): la función genera una copia del fichero XML en su estado actual, para ser añadido como evidencia. No requiere parámetro de entrada.

• getElementAttrTextByXPath(XPath, Attribute Name): devuelve el texto del atributo del elemento, buscando por XPath y Nombre del Atributo.

• getElementTextByTagName(Tag Name, Position): devuelve el texto del elemento, buscando por Tag Name (Nombre de Etiqueta) y Posición.

• getElementTextByXPath(XPath, Position): devuelve el texto del elemento, buscando por XPath y Posición.

• getElementsCountByTagName(Tag Name): devuelve el número de ocurrencias del elemento, buscando por Tag Name (Nombre de Etiqueta).

• getElementsCountByXPath(XPath): devuelve el número de ocurrencias del elemento, buscando por XPath.

• getElementsTextByTagName(Tag Name): devuelve el texto de la cadena de elementos de la matriz, buscando por Tag Name (Nombre de Etiqueta).

• getElementsTextByXPath(XPath): devuelve la cadena de texto de los elementos de la matriz, buscando por XPath.

• replaceElementAttrTextByXPath(XPath, Attribute, New Text): reemplaza el texto del atributo del elemento, buscando por Xpath y Attribute Name.

• replaceElementTextByTagName(Tag Name, Position, New Text): reemplaza el texto de elemento, buscando por Tag Name y Posición.

• replaceElementTextByXPath: reemplaza el texto del elemento, buscando por Xpath y Posición.

• saveAs: guarda el archivo .xml en la ruta del usuario. Guarda en la carpeta de log si no se especifica la ruta.

• saveXml(): guarda el archivo .xml en la ruta original.

• xmlToString: guardar XML desde la memoria de la aplicación a un String.