◷ Reading Time: 5 minutes
What is a Business Glossary?
A business glossary is a dictionary that defines all the business terminologies. A business terminology (i.e., Term) is a word or set of words that have a meaning in your business domain. The main benefit of using a Business Glossary is the reusability of business definitions (i.e., Terms) so that you can reuse all the terms in different glossaries with different logic (e.g., business rules documents).
For example in the insurance industry:
- Car Price
- High-Risk Cars List
are terms in that domain.
Terms are a fundamental part of your business language – they have a Domain (type) and an Expression associated with them. Once the terms are defined within the business glossary they can be used throughout the following rule documents:
Business Terms for execution must have their expression defined. But for modeling purposes only, you can skip defining their expressions and leave that for later. The Terms’ expression can be based on the rule or logic context. The context of a logic or rule document is defined by its input and output parameters.
To add a new Business Glossary document,
Document Types --> Business Concept --> Business Terms
Business Glossary Properties
- Name: Name of the glossary
- Variable Definition: Define variables to be used in the glossary
- Types Definition: List of Types and Functions
It will only have one item which is Term.
At the top menu, you can see the following items.
- Add New Term: Adding new terms to the glossary
- Delete a Term: Deleting a term from the glossary
- Find Term Usages: Find the usage of a term in a project
- Properties: Properties of the glossary
- Filter: Search a term in the glossary
- Add Synonym or Translation: A different language can be selected from the list to add as a translation or add a synonym
If you click on the Domain of a term, the term property window will appear.
- Expression: Expression of the term
- Term: Name of the term
- Domain Type: Type of the term (String, Numeric, Date time, Boolean, Range, Options)
- Dynamic Options: If you want to select the options from a database, add a Connection String and Query.
- List of Options: If you select ‘Options’ as ‘Domain Type’ options have to be defined here. Option values can be added as a list/ imported from a Fact Concept.
- Once a business glossary is created, open the natural language/ decision table you want to use the business glossary terms
- Click on the Properties icon to view the property window.
- Click on Glossaries in the Properties window.
- Add the Glossary.
Referencing a glossary term
- Open the decision table you want to use a glossary term.
- Refer to the glossary.
- Select a column.
- Under Properties window –> Value, you will see a property called ‘Term’ which will load all the linked (i.e., referenced) glossaries in the document (e.g., the Decision Table).
- Instead of setting the Expression property, you can select a Term from the drop-down menu.
Similar to the decision table referencing, the ‘Term’ property is available under the Properties window.
Press Control + Space on the keyboard and the options can be viewed.
Sample Business Glossary
A sample business glossary can be downloaded from the attachments at the end of this page.