70Citrix NetScaler Policy Configuration and Reference Guide

HTTP Expression Prefixes that Return Text

Prefix

Description

 

 

HTTP.REQ.URL.QUERY.

Returns the value from the name-value pair in the

VALUE

argument supplied to this prefix, using the delimiter “=”

 

from the query component in the URL.

 

Following is an example:

 

http.req.url.query.value("action")

 

The first component that matches the name is selected.

 

The matching process honors the IGNORECASE and

 

the NOIGNORECASE text modes. The

 

URLENCODED and the NOURLENCODED text

 

modes are ignored.

HTTP.REQ.URL.SUFFIX

Returns the file name suffix in a URL.

 

For example, if the path in the URL is /a/b/c/mypage.

 

html, this suffix selects “html”. Following is another

 

example:

 

http.req.url.suffix.contains("jpeg")

HTTP.REQ.USER

Returns the AAA user associated with the current

 

HTTP transaction.

HTTP.REQ.USER.EXTERNAL_

Returns a list of the external groups to which a user

GROUPS

belongs. The groups are separated by a comma (",").

 

For example, HTTP.REQ.USER.EXTERNAL_

 

GROUPS returns a comma-separated list of all the

 

external groups to which the user belongs.

 

 

HTTP.REQ.USER.EXTERNAL_

Ignores the empty elements in the list of external groups

GROUPS.IGNORE_EMPTY_

to which the user belongs.

ELEMENTS

If the element delimiter in the list is a comma (","), then

 

the following list has an empty element following

 

"a=10":

 

a=10,,b=11, ,c=89

 

But the element following "b=11" is not considered an

 

empty element.

 

For example, consider the following header in an HTTP

 

request packet:

 

Cust_Header : 123,,24, ,15

 

Then the following expression returns a value of 4:

 

HTTP.REQ.HEADER("Cust_Header").TYPECAST_

 

LIST_T(','). IGNORE_EMPTY_ELEMENTS.COUNT

 

The following expression returns a value of 5:

 

HTTP.REQ.HEADER("Cust_Header").TYPECAST_

 

LIST_T(',').COUNT.

 

 

Page 84
Image 84
Citrix Systems 9.2 manual Listt,. Ignoreemptyelements.Count, Listt,.Count