CFINVOKEARGUMENT |
Description Passes the name and value of a parameter to a component method or a web service. This tag is used within the cfinvoke tag.
Category Extensibility tags
Syntax
    <cfinvokeargument
       name="argument name"
       value="argument value"
       omit = "yes" or "no">
See also cfargument, cfcomponent, cffunction, cfinvoke, cfobject, cfproperty, cfreturn
History ColdFusion MX 7: Added the omit attribute. ColdFusion MX: Added this tag.
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 MX omits the argument from the WSDL.

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

    <cfoutput>#res#</cfoutput>
Example
    <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>

NAME |
| Required
Argument name.

VALUE |
| Required
Argument value.

OMIT |
| Optional
Default value: ""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.