Microsoft Dynamics CRM Online Help

Export data to delimited files

Most customer relationship systems include a backup function that exports data to files. These files typically are in one of the following formats: delimited text (.txt), comma-separated value (CSV) files , XML (.xml), or Microsoft Office Excel (.xls or .xlsx).

The Import Data Wizard requires all import files to have a .csv, .txt, .xml, or .zip extension and format. If your backup system created a file in another format, convert that file into one of the required file formats. (The text inside a .csv file can use any delimiter, not necessarily a comma.)

  1. Save each type of record into a separate file:
    • Specify a file name for each record type. Use one of the following criteria to determine how you name your file.
      • If you select Map Automatically, then the Import Data Wizard tries to match the file name with the record type name in Microsoft Dynamics CRM Online. For the simplest match, make the file name that same as the Microsoft Dynamics CRM Online entity display name.
      • If you are using a data map, then match the file name to the value specified in the SourceEntityName parameter in the <EntityMap> element for the record type.
      • If you are using a data map but the file name does not match with the name in the data map, then the file is shown as "Not Mapped." Manually map the file using the Import Data Wizard.
    • Store Notes and Attachments in separate files from their associated records.

      More information: How Notes and Attachments Are Imported

    • Store Addresses in a separate file.

      More information: How Addresses Are Imported

  2. Make sure that the data in each file is delimited correctly. All files in one import must use the same delimiters.
    • Separate each column of data with a consistent field delimiter: a comma (,), colon (:), semi-colon (;), or tab character (\t).
    • If the data for any column includes a field delimiter character, place a data delimiter character on both sides of the field data. Use straight quotation marks (") or a single straight quotation marks ('). Typically, double quotation marks are used as data delimiters.

      For example, if your field delimiter is a comma and your source data my contain an "Address" column that includes a comma. An example address using a comma is 123 Main Street, Apartment 2. Use "123 Main Street, Apartment 2" for the field data in this example.

  3. If needed, convert your files to the .csv extension. How you do this depends on whether your data uses ASCII or non-ASCII characters.

    If the data is in XML format, open the file in Excel.

    If the data is in Excel files and uses only ASCII characters, save each file as a .csv file.

    If the data is in Excel files and uses non-ASCII characters, convert each file to Unicode or UTF-8.

  4. If there the data in a file lacks a column heading, adding a column heading is recommended.
    • Review the column headings in each file:
      • If you select Map Automatically, the Import Data Wizard tries to match the column name with the field name in Microsoft Dynamics CRM Online. For the most efficient matching, the column heading and Microsoft Dynamics CRM Online field display name should match.
      • If you are using a data map, the column heading must match the value specified in the <SourceAttributeName> element in the <AttributeMap> element for the attribute.
      • If you are using a data map but the column name does not match with the name in the map, the column is shown as "Not Mapped". You can manually map it in the Import Data Wizard.
  5. Make sure all your files conform to the following file size and row length limits:
    • Any .csv, .txt, or .xml file must not exceed 8 MB in size.
    • The total size of the .zip file with the attachment folder cannot exceed 32 MB.
    • The total size of the extracted files must not exceed 200 MB.
  6. Remove any new line characters (\n) from the data in your source files. If the data contains new line characters, the record will not import.

Related Topics

Work with Imports

© 2011 Microsoft Corporation. All rights reserved.