userKey, altuserKey

Local, domain and system scopes

These variables set the key used to identify users in Tango.

User variables let you store values associated with a particular user of your Web site. These values can then be accessed in any application file. In order for user variables to work properly, Tango must be able to uniquely identify each user who accesses it. The World Wide Web and the protocol it uses (HTTP) do not make this easy. Tango gives you several options for specifying how Tango identifies each user. You need to choose the one that best suits your environment. You make this choice by assigning values to these configuration variables.

The userKey and altuserKey configuration variables tell Tango Server what piece(s) of information to use to identify a user when assigning to and evaluating user variables. The value of userKey is the default key for user variables. If its contents evaluate to empty, altUserKey is used instead.

When you assign a value to userKey and altUserKey, you must tell Tango Server not to evaluate the content of the VALUE attribute, but instead to evaluate the meta tag when user variables need to be keyed. This is done with the <@LITERAL> meta tag.

For more information, see "<@URL>" .

The syntax of the assignment to userKey of its default value would be as follows:

<@ASSIGN NAME=userKey VALUE=<@LITERAL VALUE="<@USERREFERENCE>">

When you use <@VAR> to get the value of either of these configuration variables, the meta tags assigned to it are returned, not the values of those meta tags, because of the use of the <@LITERAL> meta tag. To get the actual value of the key, use the ENCODING=METAHTML formatting parameter in <@VAR>.

For more information, see "Encoding Attribute" .

For example, <@VAR NAME=userKey> might return <@USERREFERENCE>, indicating that user configuration variables are keyed on the Tango user reference ID assigned to each user. To get the actual value of the key for the current user, you would use <@VAR NAME=userKey ENCODING=METAHTML>, which would return the value of the string currently being used as the user key in the current application file (a 24-digit hexadecimal string).

The default value of userKey is <@USERREFERENCE>. The default value of altUserKey is empty.

See Also

<@CGIPARAM>
<@USERREFERENCE>
<@VAR>