recentnavigation

MDO list provider for the Recent navigation history of the current associate - the ranked list of recently visited entities written by the ViewState agent’s UpsertRecentNavigation operation. Items are returned most-recent first (descending navigation_history.rank). Keys of the form <table>|<pkfield>=<id> (e.g. person|person_id=123) are resolved to display names for known tables (currently contact, person, dashboard, email_flow, selection, project, sale, ticket and the virtual mailitem); anything else falls back to the raw key as name. An entry of a known table that resolves to nothing — the record was deleted, or the associate’s rights changed and the sentry-filtered lookup no longer sees it — is left OUT of the list - it can no longer be opened, so it must not linger as a raw key. (The stored row stays; it ages out.) A key of a table with no resolver here is still returned raw, but the CRM client drops any entity key it receives still labelled with its own key — so a newly recorded entity table needs a resolver in one of the two layers or its entries never reach the user. That drop rule makes the return-field order load-bearing - row-level access filtering happens on the FIRST return field’s table (SoDataReader checks RF on it), so every fetcher below puts the entity’s own primary key first. Reordering ReturnFields would move the sentry onto a joined table and silently change which entries survive, not just how they are labelled. The name follows the functional spec’s entry format (§4.1-4.9) - the record’s own name followed by its context in parentheses — “Rema 1000 (Purchasing)”, “John Smith (Rema 1000)”. A record whose icon carries information of its own (the company’s country flag §4.2, the sale’s Sold/Lost/Stalled marker §4.4) also returns an that replaces the generic entity icon.

“recentnavigation” MDO List

MDO list provider for the Recent navigation history of the current associate: the ranked list of recently visited entities written by the ViewState agent’s UpsertRecentNavigation operation. Items are returned most-recent first (descending navigation_history.rank). Keys of the form <table>|<pkfield>=<id> (e.g. person|person_id=123) are resolved to display names for known tables (currently contact, person, dashboard, email_flow, selection, project, sale, ticket and the virtual mailitem); anything else falls back to the raw key as name. An entry of a known table that resolves to nothing — the record was deleted, or the associate’s rights changed and the sentry-filtered lookup no longer sees it — is left OUT of the list: it can no longer be opened, so it must not linger as a raw key. (The stored row stays; it ages out.) A key of a table with no resolver here is still returned raw, but the CRM client drops any entity key it receives still labelled with its own key — so a newly recorded entity table needs a resolver in one of the two layers or its entries never reach the user. That drop rule makes the return-field order load-bearing: row-level access filtering happens on the FIRST return field’s table (SoDataReader checks RF on it), so every fetcher below puts the entity’s own primary key first. Reordering ReturnFields would move the sentry onto a joined table and silently change which entries survive, not just how they are labelled. The name follows the functional spec’s entry format (§4.1-4.9): the record’s own name followed by its context in parentheses — “Rema 1000 (Purchasing)”, “John Smith (Rema 1000)”. A record whose icon carries information of its own (the company’s country flag §4.2, the sale’s Sold/Lost/Stalled marker §4.4) also returns an that replaces the generic entity icon. Implemented by the RecentNavigationListProvider class. The name of the MDO list is ‘recentnavigation’.

Additional Attributes

Description	Name	Example Value
Client whose recent navigation to fetch	client	Crm

Sample Request

GET /api/v1/MDOList/recentnavigation
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: *

Sample Code

var listProvider = ClassFactory.CreateRequired<SuperOffice.CRM.Lists.ISoListProviderFactory>().Create("recentnavigation", forceFlatList: true);
foreach (var item in listProvider.RootItems) {
    Console.WriteLine("{0} {1} {2} {3}", 
         item.Id, ResourceManager.ParseInlineResources(item.Name), item.StyleHint, item.ExtraInfo);
}

Sample Output

Id	Name	StyleHint	ExtraInfo
2	Example

“recentnavigationheadings”
“recentnavigationheadingswithallitem”
“recentnavigationheadingswithallitemwithnoselection”
“recentnavigationheadingswithnoselection”
“recentnavigationwithallitem”
“recentnavigationwithallitemwithnoselection”
“recentnavigationwithnoselection”