Maplytics for Dynamics CRM

Further to our post on Maps integration for Dynamics CRM using Live Maps https://community.dynamics.com/blogs/crminogic/archive/2009/04/27/maps-integration-for-dynamics-crm-4.aspx we have been able to compile a list of mapping components that can be made available on different entities of CRM with the aim of enabling Geo analysis of the data stored in CRM.The entities covered are:
1. Lead/Account/Contact – Plotting of the primary address of these on the map. It also provides the directions to the customer address starting from the organization address.
2. Plotting of Accounts from a selected range of Accounts that come within the specified distance. The aim here it to be able to list out all accounts that are within a given range from the Starting point.

3. Geo mapping of Leads/Accounts on the map with the aim to allow the users to analyze their customer based on geographical regions.

4. Geo mapping of Sales/Opportunity on the map with the aim to allow the users to analyze their sales by geographical regions and thereby be able to design strategies focusing on a given region.Some of the features are:
Ø Each of these when plotted on the map allow the users to drill down ability and also be able to open Contact/Lead/Account etc CRM form to check further details of these.

Ø While searching for directions, you can specify the Route that you want to take and you would get the direction via the specified location.

Ø View Summary or Detail information

Ø Use of Advanced find view for providing the record selection to be plotted on the map.

Preview:

Here clicking on Get Direction one can see the following screen.

Click here to check further details.

Adding Money type attributes in Advanced Find causes error

If you were to add a money type of an attribute as one of the columns of a view you are designing, when you try to run the view, the results page will show an error message.

This is because the money type attributes require that the currency always be specified along with the money type attribute. To fix the above error all you need to do is include the currency attribute in the view and it will work just fine.

If you design a new custom Entity in CRM, the moment you add a money type of attribute, it automatically adds an attribute for currency called “transactioncurrencyid”.


If you forget to add the currency attribute on the form, when you try to provide a value in the money type attribute it will throw an error.

We have had various requests from customers who find the “Currency” attribute unnecessary as they work in a single currency and would like to avoid it. It is possible to remove the currency attribute from the form. But you can hide the currency attribute through scripting.

So in short… Money attributes require Currency attribute to tag along with them for them to function correctly.

CRM Quick Campaign - Unsubscribe option

We can create a marketing list for group of contacts, accounts or leads and against these records we can create a Quick Campaign. This Quick Campaign would ask for the type of activity to be created for these selected records.

We were required to setup a marketing list of our contacts for a mailer to be sent to them frequently. We created a Quick campaign for these contacts and selected the activity as Email. The email template provided includes an “Unsubscribe” option which can be used for getting mails back from the contact who don’t wish to receive mails thereafter.

Below is the screenshot where an activity type is selected along with the assign to options. Here, you can set the “Assign” accordingly. “Me” option says that the owner/sender of all the emails would be the logged in user while “Assign to another user or queue” option would allow you to select a particular user and this user would be the owner/sender of these emails. When any of the contact clicks on unsubscribe link, the “To” field will get set to this selected user.

In body of this template email you can set the template message with Unsubscribe link. To provide the Unsubscribe link select the Text and click on Unsubscribe button.

This wizard ends with creating campaign and the process of sending of mails starts. The success/failures can be evaluated from the Quick Campaign just created.
When the contact clicks on Unsubscribe link the unsubscribe subjected mail would be mailed back to the sender of these mails as set above.

When the unsubscribe mail is received that particular contact from the marketing list gets updated automatically and its “Do Not send marketing materials” is set to”No” as shown in the screenshot below.

But this auto subscribe may not work and can be reasoned due to two factors:

1) The “set auto unsubscribe option” in the System settings under Marketing tab should be set and to do this follow these below steps:
a) Go to Settings ==> Administration ==> System Settings
b) In system settings go to Marketing tab and set auto unsubscribe option to “Yes”.

