Print      Open PDF Version of Online Help

Previous Topic

Next Topic

Importing Your Contacts

As a nonadministrator, you can import up to 2000 contacts at a time from a comma-separated value (.csv) file to use with Oracle CRM On Demand.

When you import contacts, you specify how you want Oracle CRM On Demand to handle duplicate records.

Several utilities are available from the Import and Export Tools page, which augment the import and export facilities in Oracle CRM On Demand:

For more information about choosing an appropriate import method, see 1089184.1 (Article ID) on My Oracle Support. For more information on importing and exporting in Oracle CRM On Demand, see Import and Export Tools.

NOTE: Company administrators can import up to 30,000 contact records at one time, with a maximum file size of 20 MB.

Before you begin. If several employees at your company are importing contacts, coordinate the importing effort to minimize record duplication. Also, prepare your file for importing to make sure you capture all the data in the file.

CAUTION: You cannot undo the importing of records or perform a mass deletion of records. Therefore, practice the importing procedure with a file of 5-10 records to avoid cleaning up data afterwards. If your company is importing a large number of records, attend a training session on importing data. For information on those resources, click the Training and Support link at the top of each page within Oracle CRM On Demand.

To import your contacts

  1. Click the Contacts tab.
  2. In the Recently Modified Contacts title bar, click Import.

    NOTE: If the Recently Modified Contacts section is not visible on your Contacts Homepage, click the Edit Layout link in the upper right corner of the page, and add the Recently Modified Contacts section to your page layout.

  3. On the Data and Integration Tools page, in the Personal Import and Export Tools section, click Import Your Contacts.

    This starts the import assistant.

  4. In Step 1 of the import assistant:
    1. Select how you want the import assistant to identify matching records.

      The import assistant uses an external unique ID, which is a unique external ID field that is imported from another system. The import assistant also uses Oracle CRM On Demand predefined fields.

      For information on how duplicate records are defined, see About Record Duplicates and External IDs.

    2. Select what you want the import assistant to do if it finds a duplicate unique record identifier in Oracle CRM On Demand. Your choices are: not to import duplicate records, to overwrite existing records, or to create additional records.
    3. Select the action you want the import assistant to follow if the imported record's unique record identifier does not match an existing record in Oracle CRM On Demand.

      NOTE: If you select Overwrite Records and Don't Create New Record in the previous option, this results in the record being updated.

    4. Decide if the import assistant should create a new record for missing associations (related records) in your data file.
    5. Select the date/time format used in the CSV file.

      For more information, see Field Type Guidelines for Importing Data.

    6. Verify that the file encoding selection is Western European.

      NOTE: You should not change this unless you are certain another encoding method is used. The default, Western European, applies to most encoding systems in Europe and North America.

    7. Select the type of CSV delimiter used in your file: comma or semi-colon.
    8. Select what you want Oracle CRM On Demand to log from the Error Logging menu: all messages, errors and warnings, or errors only.
    9. Select the CSV file whose data you want to import.
  5. In Step 2 of the import assistant:
    1. Follow the instructions for validating your file, if necessary.
    2. Select a field mapping file, if available.

      Field mapping files (.map) contain the pairing of fields in your CSV file with existing Oracle CRM On Demand fields. After you perform an import, the system sends you an email containing the .map file with the recent mapping scheme. Save it to your computer to re-use it during later imports.

  6. In Step 3 of the import assistant, map the fields in your file to Oracle CRM On Demand fields. At a minimum, you must map all required fields to the column headings in the CSV file.

    The import assistant lists the column headings from your import CSV file next to a list showing all the fields in that area in Oracle CRM On Demand, including the custom fields that you added.

    If the address field you need does not appear in the drop-down list, select the corresponding one shown in this table.

    To filter your list on this field

    Select this field from the drop-down list

    Street Number
    Address 1



    Address 2


    Address 3



    CEDEX Code
    Address 4

    PO Box/Sorting Code

    MEX State
    BRA State
    Part of Territory


    Island Code
    Boite Postale
    Codigo Postal

    Zip/Post Code

    If you selected a .map file, verify that the fields map correctly. Custom fields created since you ran the previous import might need to be mapped.

    For information about external IDs, see About Record Duplicates and External IDs.

    CAUTION: If you have selected the wrong file to import, click Cancel to change selections. At this point, using the Back button does not clear the cache, so the import file you originally selected appears in the field mapping step.

    CAUTION: External Unique ID and Manager External ID are key fields that are used to associate Contacts with their Manager Records. If these fields are not mapped, the Manager Record will be associated with Contacts using the Contact Name and Manager fields. When using the Contact Name and Manager fields to do this association, the data file records will be subject to more stringent dependency ordering.

  7. In Step 4 of the import assistant, follow the onscreen instructions, if necessary.
  8. In Step 5 of the import assistant, click Finish.

To view the queue for your import requests

  1. Click the Contacts tab.
  2. In the Recently Modified Contacts title bar, click the Import button.
  3. On the Data and Integration Tools page, click the Import Request Queue link.

    The Import Request Queue page appears with information about your requests, including the estimated time of completion.

    The following table describes the import status.




    The import completed with no errors during import.

    Completed with Errors

    The import completed but there were some errors with some of the records.


    The import completed but none of the records were imported.


    The import did not complete because an error occurred.

The following table describes the import record information.

Import Record Information


# Submitted

The number of records contained in the CSV file.

# Processed

The number of records the import engine has currently processed. This field is processed every 20 seconds, or as set by a system process.

# Successfully Imported

The number of records that were imported without any problems.

# Partially Imported

The number of records that were imported. Not all records were imported.

# Not imported

The number of records that were not imported at all.

Published 5/4/2012 Copyright © 2005, 2012, Oracle. All rights reserved. Legal Notices.