Skip to main content
Mitratech Success Center

System Fields and Custom Fields

System Fields link to data fields in the TeamConnect database, allowing users of your custom screen to edit and update the values in these fields. The System Fields available in Screen Designer vary based on which Object Type the custom screen is being made for.

To add System Fields to a custom screen

  1. Click on the System Fields tab. A list of system field names available for use in the block is displayed in the System Fields pane.
  2. For each field that you want to use, drag it from the System Fields pane to your desired position in the canvas.
    When a field is being worked on in the layout, the fields in the Properties pane can be edited to choose display formats and other attributes.
    Note: The tool enforces only the most basic validation, such as not allowing characters in numeric fields. As a result, the tool may accept property edits that may not work at runtime, or might cause an error in more sophisticated validations. For example, if you edit the value property of a field to have a default value at runtime, but the field is one that will always be populated by a non-default value automatically, your edit will be accepted, yet will have no effect at runtime.
  3. If you want a field to be in a new position in the layout, simply drag it to the new position. If you don’t want a field to appear in the layout, click the small X icon next to the field to delete it from the layout.
    Note: Fields “collapse upward” to fill empty spaces in the layout. If you leave empty fields in a column, the populated fields below the empty ones will move up so that there are no empty positions in the layout at runtime. Designers can utilize the new Empty element to add additional spacing into their blocks. This element, added in Screen Designer 5.2, inserts an empty <div> element to create the desired spacing effect.
  4. If the Properties pane is visible, it will always show the properties of whichever field has focus. Properties vary depending upon the datatype of the field that has focus.

Custom Fields are created within object definitions under various categories, and are intended for storing your organization’s custom information in TeamConnect. Using Screen Designer, you can add Custom Fields to your custom screens. For more information on creating Custom Fields in TeamConnect, see Creating Custom Fields in the Enterprise Customization Help Guide.

To add Custom Fields to a custom screen

  1. Click on the Custom Fields tab. A list of Custom Field names available for use in the block is displayed in the Custom Fields pane.
    • The category of the block template is set by the first Custom Field added to the block.
  2. For each field that you wish to use, drag it from the Custom Fields pane to your desired position in the workspace area.
    When a field is being worked on in the layout, the fields in the Properties pane can be edited to choose display formats and other attributes.
    Note: A block can only be associated with one category. As soon as you drag a custom field from the Custom Fields pane into the layout, the block becomes linked to that custom field’s category. From then on, only custom fields from that category can be used in that block.
    If you want to change the category that a block is associated with, you must first delete all custom fields from the layout before choosing the new category. Except for these considerations, editing the layout and properties of Custom Fields work s just as it does for System Fields.
  3. If you want a field to be in a new position in the layout, simply drag it to the new position. If you don’t want a field to appear in the layout, click the small X icon next to the field to delete it from the layout. 
  • Was this article helpful?