How To: Creating Custom Report with Microsoft Dynamics CRM 2011 BIDS Fetch Extension

 

The new Microsoft CRM 2011 architecture will allow report developers to create reports and customize them more than before.  Prior to Microsoft CRM 2011, reporting was mostly created via a report wizard within the CRM application and was not as customizable or flexible as people would want.  Here are the steps on creating a custom report with Microsoft Dynamics CRM 2011 via BIDS Fetch Extension:

 

Requirements:

-          Microsoft SQL Server 2008 or 2008 R2 Business Intelligence Development Studio (BIDS) installed

-          Microsoft Dynamics CRM 2011 BIDS Fetch Extension installed

-          Microsoft CRM 2011 Online account

 

Part A – Setup a Microsoft CRM 2011 FetchXML Custom Report development environment

 

  1. Setup a Windows 7 32 bit or 64 bit PC

Other supported OS: Vista, Windows Server 2008 or Windows Server 2008 R2

 

  1. Install the Microsoft SQL Server 2008 or 2008 R2 Business Intelligence Development Studio (BIDS) feature

 

  1. Install the Microsoft Dynamics CRM 2011 Fetch Extension

Run the “CRM2011-BIDSExtensions-ENU-i386.exe” installation program

 

Part B – Create a Microsoft CRM 2011 FetchXML Report

 

  1. To start creating the report, you need to open the Microsoft SQL Server Business Intelligence Development Studio (BIDS)

 

  1. Create a new project and select the Report Server Project from templates; be sure to include a name and the location to store the project

 

  1. You should have a Reports folder within your project; right click and Add New Report, this should start the Report Wizard

 

  1. Click next until you see the page with the Data Source options. You need to select a new datasource (do not save or make as a shared) – this is important because you want the datasource information local within the file you upload to CRM. Referring to a saved data source will not work because the information will not be available when uploaded to the CRM server

 

  1. Select Microsoft Dynamics CRM Fetch for type and fill in the connection string in the following format: ServerURL;OrganizationName;HomeRealmURL

 

    1. only ServerURL is required, this would be the url to your CRM server like: https://someserver.crm.dynamics.com

 

    1. The optional OrganizationName should also be included if you have multiple CRM environments, it will use the first organization otherwise – you will find this value within the Developer Resources area in the CRM client located within Settings > Customizations (refer to the red mark).

 

    1. The HomeRealmURL, also optional, it will be a registry value from HKLM\SOFTWARE\Microsoft\MSCRMBidsExtensions\HomeRealmUrl

 

  1. Next you need to enter in the credentials for you connection, it should be your Windows LiveID (WLID) – usually the email that you use to sign-in the CRM Online along with its password. Click Credentials to fill in this information and afterwards you can click next

 

  1. If successful, you will move onto the next page where it will ask for a FetchXML type query. Since this is a report, a query is important to obtain the information you want in the report

 

    1. One way to obtain a FetchXML query is to start by using the CRM Online web client and creating an Advanced Find query.

 

    1. A query usually involves asking for the columns of data you want to retrieve also, make sure you click Edit Columns so that you can select the data you want to see in your report

 

    1. Lastly, click Download Fetch XML and you should be able to view the xml file with the supplied query. I usually just open it with a browser and then view Page Source to copy the text

 

  1. Up to this step, most of the work has been done and the remaining steps of the wizard will guide you through and offer ways to customize the layout and appearance of your report

 

  1. Once you have finished using the wizard, I suggest previewing (Preview tab) the report before uploading – this will connect directly to CRM and give you the actual report. One advantage about creating a report this way is you can edit the report within Visual Studio (Design tab) and modify or add items to the report to make it more presentable

 

  1. The report should be an .RDL file that gets created; this file will need to be uploaded into the CRM environment

 

    1. Open the web client and navigate to Reports, normally found in the Workplace section. Once there, create a new report by clicking New at the top left

 

    1. Select Existing File as the Report Type, the File Location should now be enabled

 

    1. Browse to that .RDL file that was created by the project and upload it

 

  1. You have now completed your report and uploaded it to the CRM system, you can click Save and test it out by opening the report

 

Harold Lee
Workopia, Inc.


 

www.workopia.com

 

   ► Microsoft CRM Links

   ► Microsoft CRM How To Articles