Dynamics CRM 2015/2016新特性之二十三:使用Web API执行函数
关注本人微信和易信公众号: 微软动态CRM专家罗勇 ,回复206或者20160315可方便获取本文,同时可以在第一间得到我发布的最新的博文信息,follow me!
函数分为函数(function)和查询函数(query function),是不是有点儿绕口?函数的列表请参考SDK的 Web API Function Reference 章节,每个函数都有一个消息和它对应,函数不会改变数据,一般是查询数据,返回一个复杂类型或者集合。查询函数的列表请参考SDK的Web API Query Function Reference 章节,每个函数对应的是一个FetchXML的操作符,用来判断是否符合条件。
下面举例子来说明下,调用 RetrieveAllChildUsersSystemUser 这个函数吧,它说起来是绑定函数(bound function),所有绑定函数都有一个属性值是IsBound="true" 。这个必须点赞,现在执行消息方便多了,以前版本执行消息很麻烦,可以参考我的博客:通过JavaScript调用SOAP终结点执行实体消息 。
下面这个是函数的相关元数据信息:
示例调用代码如下:
var clientURL = Xrm.Page.context.getClientUrl(); var req = new XMLHttpRequest() req.open("GET", encodeURI(clientURL + "/api/data/v8.0/systemusers(4C6A6247-43A9-E511-80CF-000D3A806074)/Microsoft.Dynamics.CRM.RetrieveAllChildUsersSystemUser()?$select=fullname"), true); req.setRequestHeader("Accept", "application/json"); req.setRequestHeader("Content-Type", "application/json; charset=utf-8"); req.setRequestHeader("OData-MaxVersion", "4.0"); req.setRequestHeader("OData-Version", "4.0"); req.onreadystatechange = function () { if (this.readyState == 4 /* complete */) { req.onreadystatechange = null; if (this.status == 200) { var responseJSON = JSON.parse(this.responseText); var popstr = ""; if (responseJSON.value != null && responseJSON.value.length >= 1) { for (var i = 0; i < responseJSON.value.length; i++) { popstr += responseJSON.value[i].fullname + ";"; } } Xrm.Utility.alertDialog("这个人下属(含直接下属和非直接下属)包括:" + popstr); } else { var error = JSON.parse(this.response).error; Xrm.Utility.alertDialog("调用函数出错." + error.message); } } }; req.send();
非绑定函数(unbound function)就是不是和实体绑定的函数,所有的查询函数都是非绑定函数,还有部分函数,他们没有IsBound属性。
下图是非绑定函数 WhoAmI 定义的元数据。
下图是非绑定函数 WhoAmI 定义的元数据。
下面是调用非绑定函数的示例代码:
var clientURL = Xrm.Page.context.getClientUrl(); var req = new XMLHttpRequest() req.open("GET", encodeURI(clientURL + "/api/data/v8.0/WhoAmI()"), true); req.setRequestHeader("Accept", "application/json"); req.setRequestHeader("Content-Type", "application/json; charset=utf-8"); req.setRequestHeader("OData-MaxVersion", "4.0"); req.setRequestHeader("OData-Version", "4.0"); req.onreadystatechange = function () { if (this.readyState == 4 /* complete */) { req.onreadystatechange = null; if (this.status == 200) { var responseJSON = JSON.parse(this.responseText); Xrm.Utility.alertDialog("当前用户的ID是:" + responseJSON.UserId + ";所属业务部门ID是" + responseJSON.BusinessUnitId); } else { var error = JSON.parse(this.response).error; Xrm.Utility.alertDialog("调用函数出错." + error.message); } } }; req.send();
从Dynamics 365 V9版本开始提供了新的客户端API来方便编程,请参考 Xrm.WebApi.online.execute (Client API reference) ,还可以参考我的博文 Dynamics 365 V9版本新的客户端API Xrm.WebApi.online.execute 使用实例 。
更多信息请参考官方文档: Use Web API functions 。
相关推荐
zhounan00 2020-07-28
阿狸写代码 2020-06-14
xieyixiao 2020-06-14
bbccaaa 2020-05-13
maicowxp 2020-05-08
chvnetcom 2020-05-06
letheashura 2020-04-09
hitxueliang 2020-03-28
木子叶家园 2020-03-08
wzhwangzhuohui 2020-02-20
云之高水之远 2020-02-17
Zjzk 2020-02-01
囧芝麻 2020-02-01
xx0cw 2020-01-21
xx0cw 2020-01-12
eightbrother 2020-01-02
kuankeTech 2020-01-10
喝绿茶的猫 2020-01-06
lyqcsdn 2019-12-31