> For the complete documentation index, see [llms.txt](https://dbi-services.gitbook.io/omrun-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dbi-services.gitbook.io/omrun-help/version-4.x/element-overview/test-program-object/xml-converter-xl.md).

# XML Converter XL

### ![](/files/4Gtd6nx0rI4EOuoZtSso)

### Abstract

Plug-in to convert XML files into flat files within OMrun.

***

### Input

Execution parameters to invoke a conversion:

**Field ´@param1´** (Input file) \[mandatory]

* Description: Source location incl. file name + extension
* Syntax: \<full path>\\\<file name>.xml
* Example: @TestCases\OMrun\Mapping\_Business\_Rules\Rename\_Result\_Before\_Convert\Results\_Renamed\_Amber.xml
* Possible values:
  * \<file name>.xml (a valid entry superseds any value of field Application)
  * \* \[or] \<empty> (wildcard or no entry demands a valid entry of field Application)\\

**Field ´@param2´** (Output path) \[mandatory]

* Description: Target location of converted files
* Syntax: \<full path> (without ending backslash)
* Example: @TestCases\OMrun\Mapping\_Business\_Rules\Convert\_Result\_Before\_Verify\\

**Field ´@param3´** (Output file) \[optional]

* Description: Target file name + extension
* Syntax: \<file name>.\<extension> (without backslash at beginning)
* Example: Result\_Ready2Verify\_Amber.csv
* Possible values:
  * \<file name>.csv
  * csv (taking input file name and converting into csv)
  * \* \[or] \<empty> (default = File name from @param1 and converted into csv)\\

**Field ´@param4´** (Header definition file) \[optional]

* Description: File (csv) with all headers generated from XML file
* Syntax: \<file name.csv>
* Example: Filename\_HeaderDefinition.csv
* Possible values:
  * \<header definition file name.csv> (= File will be converted with this header definition file)
  * \* \[or] \<empty> (=No value converts each file with its own header file generated)

***

### Output

The converted file contains 2 additional attributes in front of all other attributes:

* FileName\_0 (original file name of XML input file without extension)
* Id\_1 (record id of XML input file)

Output format of the CSV file will be ANSI by default. Different formats could be set in config file (admin rights needed):\
C:\Program Files\OMIS\OMrun\BuiltInTests\OMrunPlugIn\_XmlConverter.exe.config

**Encoding CSV Output Format**\
It is possible to define the encoding for the csv file:

* UTF8 \[with BOM]
* UTF8 without BOM (Default)
* ANSI
* UTF7
* UTF32
* ASCII
* BigEndianUnicode
* Unicode


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dbi-services.gitbook.io/omrun-help/version-4.x/element-overview/test-program-object/xml-converter-xl.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.