MS CRM 2011的自定义和开发（10）——CRM web服务介绍(第二部分)—

MS CRM 2011的自定义和开发（10）——CRM web服务介绍(第二部分)——IOrganizationService（二）

上一篇文章介绍了Microsoft Dynamics CRM 2011的组织服务OrganizationService的Create、Update、Delete方法，本文介绍Associate、Disassociate和Retrieve方法。

Associate方法的签名如下：

1 public virtual void Associate (
2     string entityName,
3     Guid entityId,
4     Relationship relationship,
5     EntityReferenceCollection relatedEntities
6 )

  从签名可以看出，Associate方法完成的功能是依据输入参数relationship指定的关联，将主要实体(entityName指定）的某个实例（entityId指定)与一组相关实体（relatedEntities）进行连接。

  下面是Associate方法的样例代码，该样例代码完成的功能是依据关联“account_primary_contact”，连接两个客户实例与联系人实例。从数据库角度讲，就是设置客户实例的primarycontactid字段值为联系人的主键值，对于多对多关系而言，系统会自动向交叉表插入数据。该方法的样例代码如下：

 1 //创建联系人记录
 2 
 3 Entity setupContact = new Entity("contact");
 4 setupContact["firstname"] = "John";
 5 setupContact["lastname"] = "Doe";
 6 _contactId = _service.Create(setupContact);
 7 
 8 // 创建客户记录1
 9 Entity setupAccount1 = new Entity("account");
10 setupAccount1["name"] = "Example Account 1";
11 
12 _account1Id = _service.Create(setupAccount1);
13 
14 //创建客户记录2
15 
16 Entity setupAccount2 = new Entity("account");
17 setupAccount2["name"] = "Example Account 2";
18 
19 _account2Id = _service.Create(setupAccount2);
20 
21 //创建客户记录3
22 
23 Entity setupAccount3 = new Entity("account");
24 setupAccount3["name"] = "Example Account 3";
25 
26 _account3Id = _service.Create(setupAccount3);
27 
28  
29 
30 //创建关联实例，指定当前使用的关联是account_primary_contact
31 Relationship relationship = new Relationship("account_primary_contact");
32 
33 //创建EntityReference集合，将关联信息中的相关实体引用添加到集合中
34 
35 EntityReferenceCollection relatedEntities = new EntityReferenceCollection();
36 relatedEntities.Add(new EntityReference("account", _account1Id));
37 relatedEntities.Add(new EntityReference("account", _account2Id));
38 relatedEntities.Add(new EntityReference("account", _account3Id));
39 
40 //调用Associate方法，指定主要实体的逻辑名称，主要实体的主键值，Associate方法使用的关联，以及相关实体的引用集合
41 
42 _service.Associate("contact", _contactId, relationship, relatedEntities);

Disassociate方法，从该方法的命名就可以知道，Disassociate方法和Associate方法是互逆的两个操作，Disassociate方法的签名如下：

1 public virtual void Disassociate (
2     string entityName,
3     Guid entityId,
4     Relationship relationship,
5     EntityReferenceCollection relatedEntities
6 )
可见，Disassociate方法和Associate方法的输入参数是一样的。在调用本方法时，系统会根据relationship关联，找到相关实体的外键字段，而后，将relatedEntities集合中的记录的该外键值置为null。对于多对多关系而言，系统会根据根据entityId以及relatedEntities集合中的每个元素的主键值，从中间表中删除该数据。

  样例代码如下：

_service.Disassociate("contact", _contactId, relationship, relatedEntities);
这条语句是基于本文前面的样例代码而来，放置于_service.Associate("contact", _contactId, relationship, relatedEntities);之后，即可完成解除连接的操作。

  Retrieve方法，用于获取某个实体的单挑数据，签名如下：

1 public virtual Entity Retrieve (
2     string entityName,
3     Guid id,
4     ColumnSet columnSet
5 )

   该方法的输入参数有三个，分别是带查询实体的逻辑名称entityName，带查询实体实例的主键值id，以及返回列columnSet。返回值是Entity对象，Entity对象的包含的字段信息由columnSet指定。样例代码如下：

 1 //首先，创建一条样例数据——一条客户记录，以便后续Retrieve方法使用
 2 
 3 Entity account = new Entity("account");
 4 
 5 account["name"] = "Fourth Coffee";
 6 
 7 _accountId = _service.Create(account);
 8 
 9  
10 
11 //实例化ColumnSet，以设定返回列的信息，本样例中，设定返回列是”name”以及”ownerid”
12 ColumnSet attributes = new ColumnSet(new string[] { "name", "ownerid" });
13 
14 //调用Retrieve方法，设定查询的实体的逻辑名称”account“，设定带查询的客户实例的主键值_accountId
15 
16 //返回值是一个Entity对象。
17 account = _service.Retrieve(“account”, _accountId, attributes);

以上，介绍了微软CRM 2011中组织服务提供的三个方法Associate、Disassociate以及Reteive方法。