Please enable JavaScript to view this site.

QPR Knowledge Base 2023.1

  •      
  • Navigation: Developer's Guide > QPR API > The Object Model > QPR Metrics > SCModel Commands

    GetObjectIdByName

    Scroll Prev Top Next More

    Revision history:

    Introduced in QPR 7.4.1 SP1

     

    Returns an object ID corresponding to the object name supplied in the function call.

     

    Synopsis:

     

    SCModel.GetObjectIdByName(ObjectTypeName, ObjectName, out ObjectId)

     

    Parameters:

     

    ObjectTypeName: String, case sensitive. The following object types are supported:

    ELEMENT

    SCORECARD

    INFORMATIONITEM

    PERIOD

    PERIODLEVEL

    RANGE

    SERIES

    VALUESETTING

    INTEGRATION

    UNIT

    CHARTTEMPLATE

    PERIODACCUMULATION When using this, the ObjectName parameter must be one of the Periodic Accumulation options (as listed in the Periodic Accumulation drop-down box in the Element Properties window) in the user's current QPR Metrics client user interface language.

    ObjectName: String, case insensitive. Name of the desired object of type defined in the ObjectTypeName parameter. For example, if ObjectTypeName is "PERIOD", ObjectName can be e.g. "Q2".

    out ObjectId: Integer. Variant for storing the returned object ID.

     

    Required Rights:

     

    None.

     

    Return Values:

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

     

    RV_SUCCESS

    RV_OBJECT_NOT_FOUND

    RV_TYPE_NOT_FOUND

    RV_UNKNOWN_ERROR

     

    Example Procedure:

     

    iRet = oModel.GetObjectIdByName("PERIODACCUMULATION", "Average", iId)