# parse_document_xml

The `parse_document_xml` function parses an XML string or file into a document and returns a LuaDocument.

TIP: You can use this function if the string or file contains a single document. If you have an XML file that contains multiple documents you can use the function `parse_document_xml(filename, handler [, params] )` instead.

## Syntax

    parse_document_xml( input, file [, params ] )

## Arguments

Argument | Description
--- | ---
`input` | (string) The string or path to the file that contains the document in XML format.
`file` | (boolean) Specifies whether the `input` argument is a path to a file.
`params` | (table) A table of named parameters to configure parsing. The table maps parameter names (String) to parameter values. For information about the parameters that you can set, see the following table.

## Named Parameters

Named Parameter | Description
--- | ---
`content_paths` | (string list, default `DRECONTENT`) The paths in the XML to the elements that contain document content. You can specify a list of paths.
`document_root_paths` | (string list, default `DOCUMENT`) The paths in the XML to the elements that represent the root of a document. You can specify a list of paths.
`include_root_path` | (boolean, default `false`) Specifies whether to include the `document_root_paths` node in the document metadata. The default value includes only children of the root node.
`reference_paths` | (string list, default `DREREFERENCE`) The paths in the XML to elements that contain document references. Though you can specify a list of paths, there must be exactly one reference per document.

## Example

If you have a string named `myXmlString` that contains a document in XML format, you can obtain a LuaDocument object as follows:

    local xmlParams = {
            document_root_paths={"DOC"},
            reference_paths={"REF"},
            content_paths={"CONTENT","MORE_CONTENT"}
        }

    local myDocument = parse_document_xml(myXmlString, false, xmlParams)

## Returns

(LuaDocument). A LuaDocument object that represents the document.

© Copyright 2016-2019 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm