Web API——Create related entities in one operation详细介绍

Posted 2022-12-12 zealifree005

　　本篇继续来介绍两个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记录，原理同第三点

[javascript]

  view plain  copy  

1. var entity =new Object();  
2.     entity["name"] = 'Create related entities';//文本  
3.   
4.     var contact=new Object();  
5.     contact["firstname"]="John";  
6.     contact["lastname"]= "Smith";  
7.     entity["primarycontactid"]=contact;  
8.   
9.     var contact_customer_accounts=new Array();  
10.     contact_customer_accounts[0]=new Object();  
11.     contact_customer_accounts[0]["firstname"]="联系人";  
12.     contact_customer_accounts[0]["lastname"]="测试";  
13.       
14.     var Contact_Tasks=new Array();  
15.     Contact_Tasks[0]=new Object();  
16.     Contact_Tasks[0]["subject"]="Task associated to contact";  
17.     contact_customer_accounts[0]["Contact_Tasks"]=Contact_Tasks;  
18.     entity["contact_customer_accounts"]=contact_customer_accounts;  
19.   
20.     var jsonEntity = window.JSON.stringify(entity);  
21.   
22.     var req = new XMLHttpRequest()  
23.     req.open("post",Xrm.Page.context.getClientUrl() + "/api/data/v8.0/accounts", false);  
24.     req.setRequestHeader("Accept", "application/json");  
25.     req.setRequestHeader("Content-Type", "application/json; charset=utf-8");  
26.     req.setRequestHeader("OData-MaxVersion", "4.0");  
27.     req.setRequestHeader("OData-Version", "4.0");  
28.     req.onreadystatechange = function ()   
29.         if (this.readyState == 4)   
30.             if (this.status == 204)   
31.                   
32.               
33.             else   
34.                 var data=JSON.parse(this.responseText).error.message;  
35.               
36.           
37.     ;  
38.     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中了。