Resetting a Generic Visualization Business Area

Use public API CDR_PUB_API_GVA.RESETBAACCESS to clear all the initializations of Business Area schemas.

It is equivalent to logging out and logging back in to the system.

This API has no parameters.

Users cannot select incompatible blinding access types for different Business Areas in the same session. If they do, the initialization API errors out with a message to call this API.

You may want to trap the Initialization API's error message and, if possible, display a dialog box warning the user that the blinding access type is incompatible with open Business Areas (or the visualization tool's equivalent) and give the user the following options:

  • Continue with the current setting, which will result in closing all other Business Areas. If the user selects this option, run the Reset API and then the Initialization API with the requested setting for the current Business Area.
  • Change the setting for the current Business Area to be compatible with those already open. If the user selects this option, run the Initialization API with the appropriate setting.

Alternatively, display the Initialization API's error message and provide a way in the UI to invoke the Reset API to close all open Business Areas. Or trap the Initialization API's error message, invoke the Reset API to close all open Business Areas, and display a message. In either case, the user can then select a Business Area and blinding access type as required.