Configuring home page preferences

When you enter the home page URL (http:// hostName/arsys/home) and then log in to AR System , the Mid Tier  uses the following sequence to determine which home page form is displayed in the browser. On the web, the mid tier can be configured to have multiple preference servers. Suppose that the AR System User Preference form is configured to use the server1 server and the HelpDesk form as the home page form. 

1. The Mid Tier  checks the home page server that is defined on the Home Page tab of the AR System User Preference form.
   If you defined a home page server in user preferences, the Mid Tier  uses this setting to search for a home page form. For more information, see Specifying a server and home page in the AR System User Preference form.

   If you do not create an entry in the AR System User Preference form, the Mid Tier  creates a default record for you, but it does not populate the fields relevant to the home page settings. These are left blank by default.
2. If no user preference is defined, the Mid Tier  checks the home page server setting in the Configuration Tool.
   If there is no configuration setting, the Mid Tier  displays an error.
   In this example, the Mid Tier  found the server server1 in step 1. The Mid Tier  then checks for available home page forms.
   You define preference servers by clicking Home Page Settings in the Configuration Tool. For more information, see Specifying a server for the mid tier.
3. If the Mid Tier  locates a home page form defined in your user preferences, the browser displays it as your home page.
   In this example, the user preference was not the default Home Page form installed with AR System , but HelpDesk, an alternate home page form. The browser opens and display HelpDesk as the home page.

4. If you did not specify a home page in your user preferences, the Mid Tier  searches for a home page form on the server defined in step 1 and step 2.
   When a home page is found and opened, the Mid Tier  has compiled a list of entry points from all the servers listed in the AR Server Settings in the Configuration Tool and displays them in the home page's Application List field. If two applications have the same name, the Mid Tier  displays their server name as well, as shown in the following figure. 
   
   
   
   If such a form cannot be found, the Mid Tier  displays an error and no form is opened in the browser.

   The entry point labels that appear in the application list field are also determined by the form views. You must set the correct view label to expose, for example, a web view of the form's entry points. Otherwise, you might define an entry point that is not displayed properly in your web view. The system displays views based first on the view label and then the locale. For more information, see How form views are selected.
   For more information about configuring home page servers, see Home page preferences.

The following topics describe configuration settings for using a home page. This information is important to understanding which form is displayed as a home page.

• Specifying a home page on the server
• Specifying a server for the mid tier
• Specifying a server and home page in the AR System User Preference form