本篇继续来介绍两个web api的接口,一个是“Create related entities in one operation”即在一步操作中完成主实体的创建加关联实体的创建,一个是“Associate entities on create“即在创建记录的时候填充lookup字段。
先来说第一个api,老规矩直接上代码,稍微做下解释,注意下面的几点不存在先后顺序,我只是分开说明罢了
1、这里创建一个account实体记录
2、创建一条名为"John Smith"的contact记录(注意这条记录是新建的不是已经存在的),赋值给account中的primarycontactid(与联系人关联的lookup字段)属性字段
3、创建一条名为"测试联系人"的contact记录,account记录和这条测试联系人记录是1:N的关系,也就是说这里的contact记录可以创建多条
4、在第3点中创建的contact记录中再关联task记录,原理同第三点
var entity =new Object(); entity["name"] = 'Create related entities';//文本 var contact=new Object(); contact["firstname"]="John"; contact["lastname"]= "Smith"; entity["primarycontactid"]=contact; var contact_customer_accounts=new Array(); contact_customer_accounts[0]=new Object(); contact_customer_accounts[0]["firstname"]="联系人"; contact_customer_accounts[0]["lastname"]="测试"; var Contact_Tasks=new Array(); Contact_Tasks[0]=new Object(); Contact_Tasks[0]["subject"]="Task associated to contact"; contact_customer_accounts[0]["Contact_Tasks"]=Contact_Tasks; entity["contact_customer_accounts"]=contact_customer_accounts; var jsonEntity = window.JSON.stringify(entity); var req = new XMLHttpRequest() req.open("post",Xrm.Page.context.getClientUrl() + "/api/data/v8.0/accounts", false); 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) { if (this.status == 204) { } else { var data=JSON.parse(this.responseText).error.message; } } }; req.send(jsonEntity);
关于代码中的contact_customer_accounts的由来如下截图,Contact_Tasks也是同理可以在contact中找到,架构名称注意大小写
有图有真相,上截图
创建的account主实体记录,account中的"John Smith"的lookup字段关联的contact也是本次operation中新建的
account记录下关联的多条(我这只创建了一条)联系人记录
测试联系人记录下创建的多条(我这只创建了一条)task记录
上述即是一个create operation中产生的数据记录,是不是很cool。这个场景一般在后台代码中用的比较多,以前的做法都是通过组织服务先创建主记录后,拿到主记录的guid然后再一条条的创建子记录,现在一个api一次request就能搞定。
关于第二个api"Associate entities on create",这里不多做阐述了,以上面的demo来举例,就是创建一条account记录给primarycontactid这个lookup字段赋值,实际过程中用到的不多,就算要用到也都直接是包含在create的api中了。