Naming conventions can be defined for physical models and used to:
Note: Naming conventions can be only used to alter physical names (names) of model objects, NOT logical names (captions).
Naming conventions allow you to:
TIP:Toad Data Modeler comes with several CSV files to help you replace language-specific characters with English characters. The files are located in Documents | Toad Data Modeler | Installation Name | Naming Conventions | CSV.
To start using naming conventions, you can go to Tools Menu | Naming Conventions | Settings or click on Naming Conventions Toolbar.
In the Naming Convention Properties dialog | General tab, you can see options for:
This topic describes how various options affect the Naming Convention Verification and Synchronization process.
Note: Options mentioned in this topic also affect On Form Synchronization behavior.
Description: When enabled, Name/Caption synchronization will be checked during process.
Example: An entity Caption is "Example Entity" and its Name is "ex_entity".
A suggestion will be offered to rename the entity Name so it matches its current Caption - "Example Entity".
Description: When enabled, Naming Convention Rules will be applied and characters/words will be replaced according to Glossary during Name/Caption synchronization.
Example: An attribute Caption is "Customer main ID" and its Name is "Customer ID".
Automatic Synchronization enabled: The suggested Name will be synchronized with the object Caption and then have the NC Rule and Glossary word replacement applied to it - CSTMR MAIN ID.
Automatic Synchronization disabled: The option only affects manual synchronization (see On Form Synchronization for more information).
Description: When enabled, model objects will be automatically verified to see if they don't violate Naming Convention Rules. The verification will occur during Naming Convention Verification and Synchronization process and also when you open Properties dialog of any object.
Example: A relationship Name is "ASSIGNS_orders".
A suggestion will be offered to modify the Name so it matches the rules - "assigns orders".
To Use Glossary for Naming Convention Verification
Description: When enabled, Glossary character and word replacements will be applied during both Automatic Verification and manual verification.
Example: An entity Name is "Entrée kinds"
A suggestion will be offered to modify the Name so it matches the rule and has the defined characters/words replaced - "ENTREE TYPES".
To Turn Case-Sensitivity On
Naming convention rules can be defines in Naming Convention Properties (Tools Menu | Naming Conventions | Settingsor click on Naming Conventions Toolbar.)
Note: Click the particular column and use F2 to turn on the edit mode. Press Enter to confirm every rule you define in the form.
|Enabled||Enables set rule for particular Object Type.|
|Prefix||Defines a prefix for selected Object Type.|
|Suffix||Defines a suffix for selected Object Type.|
|Case||You can define Upper/Lower Case as a rule for object names.|
|Valid Chars||Lists characters that can be used in object name. The list can be configured in Valid Characters section.|
|Replacer||If set, replaces all invalid characters during verification and update.|
You can define a set of characters that can be used in object names. Characters outside the defined set will be considered invalid and will be replaced during verification and update process (either by Replacer, if defined, otherwise by a blank space).
To define valid characters, choose one of the three options.
All possible characters will be considered valid. You can choose to except space or any other characters. See Character Set Syntax for more information on how to specify a set of characters.
Only characters defined in this set will be considered valid. See Character Set Syntax for more information on how to specify a set of characters.
You can choose categories of characters that will be considered valid. Language Specific Characters can be also included, simply select one of the option from the menu. If you language is not present, you can create your own CSV file with characters specific to your language, see files in C:\Program Files (x86)\Quest Software\Toad Data Modeler\Naming Conventions\CSV as an example.
Example: Character set for letters a,b,c and numbers 0,1,2:
Naming Conventions also allow you to define valid and invalid characters.
On Naming Convention Rules tab you can define valid characters for physical names and also set how invalid characters should be replaced.
Example: Let’s say you have set a space as invalid character for entity names in your naming convention. See how Toad Data Modeler will behave in the following situation:
Customer Data logical name in the Caption box, will automatically change to CustomerData physical name in the Name box. -> The space will be ignored.
You edit the naming convention and define that every space should be replaced with '_'.
Customer Data logical name in the Caption box, will change to Customer_Data physical name in the Name box.
Once you manually edit the physical name, the automatic synchronization will turn off.
Use Character Replacement to replace diacritical characters. Do not use Character Replacement to replace a space with another character.
Use Word Replacement to replace one word with another word or more words. Word Replacement launches after characters are replaced.
Use this combination to define valid characters. Also, it is possible to replace invalid characters with an alternative character. Check of valid characters launches as last. See the example below.
ñ -> n
espanoles -> esp
residentes -> res
Space -> _
Toad Data Modeler proceeds in the following order:
1) "residentes españoles" -> "residentes espanoles"
2) "residentes espanoles" -> "res esp"
3) "res esp" -> "res_esp"
|Except Space Character||If it is selected, all characters are valid except for a space.|
Click this checkbox and manually write out character set that you want to forbid.
|User Defined Character Set||
Select this option to manually define character set. Incorrect definition will be highlighted in red.
|Selected Characters||Select any of the following options to set:|
|All Standard ASCII Characters (0-127)||- all standard ASCII characters valid, others are forbidden.|
- only Space (32) character as valid.
|Number '0'-'9'||- number 0 – 9 as valid.|
|Lower Characters||- only lower characters as valid.|
- Underscore 95 as valid.
(Number 95 is an ordinal value of the Underscore character.)
|Upper Characters||- only upper characters as valid.|
|Language Specific Chars||
- a diacritical character set of the particular language as valid. Click the box on the right to select the language.
|Valid Chars Column||
In this column, a complete character set is written out – according to your settings in the Valid Characters area.
Define a character that will be used as a replacer.
Example: underscore character.
Example: Character set for letters a,b,c and numbers 0,1,2: