Create new display items - SmartPlant Foundation - IM Update 48 - Help - Hexagon

Display items are used to present data or relationships on a form. Attributes or relationships are assigned for a display item from a relational table. Users can create new display items or re-use display items from the database.

Once a display item is created, it can then be added to a section for inclusion on a form. You can search for existing display items and sections to help you complete your form.

When you select the display item type to use in the New Display Item dialog box, your selection determines the additional properties that are activated.

You can use the following display item types on a form.

• Edge definition - to display relationships only.

• Relationship definition - to display or update relationship definitions.

• Interface definition - to do new instantiation of optional interfaces.

• Property definition - to display or update properties.

You use the New/Update Item form to create new display items and update existing ones. This is accessed by updating an existing display item or clicking the Update or Create button on the Manage Display Items dialog box.

1. In the Manage Display Items dialog box, click Create, and the New Item form displays. For more information, see Manage display items (Modified in an update).

   The options on this dialog box are as follows.

2. In the New Item form, type a Name and Description for the item.

3. In the Display as box, type the display item name as it should appear on the form.

4. If necessary, define default values for the display item by typing the values in the default value boxes. If applicable, these values are presented within the display item when the form is initially displayed.

   Property	Description
   Default Create Value	The default value for the display item in New dialog boxes that contain this display item. (See note below).
   Default Copy Value	The default value for the display item in Copy dialog boxes that contain this display item. (See note below).
   Default Query Value	The default value for the display item in Query dialog boxes that contain this display item. (See note below).
   Default Custom Value	The default value to use on special forms. (See note below).
   Default Revise Value	The default value to use on Revise dialog boxes. If NULL, the display item will be blank when the Revise dialog box appears. If no value is specified, the previous revision number will appear in the box. If a value is specifed, then that value will take priority and will appear in the box.

5. To define the length of the display name for the display item, type a value in the Size of label box.

6. To define an input field size, type the value in the Size of Field box.

7. In the Display item type box, select the type of item to be displayed. For more information about display items, see Display item types.

8. Select the edge, interface, property, or relationship definition as appropriate. For more information about display items, see Display item types.

9. Click Finish to create the display item.

• The default custom value can only be used on display items for properties that are scoped by a string.

• You can use the following context/environment type variables as the default create, copy, query, and custom values:

  • ENV.USER

  • ENV.USERNAME

  • $USER

  • GUID

  • $PLANT

  • CURRENTCONFIG

  • CURRENTQUERYCONFIG

  • CONFIGLEVEL (1,2,3)

• You can also get properties from other objects:

  • CLASS

  • CLASSDEF

  • PARENT

  • RELATEDOBJ

  In the form of CLASS->RelDef_12/21.Property