Revision history:
Introduced in QPR 7.2.1
Last changed in QPR 2012
Creates a new scorecard of given name and identifier. If ParentId is given, sets the scorecard referred by ParentID as a parent scorecard for the new scorecard. Returns Id of a new scorecard in Id parameter. System generates identifier for the created scorecard if Identifier parameter is empty. Top element is also created automatically.
Synopsis:
SCModel.CreateScorecard(Name, Identifier, ParentId, out Id)
Parameters:
Name: String
Identifier: String, can be left empty
ParentId: Integer. 0 if created to top level, some existing scId otherwise
Id: Integer. Id of the created scorecard
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_MODEL_IS_LOCKED
RV_CANNOT_SET_PARENT_SCORECARD
RV_INVALID_NAME
RV_IDENTIFIER_IS_RESERVED
RV_INVALID_IDENTIFIER
RV_UNKNOWN_ERROR
Example Procedure:
iRet = SCModel.CreateScorecard("New SC", "", 0, id)
