Adventures in UCI Site Map Configuration and Usability

Over the past few days, I’ve spent some time doing a deep dive into the Unified Client Interface – it seems like most people have now settled on calling it UCI. I have been trying to work out some ‘better practices’ for user centered design, with the aim of improving user adoption for those users inclined, or perhaps directed, to use it.

Microsoft are clearly working towards a User Centered design through the very fact that the new interface exists and the principles they have implemented so far. Ultimately though, the user experience will be as good or bad as the decisions you make when, as a Dynamics customiser or partner, you configure it.


Keep it Simple

One of the great benefits of the new Dynamics 365 Unified Interface – and model driven PowerApps in general – is that they are likely to end up ‘less busy’ than the old Dynamics 365 web client. This is because when you build an Dynamics 365 app, you are forced to think about what you need to include. It’s a blank canvas. If you create a new app, you should always carefully select the views, forms and dashboards that the users for that app really need. If you combine that configuration with a policy of least privilege security roles, you should end up with an easy to navigate application – clean menus, clean sitemaps, uncluttered command bars. Users should only see the buttons they need to see, so additionally, get familiar with the Ribbon Workbench and you can strip the application back even further.

This approach is very likely to create a simple path for new users to learn, where they will embrace the screens and application flow. The one thing the UCI is missing however is what I would term a ‘Home Page’ – a launch pad for the main application. Sure, there are dashboards and views of contacts which may seem like a nice place to start for some, but sometimes a simple web page based solution is best.

Users can no longer select their home page in the Unified Interface through Dynamics 365 settings. In many scenarios, this might be a good thing because as designers, we can now direct all users to an initial page by adding a web resource as the first element in the site map.

Why might you do this? Well, it could be an initial training page, or a ‘How To’ page. It could even be something business specific, such as a company logo to enforce branding. From a functional point of view, there are benefits in having a launchpad page of quick links that allow users to deep link to certain Dynamics areas from a single page.

Web Resources in the Site Map

So web resources are a good fit, old school way of showing rich data in the UCI, where you can have much more control over styling than you can with a view or form. Using web resources is also a good integration technique where, via JavaScript, you can call both Dynamics REST based web services or even Actions to wrap server side code to call other external web services.

So continuing my adventure, I started adding links to web resources to the sitemap. The fact that the left menu bar now is always displayed and that clicking different icons doesn’t force a full page re-load provides for a really slick user experience. Maybe it’s just me, but my perception with UCI is that the caching of each site map element is much better than in the web interface.

Generic Vector Icons

One thing I have always been a stickler for is attention to detail. My pet peeve with any interface is having generic icons, inconsistently styled icons, or having icons that don’t reflect what their function is. When I first added links to different web resources in the Site Map, each link was allocated a generic icon. This icon was not editable in the App Designer or in the XRM Toolbox site-map editor. Thinking Face

I noted with interest recently CRM Tip of the Day 1131, which showed me how to update the Area Vector Icon in the site map to get rid of the generic jigsaw puzzle piece.  Checking the SiteMapType.xsd schema, I noticed the same ‘VectorIcon’ attribute can be applied to Groups and SubAreas as well as Areas. After updating the SiteMap XML manually, hey presto, I have a nice unique ‘Home’ icon for my web resource again.

The end result is a ‘Home’ page like this :

uci2Basic Unified Client Interface with Simple Home Page and ALL custom icons


Is there a moral to this story? Here’s a few take aways I have:

  • The application site map editor is still a bit rough around the edges, but the underlying UCI platform provides a great foundation for user centric app development.
  • Lets hope Tangay picks up the Group and SubArea VectorIcon attributeand applies it to the XRM Toolbox Site Map editor in the same way he did for the Area attribute.
  • Better still, lets hope the vector icon attribute makes it into the full App designer in the October 2018 release.
  • Don’t be sloppy when adding elements to the sitemap, take the extra 30 minutes and get the icons right.
  • Consider a launch page for your UCI application. You can host fonts and styling as web resources too. You can use the new Xrm.Navigation APIs to help users perform functions with a minimal number of clicks or taps.
  • Strip back user roles to the most basic functions to reduce clutter on your command bar. There are some buttons that are trickier to remove than others. Wouldn’t it be great if we had the ability to specify command bar buttons in an app too?


Dynamics 365 Upgrade – Unable to add Notes to entity

I recently had an Organisation updated from Dynamics CRM 2016 Online Update 1 to Dynamics 365. After the upgrade, users experienced the following symptoms :

  • Unable to add new notes to custom entities and core entities via the notes control on the form.
  • Existing Notes created prior to the upgrade do show up ok however and can be edited.
  • This occurs on multiple entities, but not all. I didn’t see a pattern, but certainly on some contact records I could add new notes ok.


I raised this with Microsoft and it didn’t appear to be a known issue, so I decided to do some investigation myself.

Continue reading “Dynamics 365 Upgrade – Unable to add Notes to entity”

Under the Hood – There’s a Dynamics 365 App for that

Microsoft has surely been looking at Salesforce for the past few years, feeling somewhat envious of their ‘apps’ market. If you take Salesforce at their word, they have over 1.4 million registered developers, so the apps market for Salesforce is clearly not a flash in the plan.

With the recent launch of Dynamics 365, there appears to be a concerted effort at Redmond to build an ecosystem around Dynamics 365, but how has this been implemented and what do application developers need to know?

Continue reading “Under the Hood – There’s a Dynamics 365 App for that”

How to change Dynamics CRM 2013 Navigation Bar Colours and Sandbox Text

If you have over 25 CRM users with professional CALs and have been using a CRM 2013 online free development environment, you may have noticed that the navigation bar has become a sickly vomity orange colour in the past few weeks. Now you can distinguish between your production CRM online instance and your non-production instance by the colour of the navbar. In case this confused you and you thought you had entered a parallel universe, they have also helpfully added the word ‘Sandbox’ in the middle of the navbar which gets bigger if you click it. This is undoubtedly useful and will hopefully prevent you from messing up some live data by accident. More details on Sandbox environments can be found on Mike Carters CRM Online product team blog.


However, what if you are using CRM 2013 on-premise and want to highlight to a user that they are working on a different environment. Well, it looks like this Sandbox code has also made it into CRM 2013 Rollup 2, so it can be enabled somewhat, though not in a supported way.

Continue reading “How to change Dynamics CRM 2013 Navigation Bar Colours and Sandbox Text”