An application component can be set to one of the following scopes:
Global: Component is shared among all users.
Session: Separate instances of the component are provided to each user.
Request: Separate instances of the component are provided to each active request.
Specifying component scopes
You specify a component’s scope by setting its $scope
property to global
, session
, or request
. For example, a NewPerson component might be set to session scope as follows:
$class=Person
$scope=session
name=Bill
age=28
If a component’s $scope
property is not explicitly set, it automatically has global scope.
Property object scopes
A component’s properties should always point to objects whose scope is equal to or greater than its own. Thus, global-scope component properties should only point to objects that also have global scope; session-scope component properties should only point to objects that have global or session scope; while request-scope component properties can point to objects of any scope, including request.
Viewing and changing component scopes in the ATG Control Center
You can view and change the scope of a component in the Basics tab of the Component Editor. The Scope field displays the current scope of the component. You can change a component’s scope by clicking the Scope field and setting the component’s scope to global, session, or request.