Initializing Multiple Business Area Instances in the Same Session
You can also invoke this API multiple times to allow a user to read data from multiple Business Area instances as long as the user views either real or dummy data across all Business Areas. The Real (BlindBreak) and Real (Unblinded) blinding access types are considered as reading real data while NA/Dummy is considered as reading dummy data.
If the user selects a blinding access type for a Business Area that is incompatible with the blinding access types selected for other Business Areas in the same session, the API errors out with the message, "There is a change in reading dummy data to blinded data or vice-versa. Please reset access to all Business Areas using resetBAAccess api and try again;" see Resetting a Generic Visualization Business Area.
The following settings and combinations of settings work:
- NA/Dummy blinding access type on all Business Areas: The user sees only dummy data in blinded Table instances.
- Real (Unblinded) blinding access type on all Business Areas: The user sees unblinded data in all Business Areas. This option is available only if all the Business Area's Table instances whose Blinding flag is set to Yes have a Blinding Status of Unblinded.
- Real (Blind Break) blinding access type on all Business Areas: The user sees currently blinded data in blinded Table instances in all Business Areas.
- Real (Unblinded) and Real (Blind Break) blinding access types: The user sees unblinded data in Business Areas where this option is available and currently blinded data in others.
Note:
The user must always have the appropriate blinding-related privileges. Without them the user can see only dummy data in Table instances whose Blinding flag is set to Yes. Table instances whose blinding flag is set to No contain data that was never blinded (NA for Not Applicable) and is always available.
Signature
PROCEDURE SETINITILIZEBA( PI_COMPANYID IN CDR_NAMINGS.COMPANY_ID%TYPE, PI_OBJID IN CDR_NAMINGS.OBJ_ID%TYPE, PI_OBJVER IN CDR_NAMING_VERSIONS.OBJ_VER%TYPE, PI_VCURRENCY IN VARCHAR2, PI_VBLINDINGACCESSTYPE IN VARCHAR2, X_RETURN_STATUS OUT NOCOPY VARCHAR2, X_MSG_COUNT OUT NOCOPY NUMBER, X_MSG_DATA OUT NOCOPY VARCHAR2
Parameters
This API has the following parameters:
PI_COMPANYID. Enter the Business Area instance's company ID.
PI_OBJID. Enter the Business Area instance's object ID.
PI_OBJVER. Enter the Business Area instance's object version.
PI_VCURRENCY. Enter the currency value. The allowed values are Current
or any snapshot label common to all Table instances mapped to the Business Area's Table Descriptors.
PI_VBLINDINGACCESSTYPE. Enter the blinding access type. The allowed values are: NA/Dummy
, Real(Unblinded)
, or Real(BlindBreak)
. Note that there is no space between Real
and the parentheses/brackets.
Parent topic: Initializing the Business Area Instance