Category Archives: Administration

v4.0 of SnapShot! for Dynamics CRM is available

Hi Everyone,

Version 4.0 of SnapShot! is now live.  This is the most major update I’ve made in quite a while with so many adjustments that I am skipping versions 3.8 and 3.9 and moving straight to v4.0.

The following changes and additions have been made to SnapShot!

New Reports

  • Access Team Templates
  • Themes
  • Positions
  • Hierarchical security configuration
  • Entity Access Privileges

I am really excited about this report!  It shows you entity privileges across security roles. Here is a sample of the Account entity:


New Features

  • SnapShot! now supports a trial mode which will allow you to produce the following reports without having to purchase a license:
  • Entities
  • Fields
  • Views
  • Forms
  • Dynamics CRM 2016
    • Verified security privileges included any changes introduced to CRM 2016
    • Verified connectivity and report processing functionality


    • Views Report
    • Now includes disabled views
    • Added the following additional view types:
    • A template for Microsoft Dynamics CRM for Outlook
    • Offline template
  • Process Report
    • Renamed the workflow type PBL to Business Rule.
  • User Report
    • Added a Position field to report hierarchical security configuration information for CRM 2015 and 2016.
    • The Client Access License types (CALs) are now:
    • Professional
    • Administrative
    • Basic
    • Device Professional
    • Device Basic
    • Essential
    • Device Essential
    • Enterprise
    • Device Enterprise
  • Dynamics CRM Component List
    • Modified the component list to make it more compatible with the Dynamics CRM user interface navigation:


    Since SnapShot! supports Dynamics CRM 2011, 2013, 2015, and 2016, I filter the component list based on the version of Dynamics CRM that you have connected to so that only components that are available in that version are displayed.

    • Report Generation
    • Modified the output folder structure and file contents to match the component CRM list show in the SnapShot! user interface.
  • User Privileges Report:
    • Added sections to show the security roles and teams the user is a member of:


    • Security Role and User Privileges Report:
    • Made minor cosmetic changes to the reports.
    • Modified output to only show privileges that are found on the specific version of CRM the report is being created for.

    Previously, all privileges were shown, regardless if they were actually available within that version of Dynamics CRM.

    • Forms Report
    • Modified report to exclude the following form types:
    • Dialog (#8)
    • MiniCampaignBO (#3)
  • Entities Report
    • All Dynamics CRM entities are now exported. Previously, only entities marked as Customizable were export.
    • The Introduced Version property has been added to the report.

    Visit the SnapShot! product page for more information and to download the trial.

    If you have any questions or suggestions for enhancements, then please let me know.

    Thanks, Mitch

    System-Wide Alerts in Dynamics CRM 2015

    Dynamics CRM 2015 implemented a new system-wide alerts to inform you of issues with things like the Server-side Sync process. They appear in the user interface as a yellow bar at the top of the page, as you can see below:


    Clicking the View Alerts button will take you to the Alerts view where you may review the individual alerts.

    At this point I am not certain what will be alerted on, besides issues with Server-Side Sync, but those for sure are there.

    Viewing Alerts

    The actual Alerts view is on the Dynamics CRM user interface at the end of the Sales Area:


    The rather fascinating thing about Alerts, is that they are not actually Alerts, they are Traces.  So, when you are working with Advanced Find, you need to use the Traces entity.


    Programmatic Access and Automation

    The Traces (Alerts) entity is actually called TraceLog, which is the entity name to use when writing code using the Dynamics CRM SDK.

    Traces are fairly locked-down so here are some of things you can do with the entity:

    • Create a workflow to trigger on the Traces entity
    • Perform a query using Advanced Find
    • In the SDK TraceLog is listed a “internal use only” but it appears you may use the SDK to perform standard CRUD operations.  NOTE: I have not tested this.


    Privileges for the Traces entity are found on the Core Records tab:


    It would appear that everyone can Create, Read, and Append Trace records, but only the System Administrator role can delete them.  Since these are standard security roles, you should be able to change these settings if you wish.


    Traces are a very interesting addition to the Dynamics CRM platform and I need to get more information from Microsoft as to its intended use and if we as developers can actually create alerts that may be seen by the System Administrator.

    That will be my next step, when I have time.

    Monitor Queue Routing Rule Workflows

    We ran into a fascinating issue when creating Routing Rule recently.

    Here is the rule:


    This is fairly straightforward, but for some reason, we had an issue where the rule was not firing as we expected.

    I turns out that behinds the scenes, CRM actually creates a workflow to handle the magic required to route the email.

    Normally, you never really see these workflows run because they have the flag set to delete the history if the workflow was successful

    But unfortunately, in our case, something was not configured correctly in this workflow and it was failing:


    We modified the rule slightly and everything seemed to work fine after that. (I wasn’t the one doing the modification so I an not exactly sure what was changed.

    Anyway, the moral of the story is that if you ever see strange workflows, that you did not create, failing, see if they are Routing Rules.

    Refreshing your development or QA environment with production data

    In a multi-server environment (Development, QA/Staging/Testing, Production), you occasionally run into an issue where you need to have the latest production data in the lower environments.

    Here is a set of steps that will help you move the Production CRM database into Development or QA.  PowerShell is your friend here so much of this process can be automated.

    Unfortunately, I don’t have any code to share because this was a customer project. But, this is not that hard to reproduce yourself.

    We will review the task of moving to the QA environment, but the steps will apply to any other environment as well.


    Step 1: QA Environment – SQL Server

    The first step is to save any data that is specific to that environment, including:

    • SharePoint configuration
    • Custom configuration data, such as is used by plugins


    Step 2: Production Environment

    Make or get the latest full backup of the production CRM database.


    Step 3: QA Environment – CRM Server

    Turn off the following services:

    • Email Router service.
    • Asynchronous Processing Services.
    • Sandbox service.
    • Unzip service

    Use Get-Service and Stop-service

    Using the CRM Deployment Manager:

    • Disable the QA organization.
    • Delete the QA organization.

    Use Disable-CrmOrganization and Remove-CrmOrganization


    Step 4: QA Environment – SQL Server

    From the SQL Management Studio, perform the following tasks:

    1. Detach QA_MSCRM database.
    2. Move QA_MSCRM.MDF and QA_MSCRM.LDF to a separate file system as backup. This is optional, but I’m a little on the paranoid side.
    3. Delete the QA_MSCRM database.
    4. Restore the Production database backup to QA_MSCRM.

    This can be automated using PowerShell using at least two techniques: SMO commands or raw SQL commands, with the latter being the easiest.


    Step 5: QA Environment – CRM Server

    Using the CRM Deployment Manager, import the QA database.

    From the Operating System, perform these tasks:

    1. Run IISRESET.
    2. Turn on Email Router service.
    3. Turn on Sandbox service.
    4. Turn on Unzip service
    5. Turn on Asynchronous Processing Services.

    Use Get-Service and Start-service


    Step 6: QA Environment – SQL Server

    Perform any PHI cleanup to remove or obfuscate sensitive information including:

    • Phone/Fax numbers
    • Email addresses
    • Contact first and last names
    • Address information

    I would recommend the SSIS Integration Toolkit for Microsoft Dynamics CRM from KingswaySoft.

    You may also wish to review the ALM Toolkit from AdxStudio for additional application life cycle management capabilities.

    So that is about it. As you can see, it’s not rocket science, just a bunch of steps.

    By the way, one assumption is that the servers are all in the same domain. If your environments are in different domains, you’ll have a bit more work to handle mapping users from one domain to the other, but that is something that is totally doable.

    Correcting Email Router issues after transitioning CRM Online to Office 365

    I had one of my CRM Online organizations transition to the O365 platform a couple of weekends ago.  Not exactly a smooth process.  One of the issues I ran into was my email router was not running due to configuration changes.  Here is a list of things I worked through.  Hopefully this will help some other folks.


    CRM Online URL

    The URL that you utilize for CRM Online with Office 365 is different than that of CRM Online with Windows Live authentication.  The new format looks like this:[organization name]

    [organization name] is the name of your CRM Online organization as seen on the Developer Resources page (Settings, Customizations, Developer Resources).


    Unable to Publish Configuration

    Is everyone familiar with the Chicken or the Egg conundrum?  Well I ran into that here.  I could not publish the configuration from the Email Router Configuration application because the Email Router Service was not running.


    Email Router Service Will Not Start

    The email router would not start because it could not find the Microsoft.Crm.Tools.EmailAgent.xml file, which is created by publishing the configuration.


    The only way I successfully got around these issues was to perform a Repair on the CRM Email Router installation and that returned the system to normal.  The email router start successfully and I was able to publish my new configuration.


    Other Issues

    I did not, but you may also run into this issue:

    The Email Router and Microsoft.Crm.Tools.EmailAgent.SystemState.xml file


    Good luck. 


    Dynamics CRM, PowerShell, and Async Operations

    Have you used the Dynamics CRM PowerShell commandlets to automate any of your deployment tasks? 

    If not, then you should.  There is good stuff in there.

    In the CRM SDK sample code folder, you will find a folder called ps, which is where the PowerShell samples are located.

    Many of the Deployment operations have an asynchronous component so that you can “fire and forget” your operation, should you wish.

    However, there are built-in facilities for monitoring the asynchronous process that was created:

    $opstatus = Get-CrmOperationStatus -OperationId $opid
    while($opstatus.State -eq "Processing")
            Write-Host [(Get-Date)] Processing…
            Start-Sleep -s 30
            $opstatus = Get-CrmOperationStatus -OperationId $opid

    The while loop will continue to execute until the status changes away from Processing.

    BUT, and there is always a but, there is another status that you might encounter that needs to be addressed:

    while($opstatus.State -eq "Processing" -or $opstatus.State -eq "Queued")

    The Queued status will appear if the Deployment service has other processes that it is attempting to complete.  Modifying the while loop will allow your code to wait for either.

    Random SSRS Troubleshooting Notes

    Notes to myself on troubleshooting issues with SSRS.

    Error: Report render failure. Error: An error has occurred during report processing. (rsProcessingAborted)

    This is probably a security issue.


    Useful article:

    Microsoft Dynamics CRM 2011: Reports created by report wizard may fail when executing


    List SPNs associated with a server:

    setspn –L <servername>


    SQL Reporting Services Log File Locations:

    %programfiles%\Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles

    In most cases, <SQL Server Instance> will be something like: MSRS10_50.MSSQLSERVER

    Interesting Dynamics CRM 2011 Bug: Attachments do not get deleted

    I verified a strange bug related to attachments and the deleting of the parent record chain.

    • If you delete an Email with an attachment it deletes the attachment.
    • If you delete a Contact with emails that have attachments the email is deleted but not the attachment.

    For on-premise CRM administrators, you can use this script to find the orphans:

    SELECT t1.*
    FROM Attachment t1
    LEFT JOIN ActivityMimeAttachment t2 ON t2.AttachmentId = t1.AttachmentId
    WHERE t2.AttachmentId IS NULL

    My assumption is that you would need to clean these up manually.

    If you are using CRM Online, then you will have a much different story and one for which I do not have an answer.

    In a nutshell, you need to use the CRM SDK write a small application that will compare the IDs in the Attachment table to those in the ActivityMimeAttachment table and produce a list of Attachments that are not connected to ActivityMimeAttachments, then delete those records.