Home Page Configuration

The following pre-requisites are required before a user can create a new home page in Advantage and associate the home page with a business role.

  • The user has access to the Publish and Home Page Configuration pages.

  • All QuickLinks and widgets required for creating the home page are defined on the QuickLink Library and Widget Library pages, respectively.

  • A Business Role should exist in the system associated with the new home page. If you need to associate the home page with a new business role, then refer to the ”Business Role” topic for creating a new Business Role.

The following steps should be followed to create a home page, associate the home page with a business role and publish the home page.

Step 1: Create a Home Page

Refer to the following steps for creating a home page.

  1. Navigate to the Home Page Configuration (HOMEPG) page.

  2. Select the Create button to create a new home page.

  3. On the General Information tab, populate all required fields. (Note: The Associate Business Roles field will be blank at this time.)

  4. The workspace layout will be an 8 column layout for Web and 2 column layout for Mobile.

  5. On the Workspace tab, Widgets and QuickLinks are available to add to a home page layout. Here, the contents are filtered based on the Mobile setting. On a mobile home page, only widgets and QuickLinks with Mobile as Yes are displayed. On all other home pages, only widgets and QuickLinks with Mobile as No are displayed.

  6. On the Workspace tab, the Filter field can be used to filter Widgets and QuickLinks. A minimum of three characters are required to activate the filter. When the user shifts between the Widget and QuickLink tabs, the filter criteria and filtered results will be retained.

  7. On the Workspace tab, select Widgets from the Widgets tab in the left panel and then select the Add button to add the Widgets to the Workspace area in the right panel. You can also drag and drop Widgets from the Widgets tab to the Workspace area.

  8. On the Workspace tab, select QuickLinks from the QuickLinks tab in the left panel and then select the Add button to add the QuickLink to the Workspace area in the right panel. You can also drag and drop QuickLinks from the QuickLinks tab to the Workspace area.

  9. On the Workspace tab, in the Workspace area you can move the QuickLinks and Widgets around to the desired location.

  10. To enhance the user experience, all Widget and QuickLink groups are initially collapsed. A group expands if it contains filtered results or if the user manually expands it. This streamlines the navigation and optimizes screen space.

On a non-mobile home page: You can add up to 8 QuickLinks horizontally. The width of the Widgets will determine how many widgets you can add horizontally. Vertically, the Workspace area does not have any restrictions. (Note: The height and width of the widgets can be adjusted on the Widget Library page.) You can add the Blank QuickLink to your Workspace to add spacing between the widgets and QuickLinks. This QuickLink can be used on your Workspace as many times as necessary. Users will not see the QuickLink when they view the home page; instead, they will only see a blank space equal to the size of the QuickLink.

On the mobile home page: You can add up to 2 QuickLinks horizontally. The width of the Widgets will determine how many widgets you can add horizontally. Vertically, the Workspace area does not have any restrictions. (Note: The height and width of the widgets can be adjusted on the Widget Library page).

If Widgets and QuickLinks are not added on the Workspace tab, then users will see a blank mobile home page.

Default Mobile Home Page has baseline pre-delivered example widgets and quick links. If default mobile home page is modified by sites, pre-delivered widget and quick link content may not show up on the application and hence modifying the default mobile home page is not recommended.

  1. You can remove Widgets and QuickLinks from the Workspace area by selecting the X on the top right corner of the Widget or QuickLink.

  2. Once you have added all required QuickLinks and Widgets in the Workspace area, then you can select the Save & Close button to save and close out of the record.

  3. Refer to “Step 2: Associate a Home Page with a Business Role” for associating a home page with a Business Role.

Step 2: Associate a Home Page with a Business Role

Refer to the following steps for associating a home page with a Business Role.

  1. Navigate to the Business Role (BUSROLE) page.

  2. Search for the Business Role that should be linked to the home page you created in “Step 1: Create a Home Page”.

  3. Select Edit from the row-level menu for the selected Business Role.

  4. Select the home page from the Home Page ID pick list.

  5. Select the Save & Close button to save and close out of the record.

  6. Refer to “Step 3: Publish Business Role and Home Page” for publishing the changes made to the business role, including the associated home page.

Step 3: Publish Business Role and Home Page

Refer to the following steps for publishing the changes made to the Business Role and the new home page. Note: This step assumes that the ENABLE_HOMEPAGE_UPDATES parameter on ERPCTRL is set to true. If the ENABLE_HOMEPAGE_UPDATES parameter is set to false, then the System Administrator must run the postcd process, which is a combination of multiple processes (or jobs, which includes MenuGenerator job, commonpaldb job, and prodpaldb job), followed by a bounce of the application, to publish the changes. Note: whenever the ENABLE_HOMEPAGE_UPDATES parameter value in ERP Application Parameters (ERPCTRL) changes, a logout and login is required for the changes to take effect.

  1. Navigate to the Publish (PUBLISH) page.

  2. Select the Publish button to publish all the changes made for the Business Role including the associated home page.

  3. The following message “Publishing pending Business Roles. Notification will be sent once it is complete” will be displayed. You will receive an Alert once the Publish action has successfully completed, if Alerts are configured for the system.

  4. Log out and then log in with the User ID that is mapped to the Business Role selected during “Step 2: Associate a Home Page with a Business Role”. If the User ID is mapped to more than one Business Role, then you can select the desired Business Role from the User Profile (in the far right corner of the Global Navigation bar) to view the Home Page.