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

标签：crm   实体   

一、实体简介

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

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

二、存在的问题

1. 我们一般在CRM系统上通过界面来创建实体，但这个效率太低了，而且有些属性不能修改，这样有时就会出现这样的问题：有时为了修改实体的一个属性，但这个属性却是不能修改的，这时我们不得不把整个实体删除，再把字段一个个的添加。
2. 如果项目里人多了，虽然有命名规范文档，比如，我们一般把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=http://xxxx:5555/xxx/; Domain=xxxx; Username=xxxx; Password=xxx;"/>

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

3. 点击左边中间的按钮 Generate Phical Name， 自动生成 phisical name：

 

4.这时，就可以通过点击 Create Entity来创建实体了。如果只是添加些字段，也可以只勾选Fields：

 

5. 创建完成后，我们可以通过Save to Excel来保存生成的Phical Name到excel里，还可以点击View Result来查看创建过程中的log信息

下载 EntityCreater（ 提取码 aef0）

Dynamic CRM 2013学习笔记 系列汇总

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

标签：crm   实体   

原文地址：http://blog.csdn.net/hufengwen/article/details/42294021