URLSessionFormat |
Description

Depending on whether a client computer accepts cookies, this function does the following:

- If the client does not accept cookies: automatically appends all required client identification information to a URL
- If the client accepts cookies: does not append information

This function automatically determines which identifiers are required, and sends only the required information. It provides a more secure and robust method for supporting client identification than manually encoding the information in each URL, because it sends only required information, when it is required, and it is easier to code.
Returns
A URL; if cookies are disabled for the browser, client and session data are appended.
Category
Other functions
Function syntax

    URLSessionFormat(request_URL)

Parameters

Parameter | Description
request_URL | URL of a ColdFusion page

Usage

In the following example, the cfform tag posts a request to another page and sends the client identification, if required. If cookie support is detected, the function returns the following:

    myactionpage.cfm

If the detected cookie is not turned on, or cookie support cannot be reliably detected, the function return value is as follows:

    myactionpage.cfm?jsessionid=xxxx;cfid=xxxx&cftoken=xxxxxxxx

Example

    <cfform
    method="Post"
    action="#URLSessionFormat("MyActionPage.cfm")#>

request_URL |
URL of a ColdFusion page