Using Xrm.WebApi method in Web Resource opened in a new window

Question

I have opened an HTML web resource in a new window using:

Xrm.Navigation.openWebResource(webResource, windowOptions, data);

This is an HTML web resource and it is loading the ClientObject in the head

<script type="text/javascript" src="../../../ClientGlobalContext.js.aspx" ></script>

then I have some JavaScript that is trying to retrieve a Contact

var contactId = "8553DA63-11C9-E711-A824-000D3AE0CB84";
var promise = Xrm.WebApi.retrieveRecord("contact", contactId, "$select=contactid,firstname,lastname");`

but this is failing. I've step-traced into the Xrm.WebApi method and found the error is when it attempts to resolve "contact" to a Set Name

Code from Global.ashx

getEntitySetName: function(logicalName) {
    Mscrm.Utilities.addTelemetryLog("Xrm.Utility.getEntitySetName");
    var $v_0 = window.ENTITY_SET_NAMES || window.top.ENTITY_SET_NAMES;
    if (IsNull(this.$5H_1) && !isNullOrEmptyString($v_0))
        this.$5H_1 = JSON.parse($v_0);
    return this.$5H_1[logicalName.toLowerCase()]
},

For some reason the window.ENTITY_SET_NAMES object is null so an error (null reference) occurs

I've tried embedding my web resource into a CRM page and the code works correctly. The issue seems to be when the web resource is launched via Xrm.Navigation.openWebResource

Has anyone tried to use Xrm.WebApi in the context of an web resource opened with Xrm.Navigation.openWebResource? or does anyone know if there are additional steps required to retrieve data?

Update

ENTITY_SET_NAMES is initialised in main.aspx. I tried embedding my custom Web Resource directly into a new Main Form section and the retrieveRecord method works.

It appears this is a problem only when running the Web Resource from a new page via Xrm.Navigation.openWebResource

Update 2 - Response to Aron

I tried using window.parent as suggested below

var contactId = "8553DA63-11C9-E711-A824-000D3AE0CB84";
var promise = parent.Xrm.WebApi.retrieveRecord("contact", contactId, "$select=contactid,firstname,lastname");`

and for good measure also tried window.parent.top

var contactId = "8553DA63-11C9-E711-A824-000D3AE0CB84";
var promise = parent.top.Xrm.WebApi.retrieveRecord("contact", contactId, "$select=contactid,firstname,lastname");`

but both resulted in the same error

Arun Vinoth · Answer 1 · 2018-07-26T02:13:08.397

4

Sounds like a product bug within ClientGlobalContext.js.aspx, as this should give you whole context to work with.

Probably you can utilize window.opener.Xrm in this scenario, since it worked for window.opener.Xrm.Page.getAttribute it should also work for Xrm.WebApi.

You can try to access variable from opener window like this:

window["ENTITY_SET_NAMES"] = window["ENTITY_SET_NAMES"] || window.opener.top.ENTITY_SET_NAMES;

edited Jul 26 '18 at 02:13

answered Jul 25 '18 at 18:45

Arun Vinoth

20,360
14
48
135

1

I have to specify **top** but it works: `window.opener.top.ENTITY_SET_NAMES` – jasonscript Jul 26 '18 at 01:48

jasonscript · Accepted Answer · 2018-07-25T16:05:50.720

My blog :)

To get this working I have implemented a hacky work-around.

I've been debugging the Xrm.WebApi method and it is failing on a line where it attempts to take the entityname and resolve it to the setname (plural). It does this by comparing the value passed into the retrieveRecord method and comparing it to a global variable ENTITY_SET_NAMES

In my example, it is trying to resolve contact to contacts

This variable is unfortunately not present and Xrm.WebApi throws an error

My work-around is to check for this variable, and if it is not present then create it! ENTITY_SET_NAMES is a JSON-parsable string which contains the logical name and set name for each entity.

window["ENTITY_SET_NAMES"] = window["ENTITY_SET_NAMES"] || JSON.stringify({
  "account" : "accounts",
  "contact" : "contacts"
});

Executing this line before any calls to Xrm.WebApi methods appears to work and I now get results

Here's the complete snippet:

window["ENTITY_SET_NAMES"] = window["ENTITY_SET_NAMES"] || JSON.stringify({
  "account" : "accounts",
  "contact" : "contacts"
});

var contactId = "8553DA63-11C9-E711-A824-000D3AE0CB84";
Xrm.WebApi.retrieveRecord(
  "contact", 
  contactId, 
  "$select=contactid,firstname,lastname"
).then(
  function success(result) {
    console.log(result.firstname);
    // perform operations on record retrieval
  },
  function (error) {
    console.log(error.message);
    // handle error conditions
  }
);

Aron · Answer 3 · 2018-07-19T11:25:01.530

2

As per this article, when referencing the main form from a Web Resource we have to reference the parent window. Though, it only references Xrm.Page and Xrm.Utility, it should also work with Xrm.WebApi...

An HTML web resource added to a form can’t use global objects defined by the JavaScript library loaded in the form. An HTML web resource may interact with the Xrm.Page or Xrm.Utility objects within the form by using parent.Xrm.Page or parent.Xrm.Utility, but global objects defined by form scripts won’t be accessible using the parent.

Please try parent.Xrm.WebApi.retrieveRecord("contact", contactId, "$select=contactid,firstname,lastname");

This article also demonstrates parent.Xrm.WebApi

edited Jul 19 '18 at 11:25

answered Jul 19 '18 at 11:07

Aron

3,522
3
12
20

great find Aron. Unfortunately it doesn't work. I've updated my question with my test results – jasonscript Jul 20 '18 at 01:50
1

Thanks for the update. Since the code works when embedded in the form but fails when opened in a new window, it seems that opening the new window creates a new `window` object, which breaks `window.ENTITY_SET_NAMES`. Perhaps you can retrieve it from the parent window and set it on the child window to enable Xrm.WebApi. Or, when working in a new window, perhaps "roll your own" Web API calls. For that purpose [Jason Lattimer's CRMRESTBuilder](https://github.com/jlattimer/CRMRESTBuilder) is very handy. – Aron Jul 20 '18 at 12:48
I couldn't retrieve it from the parent window - it was null. The solution I eventually settled on was to create my own ENTITY_SET_NAME global variable with only the values I need. I've added my own answer if you want to see more detail – jasonscript Jul 20 '18 at 15:27

score 2 · Answer 4 · answered Nov 12 '18 at 04:30

2

If you are going to use bound actions & functions you'll also need to add a similar variable to map entities to their primary id fields.

window["ENTITY_PRIMARY_KEYS"] = ['{"account":"accountid", "contact":"contactid"}'];

answered Nov 12 '18 at 04:30

Jason Lattimer

2,847
13
14

Using Xrm.WebApi method in Web Resource opened in a new window

4 Answers4

Linked