Applied Parameters: None
Summary
This command is used to manually regenerate the harness definition files for the focused project in the Projects panel. A harness definition is a formal textual definition of a signal harness. Stored in text files called Harness Definition files (*.Harness), each definition comprises of a Harness Type and Harness Entries. Harness definitions are automatically generated when a harness connector is constructed, with harness entries, on a source schematic document. Altium Designer manages harness definition files automatically, meaning that when a harness connector is modified on the schematic sheet, the corresponding harness definition is updated to reflect those modifications.
Harness definition files appear in the Projects panel, under a project's Settings\Harness Definition Files sub-folder.
If a harness definition file differs to the corresponding graphical harness defined on the schematic sheet, the Design Compiler will throw a Conflicting Harness Definition violation (by default, a fatal error). A harness definition file can become out-of-sync, for example, if it has been manually modified, and/or its definition entry has been locked - preventing automatic update - then subsequently unlocked. Running this command forces a compile of the project and regeneration of the harness definition files, such that they are synchronized with the harness connectors (and their entries) placed on the source schematic documents.
Access
This command can be accessed by:
- Right-clicking over the entry for a project in the Projects panel, and choosing the Regenerate Harness Definitions command from the context menu.
- Focusing the entry for a project in the Projects panel, then clicking the panel's Project button and choosing the Regenerate Harness Definitions command from the context menu.
Use
After launching the command, the project will be compiled and the harness definition files re-synchronized (where possible) with the graphical harnesses on the source schematic documents.
Tips
- If a harness definition in a harness definition file is locked, this command will not update the definition in that file. You will need to manually open the definition file and update the definition accordingly.