for Microsoft Dynamics CRM - D&B Hooversimages.hoovers.com/images/pdfs/AH_for_MSCRM_OnPrem_33009.pdfTo install Access Hoover’s for Microsoft Dynamics CRM, you will need the following:

for Microsoft Dynamics CRM

On-Premise Installation Instructions

March 2009 www.crm.hoovers.com/msdynamics

HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 2

Table of Contents

Installation Requirements.......................................................................................................... 3

Basic Installation ....................................................................................................................4

Configure Microsoft Dynamics CRM...............................................................................................9

Assign Access Hoover’s User Security Role to Users ........................................................................ 9

D-U-N-S Number Attribute .................................................................................................... 12

Adding D-U-N-S Number attribute on Account and Lead forms...................................................... 12

Custom Field Mapping in Leads, Accounts and Contacts ................................................................ 16

Mapping Industry Picklist Values (Optional) ............................................................................... 18

Uninstall Access Hoover’s for Microsoft Dynamics CRM..................................................................... 19


Installation Requirements To install Access Hoover’s for Microsoft Dynamics CRM, you will need the following:

1. Hoover’s API Key To receive a Hoover’s API Key, you will need to sign up for an Access Hoover’s subscription. You can do this by going to the Access Hoover’s website (www.crm.hoovers.com/msdynamics) or by calling

(866) 464-3207.

Once you have signed up for a subscription, you will receive an email containing all of your account information, including the Hoover’s API Key to use during the Access Hoover’s installation process. If you misplace your API key, contact Hoover’s Customer Support at (866) 464-3207.

2. Microsoft .NET Framework 3.5

If Microsoft .NET Framework 3.5 it is not on your server, you will receive the below warning during the

install process.

If you need to install Microsoft .NET Framework 3.5 on your server, you can use the following link:

• Microsoft .NET Framework 3.5


Basic Installation

1. Go to www.crm.hoovers.com/msdynamics and click on the Installer Download Link for On-Premise Customers. Save the installer to your computer.

2. Open the installer file to start installation. Click Next to continue with the installation.


3. This step shows you the components that will be installed.

You also have the option to create and map a custom D-U-N-S Number field on the Lead and Account

entity. If you already have a D-U-N-S Number field on the Lead and Account entity in your Microsoft Dynamics CRM environment that you want to use, then you can deselect this option.

To continue installation, click Next.

Note: To use a pre-existing D-U-N-S Number field on the Lead and Account entity in your Microsoft Dynamics CRM environment, the attribute must have the following formatting:

• Type is nvarchar

• Format is Text

• Length is 20


4. Enter your Access Hoover’s API Key (you should have received this in an email from Hoover’s), and click Next.

5. If you are not doing a Standard CRM install and have a separate App or Platform server, you can enter your Discovery Service Computer information on this page. Otherwise, the default selection is Standard CRM

Install. After making selections, click Next to continue with install.


6. Select the CRM organization where Access Hoover’s should be installed and click Next.

7. Select the IIS website where CRM is installed (the CRM web) and click Next. You must select the CRM web.


8. Select the web directory where Access Hoover’s will be installed and click Install.

9. After Access Hoover’s has finished installing, click Next.


10. Click Finish to complete the installation process.

Configure Microsoft Dynamics CRM

After installation, it will be important to configure your Microsoft Dynamics CRM environment to enable the following:

• Access Hoover’s User security role

• D-U-N-S Number custom attribute (field) on Lead and Account records

• Custom field mapping on Lead, Account and Contact records

- Required Mapping: D-U-N-S Number field on Lead and Account records

It is critical that you configure your Microsoft Dynamics CRM environment for the above settings in order for Access Hoover’s to operate properly and for you to realize the maximum benefits from Hoover’s. To complete the following set-up instructions for Access Hoover’s, you will need to be a Microsoft Dynamics CRM user with the System Administrator Role.

Assign Access Hoover’s User Security Role to Users

For your Microsoft Dynamics CRM users to be able to use Access Hoover’s, an Access Hoover’s User Security Role was added to your Microsoft Dynamics CRM environment during the installation process.

You will need to assign the Access Hoover’s role assignment to any users who need Access Hoover’s functionality. (They will still keep all their original role assignments.)


