Ap is used to get a String[] containing runtime values associated with a paramter name. This is similar to the Rp tag which just returns a single value. The Ap tag can be used in standalone mode to write the values or in child mode by parent tag that needs arrays of values for input.

The Ap tag implement the ArrayParameter interface so parents can call the getValues(DxpRequest r) method of the Ap tag to get a set of runtime values in an array. If there is only one value associated with the parameter name (something you might use an Rp tag to get) an array with one element will be created. This allows you to turn a single value into an Array value for parents that require this.

In standalone mode the exec() method is called and the Ap tag can write the values for inspection or store the array under a new name (not very useful).

In this example the Ap tag retrieve multiple e-mails for a mail tag:

  
<dxp:SendBulkMail mailserver="your-mail-server.com">
   <dxp:Rp name="from" default="mark@plands.com"/>
   <dxp:Rp name="subject" require="true"/>
   <dxp:Ap name="to" require="true"/>
   <dxp:Rp name="content" require="true"/>
</dxp:SendBulkMail>

Return to Index

Note: We have tried to test all of the code examples but they may contain errors. Any questions, comments, suggestions, or problems should be sent to info@plands.com.