Defining Home Pages with a Text Editor

Creating Home Pages: Troubleshooting

Can't sign in

If you have assigned an Archibus user to have Home Pages as their Navigation method, but then find that the user gets an error on signing in (an error concerning finding a navigator .axvw file), make certain you have published the home pages for their role. If the home page is not present, Archibus cannot load it when signing in. See Publish Home Pages .

You publish home pages to users with this view:

Path: System / Add-In Manager / Publish Home Pages by Role

URL: http://localhost:8080/archibus/ab-publish-navigation-pages.axvw

Missing changes

If you change a page descriptor, but then don't see your changes when signing in and loading the change, again make certain you have published the home pages for that user's role.

If you are making a series of changes and testing them, you may wish to sign in as one user (e.g. "AI") and leave the " Publish Home Pages by Role" open, and then in another browser session sign in as another user (e.g. "AIDEMO") and reload the changes after each publishing action.

Note that you do not have to sign in with the second user (e.g. "AIDEMO") on every change. You can just refresh the second user's browser to see the newly published home pages. The refresh will also update dynamic results, such as charts.

Blank process panels

page_nav_mt_bucket_510x180.png

If you have a blank process panel, double check that:

  • The application ( activity_id ) and process ( process_id ) in the descriptor exist in the Archibus Processes ( afm_processes ) table.
  • The Archibus Process is set correctly:
    • a value of "Process Navigator" means the process should appear on the Navigator and in home page panels
    • a value of "Web Page Navigator Process" means that the process should not appear on the Navigator and should appear only in the home page panels.
  • The process has Archibus Process Tasks assigned to it and these tasks are of Task Type Label and/or Web URL .
  • The application and process are assigned to the current user's role (in the Archibus Role-Process Assignments or afm_roleprocs table). For security reasons, home pages will not show processes that are not assigned to the current user.

  • Your site has a license for the Archibus application from which the process comes. While the Archibus sample data assigns home pages to a nominal application (e.g. AbDashboardPageNavigation ), the actual processes won't load without an application or domain license for that process and its views.

Reserved character error

Suppose when publishing you see an error of the form, "The entity name must immediately follow the '&' in the entity reference." In this case, you have an HTML reserved character (e.g. &, <, >, ", ') in one of your strings:

title="Environment & Risk Process"

In this case, use the HTML entity name form for the character:

title="Environment &amp; Risk Process"