Retrieving TP values for Label Content object

Retrieving parameter (TP) values for the Label Content object is different than for other objects. For objects other than Label Content, the field names are determined by examining the values in the FsValidationField table.

For the Label Content object, the field names change dynamically based upon the source object. In addition, the list of Analysis Row Tags can be customized by the user. Consequently, there are no rows in the FsValidationField table.

These examples describe the ObjProperty() calls that retrieve parameter information when the object that the script is running against is a Label Content object. The label content is associated with four other objects types: Formula, Item, Specification and Analysis.

The syntax for the ObjProperty() function varies depending on the type of object that is associated with the label content. The syntax is the same for Formula and Item objects that are associated with the label content.

These examples provide the syntax to use with the ObjProperty() function to retrieve the value for a specific technical parameter. In the case of Specification and Analysis, the function retrieves one of multiple parameter values.

  • Item or Formula

    Formula and Item objects can only have one value for a technical parameter. Suppose the script has to access the value for the parameter “CALCIUM” and the target object is an Item or Formula. Then the code to ObjProperty is shown here.

    • Dim tpVal As Object = ObjProperty(“PVALUE.TP”, “”, “”, “CALCIUM”,
      “PARAM_CODE”)
  • Specification

    The Specification object supports three parameter values. These are the Min, Target, and Max value. The call to the ObjProperty to retrieve the target value for the CALCIUM technical parameter is:

    • Dim tpTargetVal As Object = ObjProperty("PVALUE_TARGET.TP", "", "",
      "CALCIUM", "PARAM_CODE")
  • Analysis

    For the Analysis object, the call to ObjProperty to retrieve the Proposed value for the CALCIUM parameter is:

    • Dim tpProposedVal as Object = ObjProperty("PVALUE_PROPOSED.TP", "",
      "", "CALCIUM", "PARAM_CODE")

Suppose you request a TP Value Type that is invalid for the given Label Content object. For example, you request the MIN value for a Label Content object whose source is an Item. Or, you request a RowTag that is not included in the LABELCONTENT.ROWTAGS profile attribute. Then, a validation error code of -5008 is returned.

Examples of Label Content arrays

ObjProperty() can be used to retrieve a set (i.e., an array of values) from the label content’s target object. Retrieving all the parameter values is not useful if the script cannot determine the parameter code that is associated with the parameter value.

To retrieve the set of parameter codes and corresponding parameter values requires calling ObjProperty twice. First to get the set of parameter codes. Second to get the set of parameter values.

Object Array Example
Item or Formula Dim pCodes() As Object = ObjProperty("PARAMCODE.TP","","","*")

Dim pVals() As Object = ObjProperty("PVALUE.TP","","","*")

Specification Dim pCodes() As Object = ObjProperty("PARAMCODE.TP","","","*")

Dim pVals() As Object = ObjProperty("PVALUE_TARGET.TP","","", "*")

Analysis Dim pCodes() As Object = ObjProperty("PARAMCODE.TP","","","*")

Dim pVals() As Object = ObjProperty("PVALUE_PROPOSED.TP","", "", "*")

  • The array variable pCodes() contains the set of parameter codes. The first parameter that is passed to ObjProperty is “PARAMCODE.TP”. The last parameter is “*” indicating the request to return all parameter codes instead of a specific code.
  • The array variable pVals() contains the set of parameter values. The “*” value indicates that the request is to return all of the parameter values.
  • pCodes() and pVals() are arrays. They hold multiple values. The parameter code pCodes(1) value is stored in pVals(1) when 1 is used to indicate which value out of the array to access.