SA XT for web access > System Architect XT > Customizing System Architect XT > Sample components in the configuration files > Navigation page
  
Navigation page
Within the Pages component you can add the <page name="navbar">…</page>, which presents as a Navigation Row above the main page content on the SAXT pages. The following code sample shows the structure of the <page name="navbar"> component and some of the sub-components within it.
<pages>
. . .
<page name="navbar" defaultlinks="home,bookmark,refresh,userlist,switchmode,about,switchworkspace">
<component type="NavLink" target="/SAXT/dashboard.aspx" label="Dashboard" hovertext="My Dashboard" name="Dashboard"/>
<component type="NavDropdown" label="Reporting" hovertext="All Reporting Utilities" name="Reporting">
<component type="NavDropdownSubMenu" label="Commercial Questions" hovertext="Commercial Questions">
<link target="pagegen.aspx?page=commercialquestions" label="Commercial Questions Page" hovertext="Commercial Questions Page"/>
<divider/>
<link target="/SAXT/ip/getpage.aspx?reportfile=Questions&amp;reportname=Infrastructure&amp;DDID=&amp;stylesheet=/stylesheets/lists.xsl" label="Infrastructure Table"/>
</component>
</component>
</page>
. . .
</pages>
Each element of the Navigation page has its own collection of available settings and properties:
Defaultlinks
Example:
<page name="navbar" defaultlinks="home,bookmark,refresh,userlist,switchmode,about,switchworkspace">
The main page element includes an optional property defaultlinks. This property controls which of the built-in links will be available on the Navigation bar, if any. Options include:
home – link to the SAXT homepage.
bookmark – link to the Manage My Bookmarks page, with the currently opened url prefilled to be added.
refresh – link to refresh the current page.
userlist – link to ‘Sessions’ page to view active user sessions.
switchmode – link to Switch to Reader/Updater for switching license and functionality from Read to Write.
about – link to SAXT About window.
switchworkspace – link to Switch Workspace dialog.
NavLink component
Example:
<component type="NavLink" target="/SAXT/dashboard.aspx" label="Dashboard" hovertext="My Dashboard" name="Dashboard"/>
The NavLink component type allows for adding a link to the Navigation bar, either to a SAXT page, or an outside source.
The following table lists NavLink component field names and their descriptions.
Field name
Required?
Description
target
Yes
Defines the url the link should open. Urls are structured differently if the link is an SAXT page (internal) or outside website (external). If Internal, you do not need the http://hostname portion, you can use "/SAXT/pagename.aspx". If External, use the full url including "http://www.website.com".
label
Yes
Defines the text to be displayed in the Navigation Bar.
hovertext
No
Text shown when user hovers mouse over the Navigation link.
newpage
No
(y/n) If y then the target page for each item is opened in a new window.
name
No
For internal links, enter a unique, one word name. This helps so that if the link is clicked and the new page opens, the navigation bar can recognize that it is the active link and will show in White text.
NavDropdown component
Example:
<component type="NavDropdown" label="Reporting" hovertext="All Reporting Utilities" name="Reporting">
...
</component>
The NavDropdown component type allows for adding a dropdown element to the Navigation bar. The NavDropdown itself does not contain a url link, but when clicked will open a menu containing other links.
The following table lists NavDropdown component field names and their descriptions.
Field name
Required?
Description
label
Yes
Defines the text to be displayed in the Navigation Bar.
hovertext
No
Text shown when user hovers mouse over the Navigation dropdown.
name
No
For internal links, enter a unique one-word name. This helps so that if the link is clicked and the new page opens, the navigation bar can recognize that it is the active link and will show in White text. This also is used for links clicked inside a Dropdown.
Within the NavDropdown component, you can include the following links and visual elements:
Link element
Example:
<link target="/SAXT/pagegen.aspx?page=commercialquestions" label="Commercial Questions Page" hovertext="Commercial Questions Page"/>
The Link element is used for adding a link inside a dropdown menu.
The following table lists Link element field names and their descriptions.
Field name
Required?
Description
target
Yes
Defines the url the link should open. Urls are structured differently if the link is an SAXT page (internal) or outside website (external). If Internal, you do not need the http://hostname portion, you can use "/SAXT/pagename.aspx". If External, use the full url including "http://www.website.com".
label
Yes
Defines the text to be displayed in the Navigation Bar.
hovertext
No
Text shown when user hovers mouse over the Navigation link.
newpage
No
(y/n) If y then the target page for each item is opened in a new window.
Divider element
Example:
<divider/>
The divider element is only a visual element, a line you can add to a dropdown to denote a separation between links.
NavDropdownSubMenu component
Example:
<component type="NavDropdownSubMenu" label="Commercial Questions" hovertext="Commercial Questions">
...
</component>
The NavDropdownSubMenu component type allows for adding a secondary dropdown menu off the main dropdown from the Navigation bar. The NavDropdownSubMenu itself does not contain a url link, but when clicked will open a menu to the right of the original dropdown containing other links.
The following table lists NavDropdownSubMenu component field names and their descriptions.
Field name
Required?
Description
label
Yes
Defines the text to be displayed in the Navigation Bar.
hovertext
No
Text shown when user hovers mouse over the Navigation dropdown.
The NavDropdownSubMenu can contain links and dividers the same way NavDropdown can, including additional NavDropdownSubMenu components for multiple levels.
See also
Sample components in the configuration files