CapitalKnowledge

Harness Designs > Auto Create Components

Configuring the FEM Task for Auto Place Components

You can use the AutomaticComponentPlacementTask flexible execution model (FEM) task to automatically place components in a design.

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.

  • At least one configured Auto Create Component constraint must be present on the design. If no constraint exists then no components will be added. See Auto Create Component

Constraints Overview.

Procedure

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

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

Table 4: 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.

								

							

							
								
									ComponentsToPlace

								

								
									Specifying "All" will place all the components for which
										an Auto Create Component constraint exists on the
										design.

									Alternatively, specify one or more object types in a comma separated
										list.

									Objects will be placed in the order in which they appear
										in the list.

									Supported object types are:

									
										
											WireEndComponents

										

										
											McEndComponents

										

										
											Clips

										

										
											Grommets

										

										
											OtherComponents

										

										
											Splices

										

										
											Devices

										

										
											SpotTapes

										

										
											BreakoutTapes

										

										
											AdditionalComponents
  1. Start the FEM task.

Results

  • Components are placed according to the configured Auto Create Component constraints, in the order defined in the ComponentsToPlace parameter in the configuration file.

  • 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 application.

Table 5: 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 Automatic
					Component Placement Task.

Table 6: Messages Shown While Running Automatic Component Placement Task Messages

									Description

								

							

						

							
								
									Automatic Component Placement is not
										applicable to the design {0}:{1}:{2}

								

								
									{0} Design name

									{1} Part number

									{2} Revision name

									The Automatic Place Components action is
										not applicable to the design type, for example, if the
										design is a merged formboard.
  • After creating the components in the design, the design is saved. An audit trail event "Design Saved" is recorded, with the description "Design saved by task - Automatic Component Placement Task."

Examples

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

Objects are placed in the order in which they appear in the comma separated list. In this example, wire end components are placed first, followed by multicore end components, then clips, etc.

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"/>

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

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

  <!-- Object types to place -->
  <Param name="ComponentsToPlace" value="WireEndComponents,McEndComponents,Clips,Grommets,OtherComponents, Splices,Devices,SpotTapes,BreakoutTapes,AdditionalComponents,All"/>

</FEMParameters>

Parent Topic:

Auto Create Components

Capital Harness Designer User Guide, 2512

Unpublished work. © 2025 Siemens

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