Explorer Tree Bean

Important: In the current release of BI Beans, the Explorer Detail bean provides full browse and search capability for the BI Beans Catalog. Consider using the Explorer Detail bean rather than the Explorer Tree bean especially for viewing folders that may contain a large number of items.

The Explorer Tree bean is a BI Beans thin bean, for use in an HTML-client application. It allows users to browse a tree. The Explorer Tree bean is useful in an HTML frame only if the display of the tree does not include a large number of items.

If you use the Explorer Tree to display folders in the BI Beans Catalog, then use the Explorer Detail Bean to display objects in the selected folder. You can also connect the Explorer Tree bean to the Explorer Search bean and to the Save As dialog.

The ThinBeanUI implementation of the Explorer Tree bean is the oracle.dss.thin.beans.persistence.ExplorerTree class. The UINode for the Explorer Tree bean is oracle.dss.thin.beans.persistence.ExplorerTreeBean. Your servlet must associate the ExplorerTree object with the ExplorerTreeBean object.

The JSP tag for this bean is the ExplorerTree tag. In the UIX Language, the definition element is the explorerTreeDef element, and the UINode is the explorerTree element.

You should store the ExplorerTree in the HTTP session.

The Explorer Tree bean keeps track of the selected path and the object type.

Using the Explorer Tree

After you instantiate the ExplorerTree, you must call its setBIContext method to specify the root folder for the tree. If your HTML-client application uses OLAP data, then set an MDFolder as the BIContext. If your application does not use OLAP data, then set a PersistenceManager as the BIContext. The BIContext that you set should also be stored in the browser session.

You can customize the Explorer Tree by setting its properties. For example, you can specify whether to show the search area and whether users can select folders.

You can use the Save As dialog with the Explorer Tree by calling the setSaveAs method of the ExplorerTree.

You should also instantiate any other Explorer beans that you plan to use with the Explorer Tree and establish communication between all of the Explorer beans.

To establish communication between the Explorer Tree and the Explorer Detail bean, call the setExplorerDetail method of the ExplorerTree.

Connecting the Explorer Tree with the Explorer Search

To establish communication between the Explorer Tree and the Explorer Search, you need to listen for the BIConstants.SEARCH_EVENT and to display the Explorer Search page in response.

There are two ways to listen for the SEARCH_EVENT:

Events that this bean generates

The ExplorerTree generates the following events, which are defined in the oracle.dss.thin.BIConstants interface.

Events that this bean handles

The ExplorerTree handles the following events: