Product Definition of a Harness

Change History

IdSubjectDate
Latest CommitAdded section about documents with type `HarnessDescription` (#1036)2025-12-18
#1036 Content of a HarnessDescription2025-12-18
KBLFRM-1038 New Implementation Guideline for Part Usages & Part Occurrences2022-09-09

The definition of the product itself (the wiring harness) is one of the major use cases of the VEC. The figure below illustrates the basic building blocks in the data model and provides guidance on where to look for specific topics. It is not a complete map of the VEC.

Building Blocks of a Harness Product Definition
Building Blocks of a Harness Product Definition

A wiring harness consists of recurring components that are produced and installed in large quantities (e.g., connectors, wires, terminals, and seals). These components have properties that are the same for all components of a specific type and are independent of their usage. In most cases, such types are identified within a company context as parts with unique part numbers. The description of these common properties is often referred to as “Part Master Data”. The “Component Specification / Part Master Data” section (blue box on the right-hand side) represents this information. This area is explained in more detail in the section “Component Specification”.

A wiring harness definition is then formed by specific uses of those component types, and a component can also occur multiple times. Each instance of a component may have additional properties specific to its usage (e.g., the signal and length of a wire, or the name of a connector). These properties are defined in the “Instances of Components” block, highlighted in green. In this area, the VEC distinguishes between abstract instances of components (PartUsage), where a specific component is not yet defined but some properties are known, and instances of concrete components (PartOccurrence). See “Instances of Components” for more details.

Based on these instances, you can specify bills of materials (BOMs), with or without variance, for composite parts, which can in turn be used hierarchically as instances for more complex parts (block on the right-hand side, highlighted in orange). See “Composite Parts” for more details.

In addition to the BOM view, it is important to establish relationships between components and other elements of the wiring harness definition (e.g., topology or electrology). This is accomplished through “Behaviour & Relationship Definitions” (highlighted in violet), which specify relationships such as routing, placement, contacting, and traceability between components and definitions at higher levels of abstraction.

Harness Description Document

Disclaimer: This page or section is currently under review by the community.

The content of this page or section can be subject to change at any time. If you find any issues or if you have any review comments please drop us an issue in our Issue Management on GitHub.

This page or section resolves #1036

The figure below illustrates how these building blocks are typically organized within a VEC describing a single harness. It also shows the typical content of Specifications within a DocumentVersion with DocumentType=HarnessDescription.

Document Structure and Typical Content of a Harness Product Definition
Document Structure and Typical Content of a Harness Product Definition

At the top level, a VEC that describes a wiring harness usually consists of two major blocks:

  1. The Part Master Data of all components (connectors, wires, terminals, seals, etc.) used within the wiring harness. Per component, this is usally a PartVersion, identifying the component, and a DocumentVersion containing the Specification defining this component.
  2. A single DocumentVersion with DocumentType=HarnessDescription, containing all information specific to the wiring harness itself, and one or more PartVersions identifying the parts (e.g., modules, individual harnesses) defined within this wiring harness description.

The figure also shows the typical Specifications used to define the information in the different building blocks of a wiring harness definition.

The VEC is an open and modular model for the entire physical electrical system of a vehicle. This means the list of specifications is not a hard requirement nor exhaustive. You may add additional specifications or documents to the wiring harness definition if you want to provide a richer information model (e.g., system schematics, signals, usage nodes). You may also choose to leave out some of the specifications shown in the figure above if they are not relevant for your use case or process (e.g., 2D/3D is mutually exclusive in many processes).

This is also the case for harness descriptions that evolve during the development process. In early phases or specific disciplines of the development, you may only have a subset of the specifications shown above and add more information as the development progresses. For example, a harness description coming from a 3D design tool may only contain topology, 3D geometry, and some geometry‑relevant components and their placements. Electrical information, routing, and variant information may be added by another discipline at a later (or parallel) stage.

A detailed description of each block/specification in the figure would go beyond the scope of this implementation guideline. Please refer to the respective sections linked above or in the table of contents for more information on each building block.