Microsoft Dynamics 365 Business Central / NAV - OData v3 Is Being Retired

Microsoft Dynamics 365 Business Central / NAV - OData v3 Is Being Retired

book

Article ID: KB0073676

calendar_today

Updated On:

Products Versions
TIBCO Cloud Integration - Connect ( Scribe ) -

Description

Summary 

Microsoft is retiring support for the OData v3 web service used in D365 Business Central. Users need to manually edit their connections to use Microsoft’s OData v4 or REST API for Business Central. You can read more about this change in this article from Microsoft. 

Affected Users

Any user connecting to the OData v3 web service for a cloud instance with the TIBCO Scribe® Online Connector For Microsoft Dynamics 365 Business Central / NAV. 

 

Example v3 URLs:

Changes in Behavior

When moving from OData v3 to OData v4

  • Metadata - some warnings may appear on field mappings. No issues are expected at runtime.
  • Update Block - OData v3 supports an UpdateMerge block, but OData v4 does not. Users will need to change the block type to UpdatePatch

When moving from OData v3 to REST

  • Metadata - The REST API has objects and properties defined differently than OData does. This change will require users to update most of their mappings for each object and field.
  • Update Block - OData v3 supports an UpdateMerge block, but REST does not. Users will need to change the block type to UpdatePatch
  • Net-Change - OData v3 (and v4) only supports a Date value. REST supports DateTime, which is an improvement and will allow users to run their Apps more frequently. 

Actions Needed

Users need to update their Microsoft Dynamics 365 Business Central connections to use either OData v4 or the REST API. 

 

Best practice is to create a new connection to OData v4 or REST APIs and Reassign connections in your flows (maps). Test your Apps & Flows (Solutions & Maps) as you update them. For larger deployments, a best practice is to use a test environment. 

For more information, please review these resources

Issue/Introduction

Support for OData v3 is being retired - What you need to do