The system watches for a visitor to display specific pages. You can use the optional parameters to define the pages that you want to trigger this Event element.

Examples: Visits any page

Visits a page named Quincy Funds J2EE DAF Demo:/en/mypreferences.jsp

Visits a page in folder Pioneer CyclingJSP: /en/catalog

Visits elements work for any page that a visitor specifically requests for display on the site (for example, by clicking a link that leads to that page). However, there are some circumstances in which a page request does not trigger a Visits element because it does not involve specifically requesting that page from the system. For example, in the Quincy Funds demo, the investorhome.jsp page is displayed within the index.jsp page by way of code that looks at the visitor’s userType profile property. Visitors never request investorhome.jsp directly. When you include a page in a Visits element, make sure that page is one for which visitors can issue a specific display request.

It is also important to be aware that in a multisite environment, the same pages typically exist on all your registered Web sites. (The pages contain code that causes different content to appear on each site as needed.) For example, the Commerce Reference Store demo contains one login.jsp page that appears on three sites: ATG Home, ATG Store, and ATG Store Germany. If you select this page, the event will be triggered when a customer visits the login page on any of these sites. In this case, to restrict the event to one site, you can add an Event's Site condition element that specifies the site , as shown:

Visits a page named ATG Commerce Reference Store:/myaccount/login.jsp
> Event's Site is ATG Store

Note: When you select the options Visits a page named… or Visits a page in folder…, you are prompted to select a page or folder from a list of available choices. The ATG Control Center automatically prepends the necessary path information for the item (the path includes either the ATG document root or, for J2EE applications, the context root). By contrast, if you select Visits page with Dynamo path or Visits page in Dynamo folder, you must type the fully qualified path to the page or folder yourself. These latter options exist mostly for backwards compatibility and replicate the way users specified document paths in earlier versions of the product. It is recommended that you use Visits a page named… or Visits a page in folder… if you have any doubt about the path of the item you want to use in this element.