Revision history:

Introduced in QPR 7.2.1

 

Creates a new element by copying element identified by the SourceId parameter. ScorecardId and ParentId parameters are used to locate the copy to some exact position.

 

Synopsis:

 

SCModel.CreateCopy(SourceID, ScorecardId, ParentID, 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

Id: Integer. ID of new object is returned in this parameter

 

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.CreateCopy(iMeaId, ScorecardId, 0, Id)