Revision history:

Introduced in QPR 7.3.1

 

Extended version of CreateCopy. In addition to functionality provided by CreateCopy, CreateCopyEX supports copying hierarchies and copying elements as references.

 

Synopsis:

 

SCModel.CreateCopyEX(SourceID, ScorecardId, ParentID, WithHierarchy, AsReference, out Id)

 

Parameters:

 

SourceId: Integer. ID of object which is to be copied.

ScorecardId: Integer. ID of some existing object.

ParentId: Integer. If this is 0, then new element is created under the top element.

WithHierarchy: Integer. 0 = Copy only source element, 1=include sub-elements.

AsReference: Integer. 0 = Create normal Copy, 1 = Copy as reference element. NOTE! If AsReference = 1 and WithHierarchy = 1, then all elements are created as reference elements.

Id: Integer. ID of new object is returned in this parameter. NOTE! If WithHierarchy = 1, then a new root element ID is returned.

 

Required Rights:

 

Administrator or Model Administrator rights to the SCModel.

 

Return Values:

Below are listed the return values that this function can return:

 

RV_SUCCESS

RV_MODEL_NOT_OPEN

RV_NO_RIGHTS

RV_SCORECARD_NOT_FOUND

RV_PARENT_NOT_FOUND

RV_ELEMENT_NOT_FOUND

RV_INVALID_ELEMENT_TYPE

RV_CANNOT_COPY_TOPELEMENT

RV_CANNOT_COPY_REFERENCE

RV_UNKNOWN_ERROR

 

Example Procedure:

 

iRet = SCModel.CreateCopyEX(iMeaId, ScorecardId, 0, 0, 1, Id)