SCHLIB List

Old Content - visit altium.com/documentation

Function

The SCHLIB List panel allows you to display design objects associated with one or more schematic components in tabular format, enabling you to quickly inspect and/or modify object attributes. When used in conjunction with the SCHLIB Filter panel, it enables you to display just those objects falling under the scope of the active filter - allowing you to target and edit multiple design objects with greater accuracy and efficiency.

Content and Use

The panel is divided into two main regions:

  • filtering controls to define which objects are displayed in the panel (display scope)
  • a tabular, spreadsheet-like region listing all objects falling under the defined display scope.

Defining Panel Display Scope

Controls at the top of the panel allow you to filter which objects are displayed in the panel and also control the current mode of the panel - allowing you to enable/disable the panel's direct editing functionality.

Click on the leftmost underlined control to select from the following options:

  • View - configure the panel in View Mode. In this mode you will only be able to use the panel for viewing object attributes. You will not be able to edit any of the attribute fields in the tabular region of the panel
  • Edit - configure the panel in Edit Mode. In this mode you will be able to view and edit the attributes of design objects, directly in the tabular region of the panel.

Click on the next underlined control to select from the following options:

  • non-masked objects - this is the default option and causes the panel to display only design objects that are not masked-out in the workspace (i.e. those objects that fall under the scope and specific query expression of the currently applied filter). This option is most effective when filtering is applied to the workspace and the associated masking highlight option is enabled
  • selected objects - causes the panel to display only design objects that are currently selected
  • all objects - causes the panel to display all design objects.

Click on the next underlined control to choose from the following options:

  • current component - only display target objects from the active library component in the design editor window
  • all components - display target objects from all components contained in the active schematic library document

The right-most underlined control allows you to determine the type of objects that can be displayed. Clicking on the control will reveal a selection pop-up.

Use the pop-up to choose which object types you wish to include in the currently displayed list - either all objects or specific objects. To choose one or more specific object types, enable the Display only option and then enable the check box next to the required object(s) in the list beneath. The list will only contain those object types currently displayed in the main spreadsheet region of the panel.

When enabling specific object types for display, the control will reflect the choice by listing the enabled types, separated by commas.

Working with Filtered Objects

The main region of the panel displays all design objects passing the defined display scope for the panel, in tabular format.

Object data is initially unsorted. Data may be sorted by any attribute by clicking on the header for that attribute's column. Clicking once will sort in ascending order. Click again to sort by descending order.

Displaying Workspace Selection

As you select objects in the design workspace, the corresponding entries for those objects will appear selected in the list. A selected object is distinguished in the list by the use of a non-white background for all of its cells.

Displaying Filtering Results

When a filter has been applied, based on a query expression entered into the SCHLIB Filter panel, only those objects under the scope of the filter will be shown, provided that:

  • the Mask out option is enabled in the Objects not passing the filter area of the SCHLIB Filter panel
  • the Display option for the SCHLIB List panel is set to non-masked objects.

If the Select option has been enabled also, in the Objects passing the filter area of the SCHLIB Filter panel, all filtered objects will appear selected in the list.

Using the Panel to Select Objects in the Workspace

As you select entries for design objects in the list, those objects will become selected in the design workspace. The list supports single or multiple selections, the latter using standard CTRL + Click, SHIFT + Click and click-and-drag features.

Double-clicking on an entry will bring up the corresponding properties dialog for that object, from where you can make changes as required.

Editing Object Attributes

You can edit attributes of an object by editing the relevant entry in the panel. Click on a cell to focus it and then either right-click and choose Edit or click again to edit the attribute value directly. Depending on the attribute, you will either need to type a value, toggle a checkbox or select an option from a drop-down. The change will take effect once you press ENTER or click outside of the field you are editing. This is one of the advantages of using the panel to edit object properties - the panel will remain open, allowing you to change attribute after attribute, as needed, without having to close and reopen a properties dialog each time.

Another advantage of using the panel for editing is that you can edit multiple objects from the one place, without having to edit, through dialogs, one object at a time. Selected objects can be of the same or differing type. Those attributes that are common to all objects in the selection will be displayed in the panel. Select the required cells - across all required objects - for the shared attribute you wish to modify. Then either right-click and choose the Edit command or press the F2 key (or the SPACEBAR). You will be able to edit the value for the chosen attribute with respect to the focused object in the selection (whose cell is distinguished by a dotted outline). Clicking outside the attribute's cell or pressing ENTER will effect the change, which will subsequently be applied to all remaining objects in the selection.

