Skip to main content

msdyn365bc Preprocessor Directives - Conditional Directives.

Hi Readers,

In the Introduction article of series we understand different types of Preprocessor  directives available in Business Central.

Preprocessor Directives are available starting Business Central 2020 Release Wave 2. 

You can read other articles in this series using this link.

In this article we will understand how to use Conditional Directives.

As name suggest with conditional directives this allows you to compile your code conditionally.

What is conditional directives?

  • A conditional resembles in some ways an if statement, but it is important to understand the difference between them. 
  • The condition in an if statement is tested during the execution of your program. Its purpose is to allow your program to behave differently from run to run, depending on the data it is operating on. 
  • The condition in a preprocessing conditional directive is tested when your program is compiled. Its purpose is to allow different code to be included in the program depending on the situation at the time of compilation.

The following conditional preprocessor directives are supported in AL.
  • #if - Specifies the beginning of a conditional clause.
  • #else - Specifies a compound conditional clause.
  • #elif - Combines else and if.
  • #endif - Specifies the end of a conditional clause that begins with #if.
Conditional Directives, works with Symbols.  And Symbol works like - 
  • A Symbol return true/false.
  • Symbol can be defined  beginning of a source file.
  • Scope of the specific symbol is the file that it is defined within.
  • Symbol can be global for the extension.
How to Define a Symbol?
  • To Define a Symbol (set to True) use #define.
  • To Undefine a Symbol (set to False) use #undef.
  • To use a Global Symbol for extension use - preprocessorSymbols in app.json.
  • preprocessorSymbols - Can be used to define one or multiple symbols.
Defining a Symbol?

A symbol can either be local or global as shown below.

How To use Symbols?

In Next article in this series, we will discuss about another preprocessor directives with examples. 

If you have any questions, add as comments to this article.

Saurav Dhyani


Popular posts from this blog

Send Mail with Attachment From Navision.

Hi all, We have seen how to save a report into PDF and how to send mail to a customer. Let's link these two post in one i.e. Mailing statement to a customer into PDF Format. This article is part of the Series. Please Refer  Table of Content here . If you have the old objects set let me brief you what I will be changing - 

Future - What Next After NAV 2016. Code Name - Madeira...

Hi All, While Browsing web I came across some article which says about next release of Microsoft Dynamics NAV. Let's see the History of Code Names Given to Previous Version  - NAV 2013 - Code Name 'Sicily' NAV 2015 - Code Name 'CRETE' NAV 2016 - Code Name 'CORFU' And as we all know that all these are the Islands.

Download Microsoft Dynamics Business Central on Premises 2020 Wave 2 Release.

 Hi Readers, As Expected Microsoft have released #msdyn365bc 2020 wave 2 is available.  This article provides details of the new release. The 2020 release wave 2 for Business Central delivers a wealth of new features. Read What's new in 2020 Release Wave 2 here .  Dynamics NAV Customers upgrading to Business Central on Prem will be able to run business central on premises, move to cloud or choose a hybrid approach.