User Guide

WebServiceConnector component (Flash Professional only) 865
WebServiceConnector component (Flash Professional only)
The WebServiceConnector component lets you access remote methods exposed by a server using
the industry-standard Simple Object Access Protocol (SOAP). A web service method may accept
parameters and return a result. Using the Flash MX Professional 2004 authoring tool and the
WebServiceConnector component you can inspect, access, and bind data between a remote web
service and your Flash application.
A single instance of a WebServiceConnector component can be used to make multiple calls to the
same operation. You need to use a different instance of WebServiceConnector for each different
operation you want to call.
Note: The WebServiceConnector component appears on the Stage during application authoring but
is not visible in the runtime application.
For introductory information on working with the results of this component, see “Working with
schemas in the Schema tab (Flash Professional only)” in Using Flash.
Using the WebServiceConnector component (Flash Professional only)
You can use the WebServiceConnector component to connect to a web service and make the
properties of the web service available for binding to properties of UI components in your
application. To connect to a web service, you must first enter the URL for the WSDL file that
represents the web service. You can enter this URL in the Component inspector or the Web
Services panel. See “Connecting to web services with the WebService connector component
(Flash Professional only)” in Using Flash.
For more information on connecting to web services, see “Data binding (Flash Professional
only)”in Using Flash.
WebServiceConnector parameters
You can set the following authoring parameters for each WebServiceConnector component
instance by using the Parameters tab of the Component inspector:
multipleSimultaneousAllowed is a Boolean value that indicates whether multiple calls can take
place at the same time; the default value is false. If this parameter is
false, the trigger()
method does not perform a call if a call is already in progress. A status event is emitted, with the
code
CallAlreadyInProgress. If this parameter is true, the call takes place.
operation is a string indicating the name of an operation that appears within the SOAP port in a
WSDL file.
suppressInvalidCalls is a Boolean value that indicates whether to suppress a call if parameters are
invalid; the default value is
false. If this parameter is true, the trigger() method does not
perform a call if the databound parameters fail the validation. A status event is emitted, with the
code
InvalidParams. If this parameter is false, the call takes place, using the invalid data as
required.
CHAPTER 6
Components Dictionary