Provides the url to a target, such as a file or application.
Items containing this option must have a type option setting of link, replace, submit, done, or pagedone.
The object identified must be one of the following:
<url>the URL</url>
Parameter | Type | Description |
---|---|---|
the URL | string | Identifies the target. Can be one of:
|
action, button, cell, pane
This sample identifies a file to link to or replace:
<url>C:\temp\myFile.xml</url>
This sample identifies a form processing application:
<url>http://www.host.domain/cgi-bin/recv_status</url>
This sample identifies a page to display:
<url>#PAGE2.global</url>
This sample creates an e-mail message that is sent automatically because it contains all of the necessary parameters. Note that the URL is enclosed in the CDATA construct because it contains ampersands (&).
<url><![CDATA[mailto:john@acme.com?&subject=Hello&
body=Hello.+How+are+you?]]></url>
This sample creates an e-mail message that appears to the user before sending, allowing the user to change the parameters.
<url>mailto:john@acme.com</url>
URLs that provide an e-mail address must follow this general format:
mailto:address?parameter=setting¶meter=setting...
The first parameter follows the question mark (?) symbol, while each additional parameter is added using the ampersand (&) symbol.
For example, a URL using all parameters would look like this:
mailto:setting?to=setting&cc=setting&bcc=setting&
subject=setting&body=setting&filename=setting
The following table lists the available parameters and their settings:
Parameter | Setting | Description |
---|---|---|
mailto: to= cc= bcc= |
string | A complete e-mail address,
such as john@acme.com. To include additional addresses, use the appropriate
parameter twice. For example, to add two cc addresses, use the cc=
parameter twice as shown: mailto:john@acme.com?cc=bob@acme.com
&cc=fred@acme.com Note that the first address, immediately after the mailto: parameter, is the first recipient. Additional recipients are specified using the to= parameter. |
subject= | string | The subject line of the e-mail. The text must conform to standard URL encoding rules, such as replacing spaces with the plus (+) symbol. |
body= | string | The body of the e-mail. The text must conform to standard URL encoding rules, such as replacing spaces with the plus (+) symbol. |
filename= | string | The name you want to give to the file that is attached to the e-mail message. If you do not set this parameter, a default file name will be assigned. |
If you provide the mailto:, cc=, bcc=, subject=, and body= parameters, the e-mail will be sent automatically and the user will not be able to modify the message. This is true even if the parameters are set to nothing. For example, the following URL would mail the message automatically:
mailto:tim@acme.com?cc=&bcc=&subject=Hello&body=Hello+Tim&body=
If you leave out any of those parameters, the user will see the e-mail message before it is sent, and will be able to change the e-mail.
<url compute="PAGE1.FIELD1.value"></url>
<url compute="'mailto:' +. to_field.value +. 

'&subject=' +. subject_field.value +. '&body=' 

+. body_field.value></url>
Character | ASCII Code | URL-encoded triplet |
---|---|---|
<space> | 32 | %20 |
\r | 13 | %0D |
Applications receiving form data must check the content type of the incoming data to see whether it is url-encoded.