描述符端点

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

架构定义数据实体的结构，但并不指定根据这些架构创建的任何数据集如何相互关联。在Adobe Experience Platform中，您可以使用描述符描述这些关系，并将解释性元数据添加到架构中。

描述符是应用于Adobe Experience Platform中架构的租户级别元数据对象。它们定义影响下游数据的验证、连接或解释方式的结构关系、键和行为字段（例如时间戳或版本控制）。

架构可以有一个或多个描述符。每个描述符定义一个@type以及它适用的sourceSchema。描述符自动应用于从该架构创建的所有数据集。

在Adobe Experience Platform中，描述符是将行为规则或结构含义添加到架构的元数据。
有多种类型的描述符，包括：

标识描述符 — 将字段标记为标识
主键描述符 — 强制唯一性
关系描述符 — 定义外键联接
备用显示信息描述符 — 允许您重命名用户界面中的字段
版本和时间戳描述符 — 跟踪事件排序和更改检测

/descriptors API中的Schema Registry端点允许您以编程方式管理体验应用程序中的描述符。

快速入门

本指南中使用的终结点是Schema Registry API的一部分。在继续之前，请查看快速入门指南，以获取相关文档的链接、阅读本文档中示例API调用的指南，以及有关成功调用任何Experience Platform API所需的所需标头的重要信息。

除了标准描述符之外，Schema Registry还支持基于模型的架构的描述符类型，如主键、版本和 时间戳。这些选项可强制唯一性、控制版本控制，并在架构级别定义时间序列字段。如果您不熟悉基于模型的架构，请先查看Data Mirror概述和基于模型的架构技术参考，然后再继续。

IMPORTANT

有关所有描述符类型的详细信息，请参阅附录。

检索描述符列表 list

通过向/tenant/descriptors发出GET请求，您可以列出贵组织定义的所有描述符。

API格式

GET /tenant/descriptors

请求

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xdm-link+json'

响应格式取决于请求中发送的Accept标头。请注意，/descriptors端点使用的Accept标头与Schema Registry API中的所有其他端点不同。

IMPORTANT

描述符需要将Accept替换为xed的唯一xdm标头，并且还提供描述符唯一的link选项。以下示例调用中已包含正确的Accept标头，但请格外小心，以确保在使用描述符时使用正确的标头。

Accept标头

描述

application/vnd.adobe.xdm-id+json

返回描述符ID的数组

application/vnd.adobe.xdm-link+json

返回描述符API路径的数组

application/vnd.adobe.xdm+json

返回扩展描述符对象的数组

application/vnd.adobe.xdm-v2+json

此Accept标头必须使用分页功能。

响应

响应包括已定义描述符的每个描述符类型的数组。换言之，如果没有定义特定@type的描述符，则注册表将不会为该描述符类型返回空数组。

使用link Accept标头时，每个描述符都显示为格式为/{CONTAINER}/descriptors/{DESCRIPTOR_ID}的数组项

{
  "xdm:alternateDisplayInfo": [
    "/tenant/descriptors/85dc1bc8b91516ac41163365318e38a9f1e4f351",
    "/tenant/descriptors/49bd5abb5a1310ee80ebc1848eb508d383a462cf",
    "/tenant/descriptors/b3b3e548f1c653326bcf5459ceac4140fc0b9e08"
  ],
  "xdm:descriptorIdentity": [
    "/tenant/descriptors/f7a4bc25429496c4740f8f9a7a49ba96862c5379"
  ],
  "xdm:descriptorOneToOne": [
    "/tenant/descriptors/cb509fd6f8ab6304e346905441a34b58a0cd481a"
  ]
}

查找描述符 lookup

要查看特定描述符的详细信息，请使用其@id发送GET请求。

API格式

GET /tenant/descriptors/{DESCRIPTOR_ID}

参数

描述

{DESCRIPTOR_ID}

要查找的描述符的@id。

请求

以下请求按其@id值检索描述符。描述符未进行版本控制，因此查找请求中不需要任何Accept标头。

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors/f3a1dfa38a4871cf4442a33074c1f9406a593407 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

