Chapter 6 Extracting documents


Understanding extraction options

Extracting PowerDesigner models offers more features than extracting documents from external applications.

You can define the following extraction parameters from the Extract Document dialog box:

Extraction options
Description
Name Name of the document in the repository
Version Version of the document to extract
Packages (PowerDesigner models only) Displays a package selection dialog box in which you can select packages if you do not want to select the entire model
Extract dependencies Dependencies are of 2 types: shortcut or generation dependencies.

A shortcut dependency is created when the shortcut of an object is linked with other objects. In this case, the dependency appears in the Shortcuts sub-tab of the Dependencies tab of the target object property sheet.

A generation dependency is created when an object is generated into another object. This dependency does not appear by default in the Dependencies tab of an object property sheet, (the model needs to be consolidated and extracted from the repository to display this information in the Generated As sub-tab of the Dependencies tab).

When you select the Extract Dependencies option both types of dependencies are extracted from the repository and displayed in the Dependencies tab of an object property sheet.

For more information on the extraction of dependencies, see the "Impact Analysis" section in chapter Managing Repository Documents.
Lock before extract Lets you lock the selected version of document before extraction in order to prevent other users from modifying the document. This check box is available to users with Lock Versions right
Extract to file Lets you extract the document to a selected file.

(PowerDesigner models only) Defining an extraction file is not mandatory. If you do not define a file, the PowerDesigner model will be loaded in memory, and added to the workspace.
Path Full or relative path of the extraction file. The default relative path is the workspace directory. You can use the Select a File tool to browse files and select a location
Merge document Allows to merge repository version of the document with local document. This option is available for documents with corresponding file on the local machine. For PowerDesigner files, the Merge dialog box is called
Read-only Extracts the document and sets the read-only flag on the file after extraction
Open document Automatically opens the document after extraction, either in the current workspace or in the corresponding external application
Add to workspace Adds the extracted document to the current workspace

PowerDesigner models vs other documents

The following table highlights the differences between extracting PowerDesigner models and other documents:

Extraction option PowerDesigner Model Other documents
Select Packages Displays a selection dialog box in which you can select packages if you do not want to extract the entire model Not available
Extract to file
  • Extract to file

    or
  • Extract without defining a file and keep model in memory
Always extract to file
Merge with existing file Displays the Merge dialog box to compare and merge repository model with existing local model file Not available, local document replaced by repository document

 


Copyright (C) 2005. Sybase Inc. All rights reserved.