Page History

Contents

• Dynamics CRM Solution
• CRM Updates Service Component
• Custom Dynamics CRM Workflow
• Creating Reports for CRM Workflows

Many clients who use SharePoint to manage their customer facing websites also use Microsoft Dynamics CRM to monitor leads and maintain client relationships. CardioLog allows you to integrate Dynamics CRM into the workflow for more robust report data. Here is a general outline on how the Microsoft Dynamics CRM integration works:

1. A website visitor ID is saved in Dynamics CRM with other form submission fields. This ID (called CardioLog ID) is used to map CRM entities to specific website visitors, including Lead, Opportunity, Contact and Customer.
2. In Dynamics CRM, one can view the web analytic reports for a single entity (ie., web visitor) through an embedded iFrame or by clicking a direct link to CardioLog reports.
3. In Dynamics CRM, a "status update" event is logged in CardioLog when an entity status changes. The update is then made available within analytic reports for the entity (ie., web visitor).
4. Dynamics CRM entity fields are automatically imported into CardioLog, and can be used to filter reports using visitor segments.
5. In Dynamics CRM, a "behavioral scoring" field is added to entities, and is automatically populated by CardioLog (based on according to the visitor's web activity).

Note: Adding customer CRM entities requires customization.

Anchor
solution solution

Dynamics CRM Solution

This custom Dynamics CRM Solution is implemented through the CRM UI, and application UI. The solution creates the following entity fields:

1. CardioLog ID - used Used to map CRM entities (Lead, Opportunity, Contact and Customer) to specific website visitors.
   1. The customer is responsible for
populating this field when
2. 1. importing form data from
his
3. 1. their website to complete this field. For example, if the client's web site has a "Contact Us" form and this form sends the data to Dynamics CRM, we assume that the CardioLog ID is stored in Dynamics CRM as well.
   2. The CardioLog ID is populated for the original entity (lead) that was browsing the website.
   3. The CardioLog ID can be retrieved from the client side (browser cookie named "userid") or from the server side (Request.Cookies["userid"])
4. CardioLogGroupID CardioLogGroupID - when When qualifying a lead, any entity generated in the process (including account, contact and opportunity) , will have its CardioLogGroupID field populated with the CardioLogID of the original lead. This field can be imported into CardioLog and used in report filtering.
5. CardioLog Score Score - score  Score for a single CRM entity. Updated by CardioLog's CRM Updates service.
6. CardioLog Report -  web analytic Web analytics report for a single CRM entity.

Image Added

The CardioLog Report iFrame 

Installing the SharePoint Marketing Suite - Follow these steps to install the Dynamics CRM Solution:

1. Download the solution file from from our site here.
2. Open Dynamics CRM > and go to the Settings tab > Solutions > Import > and select the solution zip file (CardiologIntegration_0_2_0_5_managed.zip)
3. Reload the Dynamics CRM main page
4. Under SharePoint Marketing SuiteCardioLog, click Configuration and add the following 3 fields:
   • Name = Cardiolog.API.URL, Value = http://[CardioLog App]/cardiologapi/events.asmx/SendEvent?param1=&param2=&useragent=&clientip
     The CardioLog SendEvent web service URL. Edit the CardioLog application server name.

• Name = Cardiolog.Group.CategoryID, Value = [Category ID] 
  The CardioLog Category ID
.
• - After the first execution of the CRM Updates Service component, a new category will be created. This category contains the possible values for CardioLogGroupID.
  To retrieve the Category ID execute the following query against the CardioLog database:

select Category_Id from tab_category_categories

where Category_Name = 'int_cardiologgroupid'

• Name = Cardiolog.Report.URL, Value = http://[CardioLog App]/CardioLog/CLReport/ContextBasedReport.aspx?timeframe=0&timeInterval=864000000000&startDate=30d&endDate=today&templateId=[user template ID]&entityId=[entity id]
  The CardioLog web analytics report URL. Edit the CardioLog application server name.
  
Creating
• Create the CardioLog web analytics report for CRM entities:

Open SharePoint Marketing Suite > Administration tab > Templates > create a new report template under the User content
• 1. In the CardioLog navigation pane go to Settings > Templates > click Add next to User content type and publish it.
For
• 1. See Report Templates for more information
about report templates, see http://support
• 1. .
intlock.com/entries/20746103-6-report-templatesOpen SharePoint Marketing Suite > Report Center tab > Sample Reports > Visitors > Unique Visitors > edit the report filters and click on Go > drill down on a user in
• 2. In the CardioLog navigation pane go to Report Center and browse to the Individual Report Samples folder > Visitors folder > Unique Visitors > Drill down on a user in the Unique Users table, and select the report template.
For more information about drill down see http://support.intlock.com/entries/20445137-5-visual-controls#5.7
• 2. Copy the report URL.

Image Added

The Dynamic CRM Solution Settings dialog 

Anchor
updates updates

CRM Updates Service Component

This service component has 2 functionalities:

1. Updating the score field for CRM entities.
2. Retrieving CRM entity fields for filtering and segmenting reports. User names correspond to CardioLog IDIDs.

Configuring the SharePoint Marketing Suite Follow these steps to configure the CardioLog - CRM Updates service component:

1. Configure the User Categories Updates service in SharePoint Marketing Suite CardioLog in order to retrieve CRM entity fields:
1. Open [CardioLog Installation Folder]\CardioLogScheduleServices\Settings.config and edit the following:
   
   <param>

      <handlerId>4</handlerId>

      <name>webServiceURL</name>

      <val><![CDATA[http://[CardioLog App]/VisitorSegments/DynamicsCRM2011Users.aspx]]></val>

   </param>
1.  Open [CardioLog Installation Folder]\VisitorSegments\CRMSettings.xml and edit the following:
   
   <CRMSettings>

      <instance id="1" type="dcrm">

         <webServiceUrl url="http://[DCRM server]/MSCrmServices/2007/CrmService.asmx" />

         <organizations>

            <organization id="1" name="[Organization Name]">

               <entities>

                  <entity name="[Entity Name]" cardioLogIDFieldName="int_cardiologid">

                     <attributes>

                        <attribute id="1" name="[Field Name]" />

                     </attributes>

                  </entity>

               </entities>

            </organization>

         </organizations>

      </instance>

   </CRMSettings>

• DCRM server name
• Organization Name 
  To retrieve the organization name, open CRM > Settings > System > Administration > Business Units > Name
• Entity Name 
  To retrieve the entity name (only entities supported by CardioLog - Lead, Opportunity, Contact and Customer), open CRM > System > Customization > Customizations > Customize the System > Components > Entities > Name (for example the name of the Lead entity is lead)
• Field Name 
  To retrieve the field name, open CRM > System > Customization > Customizations > Customize the System > Components > Entities > Entity Type (for instance Lead) > Fields > Name (for example the name of the Lead Source field is leadsourcecode)

3.  Open SharePoint Marketing Suite > Administration tab > CardioLog In the CardioLog navigation pane, go to Administration > CardioLog Scheduling Service > CRM Updates > and set the desired scheduling type for this service and restart the . Click Restart Service in the upper right hand corner of the CardioLog Scheduling Service windows servicewindow.

 Note: The CardioLog application pool account should have read/write access to Dynamics CRM. 

Filtering and segmenting SharePoint Marketing Suite CardioLog Reports by CRM entities and entity fields:

1. Filtering reports by CRM entities:
• Open SharePoint Marketing Suite > Report Center tab > click CardioLog and from the navigation pane select Report Center, then click the desired report and select Edit
• Click Under Filters, click Users and Groups roups and select the Customize option
• Enter the CRM entity name (CardioLog ID) in the Name field and then click Add. 
2. Segmenting reports by CRM entity fields:
• Open SharePoint Marketing Suite > Open CardioLog and from the navigation pane select Report Center, then tab > click click the desired report and select Edit
• Click Under Filters, click Visitor Segments and select the Customize option
• Click the CRM entity field (under User Categories) and select the Customize option
• Enter the field value in the Name field and then click Search. Select the desired result and click the Add button to add include it to in the filter setting.

Anchor
workflow workflow

Custom Dynamics CRM Workflow

This custom CRM workflow sends entity events (Lead, Opportunity, Contact and Customer) events (such as status update) by calling eg., status updates) by accessing the CardioLog SendEvent web service:

• CRM asynchronous workflow rules (using that use a custom workflow assembly ) will react to the desired entity events.
• For each event, the workflow calls accesses CardioLog's web service and sends the relevant data.
• Event URL has the following format: CRM | entity | status | reason
  For more information about the default Microsoft CRM values for status (StateCode) and reason (StatusCode), see http://msdn.microsoft.com/en-us/library/ms914670.aspx

...

• status and reasons, see the Microsoft StateCode and StatusCode Values table.

Image Added

The Custom CRM Workflows dialog

Anchor
reports reports

Creating Reports for CRM Workflows

1. From the Navigation Pane, click on Report Center tab >  > Click the folder where you would like to create a new report. For more information about how to create a report, see http://support.intlock.com/entries/20451026-6-report-center#6.1
2. Add the Page Views > Events and Visitors > Unique Users by Events reports
3. Enter , and select New Report.
4. We recommend adding either the Unique Users table or Visitors by Events table widget to your new report. Although tables that include user information should filter results accurately according to CRM data.
5. From the Filters menu, select "CRM" in the Portal Website Item URL field and click Go.