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; "Maintaining client identity" 70 in the ColdFusion Developer's Guide

Function syntax

URLSessionFormat(request_URL)

Parameters

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")#">
</cfform>