<html>
<head>
<link href="mmres://user_interface_reference.css" rel="stylesheet" type="text/css">
<title>CFINVOKEARGUMENT</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
   <div id="Description">
   <table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
      <tr> 
         <td valign="top" class="name">CFINVOKEARGUMENT</td>
         <td valign="top" nowrap class="compatibility">&nbsp;</td>
      </tr>
      <tr>
         <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
      </tr>


    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Description</span>
<p>
Passes the name and value of a parameter to a component method or a web service. This tag is used within the cfinvoke tag. 
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Category</span>
<p>
Extensibility tags
</p>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="syntax"><span class="title">Syntax</span><pre>&lt;cfinvokeargument
   name=&quot;argument name&quot;
   value=&quot;argument value&quot;
   omit = &quot;yes&quot; or &quot;no&quot;&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">See also</span>
<p>
cfargument, cfcomponent, cffunction, cfinvoke, cfobject, cfproperty, cfreturn
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">History</span>
<p>
ColdFusion&#160;MX&#160;7: Added the omit attribute.
</p>

<p>
ColdFusion&#160;MX: Added this tag.
</p>

<p>

</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Usage</span>
<p>
You can have multiple cfinvokeargument tags in a cfinvoke tag body.
</p>

<p>
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. 
</p>

<p>
If you are invoking a web service, you can omit a parameter by setting the omit attribute to &quot;yes&quot;. If the WSDL specifies that the argument is nillable, ColdFusion&#160;MX sets the associated argument to null. If the WSDL specifies minoccurs=0, ColdFusion&#160;MX omits the argument from the WSDL.
</p>
    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Example</span><pre>&lt;cfinvoke 
   component=&quot;nasdaq.quote&quot; 
   method=&quot;getLastTradePrice&quot;
   returnVariable=&quot;res&quot;&gt;
   &lt;cfinvokeargument 
      name=&quot;symbol&quot; value=&quot;mot&quot;&gt;
   &lt;cfinvokeargument 
      name=&quot;symbol&quot;    value=&quot;macr&quot;&gt;
&lt;/cfinvoke&gt;

&lt;cfoutput&gt;#res#&lt;/cfoutput&gt;
</pre>    </td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="CLEARSEPARATION">&nbsp;</td>
  </tr>
  <tr>
    <td valign="top" colspan="2" class="description"><span class="title">Example</span><pre>&lt;cfinvoke
   webservice =&quot;http://www.xmethods.net/sd/2001/BabelFishService.wsdl&quot;
   method =&quot;BabelFish&quot;
   returnVariable = &quot;varName&quot;
   &gt;
   &lt;cfinvokeargument 
      name=&quot;translationmode&quot; value=&quot;en_es&quot;&gt;
   &lt;cfinvokeargument 
      name=&quot;sourcedata&quot; value=&quot;Hello world, friend&quot;&gt;
&lt;/cfinvoke&gt;
&lt;cfoutput&gt;#varName#&lt;/cfoutput&gt;   
</pre>
         </td>
      </tr>
   </table>
   </div>
<div id="NAME">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">NAME</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Argument name.</p>

  </td>
  </tr>
  </table>
</div>
<div id="VALUE">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">VALUE</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Required</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">



<p>Argument value.</p>

  </td>
  </tr>
  </table>
</div>
<div id="OMIT">
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>  
<td valign="top" class="name">OMIT</td>
  <td valign="top" nowrap class="compatibility">&nbsp;</td>
  </tr>
  <tr>
  <td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
  </tr>

  <tr>
  <td valign="top" class="syntax">&nbsp;</td>
  <td valign="top" nowrap class="requirements">Optional</td>
  </tr>
  <tr>
  <td colspan="2" class="clearseparation">&nbsp;</td>
  </tr>
  <tr>
  <td valign="top" colspan="2" class="description">

<strong>Default value:</strong> "&quot;no&quot;"


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

  </td>
  </tr>
  </table>
</div>

  </body>
</html>
