- Description
- is a service for user interaction for databases.
interaction requests that the handler can provide are:
- database related errors
The general structure to transport such errors is the
::com::sun::star::sdbc::SQLException
, and if your
::com::sun::star::task::XInteractionRequest
supplies such a
::com::sun::star::sdbc::SQLException
(or an instance of any derived class),
the handler will display a generic error dialog, which is able
to travel the object chain which may be contained in the exception.
- authentication
If your
::com::sun::star::task::XInteractionRequest
(see
::com::sun::star::task::XInteractionHandler::handle()
) supplies a
::com::sun::star::ucb::AuthenticationRequest
, the handler will open a standard login
dialog to allow user authentication.
Besides the using the members of the AuthenticationRequest in the usual manner, the member Server
(if not empty) is interpreted as datasource name, thus leading to a slightly different message when
requesting the user to enter it's login data.
In the case you want to use this authentication feature, you should supply a special authentication
continuation (
::com::sun::star::ucb::XInteractionSupplyAuthentication
) as well, so the
handler can return to you, the entered information.
- parameter requests
If your
::com::sun::star::task::XInteractionRequest
supplies an
ParametersRequest
, the handler will open a standard dialog asking
the user to fill in parameter values.
In the case you want to use this feature of the handler, you should supply a special continuation
(
XInteractionSupplyParameters
) as well, so the
handler can return to you, the entered information.
|