CRM JS常用的一些方法

1.获取当前实体id

//直接获取
var entityId = Xrm.Page.data.entity.getId()
//格式处理-去括号
var entityId = Xrm.Page.data.entity.getId().replace("{", "").replace("}", "");

2.获取当前用户id

//直接获取
var userid = Xrm.Page.context.getUserId()
//格式处理-去括号
var userid = Xrm.Page.context.getUserId().replace("{", "").replace("}", "");

3.获取窗体状态

 var formStatus = Xrm.Page.ui.getFormType();

4.添加/清除窗体级提示

message:
    类型:String
    必填:yes
    描述:窗体提示语的内容
level:
    类型:String
    必填:yes
    描述:窗体提示的等级（ERROR、WARNING、INFO）
uniqueId:
    类型:String
    必填:yes
    描述:窗体提示的唯一id
//添加
Xrm.Page.ui.setFormNotification(message, level, uniqueId);
​
//清除
Xrm.Page.ui.clearFormNotification(id);

5.添加/清除字段的提示

//添加
Xrm.Page.getControl(fieldName).setNotification(message);
    /**
    * fieldName:字段名
    * message:提示语内容
    */
//清除
Xrm.Page.getControl(fieldName).clearNotification();

6.简单的筛选查找字段-addPreSearch()方法

//自定义筛选方法
preSearchHandler: function () {
        var filter = `这里填fetchXML的条件即可`;
        Xrm.Page.getControl(fieldName).addCustomFilter(filter);
    },
        
 //调用方法
  Xrm.Page.getControl(fieldName).addPreSearch(preSearchHandler);

7.复杂的筛选查找字段-addCustomView()方法

var proFetchXml = `这里填fetchXML的条件即可`;
var layoutxml = 
    `<grid name="resultset" object="10057" jump="foton_sequenceno" select="1" icon="1" preview="1">
        <row name="result" id="foton_receiptid">
            <cell name="new_name" width="150" />
            <cell name="createdon" width="150" />
        </row>
    </grid>`;
Xrm.Page.getControl(fieldName).addCustomView("{1753B0C9-0B8C-431B-8E96-44D1D4EF6A06}",
            entityLogicName, "自定义-合同明细-筛选产品",
            proFetchXml, layoutxml, true);  //添加视图
Xrm.Page.getControl(fieldName).setDefaultView("{1753B0C9-0B8C-431B-8E96-44D1D4EF6A06}");  //将视图设置为默认
/**
* fieldName:要筛选的字段名
* entityLogicName:关联的实体逻辑名
* 注意：那个id随便写，全局唯一即可
* 后面的 "自定义-合同明细-筛选产品" 是视图名称
* 需要在对应窗体上配置 ==> 关闭 视图选择器
*/

8.命名空间的模板

if (typeof (new_contact) == "undefined") { new_contact = { __namespace: true }; }
new_contact = {
    
}
// new_contact 即是命名空间名称

9.保存表单

 Xrm.Page.data.entity.save();

10.阻止保存

Xrm.Page.getEventArgs().preventDefault();//阻止保存操作
// 注意：在OnChange事件中不能使用该方法，会报错；原因大概是OnChange事件没有保存

11.打开某个实体的新建窗体

 Xrm.Utility.openEntityForm(entityName);
// entityName : 实体逻辑名

12.判断用户是否具有某个安全角色

//方法调用
UserHasRole("系统管理员")//方法内传入安全角色名称即可

//方法定义
UserHasRole: function(roleNames) {
        var ODataResult = new_contact.ODataRetrieve("SystemUserSet?$select=systemuserroles_association/Name&$expand=systemuserroles_association&$filter=SystemUserId eq guid'" + Xrm.Page.context.getUserId() + "'");
       
        if (ODataResult != null && ODataResult.results.length == 1 && ODataResult.results[0].systemuserroles_association.results.length > 0) {
            var oDataRoles = ODataResult.results[0].systemuserroles_association.results;
        for (var i = 0; i < oDataRoles.length; i++) {
                if (oDataRoles[i].Name == roleNames) {
                    return true;
            }
        }
    }
    return false;
},

    ODataRetrieve: function(oDataString) {
    var ServerUrl = Xrm.Page.context.getClientUrl();
    if (ServerUrl.match(/\/$/)) {
        ServerUrl = ServerUrl.substring(0, ServerUrl.length - 1);
    }
    var retrieveReq = new XMLHttpRequest();
    retrieveReq.open("GET", ServerUrl + "/XRMServices/2011/OrganizationData.svc/" + oDataString, false);
    retrieveReq.setRequestHeader("Accept", "application/json");
    retrieveReq.setRequestHeader("Content-Type", "application/json;charset=utf-8");
    retrieveReq.send();
    return JSON.parse(retrieveReq.responseText).d;
},

13.计算年龄的方法

jsGetAge: function (strBirthdayArr) {
        var returnAge;
        // 根据生日计算年龄
        var birthYear = strBirthdayArr[0];
        var birthMonth = strBirthdayArr[1];
        var birthDay = strBirthdayArr[2];

        d = new Date();
        var nowYear = d.getFullYear();
        var nowMonth = d.getMonth() + 1;
        var nowDay = d.getDate();

        if (nowYear == birthYear) {
            returnAge = 0;//同年 则为0岁
        }
        else {
            var ageDiff = nowYear - birthYear; //年之差
            if (ageDiff > 0) {
                if (nowMonth == birthMonth) {
                    var dayDiff = nowDay - birthDay;//日之差
                    if (dayDiff < 0) {
                        returnAge = ageDiff - 1;
                    }
                    else {
                        returnAge = ageDiff;
                    }
                }
                else {
                    var monthDiff = nowMonth - birthMonth;//月之差
                    if (monthDiff < 0) {
                        returnAge = ageDiff - 1;
                    }
                    else {
                        returnAge = ageDiff;
                    }
                }
            }
            else {
                returnAge = -1;//返回-1 表示出生日期输入错误 晚于今天
            }
        }
        return returnAge;//返回周岁年龄
    },