Specifying Incremental Options
The Incremental tab of the extract inspector enables you to specify the incremental options for the extract, such as the actions that you want to extract or whether or not to combine renames, moves, and updates. This tab is displayed only if the extract type is Incremental.
To specify incremental options:
- On the Incremental tab of the extract inspector, click Edit.
- On each of the action types, select the check box to process the action and,
optionally, specify an action code to output for that action in the extract. By
default, all actions are processed in an incremental extract. The following table
lists the default action codes for each action.
Action Default Action Code Process Adds Note: If you do not enable Process Moves, then by default the structural changes resulting from Move operations are output as Adds and Deletes (if those options are enabled). If you don't want Add and Delete operations that resulted from Moves in your output file, enable the Exclude Moves from Adds and Deletes option. See step 4, below.
Add
Process Deletes Note: If you do not enable Process Moves, then by default the structural changes resulting from Move operations are output as Adds and Deletes (if those options are enabled). If you don't want Add and Delete operations that resulted from Moves in your output file, enable the Exclude Moves from Adds and Deletes option. See step 4, below.
Delete
Process Moves Move
Process Renames Note:
If a Reset Import was performed during the incremental extract period, the From and To versions for a property cannot be determined.Rename
Process Property Updates Note:
Enable Skip Missing Properties to specify that if a property is not present in both the From and To versions of the viewpoint during an update, it is not included in the extract.Prop_Update
- Enable Combine Renames, Moves, and Updates to specify that if
a property has multiple actions performed on it, the extract combines them into
single record with the highest precedence action code. The order of precedence for
action codes is Renames, then Moves, then Updates.
For example, if a property was moved under a new parent and also had its description updated, if this setting is enabled then instead of two records in the extract file (one for the move and one for the update), the extract will contain only one record with an action code of Move.
- Enable Exclude Moves from Adds and Deletes to exclude move
actions when Adds and Deletes are processed without also processing Moves. By
default, if you select to process Adds or Deletes but not Moves, the structural
changes resulting from Move operations are output as Adds and Deletes (if those
options are enabled) in the extract file. If you select this option, the structural
changes resulting from Moves are not output in the extract file.
Note the following about this option:
- If you select to process either Adds or Deletes (or both) but not Moves, by default this option is not selected and the structural changes resulting from Moves are displayed as Adds and Deletes in the extract file. You can select the option to prevent the Moves from being output as Add and Delete actions in the extract file.
- If you select to process either Adds or Deletes (or both) as well as Moves, this option is automatically selected and cannot be changed.
- If you do not select to process both Adds and Deletes, this option is not visible.