By using filtering, you can apply a query (an expression for the filter) to target a specific group of objects in one or more components in the active library and then use the SCHLIB List panel to edit the attributes for these multiple objects, directly.

Note: Editing is only possible if the panel is configured in Edit Mode. When the panel is configured in View Mode you will, as the name suggests, only be allowed to view object properties.

Editing Attributes with Smart Grid Paste tools

There are two Smart Grid commands available as right-click options from the SCHLIB List panel of the Schematic Library editor. These commands allow you to import and create, or update, tabular data from any windows compliant tabular/spreadsheet data such as an Excel workbook or a table in a PDF document in the SCHLIB List panel.

The Smart Grid Paste command alters the value of existing objects from pasted tabular data, and Smart Grid Insert creates new objects from the tabular data. The SCHLIB List panel must be in the Edit mode in order to have copy and paste commands enabled.

Using Smart Grid Paste Command

There are two main ways to update attributes of design objects using the smart grid paste command - updating attributes one at a time with no header data, and updating attributes as a group in one go with header data.

You have to determine whether the tabular data has the Header Row or No Header Row. These options are located at the top right of the Smart Grid Paste dialog. If the tabular data has the header row, then you can map and update multiple attributes in one go otherwise, you will have to do different attributes one by one.

For example, to change attributes as a group using the smart grid paste tool, copy the data using the Copy With Header command from the right click pop up menu from the SCHLIB List panel and paste the tabular data including the header row in an Excel workbook. The updated tabular data from this workbook can then be pasted back into the same SCHLIB List panel using the Smart Grid Paste command from the pop up menu. Make sure the selected entries in the SCHLIB List correspond to the pasted tabular data; however you can always select the entries first before doing a paste.

Make sure the Header Row option on the top right of the dialog is enabled. The Smart Grid Paste dialog is then updated with the top half of the dialog representing the copied table data while the bottom half shows the proposed SCHLIB List content. Thus click the Automatically Determine Paste button to map the attributes from the Clipboard Table View to the SCHLIB List View.

All proposed data object mappings set by the Automatically Determine Paste button can be previewed before committing the new attributes to your schematic library document. Attributes that are being targeted by the Paste action are marked with a blue flag, and those whose values are changing are marked in a bold font.

You can also use Paste Column to Attribute and Undo Paste to Attribute buttons to update attributes selectively. To restore all the attributes to their original values, click on the Reset All button in this Smart Grid Paste dialog.

Likewise, if you copy the tabular data without the row header and update the tabular data in an external spreadsheet and do a smart paste back into the SCHLIB List panel, you can only do a singular update of each attribute. That is, you use the Paste Column to Attribute and Undo Paste to Attribute buttons to update each targeted attribute and to undo this same attribute each time. The proposed changes are not committed to the Schematic document until the OK button is pressed.

Using the Smart Grid Insert Command

With the Smart Grid Insert command, you can create new objects using the Smart Grid Insert dialog from the SCHLIB List panel. You must specify the object type in your tabular data before you can successfully insert new objects in the SCHLIB List and its associated schematic document.

The easiest way is to copy the existing object data from the SCHLIB List using the Copy with Header command and make additions/changes in a spreadsheet and insert the updated data back in the SCHLIB List panel. Once the new data objects are mapped from the Clipboard View to the proposed List View in the Smart Grid Insert dialog, they are flagged with green indicators. Click OK to close this dialog and to create new objects on the schematic library document.

Editing Attributes with Numeric Values

For a numerical-based attribute of an object, the simplest modification to that attribute's value is made by typing a new value to replace the existing one. The plus and minus operators can be used to specify the value's sign. A value entered without a specified sign is assumed to be positive. Therefore entering 20 is the same as entering +20.

You can enter specific units of measurement for a value entered. The software will convert the value into the current units defined for the document. If no units are specified, the default units set for the document will be used.

Modification Using an Expression

More advanced modification can be achieved by using an arithmetic expression. Simply select the entry for the attribute you wish to modify and type the expression that will be used to modify its value. You can enter any arithmetic expression, using any built-in arithmetic operators and functions (found in Pascal).

If you wish to use the current value for the attribute as part of the expression, you will need to make reference to this original value, either by using the full name of the attribute, or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). If you wish, you may use any other attribute field name in an expression. When using attribute names, if any names contain spaces, these must be replaced by the underscore character.

