CapitalKnowledge

Harness Processing

Configuring the FEM Task for Depopulate Redundant Objects

You can use the DepopulateRedundantObjectsTask flexible execution model (FEM) task to depopulate redundant objects.

Prerequisites

  • You must have configured Capital Integration Server in the capitalintegrationserverconfiguration.xml file in the config directory of your installation. See The

capitalintegrationserverconfiguration.xml File Format for more information.

  • If you want to retain certain objects that would otherwise be depopulated, a Depopulate Objects (Wire Driven) Constraint must be configured on the design.

Procedure

  1. Create an XML file similar to the example shown below, and save it in the doc/webservice/data folder of your Capital installation.

  2. Edit the parameters. All parameters are mandatory unless otherwise stated.

Table 29: Description of Parameters Name

									Description

								

							

						

							
								
									ProjectName

								

								
									The name of the project.

								

							

							
								
									DesignName

								

								
									The name of the design.

								

							

							
								
									PartNumber

								

								
									The part number of the design.

								

							

							
								
									RevisionName

								

								
									The revision name of the design.

								

							

							
								
									DepopulateType

								

								
									
										
											DERIVATIVE — removes all
											objects that, following evaluation, will not
											appear on any derivative.

											Note 
											This action is only available on a composite design that has least one
											derivative defined. This functionality does not
											perform composite breakdown.

											

										

										
											WIRE — removes all objects
											that have no wire or multicore attached.

											Note 
											This action is only available on
											a design that contains at least one wire.
  1. Start the FEM task.

Results

  • You can monitor the tasks in the Tasks Tab in the Output Window, and access the log files. You can also access the log files in your temp folder.

  • The following messages may be shown on the Tasks tab of the client.

Table 30: Messages Shown While Executing the FEM Task

          Messages

        

        
          Description

        

      

    

      
        
          FEM Task {0} started for Project: {1} and Design: {2}:{3}:{4}

        

        
          {0} FEM task name

          {1} Project name

          {2} Design name

          {3} Part number

          {4} Revision name

          The FEM task has been initiated.

        

      

      
        
          Project {0} not found

        

        
          {0} Project name

          The project specified in the configuration file cannot be
            found.

        

      

      
        
          Design {0}:{1}:{2} not found

        

        
          {0} Design name

          {1} Part number

          {2} Revision name

          The combination of the design name, part number and revision name
            specified in the configuration file cannot be found.

        

      

      
        
          Unable to acquire lock on {0} Design {1}:{2}:{3}, it is currently
            locked by {4} since {5}

        

        
          {0} Design type (e.g. composite)

          {1} Design name

          {2} Part number

          {3} Revision name

          {4} User name

          {5} Timestamp

          The design is locked, and the FEM task has been aborted.

        

      

      
        
          Design {0}:{1}:{2} deleted from project {3}

        

        
          {0} Design name

          {1} Part number

          {2} Revision name

          {3} Project name

          The design was deleted from the project before the FEM task
            acquired a lock.

        

      

      
        
          FEM task {0} cannot be performed on design {1}:{2}:{3} as the
            release level does not allow edition

        

        
          {0} FEM task name

          {1} Design name

          {2} Part number

          {3} Revision name

          The release level of the design prevents the user from editing it,
            and therefore the FEM task cannot be run.

        

      

      
        
          FEM task {0} cannot be performed on design {1}:{2}:{3} as the user
            cannot edit the design

        

        
          {0} FEM task name

          {1} Design name

          {2} Part number

          {3} Revision name

          Either the user does not have permission to edit the design, or
            the design is assigned to a domain to which the user only has read-only access.

        

      

      
        
          FEM task {0} cannot be performed on inaccessible designs

        

        
          {0} FEM task name

          The design is assigned to a domain where the user does not have
            permission to access the design.

        

      

      
        
          FEM task {0} cannot be performed on design {1}:{2}:{3} as no
            license is available to open the design

        

        
          {0} FEM task name

          {1} Design name

          {2} Part number

          {3} Revision name

          No license is available to run the action.

        

      

      
        
          FEM task {0} cannot be performed on design {1}:{2}:{3} as the
            design cannot be accessed for unspecified reason

        

        
          {0} FEM task name

          {1} Design name

          {2} Part number

          {3} Revision name

          The design is not editable for a reason other than those described
            in this table.

        

      

      
        
          Parameter definition is invalid in the parameters file

        

        
          Some of the parameters are empty or missing in the specified
            parameters file.

        

      

      
        
          {0} is not able to process modular designs. Please use Harness
            Designer Modular instead

        

        
          {0} Application name

          If the specified design is a modular design, then Capital Harness
            Designer Modular must be used to run the FEM task.

        

      

      
        
          Design {0}:{1}:{2} does not contain any data

        

        
          {0} Design name

          {1} Part number

          {2} Revision name

          There is no data in the specified design.

        

      

      
        
          Harness Design {0} has diagrams with missing style sets

        

        
          The style sets are missing for one or more of the diagrams in the
            design.

        

      

      
        
          Task {0} failed to finish

        

        
          {0} FEM task name

          The FEM task failed or was only partially successful.

        

      

      
        
          Task {0} completed with no errors for Project: {1} and Design:
            {2}:{3}:{4}

        

        
          {0} FEM task name

          {1} Project name

          {2} Design name

          {3} Part number

          {4} Revision name

          The FEM task completed successfully.

        

      

    

				The following messages are specific to the Depopulate
					Redundant Objects Task.

Table 31: Messages Shown While Running Depopulate Redundant Objects by FEM Task Messages

									Description

								

							

						

							
								
									Invalid depopulation type {0}

								

								
									{0} Depopulation type from configuration file

									The specified depopulation type is not valid for the
										design.

								

							

							
								
									Design does not have any derivatives. Execution for selected
										depopulation type is not enabled

								

								
									The derivative-driven depopulation method has been selected, but there
										are no derivatives present in the design.

								

							

							
								
									Design does not contain any wires.
										Execution for selected depopulation type is not
										enabled

								

								
									The wire-driven depopulation method has been selected,
										but there are no wires present in the design.
  • If the task completes successfully, any redundant objects are removed according to the execution mode selected. See Depopulating Redundant Objects for more information.

  • If a Depopulate Objects (Wire Driven) constraint was configured, objects of the specified type matching the query will be retained, along with any supporting objects.

Examples

This is an example of the contents of a configuration file which can be used as a template for your own file.

Copy

<?xml version="1.0" encoding="UTF-8"?>
<FEMParameters>

  <!-- Project name -->
  <Param name="ProjectName" value="Aerospace Modular"/>

  <!-- Design name -->
  <Param name="DesignName" value="Aerospace Harness"/>

  <!-- Design Part number -->
  <Param name="PartNumber" value="AA12346_1"/>

  <!-- Design Revision -->
  <Param name="RevisionName" value="1"/>

  <!-- depopulate type: DERIVATIVE or WIRE -->
  <Param name="DepopulateType" value="WIRE"/>

</FEMParameters>

Parent Topic:

Harness Processing

Capital Harness Designer User Guide, 2512

Unpublished work. © 2025 Siemens

Source: https://docs.sw.siemens.com/en-US/doc/861057055/202410078.capital_hd_user/rce1694001356148 · retrieved 2026-07-18