Integer control in DX API

The Integer control (pxInteger) helps users enter whole numbers (integers) in their forms. Learn about the JSON structure and elements of a sample Integer control, to understand how you can integrate it into your custom application.

The following JSON code is a sample API response for the Integer control:

  "validationMessages": "",
  "visible": true,
  "labelReserveSpace": true,
  "readOnly": false,
  "control": {
    "modes": [
        "displayWithReadOnlyFormat": "true",
        "modeType": "editable",
        "controlFormat": "Standard",
        "textAlign": "Right",
        "tooltip": "Valid year can't be greater than 2020",
        "maxChars": "4",
        "placeholder": "Enter a valid year",
        "formatType": "number",
        "specifySize": "auto",
        "minChars": "4"
        "currencyType": "local",
        "symbolPosition": "left",
        "hasSeparators": true,
        "textAlign": "Right",
        "tooltip": "",
        "showReadOnlyValidation": "false",
        "numberScale": "none",
        "numberSymbol": "none",
        "roundingMethod": "",
        "negativeFormat": "minusStyle",
        "modeType": "readOnly",
        "decimalPlaces": "0",
        "negativeFormatStyle": "NegativeNumber",
        "currencySymbolPosition": "left",
        "formatType": "number",
        "otherCurrencySymbol": "",
        "obfuscated": false,
        "displayCurrencyAs": "currencySymbol"
    "actionSets": [],
    "type": "pxInteger"
  "label": "Year",
  "type": "Integer",
  "required": false,
  "validateAs": "",
  "reference": "year",
  "labelFormat": "Standard",
  "disabled": false,
  "testID": "202008140904060384476",
  "value": "2020",
  "maxLength": 0,
  "expectedLength": "",
  "fieldID": "year",
  "customAttributes": {
    "testAttr": "testVal"


The following examples show a sample configuration of the control with the relevant JSON elements:

Cell properties - General tab
Cell properties - General tab
  • When rules that are part of conditions, such as Visibility or Disable, return boolean values.
  • Fields, such as Helper text or Default value, return the corresponding value from the associated Pega rules.
  • For conditions, such as Visibility or Disable, only the Always and Condition (when rule) options are supported.
  • For conditions, such as Visibility or Disable, for the Condition (when rule) option, negation with the logical operator (!) is supported. For example, !pzVisibleWhen.
DX API attributes
DX API attributes
The response returns the name-value pairs that you add to the DX API attributes of the control as part of the customAttributes element.
Property referenced in the control - Advanced tab
Property referenced in the control - Advanced tab
The message in the validationMessages element is displayed when the validation in the validateAs element fails.
Cell properties - Presentation tab
Cell properties - Presentation tab

The response returns the value of the Edit options field as a boolean readOnly element. The read-only value is part of the value key in the JSON response.

Suggest Edit
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.