TeleFlow Step 0394

From TeleFlow

XML Load Step
Load an XML document into memory.

Before an XML document can be manipulated by TeleFlow, it must be loaded into memory. An XML document can come from many sources. The most common are from a file on disk or from a separate XML server (likely a web server, using an HTTP Get). Accordingly, the XML Load step supports two sources: a file, or TeleFlow variable. A TeleFlow variable might get populated with XML in a number of different ways, although the most common would be the HTTP Response Message Body from an HTTP step.

Properties

XML handle: Every XML document loaded into memory must be assigned a number, or handle, in order for all subsequent XML Steps to reference it (TheXML Fetch step uses this handle to retrieve nodes and attributes from the XML document). This allows more than one XML document to be loaded into memory at a time. The XML handle must be numeric, but can be contained in a TeleFlow variable (eg: @HANDLE).

Load From: Specifies the source type of the XML document. If this option to is set to "Variable", you must supply a TeleFlow® variable in the "Variable / File to load" property. If set to "File", you must supply a file name in the "Variable / File to load" property.

Variable / File to load: Indicates the actual TeleFlow variable or file name - the filename can be in a TeleFlow variable, and the path to the filename is also required - containing the XML document to be loaded. The value required for this field varies depending upon the setting of the "Load From" property (see above).

Action Steps

Failure: TeleFlow® could not find the XML document requested, or the document doesn't appear to conform to proper XML document format.

Related Steps

Load Webpage
XML Fetch
XML End
XML Write