Circuit Builder: To Format the Numeric Tag of the Motor Symbol into Other Component Tags

You can include the motor symbol tag number assignment in other components in the circuit. It requires coordination between the motor symbol insertion and the insertion of the other components. The motor symbol must insert before these other components. The order of insertion is controlled by the ORDER attribute value on the marker blocks within the circuit template drawing. The marker block ORDER attribute value for the motor symbol must be a lower number than the ORDER values of the marker blocks for the other components in the circuit template drawing. When the other components are inserted, the motor tag value can be incorporated into the subsequent component tags.

1. Open the Circuit Builder spreadsheet, ace_circuit_builder.xls.
2. Find the circuit CATEGORY and TYPE, for example CATEGORY: 3ph Motor Circuit and TYPE: Horizontal - FVNR - non reversing.
3. Open the circuit code sheet with the same name as the SHEET_NAME value, for example SHEET_NAME: 3ph_H.
4. Find the motor symbol, for example CODE: MTR03, COMMENTS: Motor symbol, UI_PROMPT_LIST: 3ph motor.

   There can be multiple selections within the group. For example, there is a selection for the type of disconnecting means, and a selection to include an auxiliary contact. Each selection is assigned a numerical value from the UI_VAL field. The values are added together to determine the appropriate action for this combination of selections. The sum is matched to a value in the UI_SEL field. Once this match is made, the COMMAND_LIST value, ANNOTATE_LIST value, and so on, are used to insert and annotate the selections.

5. Edit the API call in the ANNOTATE_LIST column for this component. For example, it might look like this with two API calls concatenated:

   (c:ace_cb_anno #data 0)(c:ace_cb_save "@MOTOR_NUM@" "TAG1*" nil 1)

   The second one, c:ace_cb_save, saves the TAG1 attribute value on the motor in to memory under an index tag of “@MOTOR_NUM@”. This value can be referenced when the subsequent component marker blocks are processed.

   Note: See the API documentation for more information on c:ace_cb_save.
6. Find the component you want the tag to follow the motor tag, for example CODE: CAP01, COMMENTS: Power factor correction capacitor.
7. Edit the API call in the COMMAND_LIST column for this component. For example, it might look like this:

   (c:ace_cb_insym #xyz nil "VCA113_1-" #scl 8 "%N=@MOTOR_NUM@")

   The last argument of this API call, “%N=@MOTOR_NUM@”, tells Circuit Builder to use the TAG1 value from the motor, saved as “@MOTOR_NUM@”, as the number part of the tag for this component. For example, if the component tag format is defined as “%S-%F-%N”, the numeric part of the motor tag is used for the “%N” part of the generated component tag.

   You can also define this using a fixed _TAGFMT option. Using this approach overrides the component tag format defined for the drawing. Some examples:

   • "_TAGFMT=%F@MOTOR_NUM@" - used with the component family code string, %F.
   • "_TAGFMT=%S-@MOTOR_NUM@%F" - used with the SHEET_NAME value of the drawing, %S.
   • "_TAGFMT=CA@MOTOR_NUM@" - used with a defined text prefix.
8. Repeat for each component that should base the tag value off the motor tag value.
9. Save the spreadsheet.

Note: It can also be done by defining the MISC1 attribute on the marker blocks for each component as described in the topic To Format the Numeric Tag of the Motor Symbol in a Wire Number.