成功的响应将返回描述符的详细信息，包括其@type和sourceSchema，以及根据描述符类型而异的其他信息。返回的@id应与请求中提供的描述符@id匹配。

{
  "@type": "xdm:descriptorIdentity",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/personalEmail/address",
  "xdm:namespace": "Email",
  "xdm:property": "xdm:code",
  "xdm:isPrimary": false,
  "createdUser": "{CREATED_USER}",
  "imsOrg": "{ORG_ID}",
  "createdClient": "{CREATED_CLIENT}",
  "updatedUser": "{UPDATED_USER}",
  "created": 1548899346989,
  "updated": 1548899346989,
  "meta:containerId": "tenant",
  "@id": "f3a1dfa38a4871cf4442a33074c1f9406a593407"
}

创建描述符 create

您可以通过向/tenant/descriptors端点发出POST请求来创建新描述符。

IMPORTANT

Schema Registry允许您定义多个不同的描述符类型。每个描述符类型都需要在请求正文中发送其自身的特定字段。有关描述符的完整列表以及定义描述符所需的字段，请参阅附录。

API格式

POST /tenant/descriptors

请求

以下请求在示例架构中的“电子邮件地址”字段中定义标识描述符。这告知Experience Platform使用电子邮件地址作为标识符以帮助拼接有关个人的信息。

curl -X POST \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '
      {
        "@type": "xdm:descriptorIdentity",
        "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
        "xdm:sourceVersion": 1,
        "xdm:sourceProperty": "/personalEmail/address",
        "xdm:namespace": "Email",
        "xdm:property": "xdm:code",
        "xdm:isPrimary": false
      }'

响应

成功的响应返回HTTP状态201 （已创建）以及新创建的描述符的详细信息，包括其@id。 @id是由Schema Registry分配的只读字段，用于引用API中的描述符。

{
  "@type": "xdm:descriptorIdentity",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/personalEmail/address",
  "xdm:namespace": "Email",
  "xdm:property": "xdm:code",
  "xdm:isPrimary": false,
  "meta:containerId": "tenant",
  "@id": "f3a1dfa38a4871cf4442a33074c1f9406a593407"
}

更新描述符 put

您可以通过在PUT请求的路径中包含描述符的@id来更新描述符。

API格式

PUT /tenant/descriptors/{DESCRIPTOR_ID}

参数

描述

{DESCRIPTOR_ID}

要更新的描述符的@id。

请求

此请求基本上重写描述符，因此请求正文必须包含定义该类型的描述符所需的所有字段。换句话说，用于更新(PUT)描述符的请求有效负载与用于创建(POST)相同类型的描述符的有效负载相同。

IMPORTANT

与使用POST请求创建描述符一样，每种描述符类型都需要在PUT请求负载中发送其自己的特定字段。有关描述符的完整列表以及定义描述符所需的字段，请参阅附录。

以下示例将标识描述符更新为引用其他xdm:sourceProperty (mobile phone)，并将xdm:namespace更改为Phone。

curl -X PUT \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors/f3a1dfa38a4871cf4442a33074c1f9406a593407 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "@type": "xdm:descriptorIdentity",
        "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
        "xdm:sourceVersion": 1,
        "xdm:sourceProperty": "/mobilePhone/number",
        "xdm:namespace": "Phone",
        "xdm:property": "xdm:code",
        "xdm:isPrimary": false
      }'

响应

成功的响应返回HTTP状态201 （已创建）和更新描述符的@id（应与请求中发送的@id匹配）。

{
    "@id": "f3a1dfa38a4871cf4442a33074c1f9406a593407"
}

执行查找(GET)请求以查看描述符时，显示字段现已更新以反映PUT请求中发送的更改。

删除描述符 delete

有时您可能需要从Schema Registry中删除已定义的描述符。这是通过发出引用要删除的描述符的@id的DELETE请求来完成的。

API格式

