*CE_UpdateLink

Allows search and replace of an existing link in the specified connector with a new link entity.

Syntax

*CE_UpdateLink id search_type search_id search_name ?search_rule? ?replace_type? ?replace_id? ?replace_name? ?replace_rule? ?replace_state? ?keep_current_state? ?search_uid? ?replace_uid?

Type

HyperMesh Tcl Modify

Description

Allows search and replace of an existing link in the specified connector with a new link entity.

Inputs

id
The connector ID to update.
search_type
The entity type to search in the connector. This must be specified. The supported entities are comps, props, assems, surfs, tags, elems, nodes and parts.
search_id
The link entity ID to replace in the connector. The ID is optional only if one of the following is true:
3 - Use name
4 - Proximity
5 - Use UID
search_name
The name of the link entity to replace in the connector. The name is optional only if one of the following is true:
1 - None
2 - Use ID
4 - Proximity
5 - Use UID
?search_rule?
The rule by which the link entity was added to the connector. The following codes define the different rules:
0 - Undefined
1 - None
2 - Use ID
3 - Use name
4 - Proximity
5 - Use UID
If the rule is specified, the entity search is performed in accordance with the rule. For example, a search_rule of 2 requires search_id.
?replace_type?
The type of entity that replaces the found link entity (search_type) in the connector. If not specified, the entity type information is not replaced for the found link (replace_type = search_type). The supported types are the same as that for search_type.
?replace_id?
The entity ID that replaces the found link entity. If not specified, the entity ID information is not replaced for the found link (replace_id = search_id).
?replace_name?
The entity Name that replaces the found link entity. If not specified, the entity name information is not replaced for the found link (replace_name = search_name).
?replace_rule?
The rule to set for the found link entity. All the rules supported for search_rule parameters are supported.
?replace_state?
The flag to set for the link entity that specifies if you are connecting to mesh or to geometry. The supported values are:
0 - Undefined
1 - Connect to mesh
2 - Connect to geometry
?keep_current_state?
Optional option to keep the current connector state after the update operation. Valid states are:
0 - Unrealize if needed (default)
1 - Keep current state
At most, one of the "replace" data must be specified to see a change in the link attributes. If the replace data exactly matches the search data, the connector is not unrealized and no change is made to the link entity.
?search_uid?
The UID of the link entity to replace in the connector. The UID is optional, only if search_rule is 1, 2, 3 or 4.
?replace_uid?
The entity UID that replaces the found link entity. If not specified, the entity UID information is not replaced for the found link (replace_uid = search_uid).

Examples

To replace component ID 10 with component ID 20 for connector ID 1:
*CE_UpdateLink 1 comps 10 "" 0 0 20 "" 0 0
To replace component name "comp1" with component name "bumper" for connector ID 1:
*CE_UpdateLink 1 comps 0 "comp1" 0 0 0 "bumper" 0 0
To replace use-id with use-name rule for component ID 10 for connector ID 1:
*CE_UpdateLink 1 comps 10 "" 2 0 0 "" 3 0
To replace the state for component ID 10 in connector ID 1 from "connect to elems" to "connect to geom":
*CE_UpdateLink 1 comps 10 "" 0 0 0 "" 0 2
Note: In all the above cases, the connector entity is unrealized and any existing welds are removed from the connector. At most, one of the "replace" data must be specified to see a change in the link attributes. If the replace data exactly match the search data, the connector is not unrealized and no change is made to the link entity.