Namespace -- http://xmlns.oracle.com/bibeans
Group -- BI uiXML elements
Type of element -- Definition
Insert the biSessionCallback element in any page where you want to define a
method that will modify one or more attributes of the BISession
object before the BISession
is initialized.
No attributes. This element must contain either an instance element or a method element that you insert using code insight.
The biSessionCallback is a child of the biThinSession element and must be defined within the biThinSession.
You can use the biSessionCallback element to set the BIUser
property
of the BI configuration file dynamically. The following situations are examples
of when you might want to set this property before the BISession
object is initialized:
Supporting a login page -- By default, a BI UIX application
applies the BIUser
property to the BISession
object
after the BISession
object is initialized, but before the property
value is needed to connect to the BI Beans Catalog. To support a login page,
you need to specify the BIUser
property before the
BISession
object starts.
Changing the user for a Catalog load operation -- The
correct authorized user is required in the BIUser
property
of the BISession object in order to load an object from the BI Beans Catalog.
If you need to specify a different user for a load operation, then you must
modify the BIUser
property of the BI Beans Configuration file
before the application attempts to load a presentation from the
Catalog.
The following XML fragment shows a sample definition of a biSessionCallback
that contains an instance element. The instance element returns an instance
of a class that modifies the BIUser
property of the BISession
object before a presentation is loaded from the BI Beans Catalog.
<!-- Sample biSessionCallback that uses an instance element --> <biSessionCallback> <instance class = "myPackage.Class1", method = "getHandler"/> </biSessionCallback>
The Help topic for the instance
element shows sample code for classes that change the BIUser
property of the BISession
object.