2) The contact for which the auto unsubscribe should have worked must not have duplicate email address duplicating with another contact, account, lead, or user. Knowing this, even resolving the email address will not set the “Do Not send marketing materials” to “No” i.e. would not auto unsubscribe this contact.

How to use Parameters in Workflows/Plugins

CRM Plugins and Workflows provide the ability to pass external information to the plugins as well as receive information from plugin that can be used for further processing.

Plugins:

In case of Plugins, you can use the Secured Parameter and Unsecured Parameter that is available during Plugin registration to pass static information that can be used by the Plugin.
It is better to use the unsecured parameter as this is available in offline as well.

These parameters are available as parameters to the constructor of the Plugin.

public class AccountCreateHandler: IPlugin
{
public AccountCreateHandler(string unsecure, string secure)
{
// Do something with the parameter strings.
}
public void Execute(IPluginExecutionContext context)
{
// Do something here.
}
}

Workflows:

Workflows are allow for Input as well as Output Parameters. You can use the Input Parameters to pass static information to the Workflows. The Output parameter feature of Workflow is very interesting. The Output parameter defined in the Workflow Plugin, becomes available in the CRM Workflow window. You can use this output parameter in any of the Workflow steps.
It can be used in Wait/If condition block as a value to be checked for.

It can also be used in Create/Update step. Here the Output parameter becomes available only for the attributes that match the parameter data type.

If you had some complex logic to be evaluated before you decide who to assign the records to… you can create a Lookup type of Output parameter and assign the record to this.

Convert / Migrate Goldmine Email History and documents to Dynamics CRM

We have noticed that a lot of Goldmine users are migrating to Dynamics CRM with the requirement to have the Goldmine History brought over in CRM.

While it is very easy to get the Company/Contact information from Goldmine to CRM, one of the sore points is bringing in Email history to CRM. You will find all of the Pending/Open activities of Goldmine in the Cal table and the Closed activities in Conthist table.

The Cal/Conthist table stores all the details of the activity like the date/time, the type, the owner etc of the activity. The Ref field stores the subject and the Notes stores the description of the activity. This is true for all types of activities except Emails.

In case of Email, the email body is stored not in the Notes of the Cal/Conthist but it is a separate table called “Mailbox” to store the email body. The RFC822 attribute of the Mailbox stores the actual content of the email body. “LinkRecid” is the attribute that will help you link the two tables.

The data in this field includes the email in HTML and plain text format and requires to be processed before they can be added as the Email body in CRM. To start with it would be a good idea to use the Regular Expression class (RegEx) to parse out all HTML elements from the email body. This is essential as the email body in HTML format sometimes contains the Style tags and script tags which may cause a problem when taken to CRM and also it would not appear well formatted. It is always a good idea to parse out all HTML elements and take the email body as plain text in CRM.

One more important point to remember is to parse out all newline characters like “\r” or “\n” from the email text. CRM email body accepts the message in HTML format so these can be replaced with the HTML newline tags like "<BR>".

If you want to identify the contact to which the email was sent or any activity is associated with, you can check for the (oc: ) tag in the activity ref attribute. This tag contains the name of the secondary contact with which the activity is associated.

Coming to email attachments. GM stores the physical file path in its table. During the migration process, you can look for the file at the given physical file path and write the attachment to CRM. This information can be found in the ContSupp table. So you can link the Conthist/Cal record with the ContSupp table to get the attachment file path.

Hope this helps in conversion of Email history of Goldmine and shows you the intricacies involved in doing this through development.

For those who would not like to reinvent the wheel there are a number of product migration utilities and services in the market by third party developers who can provide you with this already existing details including Inogic. Inogic has a unique way of approaching this migration where it has developed a migration tool for Goldmine that migrates Contacts/Pending/History/Emails/Attachments, Linked Documents to CRM and it provides this utility in a combination service by testing it with your Goldmine database and handholding you through your live migration and providing minor customization all at a FIXED COST to place your Goldmine data into Dynamics CRM.

You can check out further details of this on our website.