◷ Reading Time: 5 minutes
What is Natural Language (NL)?
NL is a way of modeling business rules and logic using business terminologies. The benefit of using Natural Language is that it hides all the technical complexity (i.e., expressions, method call, etc.) from users. Modeling logic and business rules in NL
- Define a business glossary.
- Define the context of rules (given)
- Define your rules and logic (when section)
- Extend the rule using other logic (when sections)
Adding New NL
To add a new NL, you can simply select Natural Language in a Decision or Validation folder.
To add a new Natural Language document,
Document Types --> Decision Logic --> Natural Language

Once you add a document, this will be the window.

Natural Language Properties

- Name: Name of Natural Language file
- Glossaries: Link Business Glossaries or Boxed Expressions
- Includes: List of referenced natural language models
- Variables Definition: List of input and output parameters
- Types Definition: List of types and functions
Toolbox
There will be no item in the toolbox.
Top Menu
At the top menu, you can see the following items.

- Find: Find terms in the file
- Business Glossary: Link Business Glossaries or Boxed Expressions
- Logic: When you click on any line in the file, it will show the logic name of the line
- Find a logic: Find a logic (by name) in the file
- Add a new logic: Add a new logic to the file
- Properties: properties of the document
- Compile to execution plan: Show the XML code of the document
Managing Glossaries
To add or remove glossaries, you can simply click on the Business Glossary in the top menu and the following screen that allows you to manage references of glossaries for this NL file will be displayed:
To learn more about managing Glossaries please visit business glossaries.
Rule Context
By setting up the rule context, you pass information to the rule for execution. The Rule context can be defined by Input Parameters of the rule. A Natural Language rule can define input and output parameters in a Natural Language context section. When both the Declaration and Natural Language context is used, the result will be the union of all of the parameters.
Logic Format
These are blocks of when-then-otherwise-end. To understand more about Natural Language check the Logic Format.
Entering Logic
There are two ways to ask for suggestions while entering rules:
- Pressing ‘CTRL + Space’ on keyboard
- Hovering the mouse on a Term
The editor then suggests the next step in a list of shows you some information regarding a term or acceptable values.

Mouse-hovering on a term, a hint is shown about the definition of the term.

Entering a generic value (i.e., string, number, etc.) and hint shows what type of value is expected.

Entering values when the term has some selectable options, a list will ask you to chose for the right option.
Debugging
Debugging enables you to step into every line of your logic, execute that specific line and then check the values on the Parameter window in an NL document.

In order to start the debugging mode make sure you provide values for the input parameters as expected.
Video Description
Sample Natural Language
Download the sample project using the attachment which contains Natural Language (PotentialTheftRating-NL.xml).