QPR Knowledge Base 2017.1

CreateScorecard

CreateScorecard

Previous topic Next topic No directory for this topic  

CreateScorecard

Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

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)