Locating existing pages and linking in new pages
Actuate Java Component controls web page navigation with Jakarta Struts action paths. An action path is a uniform resource identifier (URI) called directly by Java Component or by a user to access the Java Component functionality. <context root>\WEB-INF\struts-config.xml contains the action path specifications.
An action path can specify a JSP to use to gather input. The action path uses the results of an Action class to determine the next action path to perform or the next JSP to display. Typically, an action path forwards the user to one action path or JSP if the execution succeeds and a different action path or JSP if the execution causes an error. In the following code sample, if the AcGetFolderItemsAction JavaBean returns success, the next JSP to display is <context root>\iportal\activePortal\private\filesfolders\filefolderlist.jsp:
<!-- Process getfolderitems -->
<action
  attribute="fileListActionForm"
  name="fileListActionForm"
  path="/getfolderitems"
  scope="request"
  type="com.actuate.activeportal.actions.AcGetFolderItemsAction"
  validate="false">
  <forward name="success"
    path="/iportal/activePortal/private/filesfolders    /filefolderlist.jsp" />
</action>
In the preceding example, the path for an error result uses the definition in the global forwards section of struts-config.xml as a default value:
<forward name="error"path="/iportal/activePortal/private/common/errors/errorpage.jsp"/>
If the JavaBean returns another result, such as viewroi, you can include a forward for that result, as shown in the following example:
<forward name="viewroi" path="/iportal/activePortal/viewer/viewframeset.jsp"redirect="true" />
To locate an existing page, navigate to that page and examine the URI in the address field of your browser. If the URI contains a JSP name, go to that file. If the URI contains an action path, search struts-config.xml for that action path without the .do extension, or look up the action path in Actuate Java Component URIs.
To add a new web page to Java Component, you change the navigation in struts-config.xml so that all navigation for your web application remains in a single location. You can change an existing input page or forward page specification in an action path to your new page, or you can create a new action path that forwards to your page. If you create a new action path, you can change another action path to forward to your new path or you can modify or create links on web pages to specify your new action path. The following action path always navigates to welcome.jsp when another action path, link, or URL invokes it:
<!-- Process welcome -->
<action path="/welcome"
  forward="/iportal/activePortal/private/welcome.jsp"
  name="welcome">
</action>\
For more information on action paths and Jakarta Struts, access the following URL:
http://jakarta.apache.org/struts

Additional Links:

Copyright Actuate Corporation 2012