# Import XML

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

<figure><img src="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2F0Ixqk96K1A55LvI04yLS%2F2023-05-23_09h28_13.png?alt=media&#x26;token=50be2372-8136-4038-862d-a377bbd77721" alt=""><figcaption></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.


---

# Agent Instructions: 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:

```
GET https://docs.keyfax.biz/product-suite/admin/entities/databoxes/import-xml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.