Web service foundation

Web Services for Microsoft Dynamics GP is constructucted on a base of Windows Communication Foundation (WCF) and eConnect. The architecture is shown in the following illustration.

Cc508698.WS_ArchitectureDiagram(en-us,MSDN.10).gif

Windows Communication Foundation

The preferred foundation for web services on the Microsoft Windows Server platform is the Windows Communication Foundation. WCF provides a versatile framework that can be used to implement several types of web services. WCF is used to implement the Microsoft Dynamics GP Service Host. This is a Windows service that can host several WCF services for Microsoft Dynamics GP. One of these is the Dynamics GP service. The Dynamics GP service provides a legacy endpoint and native endpoint. External applications use these web service endpoints to access data in Microsoft Dynamics GP.

Legacy endpoint   The legacy web service endpoint uses the BasicHttpBinding. This endpoint has the characteristics of a standard ASMX-based web service, just like a web service that was created with ASP.NET. Releases 9 and 10 of Web Services for Microsoft Dynamics GP were ASMX-based web services that were implemented using ASP.NET. Applications can use the legacy endpoint of the Dynamics GP service just like they had used the ASP.NET-based web service from the previous releases.

Native endpoint   The native web service endpoint uses the WSHttpBinding. This endpoint is similar to legacy endpoint, but has better performance. The native endpoint can also use additional web service features such as reliable messaging. The code that applications use to connect to the native endpoint of the Dynamics GP service is different from the code to connect to the legacy endpoint.

eConnect

The Dynamics GP web service uses eConnect to provide access to the data managed by the accounting system. eConnect is a set of SQL stored procedures and supporting code used by integrating applications to access data in Microsoft Dynamics GP. Data validation logic is built into eConnect, helping ensure the integrity of any data written to the database through the web services.

Though eConnect provides the data access for the Dynamics GP web service, no knowledge of eConnect is required to use the web service. The Dynamics GP web service interface completely isolates the web service developer from eConnect. The eConnect interfaces can still be used when the Dynamics GP web service is installed.