ClearTargetItems

Created: July 27, 2015 | Updated: April 11, 2017 | Applies to versions: 15.1, 16.0, 16.1, 17.0 and 17.1

Parent page: UnifiedComponent Commands

The following pre-packaged resource, derived from this base command, is available:

Applied Parameters: None

Summary

This command is used to clear the existing link between one or more selected component definitions in the active Component Library document, and their corresponding Component Items in a target Altium Vault. The need to sever the links might arise if you require to release again to a new set of Items. For example, if you have previously released but then deleted the Items from the vault, the source library will still have defined links (although invalid as the vault Items would no longer be found). Similarly, if you need to release the source library to a different target vault.

Access

This command can be accessed from the Component Library Editor by:

Selecting a single component definition (in the definitions region) and choosing the Edit » Operations » Clear Link To Target Item command from the main menus.
Right-clicking over a component definition (in the definitions region), and choosing the Operations » Clear Link To Target Item command from the context menu.
Selecting multiple component definitions (in the definitions region) and choosing the Edit » Operations » Clear Links To Target Items command from the main menus.
Right-clicking over a component definition (in a group of selected definitions in the definitions region), and choosing the Operations » Clear Links To Target Items command from the context menu.

Use

After launching the command, the link to the applicable target Component Item, for each selected component definition, will be cleared.

Be sure to save the Component Library document, now that the link information has been stripped away.

Tips

If you have already released a component definition, this procedure will effectively cause that definition, and its previously linked Component Item, to lose knowledge of each other.
Once the link to an existing Component Item in the target Altium Vault is cleared, the Name for the component definition will become non-grayed (and editable). The entry in the Action field, in the Release region of the grid, will change to Create Item - reflecting that the component definition is currently not linked to an Item in the target vault.