XML filter parameters
Important
This module requires some prior knowledge of the XML Path Language ("XPath"). To find out more about XPath, go to https://www.w3schools.com/xml/xpath_intro.asp.
Note
You can create multiple XML configurations for one template, as long as they refer to files with a different root name.
If you have selected XML as the File type, in the Filter configuration, in Configuration > Filter templates, in the relevant popup, you see these parameters and settings for XML and similar file types:
Parameter | Description | Optional/ Mandatory | Type | Valid values |
|---|---|---|---|---|
File type | Use this parameter to specify the file type for which you want to configure filter rules. | Mandatory | Dropdown | Valid values:
|
Root name | Use this parameter to limit your configuration to files that contain specific main XML node(s). In the Root name field, specify these main XML file node name(s). If you leave this field empty, your configuration is applied to all files, regardless of their root name. | Optional | Text field | Alphanumeric Maximum of 50 characters in one root name. Multiple unique values possible. You cannot enter the same value multiple times. To separate the individual values, on your keyboard, use the Space, Enter, or the Comma key. |
Include also empty root name | This parameter is displayed if you have entered any values in the Root name text field. If you select this checkbox, your configuration will also be applied to files whose root name is different from what you have specified in the Root name field. | Optional | Checkbox | Valid values:
|
File extensions | Use this parameter to specify file extension(s) for which your settings are to be applied. | Mandatory | Multiple selection | Select one or more values from the dropdown:
You must select at least one file type. |
Reload elements | Use this parameter to import and display unique elements from the uploaded sample source file, in the XML rules list, in the left-hand side pane, automatically. | Optional | Checkbox | Valid values:
|
Upload file | Use this parameter to upload a sample source file. Drag and drop the relevant file. Alternatively, click in the file upload field to browse in your documents and find the relevant file. Once you upload the file, the file upload field is replaced with the preview of your uploaded sample file. To replace the currently uploaded file with a new one, select the | Optional | File upload field | Use one of the supported file types:
Upload limit is 100kB. |
| This parameter is displayed if you have uploaded a sample source file in the Upload file field. Use it to replace the current sample source file with a new one. | Optional | Button | Valid values:
|
XML rules list | The XML rules list is displayed on the left-hand side of the popup. In it, you see XML rules which have been uploaded automatically, based on your uploaded sample file (if you have selected the Reload elements checkbox) and/or elements which you have added using the Enter XPath field. Use the XML rules list to:
| Optional | Display field | All entries use XML Path Language ("XPath"). In the XML file elements preview, you see:
|
Enter XPath | Use this field to add XPath rules that you will use in your configuration. | Optional | Text field | Use XML Path Language ("XPath"). Once you have finished typing an individual XPath rule, select the Add button to display it in the XML rules list and start using it. |
More options section | ||||
Show HTML tags as inline tags | To display this parameter, expand the More options section. To do so, at the bottom of the popup, select Use this parameter to display HTML tags as inline tags, in XTM Workbench. | Optional | Checkbox | Valid values:
|
Preserve whitespaces by converting them into inline tags | To display this parameter, expand the More options section. To do so, at the bottom of the popup, select Use this parameter to preserve whitespace characters by converting them into inline tags, in XTM Workbench. | Optional | Checkbox | Valid values:
|
