MS CRM 3.0 DMF Gotchas

Having spent over a day grappling with the Microsoft CRM Data Migration Framework v3.1 for MS CRM 3.0 I thought it useful to document some mistakes I made.

  1. In the CDF DO NOT insert rows into cdf_<entity>_info or cdf_<entity>_ext tables as these rows are created by triggers on inserts to the base table. Thus if you need to populate your custom fields in cdf_account_ext you first insert the row in to cdf_account and then UPDATE the auto-created row in cdf_account.
  2. Do NOT populate OwningUser even when you’re sure you have the right lookup to cdf_systembase! Instead populate the OwningUserName column with the username in the form DOMAIN\USER
  3. As (2) do not populate TerritoryID use TerritoryIdName and then use the CDF Data Mapping Wizard (under Cleanse CDF in the DMF app) to map the string to the correct picklist ID.
  4. For an account [name] is a required field
  5. LASTLY BUT MOST IMPORTANT, ensure you are running the DMF using an NT login with access to MS CRM and has a role assigned – a restricted access account does not seem to be sufficient for the DMF to create the rows. This got me for hours, not helped by the fact that the DMF has to be installed on the CRM server and funnily enough we don’t assign expensive CRM licences to the sysadmin accounts!

I really think MS need to look at this tool, the CDF is very good, especially for people who are good with MS SQL, however there is a complete lack of error messages. I lost over 4 hours (see point 5) due to the lack of errors. I’ve encountered the same error when adding accounts via the webservice directly and it generates an exception – why doesn’t DMF expose the exception?


2 responses to “MS CRM 3.0 DMF Gotchas

  1. hello. I am trying to learn how to use the DMF and I kinda got stuck on this CDF creating/populating thing; to be more specific, I cannot really understand how one can insert the data that needs imported from other data sources into this CDF that the DMF creates.
    I’d really appreciate your answer regarding these or some hints.

    Best regards,

  2. Sander, apologies your comment was flagged as spam. Did you have any luck?


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s