The following table provides an overview of the new, removed, or changed C/AL data types, functions, properties, and triggers in Microsoft Dynamics NAV 2017 since the previous version of Microsoft Dynamics NAV. For more information about the changes, see the specific topic about the data type, function, property, or trigger.
C/AL Functions
The following table lists the new, removed, or changed functions in Microsoft Dynamics NAV 2017.
| Function | Description |
|---|---|
New function. Adds a table field to the filter control for a table on filter page. | |
New function. Adds a table field to the filter control for a table as specified by the field number. | |
New function. Adds a filter control for a table to a filter page as specified by a record data type variable. | |
New function. Adds filter control for a table to a filter page as specified by a RecordRef variable. | |
New function. Adds filter control for a table to a filter page. | |
New function. Binds event subscribers to the subscriber codeunit instance for handling events. | |
New function. Unbinds event subscribers from the subscriber codeunit instance for handling events. | |
New function. Gets the number of filter controls that are specified in the FilterPageBuilder object instance. | |
Changed function. Includes a Boolean return value. The value is true if an encryption key is created successfully; otherwise, it is false. | |
New function. Gets the Microsoft Dynamics NAV client type that is running on the current session. | |
New function. Gets the current company of a database table record. | |
New function. Gets the current company of a database table that is referred to by a RecordRef. | |
New function. Gets the default Microsoft Dynamics NAV client type that is configured for the Microsoft Dynamics NAV Server instance that is used for the current session. | |
Gets the sort order for the records returned, such as in data from an ODATA web service. | |
Changed function. Includes the following changes:
| |
New function. Gets the filter view (which defines the sort order, key, and filters) for the record in the specified filter control of a filter page. | |
Changed function. Includes a Boolean return value. The value is true if an encryption key is imported successfully; otherwise, it is false. | |
New function. Indicates whether a C/AL variant contains a FilterPageBuilder variable. | |
New function. Determines whether a record refers to a temporary table. | |
New function. Gets the name of a table filter control that is included on a filter page based on an index number that is assigned to the filter control. | |
New function. Gets the RecordID of the record that is currently selected in the table. | |
New function. Builds and runs the filter page. | |
Sets the sort order for the records returned, such as in data from a ODATA web service. | |
New function. Sets the current filter view, which defines the sort order, key, and filters, for a record in a filter control on a filter page. | |
GETDEFAULTTABLECONNECTION Function (Database), HASTABLECONNECTION Function (Database), REGISTERTABLECONNECTION Function (Database), SETDEFAULTTABLECONNECTION Function (Database), and UNREGISTERTABLECONNECTION Function (Database) | New functions. Registers, sets, gets, and unregister table connections to external tables. |
C/AL Properties
The following table lists the new, removed, or changed properties in Microsoft Dynamics NAV 2017.
| Function | Description |
|---|---|
New property. Used for events. Specifies whether a function is a publisher of or subscriber to an event. | |
New property. Used for events. Specifies the event publisher function that an event subscriber function subscribes to. | |
New property. Used for events. Specifies the object that contains the event publisher function that an event subscriber function subscribes to. | |
New property. Specifies how event subscriber functions in a codeunit are bound to codeunit instance and events that they subscribe to. | |
New property. Used for events. Specifies whether an event is a business or integration event. | |
New property. Used for events. Specifies whether global variables in an event publisher object can be accessed from event subscriber functions. | |
New property. Used for events. Specifies whether global functions in an event publisher object can be called from event subscriber functions. | |
New property. Specifies one or more namespaces on an XMLport object. | |
New property. Specifies a namespace prefix on an element of an XMLport object. | |
New property. Specifies what happens to the event subscriber function call when the license of the Microsoft Dynamics NAV user account that is running the current session does not include the codeunit that contains the subscriber function. | |
New property. Specifies what happens to the subscriber function call when the Microsoft Dynamics NAV user account that is running the current session does not have permission to the codeunit that contains the subscriber function. | |
New property. Used for events. Specifies the table field that the trigger event pertains to. | |
New property. Specifies the scope of actions to be either Repeater or Page. | |
New property. Specifies a field to be a timestamp field that contains row version numbers for records. | |
Specifies whether the table is a normal or external (CRM or ExternalSQL) table. | |
New property. Specifies the function to be try function, which can be used to catch and handle errors and exceptions that occur when code is run. | |
Changed property. Instead of the Upgrade option, there are now two options: UpgradePerCustomer and UpgradePerDatabase. The UpgradePerCustomer option behaves like the Upgrade option in the previous Microsoft Dynamics NAV version. | |
Changed property. Includes the FilterPageHandler and HyperlinkHandler optiions. |
C/AL Statements
The following table lists the new, removed, or changed C/AL statements in Microsoft Dynamics NAV 2017.
| Statement | Description |
|---|---|
FOREACH | New statement. Iterate through a .NET Framework collection or array. For more information, see FOREACH Control Structure. |
BREAK | New statement. Terminates the iteration statement in which it used. For more information, see C/AL BREAK Statement. |
 Important |
|---|
| If your solution has used FOREACH or BREAK as names of variables in earlier versions of Microsoft Dynamics NAV, you must change the names before you upgrade to Microsoft Dynamics NAV 2017. Alternatively, you can enclose the variable names in quotation marks. If you do not, and you import an object that has this code in text format, you cannot compile the object. |