To illustrate an example of using a simple expression, consider a component pin, the Length attribute of which is currently 30. If you wanted to extend this length to 45, you could enter the expression:
Length + 15
or, in shortened form:
! + 15
Note that the spaces are optional. When you press ENTER, the value will be updated to 45.

If instead you want to shorten the pin to a length of 20, you could use the subtraction operator, as illustrated by the following expressions:
Length - 10
! - 10

To illustrate use of a function, the previous expression could be re-written as:
! - sqrt(100)
the result would be the same - a length of 20.

By using the attribute's name (or substitution character (!)) the previous expressions add to or subtract from the current value for the attribute. Without such entries in the expression, you would be setting the attribute's value to the evaluated result of the expression. For example, if the attribute name or substitution character had been left out of the previous expressions, the resulting pin length would have been 15 and -10 respectively.

Again, you can enter specific units of measurement for a value entered into an expression. The software will convert the value into the current units defined for the document. If no units are specified, the default units set for the document will be used.

By selecting multiple objects in the panel, you can change numerical attributes simultaneously using an expression. For example, you may want to adjust the length of a series of component pins, or shift components vertically or horizontally by a specific distance.

Batch Replacement of String-based Attributes

There are times when you may want to modify a string-based attribute that is common to multiple selected objects in the workspace. For example you may wish to rename the display names of selected pin objects from D1, D2, D3, etc, to Data1, Data2, Data3, etc. To perform this type of batch replacement, the use of string substitution syntax is supported in the panel.

A string substitution entry is enclosed in braces and has the form:
{oldstring=newstring}

An entry of this form causes all occurrences of oldstring found in the attribute's value to be replaced with newstring. In the case of the pin display names, you would select the associated Name attribute cell for each pin, right-click and choose Edit (or press F2), and then enter {D=Data} in the active value field.

Should you wish to replace multiple, differing string portions in the same target string, type multiple substitution entries, each enclosed in its own set of curly braces. For example, consider the following display names, associated with output pins of a component:
INTA
INTB
INTC
INTD

If the intended format for new display names is to be EXT_INT_x - where x represents 1, 2, 3, 4 - then you could select the Name attribute for the four pins in the panel, enter edit mode and then enter the following into the active value field:
{INT=EXT_INT}{A=_1}{B=_2}{C=_3}{D=_4}
The software takes this entry and effectively performs a batch substitution - substituting for the first expression, then the second, and so on.

Smart Editing of String-based Attributes

The SCHLIB List panel offers further support for string modification through its Smart Edit feature. Select the cell entries pertaining to the attribute that you wish to modify, for all required objects, right-click and choose Smart Edit from the menu that appears. The Smart Edit dialog will appear.

The dialog offers two methods for performing string modification, accessed from the Batch Replace and Formula tabs respectively.

Batch Replace Tab

This tab provides simple straightforward substitution, along the lines of the string substitution discussed previously (but without having to enter the curly braces). Click inside the From field and enter the portion of the current string that you wish to replace. Then click inside the To field and enter the string to be used as the replacement. The familiar string substitution syntax is displayed at the bottom of the tab.

For example, consider pins of a component that have the prefix D as part of their Display Name, but you need to change them to have prefix DATA instead. In this case, select the Name attribute for each of the pins in the panel and access the Smart Edit dialog. Then on the Batch Replace tab, enter D in the From field and DATA in the To field (the replacement string is therefore {D=DATA}). After clicking OK, the Display Names will be modified accordingly.

As with basic string substitution, the Batch Replace tab provides for replacement of multiple, differing string portions in the same target string. Enter the various substitutions as distinct From-To entries. Consider the previous INTx example (see Batch Replacement of String-based Attributes), where strings of the form INTx (x = A, B, C, D) need to be changed to EXT_INT_x (x = 1, 2, 3, 4). In this case, you would enter four distinct substitution entries on the Batch Replace tab, as shown.

Formula Tab

This tab provides for more advanced modification, allowing you to apply a specific expression to the selected string objects. The expression can include any built-in arithmetic operators and functions that apply to strings (found in Pascal). Once again, if you wish to use the current value for the attribute as part of the expression, you will need to make reference to this original value, either by using the full name of the attribute, or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). When using attribute names, if any names contain spaces, these must be replaced by the underscore character. So, for example, use of the Pin Designator field within a formula should be entered as Pin_Designator.

