Selecting Extract Columns

The Columns tab of the extract inspector enables you to select the properties and constant values that you want to extract for the dimension.

To select the extract columns:

  1. On the Columns tab, click Edit.
  2. To add properties to the extract, perform the following actions:
    1. Click Manage Properties.

      The properties from the viewpoint are displayed.

    2. Click the properties that you want to add to the extract, or click Select All to add all available properties.

      Selected properties are indicated by a check mark. Click X to remove the property.

      Incremental extracts only: On the selected properties, click + to add the property to the extract again. The number of instances of each property is indicated. Click X to remove an instance of the property from the selected column.


      screenshot showing property controls for incremental extracts

      Tip:

      Properties that you select are added to the extract in the order that you click them. Select the properties in the order that you want them in the file to reduce re-order actions later.

    3. Click OK.

      The selected properties are added to the Columns page.

  3. Optional: In Header, edit the column header name for the property.
  4. To add specialty columns to the extract, click Add Column, select the type of specialty column to add, and enter a column header name:

    Table 22-2 Extract Specialty Columns

    Column Type Description
    Action Code (Incremental extracts only) The action that was performed on the property. You can specify the label for the action code on the Incremental tab. See Specifying Incremental Options.
    Constant User defined constant value

    Note:

    Enter the value for the constant in Source Value.
    Extract Run ID Unique GUID for the extract being run (duplicated for all records)
    Extract Timestamp Timestamp of extract (duplicated for all records)
    Inverted Level (Full extracts only)

    Note:

    Available for extracts run against hierarchy viewpoints only.
    Bottom-up level of the node in a hierarchy set

    Bottom level nodes have a level of 0, their immediate parents have a level of 1, and so on. For example, in a hierarchy where a top node has one child node and that child node has one child node, the bottom node level is 0 and the top node level is 2.

    Record Number Incremental number starting at 1 for the first record
    User Name Name of the user running the extract (duplicated for all records)
  5. Optional (Incremental extracts only): In Source Type, specify what the value of the property is based on:
    • From: The value is based on the From version of the viewpoint
    • To: The value is based on the To version of the viewpoint
    • Combined: The value is based on the To version of the viewpoint if it is available. If not, the value is based on the From version of the viewpoint.

      Note:

      For rename actions on the Core.Name property only, the Combined value is based on the From version of the viewpoint.
  6. Optional (Full extracts only): Select the Pivot check box to specify a property to pivot on in the extract file. This will produce a separate row in the extract file for every value in the pivoting property (including null or empty values). Only one property can be pivoted in an extract.

    Note:

    You can specify List or String data type properties as pivot columns. For string data types, specify a pivot delimiter on the Options tab. See Specifying Extract Options.
  7. Optional (Full extracts only): Select the Key check box to designate a column as a primary key column. Columns marked as primary key columns will output a single row of data for each unique instance of the key values. Duplicate instances of primary key rows are suppressed from the extract output.

    You can designate more than one column as primary key columns. Duplicates are determined based on the combination of values in the key columns.

    Note:

    When using both the Pivot and Key options:

    • The pivot operation takes place first, and then duplicate rows of primary key values are filtered out from the extract.
    • The column that you are pivoting on should also be a primary key column. Otherwise, only the first record of the pivoting property will be extracted
  8. To remove columns, perform an action:
    • Click Remove All to remove all of the columns from the extract.
    • To remove individual columns, in the Actions column of the property or constant that you want to remove, click Actions and then select Remove
    • From Manage Properties, click X on a selected property to remove it from the extract.
  9. To re-order columns, in the Actions column of the property or constant that you want to move, click Actions and then select one of the move actions.
  10. Click Save.