Finding and Replacing Property Values, Attribute Values, and Symbols

From Capital Logic Designer and Capital Systems Integrator, you can find and replace attribute values, property values, and symbols across multiple designs and diagrams, a build list, or an entire project. Changes are made to Capital Logic Designer designs only.

Procedure

1. Press the space bar and enter Find and Replace. The Find and Replace dialog box is displayed.

2. Specify the Scope:

                        Scope — Select the
                            project, build list, designs, or diagrams to search. If build lists
                            exist, they are listed above the designs.
   

3. The filter symbol in the Scope section indicates whether a filter has been set or not .
   If a filter is applied but no longer required, click the Clear Filter button. To configure a filter for the search, click the Set Filter button to display the Find and Replace Filters dialog box, and specify the following options:
   
   Object Types — Select the object types to include in the search. You can click the Clear Selection button to clear the selection at any point. Note If you search for pins, the search results include backshell terminations. If you search for devices, the search results also include ground devices.
   
   
   Revision — Specify the design revision to search. You can select the Latest Revision Only check box to search across the latest revision only.
   
   Release Level — From the dropdown list, select no release level (blank) or a release level across which you want to search.
   
   Abstraction — From the dropdown list, select no abstraction level (blank) or an abstraction level across which you want to search.
   
   Domain — From the dropdown list, select no domain (blank) or a domain across which you want to search.
   
   Effectivity (Only visible if effectivity functionality is enabled for the project in Capital Project Manager) — Specify the effectivity range within which you want to search.
   
   Click OK to close the Find and Replace Filters dialog box.

4. In the Find section, specify what you are searching for and potentially want to replace. The behavior of the search depends on whether you select Exact Match or Match Case for the fields in this section: Neither are selected The search finds appropriate objects/attributes/values that contain the string entered in the box, regardless of whether any characters are uppercase or lowercase. For example, you search for an Attribute/Property of “model”. The search will find any object with an attribute or property whose name contains the string “model”. As this is not case-sensitive, it will find the string regardless of whether any characters are uppercase of lowercase in it (for example, “Analysis Model” would be found).

Exact Match is cleared and Match Case is selected The search finds appropriate objects/attributes/values that contain the string entered in the box with the same uppercase and lowercase characters. For example, you search for an Attribute/Property of “model”. The search will find any object with an attribute or property whose name contains the string “model”. As this is case-sensitive, it will not find the string if any of the characters are in a different case (for example, “Analysis Model” would not be found but “Vehicle model” would be found).

Exact Match is selected and Match Case is cleared The search finds appropriate objects/attributes/values that match the exact string entered in the box, regardless of whether any characters are uppercase or lowercase. For example, you search for an Attribute/Property of “model”. The search will find any object with an attribute or property whose name exactly matches the string “model”. As this is not case-sensitive, it will find the string regardless of whether any characters are uppercase of lowercase in it (for example, “Model” and “model” would be found but “Analysis Model” would not be found).

Exact Match and Match Case are both selected The search finds appropriate objects/attributes/values that match the exact string entered in the box with the same uppercase and lowercase characters. For example, you search for an Attribute/Property of “model”. The search will find any object with an attribute or property whose name exactly matches the string “model”. As this is case-sensitive, it will not find the string if any of the characters are in a different case (for example, “model” would be found but “Model” and “Analysis Model” would not be found).

				Be aware if you define a regular expression string, this is only applicable
					to the Find action, not the Replace action.

You can specify the following: Tip In the following fields, to search for a special character such as $, ensure that you type a delimiter () before it. For example, $.

Object Name — Enter a full name or part of a name using wildcards to limit the search to objects with particular names.

Attribute/Property — Specify the attribute or property name. You can enter the name manually or select it from the dropdown list in the field.

Matches — Specify the value of the attribute or property. If Exact Match is selected, every value string found will be fully replaced by the content in the replace section. If Exact Match is cleared, each and every occurrence of the string entered will be replaced by the content in the replace section. For example, find “AB” and replace with “C”, results in the renaming of “Property=ABDAB” with “Property=CDC”. If nothing is specified here, the entire value strings of the attribute/property occurrences found will be replaced by the content in the replace section. For example, find “AB” and replace with “C”, results in the renaming of “Property=ABDAB” with “Property=C”.

