Extract Control

Common Functionality

Global : Extract Control

The Extract Data Control window is only available if there is an extract database in the MDB. If no extract database exists an error window is displayed.

The following options are available in the Extract Data Control window:


Get All Changes	Refreshes views of data in the databases which own extracts in the current MDB. Two options control if data is collected From Parent Extract only or From All Extract Ancestors.
Update CE	When you select Update CE, the list of elements is updated to show the extract element hierarchy for the current element. The Update CE can be used to bring up-to-date the information displayed on the Extract Data Control window if displayed data has changed since the window was last displayed or updated.
Extract Claim List	Displays the Extract Claim List window.

	Click Update to update the window to the current selected extract claim (for example CE, MDB or Dbs).
	Extract Claim	Click drop-down arrow to display extract claim options, select one of the following: CE - Current Element MDB - Master Database Dbs - Databases, activates Extract DBs, click drop-down arrow and select from the list of available databases.
	Results Per Page	Number of results per page can be set to 10, 20, 50 or 100. This selects the number of elements displayed in the scrolling list, which shows a list of all elements claimed to an extract DB in the current element hierarchy. The arrow buttons are used to page backwards and forwards through the list, respectively.
	Number of Claimed Elements	The scrolling list displays a hierarchy of elements. Select an element in this list will make it the current element. The codes in front of the elements describe the extract claim state.
	Dismiss	Click Dismiss to exit.
User Claim Lists	Displays the User Claimlists window. Refer to Claimlists for further information.

The Elements scroll list displays the hierarchy of the database elements around a selected element along with information about the extract claim status of each element.

The displayed element hierarchy is not the complete element hierarchy as displayed in the Members list: only significant elements are displayed (or elements which own significant elements) because extract operations only apply to significant elements.

Changes to elements selected from the list can be Flushed, Issued or Dropped, click the appropriate option.

Select an element in the list to make it the current element. The codes in front of the elements describe the extract claim state:


H	Indicates a claim exists at a lower hierarchy level.
C	Element is claimed by the current user.
E	Element is significant and claimed to an extract in the MDB.
M	Element is significant and it, or one of its non-significant children, has been modified in an extract in the MDB
R	Element has a reference which is marked as "Include for FLUSH" in this extract. This is used by elements such as CYMLNKs which contain references which link databases together (Links between Design, Schematics and Engineering databases). This also affects XPITEM and STATUS elements.
X	Element is claimed from an extract in the MDB, so changes to the element cannot be issued or aborted.
V	Element has been modified in a Variant extract in the MDB

Click Prefix Info to display a summary of the codes.

If there is no code in front of the element then it is either a non-significant element, or it has not been claimed to an extract in the MDB.

When an element is marked CM, changes to the element can be flushed, issued or dropped.

Click Extract to claim an element and add it to the Extract Claimlist.

Change Highlighting can be used to colour changes that have been made to a database during a Extract session, select the following:

Outstanding
in Extract

Click to highlight in the extract 3D view any elements that have been changed but not yet Flushed or Issued back into the parent database. The highlighting is cleared when the window is closed, or when a subsequent extract operation is performed using the window. In the latter case the check box becomes unselected.

Introduced by
Get All Changes

Click to highlight in the extract 3D view any elements that were changed in the parent database outside the extract. The highlighting is cleared when the window is closed, or if the Outstanding in Extract check box is selected. In the latter case the Introduced by Get All Changes check box becomes unselected.

Note:

Only have an effect after Get All Changes has been selected. As the changes must be retrieved first before a comparison can be made.

Colour

Click to open the Change Highlighting Colour window. Choose a colour to use in the 3D view when either of the above have been selected.

If the World element is selected, then all changes made in all extract databases in the MDB are selected for the Flush/Issue/Drop operation.

Use the following Extract DB Operations options to change the way a Flush, Issue or Drop operation is performed.


Element Hierarchy	If selected Flush/Issue/Drop works on the selected element and all elements that is owned directly or indirectly.
Single Element	If selected Flush/Issue/Drop works on the selected element only.

Use the Rules & Connections options to control how a Flush or Issue operation behaves when considering elements which have Rules assigned or Connected items.


Always Issue/Flush Changed Rules/Connections	Click to always Issue or Flush any changed Rules or Connecting items in the database.
Default	Reset the check box to the default value.
Resultant Additional Elements	Opens a pop-up listing all the elements which can be impacted when a Flush or Issue takes place.

Click Flush, Issue or Drop, to have an impact on any changes made by all users in the Element hierarchy, which is displayed in the Extract Data Control window.


Flush	Updates the database owning the extract. Extract claims for selected elements are retained. A single element, or part of the hierarchy is flushed, depending on the Operate on setting.
Issue	Updates the database owning the extract and release the extract claim. A single element, or part of the hierarchy is issued, depending on the Operate on setting.
Drop	Drops changes made to selected elements in extracts in the MDB and releases extract claims.