17,021
Like
Share
ReportWhen using Xrm.Utitliy object to open entity form or Quick create form, sometimes we need to pass query string parameters.
In MS CRM you can enable CRM forms to accept query strings, and you can retrieve those query string parameters in form events.
Set Query string parameters
a. Go to Entity customization
b. Open form, where you want to add query strings parameters
c. Click on Form Properties
d. In form properties window you will see Parameters tabs.
e. Add Parameters, which you want to get it, when using openEntityForm or openQuickCreate
f. When adding parameter need to specify name and data type.
NOTE: In Each parameter name MUST contains at least one underscore (‘_’) character. And name cannot be started with underscore or “crm_”. Microsoft recommends that you should use solution publisher prefix when defining parameter name, e.g abc_queryString_contactId
g. We can pass Boolean, Datetime, double, entitytype, Integer, long, PositiveInteger, SafeString, UniqueId, UnsignedInt types of parameters.
Pass Query String parameters to form using openEntityForm or openQuickCreate
openContactForm: function () {
var parameters = {};
/*Custom querystring parameter*/
parameters["qryParam_boolean"] = 0; // Boolean value - 0,1, true, false
var startDate = new Date();
parameters["qryParam_datetime"] = startDate.format("MM/dd/yyyy"); // date time
parameters["qryParam_double"] = 1.0; //double
parameters["qryParam_eType"] = 2; // Entity Type Code
parameters["qryParam_integer"] = 100; //Integer
parameters["qryParam_long"] = 100000; // Long
parameters["qryParam_positiveinteger"] = 1; // Positive Integer including 0
parameters["qryParam_safestring"] = "safestring"; //string
parameters["qryParam_uniqueId"] = Xrm.Page.data.entity.getId(); //GUID
parameters["qryParam_unsignedInt"] = 1; //unsigned integer
var windowsOptions = {};
windowsOptions["openInNewWindow"] = true;
Xrm.Utility.openEntityForm("new_manufacture",null, parameters, windowsOptions);
},
Retrieve Parameters value, when entity form is opened.
To get parameter value, we need to use Xrm.Page.context.getQueryStringParameters()
getQueryStringParamters: function () {
var booleanParam;
var datetimeParam;
var doubleParam;
var entitytypeParam;
var integerParam;
var longParam;
var positiveintegerParam;
var safestringParam;
var uniqueIdParam;
var unsignedIntParam;
if(Xrm.Page.context.getQueryStringParameters().qryParam_boolean != null && Xrm.Page.context.getQueryStringParameters().qryParam_boolean != 'undefined') {
booleanParam = Xrm.Page.context.getQueryStringParameters().qryParam_boolean;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_datetime != null && Xrm.Page.context.getQueryStringParameters().qryParam_datetime != 'undefined') {
datetimeParam = Xrm.Page.context.getQueryStringParameters().qryParam_datetime;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_double != null && Xrm.Page.context.getQueryStringParameters().qryParam_double != 'undefined') {
doubleParam = Xrm.Page.context.getQueryStringParameters().qryParam_double;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_eType != null && Xrm.Page.context.getQueryStringParameters().qryParam_eType != 'undefined') {
entitytypeParam = Xrm.Page.context.getQueryStringParameters().qryParam_eType;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_integer != null && Xrm.Page.context.getQueryStringParameters().qryParam_integer != 'undefined') {
integerParam = Xrm.Page.context.getQueryStringParameters().qryParam_integer;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_long != null && Xrm.Page.context.getQueryStringParameters().qryParam_long != 'undefined') {
longParam = Xrm.Page.context.getQueryStringParameters().qryParam_long;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_positiveinteger != null && Xrm.Page.context.getQueryStringParameters().qryParam_positiveinteger != 'undefined') {
positiveintegerParam = Xrm.Page.context.getQueryStringParameters().qryParam_positiveinteger;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_safestring != null && Xrm.Page.context.getQueryStringParameters().qryParam_safestring != 'undefined') {
safestringParam = Xrm.Page.context.getQueryStringParameters().qryParam_safestring;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_uniqueId != null && Xrm.Page.context.getQueryStringParameters().qryParam_uniqueId != 'undefined') {
uniqueIdParam = Xrm.Page.context.getQueryStringParameters().qryParam_uniqueId;
}
if(Xrm.Page.context.getQueryStringParameters().qryParam_unsignedInt != null && Xrm.Page.context.getQueryStringParameters().qryParam_unsignedInt != 'undefined') {
unsignedIntParam = Xrm.Page.context.getQueryStringParameters().qryParam_unsignedInt;
}
},
Now you can set value to form or add any logic based on passed parameters.
*This post is locked for comments