自定义实体属性元数据

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

使用 AttributeMetadata 类可检索现有属性。 此类由 RetrieveAttributeRequest 消息返回。AttributeMetadata 类继承自抽象 MetadataBase 类。

可将每个属性类型的特定类与 CreateAttributeRequest 消息结合使用，以更新属性或创建自定义属性。

备注

在创建自定义属性后，可以编程方式访问这些属性，但必须先将其添加到实体窗体中并发布，然后用户才能看到它们。

属性类型

下表列出可以使用的每种 Attribute。 每个属性均继承自 AttributeMetadata 类。

类	应用程序标签	说明
BooleanAttributeMetadata	两个选项	布尔属性。 可为两个选项指定文本。 添加到窗体时，字段属性 (Property) 控制是将该属性 (Attribute) 显示为两个单选按钮、一个复选框还是一个列表。
DateTimeAttributeMetadata	日期和时间	日期和时间属性。 您可以指定此行为存储包含或不包含时区信息的日期和时间值，并指定定义这些值的显示格式的格式。 更多信息：日期及时间属性的行为和格式 备注 如果您使用 Microsoft Dynamics CRM Online 2015 更新 1 或 Microsoft Dynamics 365（内部部署），则所有日期和时间属性现在均支持早达 1/1/1753 12:00 AM 的值。
DecimalAttributeMetadata	十进制数	十进制属性。 可以指定的精度级别最多可包含 10 个小数位，还可以在从 -100,000,000,000 到 100,000,000,000 的范围内指定最小值和最大值。
DoubleAttributeMetadata	浮点数	双精度属性。 可以指定的精度级别最多可包含 5 个小数位，还可以在从 -100,000,000,000 到 100,000,000,000 的范围内指定最小值和最大值。 备注 DoubleAttributeMetadata 替代了 Microsoft Dynamics CRM 4.0 中使用的 FloatAttributeMetadata。
ImageAttributeMetadata	图像	图像属性。 每个实体可以有一个图像属性。 某些系统实体具有图像属性，新图像属性不能添加到没有它们的系统实体。 您可以将图像属性添加到自定义实体 所有图像属性都具有 SchemaName“EntityImage”和 LogicalName“entityimage”。 自定义图像属性不在名称中使用解决方案发布者自定义前缀。详细信息：实体图像。
IntegerAttributeMetadata	整数	整数属性。 可在从 -2,147,483,648 到 2,147,483,647 的范围内指定最大值和最小值。 此属性可以格式化以使用 IntegerFormat 枚举创建下列类型的字段： 持续时间：显示包含时间间隔的下拉列表。 用户可从列表中选择值，或键入表示分钟数的整数值。 时区：显示包含时区列表的下拉列表。 语言：显示包含已为组织启用的语言列表的下拉列表。 如果没有启用其他语言，则基本语言将是唯一选项。 保存的值是该语言的 LCID 值。
LookupAttributeMetadata	查找	使用 CreateOneToManyRequest 消息创建实体关系时创建的属性。
MemoAttributeMetadata	多行文本	备忘录属性。 在窗体中显示为文本框字段。 最大长度为 1048576 个字符。
MoneyAttributeMetadata	货币	货币属性。 可以指定介于 - 922,337,203,685,477 和 922,337,203,685,477 之间的最大值和最小值。 使用 PrecisionSource 属性可以设置精度级别： 当精度设置为零 (0) 时，使用 MoneyAttributeMetadata.Precision 值。 当精度设置为一 (1) 时，使用 Organization.PricingDecimalPrecision 值。 当精度设置为二 (2) 时，使用 TransactionCurrency.CurrencyPrecision 值。
PicklistAttributeMetadata	选项集	picklistattribute。 此属性提供一组显示在下拉列表中的选项。 您可以创建选择列表属性，使其包含自己的选项或使用全局选项集。
StateAttributeMetadata	状态	创建实体时会自动创建状态属性。 备注 可用于此属性的选项为只读选项。
StatusAttributeMetadata	状态描述	创建实体时会自动创建状态属性。 每个选项都必须与实体的 StateAttributeMetadata 属性关联。 使用 InsertStatusValueRequest 消息可更新用于此属性的选项。 备注 由于状态值依赖于特定状态值，因此每个 StatusOption 都必须引用特定的状态属性值。
StringAttributeMetadata	单行文本	请参阅“StringAttributeMetadata 格式”。

StringAttributeMetadata 格式

字符串属性可以格式化以允许使用 Lync 或 Skype 链接到初始电话联络。 此更改要求新 FormatName 属性添加到 StringAttributeMetadata 类，并废弃 Format 属性。

备注

Lync 已更名为 Skype for Business。 现在，您仍可以在 Microsoft Dynamics 365 中看到对“Lync”的引用，但 Dynamics 365 使用的是 Skype for Business。

使用 StringFormat 枚举可定义废弃的 StringAttributeMetadata.Format 的格式。 请转而使用 StringFormatName 类设置 StringAttributeMetadata.FormatName 的值。

这允许设置 StringFormat 枚举中不存在的 PhoneNumber 格式值。

为了向后兼容，您可以设置一个值，控制如何使用 Format or FormatName 属性来格式化属性。 如果您仅使用 Format，则您的现有代码可以继续工作，但是您在不使用 FormatName 的情况下无法将属性格式化为电话号码。 如果满足全部两个属性，则使用 FormatName 设置的值是将应用的值。

StringFormatName 类包含下列成员；每个成员返回具有与成员名称相同值：

成员名称和值	说明
Email	窗体字段将文本值作为电子邮件地址进行验证，并在字段中创建收件地址链接。
PhoneNumber	窗体字段将包含使用 Lync 或 Skype 启动电话联络的链接。
PhoneticGuide	仅供内部使用。
Text	窗体将显示文本框。
TextArea	窗体将显示文本区域字段。
TickerSymbol	窗体将显示一个链接，该链接将打开以显示股票符号的报价。
URL	窗体将显示用于打开 URL 的链接。
VersionNumber	仅供内部使用。

另请参阅

使用含有 Dynamics 365 元数据的组织服务
使用属性元数据
日期及时间属性的行为和格式
实体属性元数据消息
示例：使用属性元数据
技术文章：将选项集选项与 REST 端点结合使用 - JScript
示例：将属性元数据转储到文件
示例：将属性列表元数据转储到文件
示例：转换日期和时间行为

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权