How do I customize the root, or top level item in an ItemsGrid or Path control?

The ItemsGrid and Path controls provide listing and navigation interfaces for the items contained in an EnterpriseItems bean, such as a series of folders or categories that lead to reports and documents. There are several pre-defined values for the root, or top level node of the ItemsGrid and Path control that users can navigate to. For example, you may want your application to display the user's personal root folder after they log on, and prevent them from navigating above this top level item. Or, you may want your application to limit the user to navigate only personal categories rather than folders or other categories.

To customize the top level item

1. Set the DefaultRoot property of the ItemsGrid or Path control to None.
2. Set the EnableDefaultParent property of the EnterpriseItems bean data bound to the control to CorporateCategory, PersonalCategory, RootFolder, UserRootCategory, or UserRootFolder.
3. Ensure that the ItemTypes property of the EnterpriseItems bean is set to return the desired type.

For example, if you set the EnableDefaultParent property to CorporateCategory, you must at least select Corporate Category from the list of types available from the ItemTypes property. Or, if the EnableDefaultParent property is set to one of the pre-defined folders such as UserRootFolder, then you should set the ItemTypes property to Folder and Favorites Folder.

If you want to set a custom top level item rather than use a pre-defined value, set the DefaultRoot property of the ItemsGrid or Path control to Custom, and specify the RootItemID property.

Tip:    If you want to set the folder that is displayed initially, but you do not need to restrict the items that the user can navigate to, then you just need to set the parentItemId property of the EnterpriseItems bean.