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
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 3
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
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 4
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 5
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
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 6
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 7
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 8
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 9
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.)
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 10
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 11
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 12
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 13
2. Click on the Account entity.
3. Click on Forms and Views in the left-side menu.
Then, click on Form.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 14
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 15
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 16
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 17
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 18
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 19
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.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 20
2. Select the desired Uninstall option, and click Next.
3. Select how your Microsoft CRM Instance was installed.
HOOVER’S, INC. • 5800 AIRPORT BLVD. • AUSTIN, TX 78752-4204 | www.crm.hoovers.com/msdynamics 21
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.