Breaking news from around the world
Get the Bing + MSN extension
The views and opinions expressed in this blog are those solely of the author(s) and do not necessarily reflect Microsoft’s current policy, position, or branding. For official announcements and guidance on Dynamics 365 apps and services, please visit the Microsoft Dynamics 365 Blog.
Choose your path Increase your proficiency with the Dynamics 365 applications that you already use and learn more about the apps that interest you. Up your game with a learning path tailored to today's Dynamics 365 masterminds and designed to prepare you for industry-recognized Microsoft certifications.
Visit Microsoft Learn
2019 release wave 2 Discover the latest updates and new features to Dynamics 365 planned through March 2020
Release overview guides and videos Release Plan | View virtual launch event
Ace your Dynamics 365 deployment with packaged services delivered by expert consultants. | Explore service offerings
Connect with the ISV success team on the latest roadmap, developer tool for AppSource certification, and ISV community engagements | ISV self-service portal
The FastTrack program is designed to help you accelerate your Dynamics 365 deployment with confidence.
FastTrack Program | Finance TechTalks | Customer Engagement TechTalks | Talent TechTalks | Upcoming TechTalks
Over the last several months we have highlighted various aspects of the Service Based Architecture and steps you would complete when creating or using new operations. With this post we’d like to wrap things up and give you an all up checklist of steps you need to do when creating your own operations.
What operation endpoints are needed to enable the scenario you are going after?
Would a wrapped window or decoupled approach be the most efficient method?
(Thanks to MVP, Mariano Gomez for the great summary post on these patterns!)
With the assistance of the Service Code Generator, create a .NET assembly that will contain the object and property definitions being used in your operations.
Once you’ve created your .NET Object addin, you’ll need to add a reference to it via the Libraries window in your Dexterity dictionary. More information on how to do this can be found in the Dex.chm documentation file under Scripting > .NET Interop > .NET Assemblies.
Create new procedures
Add new metadata following the naming convention guidelines
Add in proper error handling
Ensure metadata is setup for how you wish the operation to be secured within GP
Note: The Service Code Generator can help in these steps as well
Once you have all of your service procedures defined, the next step will be to run the DAG tool on the dictionary. This wraps up the metadata supplied and includes the operation information in Discovery. If you are not familiar with the DAG tool, please see Chapter 6 of the Visual Studio Tools SDK documentation.
Three assembly files are created and they need to be copied into your Dynamics GP client directory:
Restart the three associated services with your Service Based Operation installation:
GP Dexterity Service – DEFAULT (or your named instance)
GP Dexterity Service Control
At this point your new operations should be available as an endpoint via the service. A quick way to check the information is to use the Help service call to look at the Discovery information available for your operation. Is it included and the corresponding information correct? If so, then you are ready to try a call using your new endpoint!
That concludes the checklist of steps you need to do to create a new service endpoint. At this point, other helpful steps would include creating tests around your operations. If things start to go sideways, you’ll then want to review the debugging tools available to you.
I’ve also included some additional links to posts around SBA for those who are delving deeper into unique scenarios that may require some specific control, extensibility, authentication, or working with CORS.
Raw requests and responses
Authentication (and authentication from Java Script)
CORS - Cross Origin Resource Sharing
Business Applications communities