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 - 

Dynamics 365 Business Central 2021 release wave 2 (BC19) Released.

Hi Readers, As we all were expecting Microsoft have Released Business Central 2021 Release Wave 2 Today a.k.a BC19. In this article we will see what all is announced with the General Availability.  Starting Today Customers & Partners can start using Business Central 19. #msdyn365bc #bc19

Error After Restore SQL Backup of NAV 2013 Database

Hi all, we are facing a conman issue during restoring a SQL Database backup restored for NAV 2013. While Trying to run object from Object Designer we get below listed error (even the service is configured properly) - --------------------------- Microsoft Dynamics NAV Development Environment --------------------------- There are no NAV Server instances available for this database. You must ensure that a NAV Server instance is running and is configured to use the database before you perform this activity. --------------------------- OK    ---------------------------