BBjThinClient::setUserProperties

Description

In BBj 15.00 and higher, this method sets multiple client-side properties within a given property group.

Syntax

Return Value	Method
void	setUserProperties(java.util.Map `map`)
void	setUserProperties(long `group`, java.util.Map `map`)
void	setUserProperties(long `group`, string `samesite`, java.util.Map `map`)

Parameters

Variable	Description
group	USER_PROPERTIES_COOKIES (0) USER_PROPERTIES_STORAGE (1) USER_PROPERTIES_SESSION (-1)
samesite	SAME_SITE_DEFAULT ("") SAME_SITE_LAX ("Lax") SAME_SITE_NONE ("None") SAME_SITE_STRICT ("Strict")
map	A Map structure containing key/value pairs to be set in the specified property group.

Return Value

None.

Remarks

In BUI, USER_PROPERTIES_COOKIES maps to browser cookies with a 30-day expiration, USER_PROPERTIES_STORAGE maps to browser local storage, and USER_PROPERTIES_SESSION maps to browser session storage. Any other group value is treated as a cookie with a specified expiration timestamp (e.g. System.currentTimeMillis()+24*60*60*1000*7 is exactly 7 days from now).

In GUI, the three groups map to nodes in a Preferences tree, which doesn't allow keys or values to include any $00$ characters.

If no group is specified, the default value is taken from STBL("!USER_PROPERTIES").

In BBj 20.0 and higher, the samesite value ( "Lax", "None", or "Strict") can be specified to control the set of domains that can read a given cookie. For more information, see Google's notes for Chrome 80+. If no samesite value is specified, the default value is taken from STBL("!SAME_SITE") . The samesite value is only meaningful in BUI.

When a BUI or DWC application creates a browser cookie, the cookie path attribute defaults to window.location.pathname. Some applications might want more control over the path attribute. In BBj 22 and higher, STBL("!COOKIE_PATH") can be used to specify the path value for any cookies created with setUserProperties.

Example

tc! = bbjapi().getThinClient()
props! = new java.util.HashMap()
props!.put("key1","value1")
props!.put("key2","value2")
tc!.setUserProperties(props!)
print tc!.getUserProperties()