DELETE /tenant/descriptors/{DESCRIPTOR_ID}

参数

描述

{DESCRIPTOR_ID}

要删除的描述符的@id。

请求

curl -X DELETE \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/descriptors/ca921946fb5281cbdb8ba5e07087486ce531a1f2  \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应

成功的响应返回HTTP状态204（无内容）和一个空白正文。

要确认该描述符已被删除，您可以对该描述符执行查找请求@id。响应返回HTTP状态404 （未找到），因为描述符已从Schema Registry中删除。

附录 appendix

以下部分提供了有关在Schema Registry API中使用描述符的其他信息。

定义描述符 defining-descriptors

NOTE

可应用于组织沙盒的描述符的最大数量为4000。

以下部分概述了可用的描述符类型，包括用于定义每种类型的描述符的必填字段。

IMPORTANT

您不能为租户命名空间对象添加标签，因为系统将通过该沙盒将该标签应用于每个自定义字段。相反，您必须在该对象下指定需要标记的叶节点。

身份描述符 identity-descriptor

标识描述符指示“sourceSchema”的“sourceProperty”是IdentityExperience Platform Identity Service描述的字段。

{
  "@type": "xdm:descriptorIdentity",
  "xdm:sourceSchema":
    "https://ns.adobe.com/{TENANT_ID}/schemas/fbc52b243d04b5d4f41eaa72a8ba58be",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/personalEmail/address",
  "xdm:namespace": "Email",
  "xdm:property": "xdm:code",
  "xdm:isPrimary": false
}

属性

描述

@type

正在定义的描述符类型。对于标识描述符，此值必须设置为xdm:descriptorIdentity。

xdm:sourceSchema

正在定义描述符的架构的$id URI。

xdm:sourceVersion

源架构的主要版本。

xdm:sourceProperty

将成为标识的特定属性的路径。路径应该以“/”开头，而不是以开头。不要在路径中包含“properties”（例如，使用“/personalEmail/address”而不是“/properties/personalEmail/properties/address”）

xdm:namespace

身份命名空间的id或code值。可以使用Identity Service API找到命名空间列表。

xdm:property

xdm:id或xdm:code，具体取决于使用的xdm:namespace。

xdm:isPrimary

可选的布尔值。如果为true，则指示字段作为主标识。架构只能包含一个主标识。

友好名称描述符 friendly-name

友好名称描述符允许用户修改核心库架构字段的title、description和meta:enum值。在使用“eVar”和您希望标记为包含特定于您的组织的信息的其他“通用”字段时特别有用。 UI可以使用这些显示更友好的名称或仅显示具有友好名称的字段。

{
  "@type": "xdm:alternateDisplayInfo",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/274f17bc5807ff307a046bab1489fb18",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/xdm:eventType",
  "xdm:title": {
    "en_us": "Event Type"
  },
  "xdm:description": {
    "en_us": "The type of experience event detected by the system."
  },
  "meta:enum": {
    "click": "Mouse Click",
    "addCart": "Add to Cart",
    "checkout": "Cart Checkout"
  },
  "xdm:excludeMetaEnum": {
    "web.formFilledOut": "Web Form Filled Out",
    "media.ping": "Media ping"
  }
}

属性

描述

@type

正在定义的描述符类型。对于友好名称描述符，此值必须设置为xdm:alternateDisplayInfo。

xdm:sourceSchema

正在定义描述符的架构的$id URI。

xdm:sourceVersion

源架构的主要版本。

xdm:sourceProperty

要修改其详细信息的特定属性的路径。路径应以斜杠(/)开头，而不是以斜杠结尾。不要在路径中包含properties（例如，使用/personalEmail/address而不是/properties/personalEmail/properties/address）。

xdm:title

您希望为此字段显示的新标题，以字首大写字母表示。

xdm:description

可以在标题中添加可选描述。

meta:enum

如果xdm:sourceProperty指示的字段为字符串字段，则可以使用meta:enum在分段UI中为字段添加建议值。需要注意的是，meta:enum不会为XDM字段声明枚举或提供任何数据验证。

