Import XML

Pulling data into your scripts from the calling host

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.

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.

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()

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.