Show TOC

Procedure documentationCreating an Element Data Object Locate this document in the navigation structure

Procedure

  1. Open the application in the Object Manager panel.

  2. Under the Detail section, choose the Contained Objects tab.

    The Contained Objects tab page appears.

  3. Choose Data Object from the Type field and choose Create Object.

  4. In the Object Creation dialog box that appears, choose Element from the Type field.

    The Element section appears.

  5. Choose the type of element you want to create from the Element Type field, under the Define Element Properties section.

    For more information, see Data Object

  6. Under the General Data section, enter a name for the element and choose Create and navigate to object.

    The data object appears in the Object Manager panel.

    Note Note

    If you choose Create button, the element data object appears under the Contained Objects tab. Click the name of the created object to define the element properties.

    End of the note.
  7. Add values to the element data object that you have created. You can create values, or refer to existing values or bind the data object.

    • Create New Values

      1. In the Domain Values tab page, choose Create Values.

      2. In the Object Creation dialog box that appears, enter name and value for the data object.

      3. Choose Create.

      4. Depending upon the element you create, the related value fields appear in the Object Creation dialog box. Enter the related values in the fields that appear.

        The following table helps you to create new values and set element attributes:

        Element Type

        Values

        Element Attributes(Optional)

        Description

        (all types)

        Name and Text fields appear for all the element types. You can enter name and text appropriately for all the element types

        (Optional) If you want to set additional attributes of an element, choose Element Attributes(Optional) tab.

        Text

        Enter text in the Value field.

        Length

        You can enter an attribute with a maximum length of 255 in the Value field.

        Number

        Enter a number in the Value field

        Length

        You can enter an attribute with a maximum length of 31.

        The length represents the number of digits without exponent or sign.

        Decimals

        You can enter up to 10 maximum number of decimal places.

        Positive values only

        Select the checkbox to enter only positive values.

        Boolean

        You may choose True or False from the Value field.

        Amount

        Enter amount and currency in the Value and Currency fields.

        Quantity

        Enter quantity and unit in the Value and Unit fields.

        Timepoint

        You can choose the following different timepoint options:

        • Date

          In the Date field, choose Calendar (Calendar). Choose the date from the calendar.

        • Time

          In the Time field that appears, enter time in hh:mm:ss format.

        • Date Time

          In the Date and Time fields that appear, choose Calendar (Calendar) and select the date from the calendar. In the Time field enter time in hh:mm:ss format.

        • Universal Time

          In the Date field, choose Calendar (Calendar) and select the date from the calendar. In the Time field enter time in hh:mm:ss format.

        Note Note

        1. You can set element attributes only for Number, Timepoint and Text element types.

        2. If the value of a constant does not fit to the element attributes (for example, exceeds the length) then you will get a warning message. You can still activate the object and such calculations are carried on with decfloat precession.

        3. The element attributes only affect the design time and not the runtime of the BRFplus.

        End of the note.
    • Select from Existing Values

      1. In the Domain Values tab, choose Select Values.

      2. In the Object Query dialog box that appears, select the value and choose Select.

    • Bind the Element Data Object

      You can bind the data object if you want to have a value help from where you can select values. Under the Element Properties tab, choose one of the following options from the Select Binding Type dropdown list:

      • Bind to an Existing Element

        1. Choose Bind an existing BRFplus element option to bind the object to an existing element.

        2. In the Object Query dialog box that appears, select the data object.

      • Bind to a Data Dictionary object

        1. Choose the Bind a data dictionary (DDIC) element to bind the object to an element object in the data dictionary.

        2. In the Bind DDIC dialog box that appears, select the DDIC element and choose Select.

      For more information, see Data Binding

  8. If you want to to restrict the number of allowed comparison types for an element, choose the relevant allowed comparison from the Allowed Comparisons field on the Element Properties tab.

    Example Example

    You can set restrictions on comparisons of an element, for example, in decision tables or decision trees. If you select Equals comparison for an element that is used in a decision table, then you can have only one or no value and you cannot use less or greater comparisons.

    End of the example.

    The following table lists the allowed comparison types for an element:

    Allowed Comparisons for an element

    Description

    No Restriction

    Data object can be used in all types of comparison operations which are supported by the system for the particular type of the data object. This is the default for elementary data objects of type Text.

    Equals

    Data object can only be tested for equality against one single value.

    Single Value

    Data object can only be tested for equality or unequality against one single value. This is the default for elementary data objects of type Boolean.

    Value List

    Data object can only be tested for equality or unequality against a list of values.

    Non-textual

    Data object can be used in all types of comparison except for string comparisons (like contains string or matches pattern). This is the default for elementary data objects of the following types:

    • Amount

    • Number

    • Quantity

    • Timepoint

    User-Defined

    Data object can be used in those types of comparison operations that are explicitly mentioned in a list of allowed operations. This list has to be defined individually for that particular data object. For example, you can define that a data object may be used in greater than and greater than or equal to comparisons, but not in less than and less than or equal to comparisons.

  9. Activate the data object.

  10. Save the data object.

More Information

Comparison Operations