To migrate from ACT! 2005, version 7 to Microsoft Dynamics CRM, you need to export your data from ACT! 2005, version 7, prepare your source data for migration, and then run the Data Migration Manager to map and migrate your data. For an overview of the migration process, see Data migration overview.
This article describes how to export your data and set up your source files to match Microsoft Dynamics CRM record types, shows you where the default fields in ACT! 2005, version 7 map to in an uncustomized Microsoft Dynamics CRM, and includes detailed steps for using Data Migration Manager to do your own mapping.
Important
- The mappings in this article are guidelines only. Because your ACT! 2005, version 7 database and Microsoft Dynamics CRM may be customized, you will need to verify that the mappings make sense for your data.
- Because the data format changed between ACT! 2005, version 6 and ACT! 2005, version 7, the ACT! 2005, version 6 data map provided with Data Migration Manager will not work with ACT! 2005, version 7 data.
Preparing the data
Before migration, data must be in comma-separated value format (.CSV) files, and each file must contain data for one record type in Microsoft Dynamics CRM.
Prepare your data:
- Export account and contact data from ACT! 2005, version 7 to text files. These files can contain comma-delimited or tab-delimited data.
- Rename the exported data files to Accounts.csv and Contacts.csv.
- Remove any newline characters from the data in Accounts.csv and Contacts.csv. If a record contains the newline character, it will not migrate.
- Because some of the data in ACT! 2005, version 7 account records must be stored in CustomerAddress record types in Microsoft Dynamics CRM, make two copies of Accounts.csv, naming the copies BillingAddress.csv, and ShippingAddress.csv. In Data Migration Manager, you will map the needed columns in each file to attributes in the Account and CustomerAddress record types.
- Edit the BillingAddress.csv file:
- Delete all columns except:
- Billing City
- Billing Country
- Billing Address1
- Billing Address2
- Billing Address3
- Billing ZIP Code
- Billing State
- Company
- Add two columns: Address Type, and Object Type.
- In the Address Type column, add the value Bill to in all rows.
- In the Object Type column, add the value 1 in all rows. (The value 1 indicates that this address belongs to an account. The value 2 indicates that this address belongs to a contact.)
- Edit the ShippingAddress.csv file:
- Delete all columns except:
- Shipping City
- Shipping Country
- Shipping Address1
- Shipping Address2
- Shipping Address3
- Shipping ZIP Code
- Shipping State
- Company
- Add two columns: Address Type, and Object Type.
- In the Address Type column, add the value Ship to in all rows.
- In the Object Type column, add the value 1 in all rows. (The value 1 indicates that this address belongs to an account.)
- If you want to map the owners of records to Microsoft Dynamics CRM users other than you, refer to footnote � in the Review the Mapping Tables section. If necessary, create a Users.csv file.
Review the mapping tables
Review the data in the following tables to see how the columns in the source Accounts.csv and Contacts.csv files map to attributes in Microsoft Dynamics CRM.
Account mapping table
ACT! 7 attribute
|
Account mapping
|
Billing City
|
Ignore
|
Billing Country
|
Ignore
|
Billing Address 1
|
Ignore
|
Billing Address 2
|
Ignore
|
Billing Address 3
|
Ignore
|
Billing Address 4
|
Ignore
|
Billing ZIP Code
|
Ignore
|
Billing State
|
Ignore
|
City
|
Address 1: City
|
Country
|
Address 1: Country/Region
|
Address 1
|
Address 1: Street1
|
Address 2
|
Address 1: Street2
|
Address 3
|
Address 1: Street3
|
Phone
|
Main Phone
|
ZIP Code
|
Address 1: ZIP/Postal Code
|
State
|
Address 1: State/Province
|
Extension
|
Ignore, or create a custom attribute �
|
ID/Status
|
Relationship Type
|
Record Creator�
|
Ignore�
|
Company Description
|
Description
|
Division
|
Create a custom attribute
|
Fax Phone
|
Fax
|
Fax Extension
|
Ignore, or create a custom attribute �
|
Industry
|
Industry
|
Company
|
Account Name
|
Number of Employees
|
Number of Employees
|
Referred By
|
Ignore, or create a custom attribute �
|
Region
|
Ignore, or create a custom attribute �
|
Revenue
|
Annual Revenue
|
Shipping City
|
Ignore
|
Shipping Address 1
|
Ignore
|
Shipping Address 2
|
Ignore
|
Shipping Address 3
|
Ignore
|
Shipping ZIP Code
|
Ignore
|
Shipping State
|
Ignore
|
SIC Code
|
SIC Code
|
Territory
|
Territory Name
|
Ticker Symbol
|
Ticker Symbol
|
Toll-Free Phone
|
Other Phone
|
Toll-Free Extension
|
Ignore, or create a custom attribute �
|
Web Site
|
Website
|
Contact mapping table
ACT! 7 attribute
|
Contact mapping
|
Add to ACT! Note
|
Ignore
|
Alternate Phone
|
Address 1: Telephone2
|
Alternate Extension
|
Ignore �
|
Birth Date
|
Birthday
|
City
|
Address 1: City
|
Country
|
Address 1: Country
|
E-mail
|
E-mail
|
Address 1
|
Address 1: Street
|
Address 1
|
Address 1: Street1
|
Address 2
|
Address 1: Street2
|
Address 3
|
Address 1: Street3
|
Phone
|
Address 1: Phone
|
ZIP Code
|
Address 1: ZIP/Postal Code
|
State
|
Address 1: State/Province
|
Extension
|
Ignore
|
ID/Status
|
Relationship Type
|
Company
|
Parent Customer (Account Name)
After you map the column, you will see the Define Relationship page. On this page, select Account, select Account Name, and then click Next.
|
Web Site
|
Website
|
Record Creator �
|
Ignore �
|
Receive Newlsetter
|
Ignore, or create a custom attribute �
|
Delivery Instructions
|
Ignore, or create a custom attribute �
|
Department
|
Department
|
Fax Phone
|
Fax
|
Fax Extension
|
Ignore, or create a custom attribute �
|
First Name
|
First Name
|
Contact
|
Create a custom attribute
|
Home City
|
Address 2: City
|
Home Country
|
Address 2: Country
|
Home Address 1
|
Address 1: Street1
|
Home Address 2
|
Address 1: Street2
|
Home Address 3
|
Address 1: Street3
|
Home Phone
|
Home Phone
|
Home ZIP Code
|
Address 2: ZIP/Postal Code
|
Home State
|
Address 2: State/Province
|
Home Extension
|
Ignore, or create a custom attribute �
|
Messenger ID
|
Ignore, or create a custom attribute �
|
Private Contact
|
Ignore, or create a custom attribute �
|
Title
|
Job Title
|
Last Attempt
|
Ignore, or create a custom attribute �
|
Letter Date
|
Ignore, or create a custom attribute �
|
Last Meeting
|
Ignore, or create a custom attribute �
|
Last Reach
|
Ignore, or create a custom attribute �
|
Last Results
|
Ignore, or create a custom attribute �
|
Middle Name
|
Middle Name
|
Mobile Phone
|
Mobile Phone
|
Mobile Extension
|
Ignore, or create a custom attribute �
|
Name Prefix
|
Create custom attribute
|
Name Suffix
|
Ignore, or create a custom attribute �
|
Pager Phone
|
Pager
|
Pager Extension
|
Ignore, or create custom attribute �
|
Personal E-mail
|
Email Address 2
|
Referred By
|
Ignore, or create a custom attribute �
|
Salutation
|
Salutation
|
Spouse
|
Spouse/Partner Name
|
User 1 ... User 10 �
|
Ignore, map to existing attribute, or create custom attribute �
|
Billing address mapping table
ACT! 7 attribute
|
Billing-address mapping
|
Billing City
|
City
|
Billing Country
|
Country/Region
|
Billing Address 1
|
Street1
|
Billing Address 2
|
Street2
|
Billing Address 3
|
Street3
|
Billing ZIP Code
|
ZIP/Postal Code
|
Billing State
|
State
|
Company
|
Parent (Account Name)
After you map the column, you will see the Define Relationship page. On this page, select Account, select Account Name, and then click Next.
|
Address Type
|
Address Type
|
Object Type
|
Object Type
|
Shipping address mapping table
ACT! 7 attribute
|
Shipping-address mapping
|
Shipping City
|
City
|
Shipping Country
|
Country/Region
|
Shipping Address 1
|
Street1
|
Shipping Address 2
|
Street2
|
Shipping Address 3
|
Street3
|
Shipping ZIP Code
|
ZIP/Postal Code
|
Shipping State
|
State
|
Company
|
Parent (Account Name)
After you map the column, you will see the Define Relationship page. On this page, select Account, select Account Name, and then click Next.
|
Address Type
|
Address Type
|
Object Type
|
Object Type
|
� The mappings shown in the table will result in all records being owned by the user who migrates the data. If your goal is to have more than one owner or someone else as the record owner, you can use one of the following approaches:
- After migrating the records using the mapping described in this article, use Microsoft Dynamics CRM to bulk-assign the records to specific users. For an example of using Advanced Find to find and bulk-assign records, see Don't lose customers when a salesperson leaves your organization.
- Instead of ignoring the Record Creator column during mapping, map the Record Creator column for accounts and contacts to the Microsoft Dynamics CRM Owner attribute. You will also need to create and migrate a Users.csv file that includes a record for each user in the source data.
You will be prompted by Data Migration Manager to map each Record Creator value to a Microsoft Dynamics CRM user, and will be given the option to create a new user, if needed. For more information on migrating ownership data, see the topic "How Ownership Data is Migrated" in the Data Migration Manager Help file.
� For user defined fields, you have a choice on how to map the data. Select the option that makes sense given the information contained in your source data file. If you need to create custom attributes, see the topic "Custom Attributes" in the Data Migration Manager Help file.
� For fields that exist in ACT! 2005, version 7, but do not exist, by default, in Microsoft Dynamics CRM, you can either ignore the data or create a custom attribute. Review the data in your source file to see if you have useful data in this field that needs to be preserved.
Migrating the data
- On the Start menu, click All Programs, click Microsoft Dynamics CRM, and then click Microsoft Dynamics CRM Data Migration Manager.
- Click Start a Migration.
- Select the Start a new migration option, and then on the Get Started page, click Next.
- Click Start a Migration.
- Specify the migration name, enter ACT7 as the source system, and then click Next.
- Select the .csv files you created: Accounts.csv, Contacts.csv, BillingAddress.csv, ShippingAddress.csv, and optional Users.csv, and then click Next.
- Specify the delimiters:
- Select the delimiter used in the source files, and the character that is used to enclose fields that contain the delimiter.
- Select the First row of each file contains column headings checkbox.
- Preview each file to make sure it displays correctly, including using the horizontal scroll to check all columns.
- Click Next.
Note
If errors are found while validating files, such as finding newline characters, a separate error page will be displayed. Troubleshoot any errors.
- On the File Mapping page, click Next.
- For each of the four files, select Map this file to an existing Microsoft Dynamics CRM entity, select the entity with the same name as the file, and then click Next.
- On the File Summary page, click Next.
- On the Column Mapping Results page, click Next.
- For each column in the Accounts.csv file, on the Map Column page, select the needed option based on the mapping shown in the Account mapping table, and then click Next.
- For each column in the Contacts.csv file, on the Map Column page, select the needed option, based on the mapping shown in the Contact mapping table, and then click Next.
- For each column in the BillingAddress.csv file, on the Map Column page, select the needed option, based on the mapping shown in the Billing Address mapping table, and then click Next.
- For each column in the ShippingAddress.csv file, on the Map Column page, select the needed option, based on the mapping shown in the Shipping Address mapping table, and then click Next.
- The Column Summary page appears. Click Next.
- The User Summary page appears. Unless you created a Users.csv file and mapped ownership of the records, all records will be assigned to the current user. Click Next.
- The Review Summaries page appears. Click Next.
- The Start Migrating Data page appears. Click Migrate Data.
- The Converting Data page appears,converting your data to the required format, and uploading it to your server. If no errors are found, the wizard will continue to the Migration Completed page.
- If no errors are found, click Next.
- If errors are found, the first 50 are displayed. To view additional errors and error details, click Export Errors.
- The Uploading Data page appears, the data is uploaded to the server, and migration is complete.
- If no errors are found, click Next.
- If errors are found, the first 50 are displayed. To view additional errors and error details, click Export Errors.
- Any data not listed on the error page successfully migrated.
- Click Finish.
Your ACT! 2005, version 7 data is now migrated. If you need to do another migration from ACT! 2005, version 7, you can reuse these mappings by selecting the migration name you specified in step 5 when you start your new migration.
Related Links
Data migration overview
Blog post: Record Owner Migration