Getting started with the SDK

This section provides initial pointers to help you get started with the Microsoft Dynamics Marketing SDK. Before you use the SDK, you should review the Microsoft Dynamics Marketing 2016 Update Readme.

Download the SDK package

Before you start, download the Dynamics Marketing SDK package. In addition to the documentation, this download package includes the assemblies needed for development, all sample code found in the documentation, and other resources.

To start the SDK package download, click Download. If the File Download dialog box appears, do one of the following:

• To start the download immediately, click Run.

• To copy the download to your computer to view at a later time, click Save.

Install the SDK

1. Open the MicrosoftDynamicsMarketingSDK.exe file.

2. Accept the license terms and choose Next.

3. Choose Browse and specify the folder location to install the SDK in.

4. Choose Next.

After the installation, you’ll see the following files and folders in the location that you specified:

• LicenseTerms.docx: Contains software license terms for the SDK.

• MdmSdk.chm: Contains the SDK documentation in a .chm file format.

• Bin folder: Contains the assemblies that you need for developing applications with Dynamics Marketing.

• Sample code folder: Contains sample codes that demonstrate the features available with Microsoft Dynamics Marketing. More information: Quick start with sample code

Authenticate queues

The Dynamics Marketing SDK uses the Microsoft Azure Service Bus and the request/response functionality to communicate between Dynamics Marketing and external systems.

Dynamics Marketing provides authentication via service bus queue security. The administrator uses the data integration services to create the two service bus queues as part of the Site configuration and integration settings. The administrator owns the service bus and the queues and uses the certificate to grant permissions to the SDK service to communicate with SDK queues. Client applications must be authenticated and granted access to the service bus queues before they start using the SDK. Permissions can be granted to the client application using various types of authentication mechanisms. More information: Service Bus Queues, Topics, and Subscriptions, Service Bus Authentication and Authorization with the Access Control Service

Configure Dynamics Marketing to communicate through queues

Before you can use SDK services, you need to configure Dynamics Marketing to communicate through queues. The queue manages SDK requests that come in to, and responses that go out from, Dynamics Marketing.

1. Navigate to Home > Settings > Administrator > Integration Options.

2. In the SDK Service Settings, choose the configuration button .

3. In the Microsoft Azure configuration dialog box:

   • Enter an existing namespace of an existing service bus. If you don’t have a service namespace, you can create a new one.

   • Enter the name of the existing queue that handles requests coming to Microsoft Dynamics Marketing. If this queue and the response queue don’t exist, go to step 4.

   • Enter the name of the queue that transfers responses from Microsoft Dynamics Marketing.

4. Choose Configure Azure ACS to create the queues if they don’t exist already.

5. Provide the Management Key to the Microsoft Azure Service Bus.

6. Select Enable.

7. Choose OK and then choose Submit or Save.

Authorize queues

Before you start making calls to the SDK service, you need to provide permissions to the service for reading or writing to the available entities. The request queue and response queue communicate marketing list, email messages, company, lead, contacts, external entities, categories, events, marketing results, and custom fields. All calls to the entities will be delivered using the same request queue. If access to the queues isn’t enabled, all requests to the queue will be ignored.

To enable SDK services and set permissions to message types or groups:

1. Navigate to Home > Settings > Administrator > Integration Options.

2. In SDK Service Settings,

   1. Select Enable to enable the SDK gateway.

   2. Assign permissions to queues:

      • Select Read to allow read operations for respective entities.

      • Select Write to allow write operations for respective entities.

3. Choose Submit or Save.

Note

The current Azure Management Portal doesn’t allow you to view the configuration of the “Require Session” flag. To see the flag, query the QueueDescription class, or use the Service Bus Explorer or a similar tool.

Next steps

• Browse through the Programming reference for Microsoft Dynamics Marketing to understand Dynamics Marketing assembly and messages.

• Install and run the sample codes that are available with Dynamics Marketing SDK to experiment with the system behavior. More information: Quick start with sample code

See Also

Tasks

Quick start with sample code

Concepts

Developer overview of Microsoft Dynamics Marketing
Sample code
Assembly included in the Microsoft Dynamics Marketing SDK

Other Resources

Web service and assembly reference
Site configuration and integration settings

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.