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

　　本篇继续来介绍两个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中了。