The Find Member dialog is a BI Beans thin bean, for use in an HTML-client application. It allows users to select a page dimension member whose associated data should be displayed in a thin Dataview
. It works in conjunction with the paging control of the thin Dataview
.
The paging control of a thin presentation bean displays 25 dimension members. When the page dimension has more than 25 members, the paging control displays more..., to allow access to the full set of dimension members. When the user clicks more..., then the dimension members are listed in the Find Member dialog, which appears in a separate browser window. Users can search and navigate the list of dimension members in this dialog.
The ThinBeanUI
implementation of the Find Member dialog is the
oracle.dss.thin.beans.dataView.FindMember
class. The UINode
for the Find Member dialog is oracle.dss.thin.beans.dataView.FindMemberBean
.
To render the Find Member dialog, your servlet must associate
the FindMember
object with the FindMemberBean
object.
The JSP tag for this dialog is the FindMember
tag. In the UIX Language, the definition element is the findMemberDef element,
and the UINode
is the findMember element.
The FindMember
object should be stored in the HTTP session.
Whenever you enable the paging control in a thin presentation bean, you must set an event target on the thin presentation bean to direct the INIT_FIND_MEMBER_EVENT
to an instance of the FindMember
object.
If you do not direct the event to a FindMember
object, then the paging control does not display the more... entry, and your user will never have access to dimension members after the first 25.
You also need to set an event target on the FindMember
object, to direct the Page event back to the thin presentation bean that will handle the event.
You do not need to establish OK and Cancel navigation with the Find Member dialog as you do with other thin dialogs. The Find Member dialog creates Select and Cancel buttons and handles the events that they generate.
In the BI Beans servlet samples, "Sample 2: Displaying Linked Crosstab and Graph" includes a Find Member dialog.
The FindMember
dialog generates the following events, which are defined in the oracle.dss.thin.BIConstants
interface:
PAGE_EVENT
-- This event is generated when a user clicks
Select. It is handled by the view that you set
on FindMember
by calling its setView
method. You
do not need to set an event target. This event has a BI_PREFIX
parameter, which identifies the page of data to display.
SEARCH_EVENT
-- This event is generated when a user clicks
the Go button to search for a dimension member.
The FindMember
object handles this event. This event has the
SEARCH_STRING
parameter, which identifies search criteria.
GOTO_ROW_EVENT
-- This event is generated when a user clicks a particular member. The FindMember
object handles this event. This event has the VALUE
parameter, which identifies the member to highlight.
The FindMember
object handles the following events:
INIT_FIND_MEMBER_EVENT
-- The FindMember
object handles this event by passing an InitEvent
to any ThinBeanDialogListener
objects that you register with it.
SEARCH_EVENT
-- The FindMember
object handles this event.
GOTO_ROW_EVENT
-- The FindMember
object handles this event.
Initialize the Find Member dialog as you would initialize any thin bean dialog. In your initialization code, set the view whose page items will be displayed in the Find Member dialog, by calling FindMember.setView
.