Adding Virtual Columns (DEFINE) in a Synonym

How to:

You may create a DEFINE field as a custom field in the Synonym Editor. A custom field can be used in a request as though it is a real data source field. Virtual columns (DEFINE fields) are available when the data source is used for reporting.

A virtual column can contain an expression, a constant, or a column name.

Virtual columns are designated by the following icon:

Virtual Columns icon

After creating a virtual column, you can test it by right-clicking the synonym and selecting Sample Data. Sample data appears in a separate dialog box.


Top of page

x
Procedure: How to Create a Virtual Column in a Synonym

To create a virtual column in a synonym:

  1. From the Projects or Data Servers area, open a synonym by double-clicking a Master File from the Master Files folder.

    The Synonym Editor opens.

  2. Right-click a segment (or column) and click Add.

  3. Select Virtual Column from the Add submenu.

    The Virtual Column Calculator opens.

    The Virtual Column Calculator

  4. From the Virtual Column Calculator, type a name for the column in the Column input field, or use the default define name.
  5. You may enter a descriptive title for the virtual column (DEFINE) in the Title input field.

    Tip: From the Synonym Editor, click the browse (...) button at the right of the TITLE and DESCRIPTION value fields to specify multiple language titles.

  6. Use the Expression tab and the calculator buttons to build the expression for the virtual column (DEFINE).

    or

    Use the Relational Expression tab to build the expression.

    1. From the Relational Expression tab, use the drop-down lists to select the filter Column, Relation, and Type.

      Note: Parameters are not supported.

    2. Click the browse (...) button at the right of the Value input field.

      Value input field

      The Value Selection dialog box opens.

      Value Selection

    3. Select from the available values and use the arrows to add or remove values.
    4. Click OK to close the Value Selection dialog box and return to the Relational Expression tab.

      The expression is added to the value field.

    5. To add another filter, double-click a column or variable from the Columns/Variables tab on the right side of the Virtual Column Calculator. The filter is added to the Relational Expression tab, where you can add the expression value.
    6. To delete an expression, click in the row number column of the expression that you are deleting, right-click and select Delete selected row(s). The expression is removed from the Relational Expression tab.
  7. You may select the Check expression and Sample Data buttons, located on the top right of the Virtual Column Calculator, to verify that the expression is valid and to view sample data for the filter.
  8. Click OK to close the Virtual Column Calculator and return to the Synonym Editor.

    Note: To edit the Define, Title, or Expression, you may do so directly from the Synonym Editor or you may click the browse (...) button at the right of the EXPRESSION value field to relaunch the Virtual Column Calculator.

  9. If no columns from the synonym are used in the expression or have been defined, you can use the WITH option to identify the logical home of the defined calculation. You can also use the WITH option to move the logical home for the virtual column to a lower segment than it would otherwise be assigned (for example, to count instances in a lower segment).

    Tip: You can click and drag the DEFINE field and move it to a different segment in the Segment and Field View tab, which also changes the segment association.

  10. Specify the Missing Data options for columns that allow null data. You can allow all missing data.
  11. Click Save from the File menu to save the synonym.
  12. To close the Synonym Editor, select Close from the File menu or click the control button in the upper-right corner.

For more information about expressions and virtual column (DEFINE) attributes, see Defining Attributes and Creating Expressions for Custom Fields.


WebFOCUS