*modent_addcontentsbyids
Adds entities to a modular entity via IDs.
Syntax
*modent_addcontentsbyids modular_entity_type modular_entity_id content_entity_type content_entity_ids representation_key
Type
HyperMesh Tcl Modify Command
Description
Adds entities to a modular entity via IDs. Selection by IDs is mainly useful for adding include entities, which cannot be selected by mark.
When modular entity is subsystem, only one include entity can be associated with it. Also, if an include entity is already associated with a subsystem, it cannot be re-associated with another subsystem.
Inputs
- modular_entity_type
- The type of modular entity to update. Valid values are subsystemconfigurations, subsystems and subsystemsets.
- modular_entity_id
- The ID of the modular entity to update.
- content_entity_type
- The type of entity to add.
- content_entity_ids
- A quoted list of the entity IDs to add. If modular_entity_type is subsystem and content_entity_type is include, only one content_entity_id can be used.
- representation_key
- The representation key of the subsystem to populate. This defaults to the only realized representation and can be omitted.
Examples
To add the contents of include ID 4 to subsystem ID
2:
*modent_addcontentsbyids subsystems 2 includes "4"
Errors
Incorrect usage results in a Tcl error. To detect
errors, you can use the catch
command:
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
2020
2022.2 – Only one includefile entity can be associated with a subsystem.