User Guide

894 Chapter 6: Components Dictionary
XMLConnector component (Flash Professional only)
The XMLConnector component lets you read or write XML documents using HTTP GET or
POST operations. It acts as a connector between other components and external XML data
sources. The XMLConnector component communicates with components in your application
using either ActionScript code or data binding features in the Flash authoring environment. The
XMLConnector component has properties, methods, and events, but it has no visual appearance
at runtime.
Using the XMLConnector component (Flash Professional only)
The XMLConnector component provides your application with access to any external data
source that returns or receives XML through HTTP. The easiest way to connect with an external
XML data source and use the parameters and results of that data source for your application is to
specify a schema, the structure of the XML document that identifies the data elements in the
document to which you can bind.
For more information on working with the XMLConnector component, see “Connecting to
XML data with the XMLConnector component (Flash Professional only)” in Using Flash.
XMLConnector parameters
You can set the following authoring parameters for each XMLConnector component instance in
the Parameters tab of the Component inspector:
direction is a string that defines what HTTP operation to perform when trigger() is called:
send, sendAndLoad, or load correspond to receive, receive/send, and send, respectively.
ignoreWhite is a Boolean value; the default setting is false. When this parameter is set to true,
the text nodes that contain only white space are discarded during the parsing process. Text nodes
with leading or trailing white space are unaffected.
multipleSimultaneousAllowed is a Boolean value; when set to true, it allows a trigger()
operation to initiate when another
trigger() operation is already in progress. Multiple
simultaneous
trigger() operations may not be completed in the same order they were called.
Also, Flash Player may place limits on the number of simultaneous network operations. This limit
varies by version and platform. When the parameter is set to
false, a trigger() operation
cannot initiate if another one is in progress.
suppressInvalidCall is a Boolean value; when set to true, it suppresses the trigger() operation
if the data parameters are invalid. When suppressInvalidCall is set to
false, the trigger()
operation executes and uses invalid data if necessary.
URL is a string that points to an external XML data source.
CHAPTER 6
Components Dictionary