Note: Users will need to be in an additional Security Role (besides the Access Hoover’s User role) with the following rights for Account, Contact and Lead: Read, Create, Write, Append and Append To. (See #5 in this section for details).

1. Click on Settings in the

main left-side menu for Microsoft Dynamics CRM.

Then, click on Administration > Users.

2. Select the desired users and

then click More Actions > Manage Roles.


3. Select the Access Hoover’s User role and click on OK button.

4. Verify that a user has the

Access Hoover’s User Role by opening the user record and selecting Roles in the

left-side menu.

You should see Access Hoover’s User listed in the Role view.

5. IMPORTANT:

A User will also need to be in an additional role

(besides Access Hoover’s) that has at least the following minimal rights for

Account, Contact and Lead entities:

Read Create

Write Append Append To

See example.


D-U-N-S Number Attribute

Leads imported using Access Hoover’s include the D-U-N-S Number. When an Account is updated with data from Access Hoover’s, the D-U-N-S Number is added.

During the installation process, you had the option of creating and mapping a D-U-N-S Number attribute for both the Account and Lead entities.

If you chose to create and map these attributes, you still need to add the created attributes to your Microsoft Dynamics CRM Account and Lead entity forms by using the instructions in the following section.

If you chose NOT to create these attributes and are using a pre-existing D-U-N-S Number field in the Microsoft

Dynamics CRM environment, you can skip this section and go to the next section “Custom Field Mapping in Accounts, Contacts and Leads” to do the required mapping.

Adding D-U-N-S Number attribute on Account and Lead forms

You will need to complete the following steps to add the D-U-N-S Number attribute to the entity form for the Account and Lead entities.

1. Click on Settings in the main left-side menu for Microsoft Dynamics CRM.

Then, click Customization >

Customize Entities.


2. Click on the Account entity.

3. Click on Forms and Views in the left-side menu.

Then, click on Form.


4. Click on the section where you would like the D-U-N-S Number field to appear, and

click on Add Fields in the Common Tasks sidebar.

5. Find and select the D-U-N-S Number field, and click on

the OK button.

6. Use the green arrows in the Common Tasks sidebar to

move the field to the desired location on the

form.

Click on Save and Close

button.


7. Click on the Actions menu, and then Publish.

Click on Save and Close button.

8. Verify the D-U-N-S Number field has been added by

opening an actual record.

9. Repeat steps 1-8 for the

Lead entity.


Custom Field Mapping in Leads, Accounts and Contacts You can map more than 50 Hoover’s datapoints to your Lead, Account and Contact record fields in Microsoft

Dynamics CRM. During the installation process, the following native Microsoft CRM fields were mapped for you. You can leave these mappings as-is or modify to your organization’s needs.

Account Record Mapping Lead Record Mapping Contact Record Mapping

MS CRM Attribute Hoover’s Datapoint MS CRM Attribute

Hoover’s Datapoint MS CRM Attribute

Hoover’s Datapoint

address1_city HQ City address1_city HQ City firstname First Name

address1_country Country address1_country Country jobtitle Title

address1_line1 HQ Address 1 address1_line1 HQ Address 1 lastname Last Name

address1_line2 HQ Address 2 address1_line2 HQ Address 2 middlename Middle Name

address1_postalcode HQ Postal Code address1_postalcode HQ Postal Code salutation Prefix

address1_stateorprovince HQ State/Province address1_stateorprovince HQ State/Province suffix Suffix

fax HQ Main Fax address1_telephone1 HQ Phone websiteurl Web Address

hoovers_dunsnumber* D-U-N-S Number* companyname Company Name

name Company Name fax HQ Main Fax

numberofemployees Total Employees firstname First Name

revenue Revenue hoovers_dunsnumber* D-U-N-S Number*

telephone1 HQ Phone jobtitle Title

tickersymbol Symbol lastname Last Name

websiteurl Web Address middlename Middle Name

revenue Revenue

salutation Prefix

*If you opted to create the D-U-N-S Number attribute during Basic Installation: #3, then the attribute is added and mapped for Account and Lead records. websiteurl Web Address

Note: The MS CRM Parent Customer attribute is automatically mapped for the Contact record during the installation process, but you will not see it in the field mappings.

Access Hoover’s provides you with the flexibility to assign Hoover’s datapoints to your existing Microsoft Dynamics CRM fields to maintain the integrity of your own database. For example, you can map the Hoover’s datapoint “Doing Business As” to an existing Microsoft Dynamics CRM field for “DBA,” if a company’s DBA is

important to your organization.

You are also able to create new attributes in Microsoft Dynamics CRM for mapping available Hoover’s datapoints. For example, if you don’t currently have a Biography field on your Contact entity, you can create it, add it to the Contact form and map to the Hoover’s datapoint for Biography.

Most field mapping is optional, but there is one required field – the D-U-N-S Number. This Hoover’s field must be mapped to a field in Microsoft Dynamics CRM on the Account and Lead records. If you had these fields added

during the installation process, then they are already mapped for you.

Note: You will be unable to save your mapping assignments unless the D-U-N-S Number field is mapped on the Account and Lead mapping page.

You can use the instructions below for mapping fields to Lead, Account and Contact records. The only difference will be that the D-U-N-S Number field is not required for Contact records.


1. Click on Settings in the main left-side menu for Microsoft Dynamics CRM.

Then, click Hoover’s Configuration > Map Account Fields.

(Use these same instructions for mapping Lead and Contact records).

2. The CRM Attribute column

will list all of the attributes for the entity you are

mapping. The Hoover’s Field column

will show you a list of all Hoover’s datapoints.

Select a Hoover’s datapoint from the drop-down box to

be associated with your CRM field.

The D-U-N-S Number attribute is a required

mapping for Account and Lead records.

CRM Attributes that are integers will only be able to be mapped to integer fields

in Hoover’s.

When you have completed mapping, click on the Save All Changes button and

close window.

3. Repeat the above process for Lead and Contact records.


Mapping Industry Picklist Values (Optional) Mapping industry picklist values enables you to control the picklist values that are available to your users.

1. Click on Settings in the

main left-side menu for

Microsoft Dynamics CRM. Then, click Hoover’s Configuration > Map Industry Values for Accounts. (Use these same

instructions for mapping industry values for Lead

records).

2. The Hoover’s Value column

will list the Hoover’s industry values.

The CRM Value column will list the industry values available in Microsoft

Dynamics CRM.

Select a Microsoft Dynamics CRM value from the drop-down box to be associated

with your Hoover’s Value.

You can associate a Microsoft Dynamics CRM value to more than one

Hoover's value. When you have completed

mapping, click on the Save All Changes button and

close window.

3. Repeat the above process for industry values for Lead

records.


Uninstall Access Hoover’s for Microsoft Dynamics CRM

The Access Hoover’s for Microsoft Dynamics CRM On-Premise uninstall process allows you to select from the following options:

• Uninstall - Remove all installed components This will remove the Hoover’s AppPool, Hoover’s Virtual, Hoover’s web files and all Hoover’s customizations from the Sitemap and ISV.

• Uninstall Organization – Remove org-specific components from one org This will remove the Hoover’s customizations from the Sitemap and ISV for a specific org within a multiple org environment.

• Uninstall Customizations – Remove ISV and Sitemap related customizations This will only remove the Hoover’s customizations from the Sitemap and ISV.

NOTE: The above options will NOT remove custom entities or attributes that were added during installation, so you can still view that data in your system. If you do not want the custom entities and attributes in your

system, you can manually remove them. Just remember, by deleting the entity or attribute, you lose all of the associated data.

1. Find and open the installer file. If you did not save it to the server, go to

www.crm.hoovers.com/msdynamics, and click on the Installer Download Link for On-Premise Customers. Save the installer to your computer.

Open file and click Next to continue with uninstall.


2. Select the desired Uninstall option, and click Next.

3. Select how your Microsoft CRM Instance was installed.


4. Select the CRM Organization where the Access Hoover’s integration should be uninstalled, and click Next.

5. You have uninstalled Access Hoover’s integration with Microsoft Dynamics CRM. Click Finish.

Documents

for Microsoft Dynamics CRM - D&B Hooversimages.hoovers.com/images/pdfs/AH_for_MSCRM_OnPrem_33009.pdfTo install Access Hoover’s for Microsoft Dynamics CRM, you will need the following: