Ability to Update Components when Re-Releasing a Child Model

Old Content - visit altium.com/documentation

When you make a change to a vault-based domain model - be it a symbol, PCB 2D/3D Component model, or simulation model - the moment you release that change into a new revision of the model's Item, any Component Items that use that model will become effectively out of date, still using the previous revision. In most cases, you will no doubt want to re-release those components, with the respective model links updated to use the latest revisions available. To streamline this process, Altium Vault 2.5, in conjunction with Altium Designer 15.1, facilitate the ability to update related Component Items - at the point of re-releasing a model Item - after having made any modifications to that model through the file-less editing feature.

The option to perform this update to the parent Component Items, can be found in the Create Revision dialog, that appears when releasing the modified model document back to the target Altium Vault. This option - Update items related to <ModelItemRevision> - is enabled by default.

<ModelItemRevision> is the current revision of the model Item, that is, the revision currently being used by any related Component Items. Once the model itself is released, this would naturally be the previous (earlier) revision, and no longer the latest.

Accessing the option to update related Component Items.

The Create Revision dialog appears when you are finished your file-less editing session, and have clicked the  button (in the editor's standard toolbar), to release the modified document.
If you want to keep all related Component Items using the current revision of the model Item, simply disable this option. Only the model itself will then be released.

Once you click OK in the Create Revision dialog, the model document is released back to the vault, and its associated temporary editor closed. A Component Library document is then opened in its associated temporary editor (file-less editing), presenting the following:

  • Definitions for all components that are associated to (reference) the model Item.
  • The Model Links region shows the latest (just released) revision for that model Item.
  • The entry for the linked model - in the applicable Models field of each component definition - is set to use that latest revision of the just-released model Item.
When multiple Component Items use the model Item, rather than separate instances of Component Libraries being opened, a single CmpLib document presents a merged view of the world, with all parameters and model links - used by the source component definitions - presented.

Unless you need to make any further adjustments, simply click the  button (in the editor's standard toolbar), to release the modified definitions into new revisions of the corresponding Component Items, back in the target vault.

Example of pushing a change made to a Schematic Symbol Item, through to a Component Item that references it.

If only a single Component Item is affected, the release will proceed, and the temporary Component Library editor then closed. If multiple Component Items are affected, the Release Manager dialog will appear. This lists all component Items that are scheduled to be released - by default all enabled for inclusion in the release.

If multiple Component Items are involved in the update, the Release Manager dialog will be employed.

Make any changes - to Comment, Description, and inclusion (Enabled option) - as required, then click the Release Items button. View the impending release changes in the subsequent Confirm Release dialog, then click OK. Once the release process completes - indicated by Release Successful in the applicable Action-Status field(s) - close the dialog. The temporary Component Library editor will also then be closed.


You are reporting an issue with the following selected text and/or image within the active document: