{"id":1495,"date":"2015-07-24T14:53:09","date_gmt":"2015-07-24T09:23:09","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=1495"},"modified":"2026-02-05T15:38:14","modified_gmt":"2026-02-05T10:08:14","slug":"support-to-open-an-entity-form-in-a-new-window-in-dynamics-crm-2015-sp1","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2015\/07\/support-to-open-an-entity-form-in-a-new-window-in-dynamics-crm-2015-sp1\/","title":{"rendered":"Support to open an Entity form in a new Window in Dynamics CRM 2015 SP1"},"content":{"rendered":"

Introduction:<\/strong><\/h2>\n

Every CRM update comes with a lot of goodies for both the developers and the end users, so Dynamics CRM 2015 SP1 was not different.<\/p>\n

One of such feature is opening a record in a new window.<\/p>\n

While most of you`ll think, what`s so great in this, we have been doing this since CRM 2011, or maybe even before that.<\/p>\n

Well here the difference is, now this is available through CRM API.<\/p>\n

Before finding out how to achieve this, let`s run down the memory lane, let`s start with CRM 2011 and understand how this functionality have evolved with every update from CRM 2011 to CRM 2015 SP1.<\/p>\n

CRM 2011:<\/strong><\/p>\n

How do we used to open an entity record or simple, a record during CRM 2011 era?<\/p>\n

We used to use the JavaScript functionality of window.open() to open up a record.<\/p>\n

Syntax:<\/p>\n

window.open(URL, name)<\/strong><\/p>\n

URL <\/strong>– server name + URL of the record<\/p>\n

name<\/strong> – specifies where to open the window, i.e., on the same page or a new tab or a new window.<\/p>\n

CRM 2013:<\/strong><\/p>\n

Now, comes the CRM 2013, complete overhauled design, with added features for developer.<\/p>\n

It further simplified the way of opening a record, by providing us a parameterized function. This also ensured that it works across devices.<\/p>\n

Syntax:<\/p>\n

Xrm.Utility.openEntityForm(name, id, parameters)<\/strong><\/p>\n

name<\/strong> – Name of the entity, whose record we want to open.<\/p>\n

id<\/strong> – GUID of the record to be opened, if passed null, it opens an empty record form.<\/p>\n

parameters<\/strong> – parameters to be used on the form.<\/p>\n

Though it simplified the process of opening a record by eliminating the need to create the URL, still it lacked in one component i.e., giving us the choice whether to open a record on the same page or in a new window.<\/p>\n

Remember since CRM 2013, all navigation in CRM is in-place i.e it replaces the current page with the new URL that is requested.<\/p>\n

Using the above piece of code to open a record, would very well open the record, but it would open on the same page itself, which was kind of annoying.<\/p>\n

What if we want to open a record in a new window then? Well, we have to use the same conventional method i.e., window.open(). As a result this functionality could be achieved but not supported across devices.<\/p>\n

CRM 2015 SP1:<\/strong><\/p>\n

Then, came CRM 2015 SP1 update, in this update the openEntityForm method has been enhanced further<\/p>\n

It means the method is allowed to take in one more parameter, which on specifying defines where the record would open<\/p>\n

Syntax:<\/p>\n

Xrm.Utility.openEntityForm(name, id, parameters, options)<\/strong><\/p>\n

options – <\/strong>It`s optional. \u00a0<\/strong>It takes in an object in which we have to specify true or false, true means open in a new window and false means to open on the same page. If this parameter is not specified it defaults to false.<\/p>\n

How to use this functionality?<\/strong><\/p>\n

First of all create an Object.<\/p>\n

var options = {<\/p>\n

openInNewWindow : true<\/p>\n

};<\/p>\n

Note: <\/em><\/strong>the property openInNewWindow cannot be replaced by any another name.<\/em><\/p>\n

Xrm.Utility.openEntityForm(“account”, null, null, options)<\/p>\n

The object just takes only one property currently, we cannot specify the height or width of the window to be opened. It by defaults take up the entire screen.<\/p>\n

Conclusion:<\/strong><\/p>\n