Extensions.Xml

From emotive
Jump to navigation Jump to search

Classification

Name Xml
Short Description Reads and interprets XML documents from the file system or any other source
Class OTX Extension
Base Extension -
Pre-Conditions -
Specified by ISO 13209-3

Introduction

The Xml extension makes it possible to read and interpret XML documents from the file system or any other source. It allows modification of existing documents and creation of new documents.

The extension follows the Document Object Model (DOM) approach. It offers actions, terms, and data types for basic tasks such as navigating to child elements, adding e.g. adding a processing instruction to a document.

It is, however, it is not intended as a general-purpose DOM API. Use cases which are not expected in the domain of vehicle diagnostics (e.g. reading comments) are not covered by this extension.

For reasons of interoperability and exchangeability, the usage of relative paths is recommended.

Actions

AddXmlChildElement
DeleteXmlAttribute
DeleteXmlChildElement
SetXmlComment
SetXmlElementAttribute
SetXmlElementAttributes
SetXmlElementText
SetXmlProcessingInstructions
ValidateXml
XmlSaveToFile

Terms

CopyXmlElement
CreateXmlDocument
CreateXmlElement
GetXmlElementAttributes
GetXmlElementChildElements
GetXmlElementName
GetXmlElementsByXPath
GetXmlElementText
GetXmlRootElement
XmlFromByteField
XmlLoadFromFile
XmlToByteField

Data Types

XmlDocument
XmlElement

Exceptions

XmlChangeException
XmlException
XmlFormatException
XPathException

Checker Rules

Xml_Chk001 Type-safe SetXmlElementAttributes
Xml_Chk002 Type-safe CreateXmlElement
Xml_Chk003 Type-safe GetXmlElementAttributes