Monday, January 28, 2019

Dynamics 365–Open URL in a new window from SiteMap

The way I have found to be able to do this is by adding a web-resource HTML file with the following code:


        <title>New Window</title>

         <script type="text/javascript">
             function OpenWindow(url)
               var newWindow =,"_blank");
               if (window.focus) {
         Opening new window….

Then add a web-resource sub-item onto the SiteMap and point it at the web resource. That should do it!

Note about UCI: in UCI, a URL always opens in a new window, which is a change in behavior from the web-legacy interface and so you dont need the above hack to open the URL in a new window

Wednesday, January 23, 2019

Embed PowerBi Report in Dynamics CRM system dashboard

Its easy to create a dashboard that either includes the entire PowerBi dashboard (Power BI Dashboard) option.


Or you can include pieces from a PowerBi Dashboard (Dynamics 365 Dashboard and add a PowerBi tile)


The problem with this option is that they are “personal” dashboards and so you have to share them with users. This is not ideal when you have to share the dashboard with all users. Dashboards that can be made available to all users are system dashboards. But system dashboards cannot include PowerBI dashboards or tiles (why! oh! why!)

Here is a less than ideal workaround (not ideal, as you cant share a PowerBi dashboard or tile). You can only embed a full powerBi report (because we will be embedding it as an iframe).

  1. First, you need to make your report available for embedding. You do this by opening your PowerBi report online ( and then click File >> Embed
  2. The next dialog will provide you a URL, copy it
  3. Create a new Dashboard by going to “Customizations” in Dynamics CRM
  4. Add an iFrame component onto your dashboard and set the url to the one you copied above:

That will make your entire PowerBi dashboard available on the Dynamics CRM dashboard.

PowerBi–Dynamics 365 (Online) Connector vs Common Data Service for Apps Connector

Its been a while since I have looked at the CDS connector, so I thought I would go looking and here are some things I found:

PowerBi desktop version: December 2018

The CDS connector is still in beta!


And still provides the warning:



The one big thing I noticed right of the bat is that the dialog doesnt allow the usage of parameters (more on a work around later).

There are 2 new settings (that I havent seen earlier): Reoder columns and Add display column. Setting them both to true leads to a couple of very awesome improvements over the the Dynamics Online connector:

First, the columns are all alphabetized! If you have ever had to look for a column with the old connector (we have 200 fields on account), you know how amazing having ordered columns is!

Second, is that you now get the display value in addition to the actual value! hallelujah!


Once you select your entities and load your source, you see the next nice difference, tables are named with their singular names instead of the plural names. This used to drive me crazy and I like using the singular names, so in my opinion – cool!


In the image above, the first set of tables was loaded using the Dynamics 365 (online) connector. The 2nd one was created using the Common Data Service for Apps connector. Something to note is that you can still access the old named tables under the “System” node when you are selecting the entities.

Back to the issue of not being able to use parameters:

If you click on the “Advanced Editor”, you can update the connection to use a parameter:

     Source = Cds.Entities(#"Sales CRM URL", [ReorderColumns=true, UseFormattedValue=true]),
     entities = Source{[Group="entities"]}[Data],
     accounts = entities{[EntitySetName="accounts"]}[Data]

In the example above, "Sales CRM URL" is a parameter that I have defined and points at the CRM api url. And the CDS connection still works. So its just the dialog that doesnt support parameters, but you can still use the parameter in the queries. (Be advised that you wont be able to open the dialog again for the connection.

Another thing I wanted to look at was what the file size looked like using the CDS connector vs the D365 connector and they were pretty much the same (and in fact the CDS connector:


All in all, the new CDS connector works great and also includes many of the entities that didnt show up before (eg: leads). I just wished that it would graduate from beta soon!



Saturday, January 12, 2019

Dynamics 365 - Copying Notes from a Lead to an Account

We had a requirement to copy notes from a lead onto an account, when the lead is qualified. There is no OOB way to do this, but I found a Workflow library called “msdyncrmWorkflowTools” that has a step that can do this. Here is how:

The step is called “Clone Children”:

First install the Workflow library by downloading the solution from and importing the solution into your CRM solution.

  1. Next create a workflow process that is attached to the “Account” entity.

  2. After you save it, open the newly created process.
  3. Set the scope to “Organization” (not a required step)
  4. Set the execute as to “owner of the process” (not a required step)
  5. And set the process to run when the “record is created”
  6. Next add a check condition to see if the account’s Originating Lead has been set, which would signal that the account was being created from a lead.
  7. Next add the Clone Children step from “msdyncrmWorkflowTools (
  8. Set the properties to the following values:
    image image
    The relationship name is case-sensitive, so enter it as Lead_Annotation.
    The new parent field, which is used for the old parent field name is objectid.
  9. Save and activate the process and test it!

Friday, January 04, 2019

XrmToolbox–useful build settings

  1. ILMerge
    Used, when you have multiple assemblies and you need to package them together.
    Stage: Post Build Step

  2. ilmerge.exe /target:library /targetplatform:v4,"C:\Windows\Microsoft.NET\Framework\v4.0.30319" "/out:CombinedModuleName.dll" "inputModule1.dll" "inputModule2.dll" "inputModule3.dll"

  3. Copy the plugin to a plugins folder
    This makes it easier to tell XTB to load the dll you are developing

  4. if $(ConfigurationName) == Debug (
      IF NOT EXIST Plugins mkdir Plugins
      move /Y  "CombinedModuleName.dll" Plugins
  5. Debug settings:
    Start external program: path to xrmtoolbox.exe
    Command line arguments:
    /plugin:"NameOfThePlugin" /overridepath:"path to the parent of plugin folder" /connection:"specific connection if you want to use one"

    Note: in step 2, we create a folder called Plugins under the debug output folder (eg: {ProjectName}\bin\Debug\Plugins). The path that OverRidePath should point to is the Debug folder. The reason is that XTB will look for a sub-folder called plugins to locate the plugin.

For more information:

Wednesday, January 02, 2019

Xrm.Page is deprecated–what to do in v9+

According to this:, in V9, Xrm.Page is being deprecated. Xrm.Page used to be used in Javascript called by forms as well as the ribbon.

The fix is documented here:



The gist:


  1. Pass the executionContext from the handler: see
  2. Add a parameter on your js function to accept the executionContext
  3. call getFormContext() on your parameter to get the form-context. See:

function functionCalledDirectlyByTheForm(executionContext)
     var formContext = executionContext.getFormContext(); // get formContext

    // use formContext instead of Xrm.Page 
     var firstName = formContext.getAttribute("firstname").getValue();
     var lastName = formContext.getAttribute("lastname").getValue();
     console.log(firstName + " " + lastName);


  1. Pass the PrimaryControl as a CRM Parameter to your javascript function
    In Ribbon Workbench:
  2. Add a parameter on your js function to accept the primaryControl as a parameter
    function OnMyRibbonButtonAction(commandProperties, primaryControl) {
  3. use the PrimaryControl parameter as though it were the formContext:

function functionCalledDirectlyByTheRibbon(primaryControl)
    // use primaryControl instead of Xrm.Page 
    var firstName = primaryControl.getAttribute("firstname").getValue();
     var lastName = primaryControl.getAttribute("lastname").getValue();
     console.log(firstName + " " + lastName);


Dont use getFormContext in a function called by the ribbon. “getFormContext” is not available in the UCI, and so even though it may work in the legacy web-client, it will break when you begin using the UCI.

If you want a function to work when called from the form as well as the ribbon and you want it to work with the web-client and UCI, do something like this:

//use this to get an object which you can use like the formContext.
//this code can be called from a function that was either invoked from a form or from the ribbon.
function getFormContext(executionContext) {
     var formContext = null;
     if (executionContext !== null) {
         if (typeof executionContext.getAttribute === 'function') {
             formContext = executionContext; //most likely called from the ribbon.
         } else if (typeof executionContext.getFormContext === 'function'
                 && typeof(executionContext.getFormContext()).getAttribute === 'function') {
             formContext = executionContext.getFormContext(); // most likely called from the form via a handler
         } else {
             throw 'formContext was not found'; //you could do formContext = Xrm.Page; if you like.
     return formContext;


Because Xrm.Page is deprecated, you can no longer use Xrm.Page.context. Instead, you should use Xrm.Utility.getGlobalContext(). This method returns an object that supports most of the methods that were available from Xrm.Page.context.


This formContext diagram is extremely useful for determining what is available from the formContext and what is not:

formContext object model


Understand the Client API object model: