Dynamic CRM 2013学习笔记（三）快速创建实体 EntityCreater-白红宇

Dynamic CRM 2013学习笔记（三）快速创建实体 EntityCreater

阅读量：5811 次

发布时间：2019-06-18

本文共 3901 字，大约阅读时间需要 13 分钟。

本文转自作者

一、实体简介

实体用于在 Microsoft Dynamics CRM 中建立业务数据模型和管理业务数据。例如，可以使用客户、市场活动和事件（案例）等实体跟踪和支持销售、市场营销和服务活动。实体具有一组属性，每个属性表示一个特定类型的数据项。例如，客户实体具有 Name、Address 和 OwnerId 属性。从概念上讲，实体类似于数据库表，实体属性对应于表列。在 Microsoft Dynamics CRM 中创建实体记录（或记录）类似于在数据库表中添加记录。实体划分成三个类别：系统、业务和自定义。作为处理业务数据的开发人员，您将使用业务和自定义实体。Microsoft Dynamics CRM 使用系统实体处理所有内部流程，如工作流和异步作业。不能删除或自定义系统实体。

业务实体是默认安装的 Microsoft Dynamics CRM 的一部分，它们显示在自定义用户界面中。例如，客户、联系人和信件都是业务实体。安装 Microsoft Dynamics CRM 后，可以向其中添加自定义实体以满足组织的特定业务需求。在 Microsoft Dynamics CRM 解决方案中，可以将业务和自定义实体以及属性设置为可自定义或不可自定义。可以通过以下方式修改可自定义实体：重命名可自定义实体、添加新属性或更改各种设置，如重复检测或队列支持设置。不能修改不可自定义的实体。

二、存在的问题

我们一般在CRM系统上通过界面来创建实体，但这个效率太低了，而且有些属性不能修改，这样有时就会出现这样的问题：有时为了修改实体的一个属性，但这个属性却是不能修改的，这时我们不得不把整个实体删除，再把字段一个个的添加。

如果项目里人多了，虽然有命名规范文档，比如，我们一般把lookup类型的字段后面加上id，但有时一不小心有兄弟就会忘记了。

三、解决方法

于是就想着通过工具来生成实体，网上搜索后，没发现有什么好的实体生成工具。于是只得自己动手，创建entity及各类型的属性：

1. 实体创建

1: CreateEntityRequest request = new CreateEntityRequest

2: {

3:     HasNotes = false,

4:     HasActivities = false,

5:     Entity = new EntityMetadata

6:     {

7:         IsActivity = false,

8:         SchemaName = customEntityName,

9:         DisplayName = new Label(entity.DisplayName, 1033),

10:         DisplayCollectionName = new Label(entity.DisplayName, 1033),

11:         OwnershipType = OwnershipTypes.UserOwned,

12:         IsAvailableOffline = true

13:     }

14: };

2. string属性

1: [AttributeType("Single Line of Text")]

2: public class StringAttributeeCreater : AttributeCreater

3: {

4:     public override AttributeMetadata Create()

5:     {

6:         AttributeMetadata attribute = new StringAttributeMetadata

7:         {

8:             SchemaName = Field.PhysicalName,

9:             RequiredLevel = GetRequiredLevel(),

10:             MaxLength = 100,

11:             FormatName = StringFormatName.Text,

12:             DisplayName = new Microsoft.Xrm.Sdk.Label(Field.DisplayName, 1033)

13:         };

14:         return attribute;

15:     }

16: }

3. optionset 属性

1: [AttributeType(OptionSetAttributeeCreater.OptionSet_STR)]

2: public class OptionSetAttributeeCreater : AttributeCreater

3: {

4:     public const string OptionSet_STR = "Option Set";

5:     public override AttributeMetadata Create()

6:     {

7:         PicklistAttributeMetadata attribute = new PicklistAttributeMetadata

8:         {

9:             RequiredLevel = GetRequiredLevel(),

10:             SchemaName = Field.PhysicalName,

11:             DisplayName = new Microsoft.Xrm.Sdk.Label(Field.DisplayName, 1033),

12:             OptionSet = new OptionSetMetadata()

13:         };

14:

15:         attribute.OptionSet.IsGlobal = true;

16:         if (!string.IsNullOrEmpty(Field.Remark))

17:         {

18:             attribute.OptionSet.Name = Field.Remark;

19:         }

20:         else if (!string.IsNullOrEmpty(Field.TypeRule))

21:         {

22:             string[] arr = Field.TypeRule.Split('\n');

23:

24:             foreach (string item in arr)

25:             {

26:                 string[] arr2 = item.Split('，', ',');

27:                 if (arr2.Length == 2)

28:                 {

29:                     int value = int.Parse(arr2[0]);

30:                     attribute.OptionSet.Options.Add(new OptionMetadata(new Microsoft.Xrm.Sdk.Label(arr2[1], 1033), value));

31:                 }

32:             }

33:         }

34:         return attribute;

35:     }

36: }

其它属性以此类推，这里就不一一介绍了，大家可以查看下sdk，里面有详细的介绍。

四、EntityCreater工具

1. 通过excel列出实体名和字段名

（EntityCreaterGuide.xlsx）

下面是个例子：

2. 首次使用EntittyCreater里，要修改下CRMEntityCreater.exe.config里面的连接信息

<add name="name" connectionString="Url= Domain=xxxx; Username=xxxx; Password=xxx;"/>

运行EntityCreater，并把保存好的excel文件拖入左上角的框框里，这时它会把里面所有的sheet都显示出来，我们可以依次创建这些实体：