MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX, Develop Manual

Page: 715 / 860

Consuming web services 715
where:
•
webservice
specifies the URL to the WSDL file for the web service.
•
method
specifies the operation of the web service to invoke.
•
inputParamN
specifies an input parameter passed to the operation.
•
returnVariable
specifies the name of the variable that contains any results returned from the
web service.
To access a web service using cfinvoke:
1
Create a ColdFusion page with the following content:
<cfinvoke
webservice = "http://www.xmethods.net/sd/2001/BabelFishService.wsdl"
method = "BabelFish"
translationmode = "en_es"
sourcedata = "Hello world, friend"
returnVariable = "foo">
<cfoutput>#foo#</cfoutput>
2
Save the page as wscfc.cfm in your web root directory.
3
View the page in your browser.
The following string appears in your browser:
Hola mundo, amigo
You can pass parameters to web services using two other mechanisms: the
cfinvokeargument
tag
and the
argumentCollection
attribute of the
cfinvoke
tag.
To pass parameters using the
cfinvokeargument
tag, you write your call to the web service, as
the following code shows:
<cfinvoke
webservice ="http://www.xmethods.net/sd/2001/BabelFishService.wsdl"
method ="BabelFish"
returnVariable = "varName" >
<cfinvokeargument name="translationmode" value="en_es">
<cfinvokeargument name="sourcedata" value="Hello world, friend">
</cfinvoke>
<cfoutput>#varName#</cfoutput>
The
cfinvokeargument
tag is a nested tag of the
cfinvoke
tag that lets you specify the name and
value of a parameter passed to the web service.
You can also use an attribute collection to pass parameters. An attribute collections is a structure
where each structure key corresponds to a parameter name and each structure value is the
parameter value passed for the corresponding key. The following example shows an invocation of
a web service using an attribute collection:
<cfscript>
stArgs = structNew();
stArgs.translationmode = "en_es";
stArgs.sourceData= "Hello world, friend";
</cfscript>