定义引用记录的备用键

此主题适用于 Dynamics 365 Customer Engagement (on-premises)。 有关此主题的 Power Apps 版本,请参阅: 使用 Power Apps 门户定义备用键

使用备用键,您可以确保通过准确有效的方式集成外部系统的数据。 当外部系统不存储唯一标识记录的记录 ID (GUID) 时此功能尤为重要。 备用键不是 GUID,您可以使用这些键唯一标识记录。 您必须为备用键提供一个唯一名称。 您可以使用一个或多个实体字段定义此键。 例如,要使用备用键标识客户记录,则可以使用“客户名称”和“客户编号”。 您可以定义备用键,而不必编写代码,也可以通过编程方式进行定义。 请注意,尽管您可以在用户界面 (UI) 中定义备用键,在代码中,他们只能通过编程方式使用。

备用键功能的一些好处包括:

  • 更快地查找记录。

  • 更可靠的批量数据操作。

  • 利用从不含记录 ID 的外部系统导入的数据简化编程。

重要提示

  • 您不能将现有记录正在使用的字段用作备用键。 这将导致重复记录错误。
  • 启用了字段级安全性的字段不能用作备用键。 详细信息:用于控制访问的字段级安全性

若要了解有关备用键编程的详细信息,请参阅:
定义实体的备用键
使用备用键创建记录

定义备用键

  1. 打开解决方案资源管理器。
  2. 转到组件 > 实体 > 实体 <X> > 密钥
  3. 选择新建
  4. 在窗体中,填写必填字段(显示名称名称),然后选择并将字段添加到键。
  5. 保存键。

下面的示例在备用键定义中使用“客户编号”字段。

定义客户实体的备用键。

备注

您最多可以为一个实体定义五个不同的键密钥。

另请参见

创建和编辑 Web 资源
定义实体的备用键(开发人员指南)使用备用键创建记录(开发人员指南)