这只能用于Adobe定义的核心XDM字段。如果源属性是您的组织定义的自定义字段，您应该直接通过PATCH请求编辑该字段的meta:enum属性，该请求是该字段的父资源。

meta:excludeMetaEnum

如果由xdm:sourceProperty指示的字段是一个字符串字段，该字段具有在meta:enum字段下提供的现有建议值，则可以在友好名称描述符中包含此对象，以从分段中排除这些值的部分或全部。每个条目的键和值必须与字段的原始meta:enum中包含的键和值匹配，才能排除该条目。

关系描述符 relationship-descriptor

关系描述符描述两个不同架构之间的关系，它们以xdm:sourceProperty和xdm:destinationProperty中描述的属性作为密钥。有关详细信息，请参阅有关定义两个架构之间关系的教程。

使用这些属性声明源字段（外键）与目标字段（主键或候选键）的关系。

TIP

外键是源架构中的字段（由xdm:sourceProperty定义），它引用了另一个架构中的键字段。 候选键 是目标架构中唯一标识记录的任意字段（或字段集），可以代替主键使用。

API支持两种模式：

xdm:descriptorOneToOne：标准1:1关系。
xdm:descriptorRelationship：用于新工作和基于模型的架构的常规模式（支持基数、命名和非主键目标）。

一对一关系（标准架构）

在维护已依赖于xdm:descriptorOneToOne的现有标准架构集成时使用此项。

{
  "@type": "xdm:descriptorOneToOne",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SOURCE_SCHEMA_ID}",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/parentField/subField",
  "xdm:destinationSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{DEST_SCHEMA_ID}",
  "xdm:destinationVersion": 1,
  "xdm:destinationProperty": "/parentField/subField"
}

下表介绍了定义一对一关系描述符所需的字段。

属性

描述

@type

正在定义的描述符类型。对于关系描述符，该值必须设置为xdm:descriptorOneToOne，除非您有权访问Real-Time CDP B2B edition。通过B2B edition，您可以选择使用xdm:descriptorOneToOne或xdm:descriptorRelationship。

xdm:sourceSchema

正在定义描述符的架构的$id URI。

xdm:sourceVersion

源架构的主要版本。

xdm:sourceProperty

要定义关系的源架构中字段的路径。应该以“/”开头，而不是以“/”结尾。不要在路径中包含“properties”（例如，“/personalEmail/address”而不是“/properties/personalEmail/properties/address”）。

xdm:destinationSchema

此描述符正在定义关系的参考架构的$id URI。

xdm:destinationVersion

引用架构的主要版本。

xdm:destinationProperty

（可选）引用架构中目标字段的路径。如果忽略此属性，则包含匹配引用标识描述符的任何字段都会推断目标字段（请参阅下文）。

一般关系（基于模型的架构和新项目推荐）

请将此描述符用于所有新实施和基于模型的架构。它允许您定义关系的基数（如一对一或多对一），指定关系名称，以及指向非主键（非主键）的目标字段的链接。

以下示例显示如何定义常规关系描述符。

最小示例：

此最小示例仅包括定义两个架构之间的多对一关系的必填字段。

{
  "@type": "xdm:descriptorRelationship",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SOURCE_SCHEMA_ID}",
  "xdm:sourceProperty": "/customer_ref",
  "xdm:sourceVersion": 1,
  "xdm:destinationSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{DEST_SCHEMA_ID}",
  "xdm:cardinality": "M:1"
}

所有可选字段的示例：

此示例包括所有可选字段，例如关系名称、显示标题和显式非主键目标字段。

{
  "@type": "xdm:descriptorRelationship",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SOURCE_SCHEMA_ID}",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/customer_ref",
  "xdm:destinationSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{DEST_SCHEMA_ID}",
  "xdm:destinationProperty": "/customer_id",
  "xdm:sourceToDestinationName": "CampaignToCustomer",
  "xdm:destinationToSourceName": "CustomerToCampaign",
  "xdm:sourceToDestinationTitle": "Customer campaigns",
  "xdm:destinationToSourceTitle": "Campaign customers",
  "xdm:cardinality": "M:1"
}