Consider for example three pins specified for a schematic component, with designators 1, 2 and 3. You might want to extend the designators of these pins by including some indication of their role. First select the cell entries for the Pin Designator attributes of these pins. Then, using the addition operator, you could write an expression to add to the existing string value of the Pin Designator attribute. This would take the existing (original) string value and concatenate it with a specified new string, as illustrated below:
'ADDR_' + Pin_Designator
or, in shortened form:
'ADDR_' + !
Note that the spaces are optional. After clicking OK, the designators of the pins will be updated to ADDR_1, ADDR_2 and ADDR_3 respectively.

To illustrate the use of string-based functions consider the Copy function, which can be used to take a portion of an original string and place it within an expression to create a new string. Consider pin display names of the format DATA_I_x[7..0], that now need to be changed to the format EXT_DATI_x[31..0]. In this case you could select the cell entries for each pin's Name attribute, access the Smart Edit dialog and write the following expression on the Formula tab:
'EXT_' + Copy(Name,1,3) + 'I' + Copy(Name,7,3) + '31..0]'
or, in shortened form:
'EXT_' + Copy(!,1,3) + 'I' + Copy(!,7,3) + '31..0]'

Right-click Menu

The right-click pop-up menu for the main list area of the panel provides the following commands:

  • Edit - this command allows you to edit single or multiple selected objects with respect to a particular attribute in the list. When editing a single object, the command becomes available when an attribute cell entry for a design object is editable. After launching the command you will be able to edit the value in the selected cell directly. Click outside the cell or press Enter to effect the change.
    When editing multiple objects simultaneously, the command will only become available if the chosen attribute is editable for all objects in the selection. After launching the command you will be able to edit the value in the focused cell directly. Click outside the cell or press Enter to effect the change across all cells in the selection. (See Editing Object Properties)
  • Smart Edit - this command provides access to the Smart Edit dialog, from where you can specify the criteria used to perform batch replacement of string-based attributes. (See Smart Editing of String-Based Attributes)
  • Copy - allows you to copy the selected cells in the list to the Windows clipboard, for use in other applications
  • Paste - allows you to paste the current content of the Windows clipboard into the list. Combined with the Copy command, this enables you to copy cell content out to another spreadsheet application, make modifications and then paste the modified data back into the SCHLIB List panel
  • Show Children - this command is used to add object entries to the list with respect to the primitives that constitute group objects (e.g. Parts)
  • Zoom Selected - zooms and centers (where possible) the selected objects in the design editor window
  • Report - use this command to generate a report containing all objects displayed in the list. After launching the command, the Report Preview dialog will appear from where you can peruse, print and export the report in various file formats. The report will contain only data that is visible in the panel
  • Report Selected - use this command to generate a report containing only those objects that are currently selected in the list. After launching the command, the Report Preview dialog will appear from where you can peruse, print and export the report in various file formats. The report will contain only data that is visible in the panel
  • Select All - this command is used to select all objects in the list. The corresponding design objects will become selected in the main design workspace
  • Select Column - this command is used to select all cells in the column associated with the currently selected cell. All corresponding objects will become selected in the design workspace. This command is particular useful when editing a particular attribute of multiple objects

  • Choose Columns - provides access to the Columns Setup dialog, from where you can determine which of the available attribute columns are displayed in the panel and the order in which the columns appear. By default, the Display Mode for each attribute will be set to Automatic. In this mode, an attribute column will be automatically displayed if it is common to all design objects currently displayed in the panel. Clicking on the mode will pop-up options that allow you to force the display of the attribute or hide it completely.

List Shortcuts

The following table summarizes key shortcuts that are available when using the main list region of the panel:

Arrow Keys

Shift focus to next cell in direction of arrow key

Left-Click & Drag

Multi-select in direction of mouse movement

CTRL + Click

Multi-select (non-sequential)

SHIFT + Click

Multi-select (sequential)

SPACEBAR or F2

Edit selected cell

ENTER

Finish editing current cell and enter edit mode for cell beneath

CTRL + C (or CTRL + INSERT)

Copy

CTRL + V (or SHIFT + INSERT)

Paste

PAGE UP

Jump selection to top of visible list area

PAGE DOWN

Jump selection to bottom of visible list area

Mouse-wheel

Pan up or down

Notes

  • Pressing SHIFT + F12 will toggle the visibility of the panel in the workspace.
  • When any filtering currently applied to the workspace is cleared, the option to display non-masked objects in the panel will produce the same result as choosing the option to display all objects.

See Also

You are reporting an issue with the following selected text and/or image within the active document: