---
title: NavigationContext
summary: API reference for NavigationContext.
status: draft
owner: SAIF Documentation Team
last_reviewed: 2026-08-17
library: SAIF.Presentation.Web.Core.Infragistics103
reference_type: package
---

# NavigationContext

`NavigationContext` is the presentation-layer entry point into the BOF Menu subsystem: constructing it for a given user loads the set of menu items that user is authorized to see, and its lookup methods resolve the currently-executing page's menu/authorization identity. It opens an Oracle BOF data connection scoped to a fixed `MENU` DB user and delegates the actual authorization query logic to `SAIF.Business.Menu` collection classes, which are out of scope for this library.

## Purpose
- Load and cache a user's authorized menu items on construction, enforcing [BR-NC-001](../../business-rules.md#br-nc-001-menu-visibility-is-restricted-to-authorized-items).
- Resolve the current page's authorized menu item/page identity by application code, category, and link, preferring exact matches over fallback matches per [BR-NC-002](../../business-rules.md#br-nc-002-exact-match-is-preferred-over-fallback-match-for-menu-resolution).
- Cache application-code and menu-category lookups statically to avoid repeated data-layer round trips across requests.

## Context
- Namespace: `SAIF.Presentation.Web.Core`
- Assembly/package: `SAIF.Presentation.Web.Core.Infragistics103` (merged into `SAIF.BOF.Presentation.Web.Infragistics103` NuGet package)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| MenuAuthorizedItems | `Property MenuAuthorizedItems As clsMenuAuthorizedItemCollection` | Holds the set of menu items the constructed user is authorized to see; populated during construction. |
| ApplicationCodes | `ReadOnly Property ApplicationCodes As clsApplicationCodeCollection` | Returns the statically cached collection of active application codes, used to map a request's application path to an app code. |
| MenuCategories | `ReadOnly Property MenuCategories As clsMenuCategoryCodeCollection` | Returns the statically cached collection of menu category codes. |
| GetItemSeq | `Function GetItemSeq(inApplication As String, inCategory As String, inPageLink As String) As Decimal` | Returns the menu-item sequence number for the given application/category/link, or `0` if no match is found. |
| GetItem | `Function GetItem(inCategory As String, inLink As String, Optional inAnyApp As Boolean = False) As clsMenuAuthorizedItem` | Resolves the authorized menu item for the given category and link, optionally searching across all applications; returns `Nothing` if unresolved. |
| GetCurrentItem | `Function GetCurrentItem(inCategory As String) As clsMenuAuthorizedItem` | Resolves the authorized menu item for the current request's application/page, within the given category, preferring an exact match per [BR-NC-002](../../business-rules.md#br-nc-002-exact-match-is-preferred-over-fallback-match-for-menu-resolution). |
| IsMenuItem | `Function IsMenuItem(inApplication As String, inItem As String) As Boolean` | Returns whether the given application/item combination exists as a resolvable menu page. |
| GetCurrentPage | `Function GetCurrentPage() As clsMenuAuthorizedItem` | Resolves the authorized menu item matching the current request's application and page link, preferring an exact match. |
| New() | `Protected Friend Sub New()` | Parameterless constructor available only within the assembly/derived types; leaves `MenuAuthorizedItems` unpopulated. |
| New(inUser) | `Public Sub New(inUser As String)` | Constructs the data layer connection, retrieves the portal info, and loads the authorized menu items for `inUser`, enforcing [BR-NC-001](../../business-rules.md#br-nc-001-menu-visibility-is-restricted-to-authorized-items). |

## Behavioral notes
- The public constructor hardcodes the Oracle BOF data-layer connection to a fixed `MENU` DB user account, reading `MENU_ENVIRONMENT` from `ConfigurationManager.AppSettings`.
- No branch/error handling is visible in the constructor; failures surface as unhandled exceptions from the data layer or `SAIF.Business.Menu` collection calls.
- `ApplicationCodes` and `MenuCategories` are cached via `Static` local variables in private shared helper functions, so the first successful lookup persists for the process lifetime*.

## Constraints and usage notes
- Requires a `MENU_ENVIRONMENT` application setting to be present in the consuming application's own configuration file; this project has no `web.config`/`app.config` of its own.
- `GetItem`/`GetCurrentItem`/`GetCurrentPage` all depend on `HttpContext.Current.Request` being available, so they are only usable within an active web request context.

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- SAIF.Presentation.Web.Core.Infragistics103\NavigationContext.vb