选择关系描述符

请按照以下准则确定要应用的关系描述符：

状况

要使用的描述符

新的工作或基于模型的架构

xdm:descriptorRelationship

标准架构中的现有1:1映射

继续使用xdm:descriptorOneToOne，除非您需要仅由xdm:descriptorRelationship支持的功能。

需要多对一或可选基数(1:1， 1:0， M:1， M:0)

xdm:descriptorRelationship

UI/下游可读性需要关系名称或标题

xdm:descriptorRelationship

需要不是标识的目标目标

xdm:descriptorRelationship

NOTE

对于标准架构中的现有xdm:descriptorOneToOne描述符，除非您需要非主标识目标目标、自定义命名或扩展基数选项等功能，否则请继续使用它们。

功能比较

下表比较了两种描述符类型的功能：

功能

xdm:descriptorOneToOne

xdm:descriptorRelationship

基数

1:1

1:1， 1:0， M:1， M:0 （信息性）

目标目标

标识/显式字段

默认主键，或通过xdm:destinationProperty的非主键

命名字段

不受支持

xdm:sourceToDestinationName、xdm:destinationToSourceName和标题

关系拟合

有限

基于模型的架构的主要模式

约束和验证

在定义一般关系描述符时，请遵循以下要求和建议：

对于基于模型的架构，请将源字段（外键）放在根级别。这是当前的摄取技术限制，而不仅仅是最佳实践建议。
确保源字段和目标字段的数据类型兼容（数字、日期、布尔值、字符串）。
请记住，基数是信息性的；存储不会强制执行。以<source>:<destination>格式指定基数。接受的值为： 1:1、1:0、M:1或M:0。

主键描述符 primary-key-descriptor

主键描述符(xdm:descriptorPrimaryKey)对架构中的一个或多个字段强制执行唯一性和非null约束。

{
  "@type": "xdm:descriptorPrimaryKey",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
  "xdm:sourceProperty": ["/orderId", "/orderLineId"]
}

属性

描述

@type

必须为xdm:descriptorPrimaryKey。

xdm:sourceSchema

架构的$id URI。

xdm:sourceProperty

主键字段的JSON指针。使用组合键数组。对于时间序列架构，复合密钥必须包含时间戳字段，以确保事件记录中的唯一性。

版本描述符 version-descriptor

NOTE

在UI架构编辑器中，版本描述符显示为“版本标识符”。

版本描述符(xdm:descriptorVersion)指定一个字段来检测和防止无序更改事件发生冲突。

{
  "@type": "xdm:descriptorVersion",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
  "xdm:sourceProperty": "/versionNumber"
}

属性

描述

@type

必须为xdm:descriptorVersion。

xdm:sourceSchema

架构的$id URI。

xdm:sourceProperty

版本字段的JSON指针。必须标记为required。

时间戳描述符 timestamp-descriptor

NOTE

在UI架构编辑器中，时间戳描述符显示为“时间戳标识符”。

时间戳描述符(xdm:descriptorTimestamp)将日期时间字段指定为具有"meta:behaviorType": "time-series"的架构的时间戳。

{
  "@type": "xdm:descriptorTimestamp",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
  "xdm:sourceProperty": "/eventTime"
}

属性

描述

@type

必须为xdm:descriptorTimestamp。

xdm:sourceSchema

架构的$id URI。

xdm:sourceProperty

时间戳字段的JSON指针。必须标记为required并且类型为date-time。

B2B关系描述符 B2B-relationship-descriptor

Real-Time CDP B2B edition引入了一种定义架构之间关系的替代方法，该方法允许多对一关系。此新关系必须具有@type: xdm:descriptorRelationship类型，并且有效负载必须包含比@type: xdm:descriptorOneToOne关系更多的字段。有关详细信息，请参阅有关为B2B edition定义架构关系的教程。

