Update an Object's Validation Status

Use this API to update an object's validation status. The API performs a cascade validation on this object and its related objects.

If this object is an instance, the API also validates its source definition. If this object contains other objects with a validation status, the API updates the validation status of all of them; and if they are instances, their source definitions.

The operation fails if any of the underlying definitions are checked out. If you are validating a Report Set, the operation also fails if any of the Program instances in the Report Set have a validation status lower than the one to which the Report Set is being upgraded.

Name

CDR_PUB_VL_VALIDATION.UpdateValStatus

Signature

PROCEDURE UPDATEVALSTATUS( 
  P_API_VERSION  IN    NUMBER, 
  P_INIT_MSG_LIST  IN    VARCHAR2 := CDR_PUB_DEF_CONSTANTS.G_FALSE, 
  P_COMMIT  IN    VARCHAR2 := CDR_PUB_DEF_CONSTANTS.G_FALSE, 
  P_VALIDATION_LEVEL  IN    NUMBER := CDR_PUB_DEF_CONSTANTS.G_VALID_LEVEL_FULL, 
  X_RETURN_STATUS  OUT    VARCHAR2, 
  X_MSG_COUNT  OUT    NUMBER, 
  X_MSG_DATA  OUT    VARCHAR2, 
  PI_VALOBJ  IN    CDR_VAL_STATUS_OBJ_TYPE, 
  PO_CASCADEDOBJCOLL  OUT    CDR_BASE_OBJ_COLL, 
  PO_ERRORNAMINGCOLL  OUT    CDR_BASE_OBJ_COLL 
); 

Parameters

This API has standard parameters (see Standard Parameters) and the following parameters:

  • PI_VALOBJ (Mandatory) This is a parameter of table type CDR_VAL_STATUS_OBJ_TYPE. Enter values to identify the object whose validation status you want to update.

    The following attributes are required: COMPANY_ID,OBJ_ID,OBJ_VER,OBJ_TYPE_RC,VALIDATION_STATUS_RC,OBJECT_VERSION_NUMBER.

  • PO_CASCADEDOBJCOLL This output parameter is a collection of all the objects whose validation status was updated due to cascading. If this parameter contains a value, the validation update operation succeeded.
  • PO_ERRORNAMINGCOLL This output parameter is a collection of objects whose validation status could not be updated. If this parameter contains a value, the validation update operation failed.