How to Pass Parameters to a Web Resource in Dynamics CRM

How to Pass Parameters to a Web Resource in Dynamics CRM

HTML Web Resources are commonly used in Dynamics 365 CRM to create custom user interfaces, dashboards, visualizations, and integrations. In many scenarios, the Web Resource needs information from the parent CRM form, such as record IDs, field values, or user details.

Passing parameters to a Web Resource allows developers to create dynamic and reusable solutions without hardcoding values.

Business Scenario

Suppose an Account form contains an HTML Web Resource that displays account-related analytics. The Web Resource must receive the current Account ID so it can retrieve and display the correct data.

Step 1: Add HTML Web Resource

  1. Create an HTML Web Resource.
  2. Add the Web Resource to the form.
  3. Open Form Designer.
  4. Insert the Web Resource.
  5. Save and Publish the form.

Step 2: Pass Parameter from Form 

var accountId =
formContext.data.entity.getId();

var webResource =
formContext.getControl(
"WebResource_Account"
);

webResource.setSrc(
"/WebResources/new_AccountDashboard.html?id="
+ accountId
);

This appends the record ID as a query string parameter.

Step 3: Read Parameter in HTML Web Resource 

function getParameterByName(
name
) {

var url =
window.location.href;

name =
name.replace(
/[\[\]]/g,
'\\
'
);

var regex =
new RegExp(
'[?&]' +
name +
'(=([^&#]*)|&|#|$)'
);

var results =
regex.exec(url);

if (!results)
return null;

if (!results[2])
return '';

return decodeURIComponent(
results[2]
.replace(/\+/g, ' ')
);

}

var accountId =
getParameterByName('id');

The Account ID is now available inside the HTML page.

Passing Multiple Parameters 

webResource.setSrc(
"/WebResources/new_page.html"
+
"?id=" + accountId
+
"&name=" + accountName
+
"&status=" + status
);

Example Output URL 

new_page.html
?id=12345
&name=CRMONCE
&status=Active

Common Use Cases

Important: Always encode parameter values before passing them to a Web Resource to avoid issues with special characters and URL formatting.

Benefits

Key Takeaways