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.