> For the complete documentation index, see [llms.txt](https://docs.keyfax.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keyfax.biz/product-suite/admin/entities/databoxes/import-xml.md).

# Import XML

{% embed url="<https://youtu.be/FurpuN3HgEs>" %}

<figure><img src="/files/VYuMNlzPNvyNvzILz0EX" alt=""><figcaption><p>Import Databox</p></figcaption></figure>

**Group -** when displayed in the left hand menu, Databoxes are arranged into groups. Select a group from the drop down list to add the Databox to an existing group or type in a new group name to create a new group.

**Name –** a descriptive name for the Databox. Use a meaningful description to identify the Databox in relation to its purpose for ease of recognition.

**Empty bookmarks allowed –** check this box if the Databox can be used in a task or message without being required to hold a value. If they are not allowed, the operator will be prompted to compelte them before sending the email or printing a letter.&#x20;

**Description -** a short description of the Databox. \
\
**Read Only** – check this box if the Databox will only be available to be read from when used within the Scripts.

**XPath** - the XPath details the node/element of the Import XML that is to be read from by the Databox. This has to be detailed in standard XPath format.

{% hint style="info" %}
XPath is a language that describes how to locate specific elements, attributes or processing instructions in an XML document. It allows you to locate particular content within a document. XPATH treats an XML document as a logical ordered tree.

XPath statements can get very complex but in the context of Databoxes, this shouldn't get more complicated than **NodeName/NodeName/text()**, e.g. **Startup/AssetID/text()**
{% endhint %}

**Test** – if your Databox owns any Expressions, this is how to confirm that they are set up correctly and will work whatever data is passed to it, including null/empty values.\
\
**Help with Expressions** – Help on constructing expressions to manipulate the data, which also includes examples of specific expressions and guidance on where to find extra help.