User Guide Cancel

cfinvokeargument

 

Description

Passes the name and value of a parameter to a component method or a web service. This tag is used in the cfinvoke tag.

Category

Syntax

<cfinvokeargument
name="argument name"
value="argument value"
omit = "yes|no">
<cfinvokeargument name="argument name" value="argument value" omit = "yes|no">
<cfinvokeargument 
name="argument name" 
value="argument value" 
omit = "yes|no">
Note:

You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys.

See also

History

ColdFusion MX 7: Added the omit attribute.ColdFusion MX: Added this tag.

Attributes

Attribute

Req/Opt

Default

Description

name

Required

 

Argument name.

value

Required

 

Argument value.

omit

Optional

no

Enables you to omit a parameter when invoking a web service. It is an error to specify omit="yes" if the cfinvoke webservice attribute is not specified.yes: omit this parameter when invoking a web service.no: do not omit this parameter when invoking a web service.

Usage

You can have multiple cfinvokeargument tags in a cfinvoke tag body.
You can use cfinvokeargument tag to dynamically determine the arguments to be passed. For example, you can use conditional processing to determine the argument name, or you can use a cfif tag to determine whether to execute the cfinvokeargument tag. If you are invoking a web service, you can omit a parameter by setting the omit attribute to "yes". If the WSDL specifies that the argument is nillable, ColdFusion MX sets the associated argument to null. If the WSDL specifies minoccurs=0, ColdFusion omits the argument from the WSDL.

Example1

<cfinvoke
component="nasdaq.quote"
method="getLastTradePrice"
returnVariable="res">
<cfinvokeargument name="symbol" value="mot">
<cfinvokeargument name="symbol" value="macr">
</cfinvoke>
<cfoutput>#res#</cfoutput>
<cfinvoke component="nasdaq.quote" method="getLastTradePrice" returnVariable="res"> <cfinvokeargument name="symbol" value="mot"> <cfinvokeargument name="symbol" value="macr"> </cfinvoke> <cfoutput>#res#</cfoutput>
<cfinvoke 
component="nasdaq.quote" 
method="getLastTradePrice" 
returnVariable="res"> 
<cfinvokeargument name="symbol" value="mot"> 
<cfinvokeargument name="symbol" value="macr"> 
</cfinvoke> 

<cfoutput>#res#</cfoutput>

Example2

<!--- Using cfinvoke to consume a web service using a ColdFusion component. --->
<cfinvoke
webservice="http://www.xmethods.net/sd/2001/TemperatureService.wsdl"
method="getTemp"
returnvariable="aTemp">
<cfinvokeargument name="zipcode" value="55987"/>
</cfinvoke>
<cfoutput>The temperature at zip code 55987 is #aTemp#</cfoutput>
<!--- Using cfinvoke to consume a web service using a ColdFusion component. ---> <cfinvoke webservice="http://www.xmethods.net/sd/2001/TemperatureService.wsdl" method="getTemp" returnvariable="aTemp"> <cfinvokeargument name="zipcode" value="55987"/> </cfinvoke> <cfoutput>The temperature at zip code 55987 is #aTemp#</cfoutput>
<!--- Using cfinvoke to consume a web service using a ColdFusion component. ---> 
<cfinvoke 
webservice="http://www.xmethods.net/sd/2001/TemperatureService.wsdl" 
method="getTemp" 
returnvariable="aTemp"> 
<cfinvokeargument name="zipcode" value="55987"/> 
</cfinvoke> 
<cfoutput>The temperature at zip code 55987 is #aTemp#</cfoutput>

Get help faster and easier

New user?