getUserPrivilege is a function that will return canRead, canCreate, and canUpdate. This function correlated with the Field Level Security feature makes it suitable to check if users have enough privilege to run our custom function on Javascript.
For example, we have below customization on formOnLoad:
var BlogJs = BlogJs || {};
(function() {
this.formOnLoad = function(executionContext){
onLoadCustomerId(executionContext);
setValueIcNumber(executionContext);
};
var onLoadCustomerId = function(executionContext){
var formContext = executionContext.getFormContext();
// formOnLoad logic for CustomerId attribute (enabled Field Level Security)
// Can be init value, addPreSearch, etc..
console.log("onLoadCustomerId called!");
};
var setValueIcNumber = function(executionContext){
var formContext = executionContext.getFormContext();
formContext.getAttribute("twr_icnumber").setValue("temmy-testing");
}
}).apply(BlogJs);
In the example above, let’s say we already set up the CustomerId and IC Number attribute to be part of Field Level Security. But, we have custom logic for both of the attributes that lead to some users might not have enough access. So, in order to fix it we can use the getUserPrivilege function:
var BlogJs = BlogJs || {};
(function() {
this.formOnLoad = function(executionContext){
onLoadCustomerId(executionContext);
setValueIcNumber(executionContext);
};
var onLoadCustomerId = function(executionContext){
var formContext = executionContext.getFormContext();
// if user can't create, return
if(!formContext.getAttribute("twr_customerid").getUserPrivilege().canCreate) return;
// formOnLoad logic for CustomerId attribute (enabled Field Level Security)
// Can be init value, addPreSearch, etc..
console.log("onLoadCustomerId called!");
};
var setValueIcNumber = function(executionContext){
var formContext = executionContext.getFormContext();
// if user can't create, return
if(!formContext.getAttribute("twr_customerid").getUserPrivilege().canCreate) return;
formContext.getAttribute("twr_icnumber").setValue("temmy-testing");
}
}).apply(BlogJs);
If the user doesn’t have enough access to the CustomerId attribute (for Read, Create, or Update), we don’t need to run the logic (to avoid error)!
Happy CRM-ing!
About the Author:
My name is Temmy Wahyu Raharjo. I am a passionate programmer who loves the idea of Clean Code. A grasshoper of a Test Driven Development. .Net programmer, Angular newbie, Microsoft Dynamic CRM Consultant.
Reference:
Raharjo, T. (2022). How to use the getUserPrivilege function in Dataverse Client API. Available at: https://temmyraharjo.wordpress.com/2022/06/05/how-to-use-the-getuserprivilege-function-in-dataverse-client-api [Accessed: 7th October 2022].