{
   "@type": "xdm:descriptorRelationship",
   "xdm:sourceSchema" : "https://ns.adobe.com/{TENANT_ID}/schemas/9f2b2f225ac642570a110d8fd70800ac0c0573d52974fa9a",
   "xdm:sourceVersion" : 1,
   "xdm:sourceProperty" : "/person-ref",
   "xdm:destinationSchema" : "https://ns.adobe.com/{TENANT_ID/schemas/628427680e6b09f1f5a8f63ba302ee5ce12afba8de31acd7",
   "xdm:destinationVersion" : 1,
   "xdm:destinationProperty": "/personId",
   "xdm:destinationNamespace" : "People",
   "xdm:destinationToSourceTitle" : "Opportunity Roles",
   "xdm:sourceToDestinationTitle" : "People",
   "xdm:cardinality": "M:1"
}

属性

描述

@type

正在定义的描述符类型。对于我们具有以下字段，该值必须设置为xdm:descriptorRelationship。有关其他类型的信息，请参阅关系描述符部分。

xdm:sourceSchema

正在定义描述符的架构的$id URI。

xdm:sourceVersion

源架构的主要版本。

xdm:sourceProperty

xdm:destinationSchema

此描述符正在定义关系的参考架构的$id URI。

xdm:destinationVersion

引用架构的主要版本。

xdm:destinationProperty

（可选）引用架构中目标字段的路径。这必须解析为架构的主ID，或解析为另一个数据类型与xdm:sourceProperty兼容的字段。如果忽略，则关系可能无法按预期运行。

xdm:destinationNamespace

引用架构中的主ID的命名空间。

xdm:destinationToSourceTitle

从引用架构到源架构的关系显示名称。

xdm:sourceToDestinationTitle

从源架构到引用架构的关系显示名称。

xdm:cardinality

架构之间的连接关系。此值应设置为M:1，表示多对一关系。

引用身份描述符

引用身份描述符为架构字段的主要身份提供引用上下文，允许其他架构中的字段引用该上下文。引用架构必须先定义主标识字段，其他架构才能通过此描述符引用该字段。

{
  "@type": "xdm:descriptorReferenceIdentity",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/78bab6346b9c5102b60591e15e75d254",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/parentField/subField",
  "xdm:identityNamespace": "Email"
}

属性

描述

@type

正在定义的描述符类型。对于引用标识描述符，此值必须设置为xdm:descriptorReferenceIdentity。

xdm:sourceSchema

正在定义描述符的架构的$id URI。

xdm:sourceVersion

源架构的主要版本。

xdm:sourceProperty

源架构中用于引用引用架构的字段的路径。应该以“/”开头，而不是以开头。不要在路径中包含“properties”（例如，/personalEmail/address而不是/properties/personalEmail/properties/address）。

xdm:identityNamespace

源属性的身份命名空间代码。

已弃用的字段描述符

您可以弃用自定义XDM资源中的字段，方法是向相关字段添加设置为meta:status的deprecated属性。但是，如果要弃用由架构中的标准XDM资源提供的字段，可向相关架构分配已弃用的字段描述符，以实现相同的效果。通过使用正确的Accept标头，您可以在API中查找架构时查看该架构已弃用的标准字段。

{
  "@type": "xdm:descriptorDeprecated",
  "xdm:sourceSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/c65ddf08cf2d4a2fe94bd06113bf4bc4c855e12a936410d5",
  "xdm:sourceVersion": 1,
  "xdm:sourceProperty": "/faxPhone"
}

属性

描述

@type

描述符的类型。对于字段弃用描述符，此值必须设置为xdm:descriptorDeprecated。

xdm:sourceSchema

要应用描述符的架构的URI $id。

xdm:sourceVersion

要将描述符应用于的架构的版本。应设置为1。

xdm:sourceProperty

架构中要将描述符应用于的属性的路径。如果要将描述符应用于多个属性，则可以提供数组形式的路径列表（例如，["/firstName", "/lastName"]）。

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07