Symbol — To search objects that use a particular symbol only, click the ellipsis button (...) to display the Symbol Selection dialog box, browse the available symbol libraries, and select the symbol. The symbol is displayed in a Preview window. Select Show Origin to display the symbol origin on the symbol. You can click the Clear button to clear the symbol selection.

5. In the Replace section, you can specify the following:

                        Attribute/Property —
                            The attribute or property name to replace the attribute or property
                            names found by the search. You can enter the name manually or select
                            it from the dropdown list in the field. The properties listed are
                            those created at the project level and are not those created on the
                            fly for an instance of an object. The attributes listed are only
                            those applicable to the specified objects.
   
                    
   
                    
                        Value — The property
                            value to replace the property values found by the search.
   
                    
   
                    
                        Symbol — Select the
                            symbol to replace the symbols found by the search. Click the
                            ellipsis button (...) to
                            display the Symbol Selection dialog box, browse the available symbol
                            libraries, and select the symbol. The symbol is displayed in a
                            Preview window. Select Show
                                Origin to display the symbol origin on the
                            symbol.
   
                        You can click the Clear button  to clear the symbol selection.
   
                    
   
                    
                        Update Symbol Only —
                            Select to replace only the symbols used for the found objects and
                            not their attributes or properties. You cannot replace comment
                            symbols or symbols associated to library parts.
   
                    
   
                    
                        Preserve Pin
                            Positions
   
                        Select to retain the pins on the symbol instance
                            where they are on the diagram.
   
                    
   
                    
                        Remove Properties not on
                                Symbol
   
                        Select to remove any properties from the symbol
                            instances that are not on the symbol in the symbol library.
   
                    
   
                    
                        Copy Attribute/Property Values from
                                Symbol
   
                        Select to copy any properties and attributes that
                            are on the symbol in the symbol library to the symbol instances.
   
                    
   
                    
                        Preserve Attribute
                                Text
   
                        The attribute visibility settings on a diagram
                            instance of a symbol may be different to the attribute visibility
                            settings on that symbol in the symbol library. If selected, the
                            attribute visibility settings on the symbol instance on the diagram
                            are retained. If cleared, the attribute visibility settings on the
                            diagram instance are overwritten by those on the symbol in the
                            library.
   
                    
   
                    
                        Preserve Diagram Pin
                                Name
   
                        On a diagram, you can rename a pin name on a symbol
                            instance. If selected, the pin names on the diagram are retained.
                            If cleared, the pin names on the diagram are replaced by the pin
                            names from the symbol in the symbol library.
   

6. Click one of the following buttons:Find — Finds the specified attributes and properties but does not replace any values. The Output window displays the found objects on the Find and Replace tab. You can select an object name to view that object on a diagram.

Preview — Previews the changes that would be made if you did a replace but does not change the actual designs. The changes are displayed on the Find and Replace tab in the Output window but are not applied to the actual design. You can select an object name to view that object on a diagram.

Replace — Finds and replaces the specified values. This works on editable designs only. If the replace action affects a shared object, the design is saved automatically. This button is dimmed if the Replace section does not contain valid data. The objects with replaced values are listed on the Find and Replace tab in the Output window. You can select an object name to view the object on a diagram. Some replacement values may be invalid for some of the found objects and the Find and Replace tab lists these as errors.

7. If you are replacing values, a message states that the operation cannot be undone and you must confirm whether to proceed. You can select a check box so that the message is not displayed again.
   If you are replacing symbols and the replacement symbol has a different number of pins to the symbol instance, the Map Pins Dialog Box is displayed to map the pins from the replacement symbol to the pins on the symbol instances. You can also specify which data on the symbol instance to preserve and which to remove.

Parent Topic:

Modifying Objects

Capital Logic Designer User Guide, 2512

Unpublished work. © 2025 Siemens