for Microsoft Dynamics CRM On-Premise Installation Instructions

Transcription

1 for Microsoft Dynamics CRM On-Premise Installation Instructions March

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 Adding D-U-N-S Number attribute on Account and Lead forms Custom Field Mapping in Leads, Accounts and Contacts Mapping Industry Picklist Values (Optional) Uninstall Access Hoover s for Microsoft Dynamics CRM HOOVER S, INC AIRPORT BLVD. AUSTIN, TX

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 ( or by calling (866) Once you have signed up for a subscription, you will receive an 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) 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 AIRPORT BLVD. AUSTIN, TX

4 Basic Installation 1. Go to 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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

6 4. Enter your Access Hoover s API Key (you should have received this in an 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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 Note: The MS CRM Parent Customer name Company Name fax HQ Main Fax attribute is automatically mapped for the Contact record during the numberofemployees Total Employees firstname First Name installation process, but you will not revenue Revenue hoovers_dunsnumber* D-U-N-S Number* see it in the field mappings. telephone1 HQ Phone jobtitle Title tickersymbol Symbol lastname Last Name websiteurl Web Address middlename Middle Name *If you opted to create the D-U-N-S Number revenue Revenue attribute during Basic Installation: #3, then the attribute is added and mapped for salutation Prefix Account and Lead records. websiteurl Web Address 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 AIRPORT BLVD. AUSTIN, TX

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 AIRPORT BLVD. AUSTIN, TX

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 dropdown 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 AIRPORT BLVD. AUSTIN, TX

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 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 AIRPORT BLVD. AUSTIN, TX

20 2. Select the desired Uninstall option, and click Next. 3. Select how your Microsoft CRM Instance was installed. HOOVER S, INC AIRPORT BLVD. AUSTIN, TX

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. HOOVER S, INC AIRPORT BLVD. AUSTIN, TX