Composite Data Management > Giveaway
Usage Example - Giving Away
Together Two Mutually-Exclusive Options on a Harness
The following usage example demonstrates how to give away together two mutually-exclusive options for a harness and view the difference that this makes to the number of harness levels.
Note
This example was created using an earlier version of Capital. Various dialog boxes may have been updated since the screen shots were created. However, the example still shows the relationships between the different types of composite data.
Giveaway is intended to reduce the number of harness levels by removing some that contain a sub-set of the wiring in another harness level. Although this results in unnecessary wiring being included in some built vehicles, the reduction in the number of levels removes the cost of managing these separate part numbers. Mutually-exclusive options normally result in mutually-exclusive wiring in separate levels that are never a sub-set and therefore not normally given away. In some cases, however, the reduction in harness levels is desirable despite the redundant wiring that results. For this reason, the ‘giveaway together’ functionality allows mutually-exclusive options to be given away and their separate harness levels merged.
This example uses a Quick Start - Automotive Generative project and references the Vehicle Topology diagram of the Sports Coupe design in that project.
Run Composite Wiring Synthesis
to Promote All Options to the Appropriate Harnesses
You start by promoting all options to harnesses. To do this, run Composite Wiring Synthesis (CWS).
Procedure
Press Space Bar and enter Synthesis; the Wiring Synthesis dialog box displays.
Choose Full Synthesis. Note As your aim is only to promote options to harnesses, you could select just the Update Harness Options step. This would give slightly different results because some harness levels are combined when all Full Synthesis steps are selected.
Click Go; a progress bar displays. Figure 161: Progress Bar
- When CWS is complete, click Close; the system has promoted options to harnesses, has synthezied wiring for all signals, and has generated physical harness levels for the harnesses.
Edit the Options to Make the Front and Rear Fog Lights Mutually-Exclusive
You place the Fog Lamps-REAR and Fog Lamps-FRONT options in their own Option Folder and mark the folder as containing mutually-exclusive options.
Procedure
View the Options in the project by pressing Space Bar and entering Options; the Options Dialog Box displays. The following are the default options from the Automotive Generative project.
The top-level Options folder contains options grouped into Option Folders.
The Other folder contains options that relate to other features of the vehicle such as door locks and fog lamps. Note that the options in this folder are not set as Mutually Exclusive and they are not marked as Mandatory.
If Mutually Exclusive was selected, none of the options in the folder could be selected together in a vehicle.
If Mandatory was selected, at least one of the options within this folder would have to be included in any vehicle.
Click the Create a new Folder () button; a new folder is added to the Options browser:
Specify a folder name of FOG and select Mutually Exclusive and Mandatory.
Drag the Fog Lamps-REAR and Fog Lamps-FRONT options into the FOG folder.
The Fog Lamps-REAR and Fog Lamps-FRONT options are now mutually-exclusive and at least one of them must be included in the vehicle.
Edit the Vehicle Models So That Giveaway Options Are Required
Giveaway options are specified to reduce the number of buildable harness levels that are generated by Composite Wiring Synthesis (CWS). However, this Automotive Generative project data has only a small number of harness levels defined due to the highly constrained vehicle models.
Therefore, it is necessary to edit the default vehicle models in the project in order to use the data for this example.
Procedure
- Press Space Bar and enter Models; the Define Vehicle Models dialog box displays.
The Fog Lamps-REAR and Fog Lamps-FRONT options are currently both STD in the LHD-SP vehicle model. They display in red because they are now mutually-exclusive and therefore cannot both be STD in a vehicle model.
- Edit the values for the Fog Lamps-REAR and Fog Lamps-FRONT options so that they are both optional for all three vehicle models. To do this, click the table cells and select OPT from the drop-down list. The table should look as follows:
This means that you can build the vehicle models both with and without the Fog Lamps-REAR and Fog Lamps-FRONT options. This means that Composite Wiring Synthesis generates more harness levels than it would have otherwise.
- Click OK to exit the dialog box.
Run CWS to Generate Harness Levels for the Harness
You use CWS to re-generate physical harness levels.
Procedure
Press Space Bar and enter Synthesis; the Wiring Synthesis dialog box displays.
Deselect all of the steps apart from Generate Physical Harness Levels step. Click Go; a progress bar displays.
When CWS is complete, click Close; the system has generated physical harness levels for the harnesses.
View the Harness Levels for the IP Harness
You could view the harness levels for any harness but you concentrate on the IP (Instrument Panel) harness.
Procedure
Right-click the IP harness in the Design Browser (Design tab) and choose Define Harness Levels; the Define Harness Levels - Harness:IP dialog box displays.
It lists the six harness levels that the system has generated for the IP harness:
In particular, you are interested in the relationship between the harness levels and the Fog Lamps-REAR and Fog Lamps-FRONT options. You can see that each harness level supports only one of these options. Therefore, they could be specified as giveaway on the IP harness in order to reduce the number of harness levels.
Specify the Fog Lamps-REAR and Fog Lamps-FRONT Options as Giveaway for
the IP Harness
This is done from the Define Harness Levels - Harness:IP dialog box. At this point, you are specifying that the options are given away separately. You then see that this makes no difference to the number of harness levels.
Procedure
Click the Give away options () button; the Give Away - Harness:IP dialog box displays.
Select the Fog Lamps-REAR and Fog Lamps-FRONT options in the Available window and click Add; the options are added to the Selected window.
Click Recalculate; the Estimated Level Count value changes to an estimation of the number of harness levels that would be generated by CWS for the IP harness with those two options as giveaway.
Giving away those two options like this has made no difference to the number of levels.
Click OK; the options are saved as giveaway and the dialog box closes. Nothing changes on the Define Harness Levels - Harness:IP dialog box at this point.
Click OK to exit the Define Harness Levels - Harness:IP dialog box.
Run CWS to Re-generate Harness Levels
CWS re-generates the harness levels and treats the Fog Lamps-REAR and Fog Lamps-FRONT options as given away separately on the IP harness.
Procedure
Press Space Bar and enter Synthesis; the Wiring Synthesis dialog box displays.
Deselect all of the steps apart from Generate Physical Harness Levels step again and click Go; a progress bar displays.
When CWS is complete, click Close; the system has re-generated the physical harness levels for the harnesses.
View the Re-generated Harness Levels for the IP Harness
This demonstrates that giving away the options separately made no difference to the number of harness levels.
Procedure
Right-click the IP harness in the Design Browser (Design tab) and choose Define Harness Levels; the Define Harness Levels - Harness:IP dialog box displays.
The listed harness levels are exactly the same as before. This is because none of the levels are a sub-set of the others (with respect to fog lights):
Specify That Fog Lamps-FRONT and Fog Lamps-REAR Are Given-Away Together
for the IP Harness
This is done from the Define Harness Levels - Harness:IP dialog box again and you see how this does make a difference to the number of harness levels.
Procedure
Click the Give away options () button; the Give Away - Harness:IP dialog box displays.
Click New Group to create a new give-away group in the Selected window.
Move the Fog Lamps-REAR and Fog Lamps-FRONT options into the Group1 folder by dragging them onto it; they are now listed below it.
Despite being mutually-exclusive, the two options are given away together now. This means, any vehicle contains the wiring for both options (even though the wiring for one of these options is redundant).
Click Recalculate; the Estimated Level Count value changes to an estimation of the number of harness levels that would be generated by CWS for the IP harness with those two options given away together.
Click OK; the options are saved as being given away together and the dialog box closes. Nothing changes on the Define Harness Levels - Harness:IP dialog box at this point.
Click OK.
Re-run CWS to Re-generate Harness Levels
CWS re-generates the harness levels and treats the Fog Lamps-REAR and Fog Lamps-FRONT options as given away together on the IP harness.
Procedure
Press Space Bar and enter Synthesis; the Wiring Synthesis dialog box displays.
Deselect all of the steps apart from Generate Physical Harness Levels step again and click Go; a progress bar displays.
When CWS is complete, click Close; the system re-generates the physical harness levels for the harnesses.
View the Newly Re-generated Harness Levels for the IP Harness
You see the difference made by giving away the options together.
Procedure
Right-click the IP harness in the Design Browser (Design tab) and choose Define Harness Levels; the Define Harness Levels - Harness:IP dialog box displays.
There are now three harness levels:
Note that the Fog Lamps-REAR and Fog Lamps-FRONT options are included as giveaway on all three harness levels. This means that there is always a cost to this giveaway as the wiring for one set of fog lights is always redundant. However, it does reduce the number of harness levels which might result in a reduction in the cost of managing the part numbers.
Note that the harness levels display in red because they include mutually-exclusive options. This does not prevent you from working with them.
Parent Topic:
Giveaway
Related Topics
- Giveaway
Capital Systems Integrator User Guide, 2512.2606
Unpublished work. © 2026 Siemens
Source: https://docs.sw.siemens.com/en-US/doc/861057055/202511026.capital_si_user/id8209c32e-613f-4fe6-ba95-22669fec9e03 · retrieved 2026-07-18