Altium NEXUS Documentation

BatchRenameByTemplate

Modified by Susan Riege on May 11, 2019

Parent page: UnifiedComponent Commands

The following pre-packaged resource, derived from this base command, is available:


Applied Parameters: None

Summary

This command is used to rename one or more selected components in the active Component Library document, on-the-fly, using a different naming scheme to that defined as the default scheme for the document.

Access

This command can be accessed from the Component Library Editor, when configured in Batch Editor mode, by:

  • Selecting a single component definition (in the lower grid region) and choosing the Edit » Operations » Rename Component command from the main menus.
  • Right-clicking over a component definition (in the lower grid region), and choosing the Operations » Rename Component command from the context menu.
  • Selecting n component definitions (in the lower grid region) and choosing the Edit » Operations » Rename n Components command from the main menus.
  • Right-clicking over a component definition (in a group of n selected definitions in the lower grid region), and choosing the Operations » Rename n Components command from the context menu.
If the Component Library Editor is currently in Single Component Editor mode, switch to the Batch Editor mode using the Tools » Switch to Batch Editor command.

Use

After launching the command, the Component Name Template dialog will appear. Use this dialog to specify the required Naming Scheme, and control the Initial Index.

Note that the dialog will initially show the default naming scheme entered in the Document Options dialog. If you leave this scheme, you will not be able to change the Initial Index. The latter can only be changed if a different naming scheme is used.

After defining the scheme as required, click OK - the component definition(s) will be renamed according to this defined scheme.

Parameter-based Name Templates

The CmpLib Editor provides support for the use of parameter-based Component Name Templates. Such templates allow you to precisely name, or rather rename your components, based on the currently defined values of parameters available to those components in the CmpLib file. Include a parameter into the naming template using the format [<ParameterName>]. Examples might be:

  • CMP-[Value]
  • CMP-[Part Number]
  • [Comment]
  • [Comment]-[Value]
  • [Value]
  • [Part Number]

You can also use multiple parametric declarations in your templates, for example:

  • CMP-[Part Number]-[Value]
  • CMP-[Manufacturer Part Number]-[Value]-[Tolerance]

In addition, and purely optional, you can also add an iterator macro, specified within curly braces (e.g., {000}, {00A}), for example:

  • CMP-[Value]-{001}
  • CMP-[Part Number]-{00A}

Tips

  1. The naming scheme used in the renaming process is only used for that process. It does not replace the defined default naming scheme for the document. If you want additionally-added component definitions to be named using this same scheme, ensure that you define this scheme at the document level by changing the Component Naming field in the Document Options dialog accordingly.
  2. The Item ID for an individual component definition can also be changed directly in the grid. Click once to focus the Item ID cell, then click again (or press F2) to enter in-place editing. Change the name as required. Note that the use of parameteric decalrations is not supported when directly editing the name in this way.

 

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.