This is the final post in a 5-part series covering the basics of the SDK for Connector.
When you get your custom implementation or extensions to build in Visual Studio and you want to test their functionality in Connector, there are some steps involved in preparing your Adapter for use with Connector. This post will help you to name the files correctly, put the adapter files in the correct locations, and configure the SampleAdapter.
The adapter artifact can be named whatever makes sense for your specific implementation or extension. The ObjectProviders can be named whatever makes sense, although it typically makes sense to name them using Object + ObjectProvider so that they are easy to understand. The ObjectProvider configuration files must be named [Object]ObjectProvider.config so that they match with the ObjectProvider filename.
When you build the SampleAdapter solution, you will notice that the output DLL is given the name using the full namespace such as Adapter1. It is important that the output DLL takes the name of the full namespace. This makes it easier for the Dynamics CRM Adapter to locate the new adapter.
You need to include these things for the Connector client to recognize and load your adapter:
Once you have located these files in the “bin” folder of your project directory, you can copy them to the “Adapters” folder of your Dynamics CRM Adapter installation location. By default, this folder is located at $(ProgramFiles)\Microsoft Dynamics\Microsoft Dynamics Adapter\Adapters\.This is where you need to put your Adapter DLL file and the folder containing the ObjectProvider Configuration files named appropriately. Once you have done this, you should be able to open the Dynamics CRM Adapter client application and a wizard with help you configure and activate the new adapter.
The SampleAdapter project that comes with this SDK can be opened in Visual Studio 2008 or 2010. Once you open the project in Visual Studio, you can build the project. The output of the project can be found in the project directory in the “bin” folder. Select the “Dynamics.Integration.SDK.Sample.SampleAdapter.dll” file and the “ObjectConfig” folder and copy and paste them in into the $(ProgramFiles)\Microsoft Dynamics\Microsoft Dynamics Adapter\Adapters\ folder. Then, open the “Microsoft Dynamics CRM Adapter” client application. When you open this application, you should be prompted with a window asking you to configure a new SampleAdapter. At this window, enter the username to connect to the GP Web Service (DOMAIN\username), the password for this user account, and the URL for the GP Web Service (http://localhost/DynamicsGPWebServices/DynamicsGPService.asmx by default). Then, you should be able to click the save button.
Next, right-click on the “Home” text on the left-hand side in the top corner. Select “create new integration” from the menu. Select the “blank” option. On Application 1, select the “SampleAdapter” and the appropriate company and on Application 2 select “Microsoft Dynamics CRM 4.0”. Then, click the create button. Now, you must add maps and activate them. Right click the “maps” text under your new integration and select “Create new map.” Then, you need to decide if you want to try the SampleCustomer or UofMSchedule map.
After the maps run the first time, you should be able to see the objects synchronize.
I know this work out of box with Dynamic's AX, GP and NAV, but with the Dynamic's Adapter SDK can we customise something for Dynamic's SL with custom built WCF webservice or something similar?
You could use the SDK to create adapters for Dynamics SL, but also want you to know that we are working on a Dynamics SL integration that should be available late this year.
Good to know that, but meanwhile there are 3 version of Connector which version should i use for the Adapter for SL?
The only differences in the Connector is the ERP adapters that are included. You can just use FP6.
I manage to integrate CRM Account to SL Customer, but when i try SL Customer to CRM Account it throw me an error:
[Customer to Account] has encountered an error while processing key [Renown.Dynamics.Integration.Adapters.SL2011.WebService.CustomerKey]. The given key was not present in the dictionary.
I follow the instruction any idea?
Generally this is a mapping issue, in that something is trying to be mapped that is not present in the source record. I would suggest that you start un-mapping fields to see which one is cuasing the error.
Got the SDK with the latest and greatest, compiled and deployed the SDK samples adapters (dll + config files). Nothing. No sample adapter in the UI. Per article, I am suppose to be promped for my settings.
will the already existing maps show in the new adapter? if not how can we reference them