Endeca RAD Toolkit NavigationDataSource and GuidedNavigation controls
The Endeca’s Rapid Application Development (RAD) Toolkit for ASP.NET provides a set of Web server controls for querying and displaying data from Endeca. This Blog Focusses on NavigationDataSource and GuidedNavigation controls of the Endeca RAD Toolkit.
In order to use the Endeca RAD controls from ASP.Net project references to Endeca.Web.dll and Endeca.Web.UI.WebControls.dll has to be added.
NavigationDataSource control provides navigation query information, including dimension refinements, record results, aggregated record results and Guided Navigation displays dimension groups, dimensions, and dimension value names on a Web page.
Once a NavigationDataSource control is added to an asp.net page, a markup resembling the below would be created
| MdexCertificatePath='<%$ EndecaConfig:Servers.Servers["Melbourne "].CertificatePath %>' MdexHostName='<%$ EndecaConfig:Servers.Servers["Melbourne"].HostName %>' MdexPort='<%$ EndecaConfig:Servers.Servers["Melbourne "].Port %>'> Where Melbourne is the Name of the Machine. |
After setting the properties of a NavigationDataSource Control, GuidedNavigation Control has to be added to the .aspx Page for displaying navigation. The Markup generated on the Source Page for GuidedNavigation will look like below HTML. | DataSourceID="NavigationDataSource1" ShowRefinements="True"> | The DataSourceID of Endeca RAD GuidedNavigation should be set to NavigationDataSource’s ID. Also there is an option called Preview Endeca Data for NavigationDataSource. If the Option is checked, it displays the Endeca Dimension and Dimension Value Names in design mode. Guided Navigation control properties DataMember - DataMember Value is set to DimensionStatesResult and is not Available for Modification. UrlManagerID - UrlManagerID is Optional. Name of the UrlManager that builds URLs for the control is specified. ExcludedDimensionIds - This property usage is Optional. RAD Excludes the dimension values specified by ID and displays all other dimension values. Both ExcludedDimensionids and IncludedDimensionids should not be used at the same time. IncludedDimensionIds - This property usage is Optional. Displays only the dimension values specified by ID and no other dimension values. Both ExcludedDimensionids and IncludedDimensionids should not be used at the same time. ShowRefinements - Property is Optional. Specifies whether any dimension values display in the control. If the Control should not display any dimension values ,Set ShowRefinements to false.Default Value is True. ShowSelectedDimensionValues - Optional Property. Specifies whether Selected dimension Value is displayed in the Control. If True is Chosen, Selected Dimension Values are displayed with a [X] next to the value and closes the parent dimension. Click on [X] removes the Dimension value from the Query. |