Tool to generate OpenAPI specification for custom services in D365 FO

 

This blog post walks you through the tool created to generate OpenAPI specification (formerly Swagger specification) for D365 FO custom services. Creating an OpenAPI specification from scratch requires lot of effort and time and even requires skill to generate in the correct format to be consumed externally. In order to avoid additional time to manually generate such specifications, I have created a tool which will automatically create an OpenAPI specification directly from D365 FO on a click of a button without the need of additional steps to wrap the D365 FO custom service using a third party tool.

 


 

 

Business Scenario:

Simplified Solution Inc. has requested for OpenAPI specification for the custom services created within D365 FO for external application consumption.

 

Problem Statement:

There is no facility to generate standard OpenAPI specification directly within D365 FO. Even if specification can be created manually from scratch, it still requires knowledge and skill to create the specification in the right JSON or YAML format as per the requirement. As time is of essence and working on a fixed time project, it becomes difficult to produce such a specification on time with limited available resource.

 

Solution:

To overcome the above problem statement, I have created a tool within D365 FO which creates an OpenAPI specification directly from D365 FO just with a click of a button. All you need to do is select the custom service from the available list for which you need to generate the specification document. The generated document from D365 FO can directly be consumed within swagger.io, postman or any other third party tool as required.

 

Pre-requisites:

Following are the pre-requisites to get this tool ready for action:

1)    Download the deployable package from GitHub

2)     Install the deployable package in your D365 FO environment (Detailed instructions available in GitHub for installation and uninstallation of the tool)

3)     swagger.io or postman online free tool to render the OpenAPI specification generated from D365 FO

 

Execution:

Post completion of the above mentioned pre-requisites, follow the below mentioned steps to generate the OpenApi specification document:

1)    Navigate to System Administration >> Enquiries >> 'Generate API spec for custom service' to open generate API spec dialog

 


 

2)    Select the service for which specification needs to be generated

 

3)    Click on ‘Generate Swagger’

 

            

4)    An OpenAPI Json specification file will be generated ready to be consumed in any third party application with a few tweaks to update the description and purpose of the service if required

 


 

5)    Generated specification can now directly be copied in swagger.io editor for instance for further use

 




Conclusion:

Hope this will prove to be helpful in your real life scenarios and ease out the work on generating API specifications. The beauty of this tool is that, you don’t have to be technical to be able to use it.

Feel free to suggest any improvements / enhancement for this tool.

The purpose of the tool is to simplify your work in day to day life so that you don’t have to go through the pain of generating the specification from scratch. Hence, please don't forget to share this blog with your friends and colleagues as well.

Hope you enjoyed reading it.

Happy to connect one to one on LinkedIn.

 

Until next time, See You!!!

Comments

Post a Comment

Popular posts from this blog

A Tool To Generate Data Entity Relationship Diagram In Simplified Way In D365 FO

Image
  This blog post walks you through the process of generating ERD diagrams for data entities within Dynamics 365 Finance & Operations. In order to overcome the difficulty of manually generating data model for data entities, I have created a tool for generating ERD diagrams to simplify your work. Lets understand the business scenario and why this tool is required.   Business Scenario: Simplified Solution Inc. has asked the implementation and architect team to  generate ERD diagram for D365 FO data entities to understand the data entity data model. This will serve the purpose of smoother implementation experience for reporting, integration and data migration teams.   Problem Statement: This is a common requirement asked by the architects and knowing that the standard ERP product does not provide an easy way to extract this information directly from the system, it becomes difficult and sometimes time consuming to list down all the relationships between ...
Read more

A Tool To Generate Data Entity Relationship Diagram In Simplified Way In D365 FO (Enhanced)

Image
  This blog post walks you through the enhancement towards already created tool to generate data entity relationship diagram. Identification of related entities can be challenging and tiresome activity which might consume considerable efforts and time to generate the ERD diagram. Hence to overcome this issue, new features have been added to the existing tool to automatically identify and populate related data entities for the diagram. Business Scenario: Simplified Solution Inc. has asked to identify the data entities and generate ERD for the products structure configured within D365 FO on the basis of the released products. Problem Statement: Identifying the related entities based on the primary data entity requires manual intervention of a developer to identify the relations on each entity using visual studio. This is a challenging process and requires good amount of time and efforts to identify the related entities. Solution: As an enhancement to the current tool, couple of fea...
Read more