附录

本文档提供与使用API相关的补充 Schema Registry 信息。

使用查询参数

支 Schema Registry 持在列出资源时使用查询参数进行页面和筛选结果。

注意

组合多个查询参数时,必须用和号(&)分隔。

分页

用于分页的最常见的查询参数包括:

参数 描述
start 指定列出的结果的开始位置。 此值可以从列表响 _page.next 应的属性中获取,并用于访问结果的下一页。 如果 _page.next 值为null,则没有其他页可用。
limit 限制返回的资源数。 示例: limit=5 将返还列表5个资源。
orderby 按特定属性对结果排序。 示例: orderby=title 将按标题按升序(A-Z)对结果排序。 在参 - 数值()之前orderby=-title添加一个值,将按标题以降序(Z-A)对项目排序。

筛选

您可以使用参数筛选结 property 果,该参数用于对检索的资源中的给定JSON属性应用特定运算符。 支持的运算符包括:

运算符 描述 示例
== 过滤器属性是否等于提供的值。 property=title==test
!= 过滤器:属性是否不等于提供的值。 property=title!=test
< 过滤器该属性是否小于提供的值。 property=version<5
> 过滤器该属性是否大于提供的值。 property=version>5
<= 过滤器,该属性是否小于或等于提供的值。 property=version<=5
>= 过滤器为属性是大于或等于提供的值。 property=version>=5
~ 过滤器,根据该属性是否与提供的常规表达式匹配。 property=title~test$
(None) 仅声明属性名称只返回存在属性的条目。 property=title
小贴士

可以使用该参 property 数按其兼容类过滤混音。 例如, property=meta:intendedToExtend==https://ns.adobe.com/xdm/context/profile 只返回与类兼容的混 XDM Individual Profile 合。

兼容性模式

Experience Data Model (XDM)是一个公开的文档规范,它由Adobe驱动,旨在提高数字体验的互操作性、表现力和强大功能。 Adobe在GitHub上的开放源项目中维护 源代码和正式的XDM定义。 这些定义以XDM标准表示法编写,使用JSON-LD(链接数据的JavaScript对象表示法)和JSON模式作为定义XDM模式的语法。

在公共存储库中查看正式的XDM定义时,您会发现标准XDM与您在Adobe Experience Platform看到的不同。 您在中看到的 Experience Platform 内容称为兼容性模式,它提供了标准XDM与内部使用方式之间的简单映射 Platform。

兼容性模式的工作原理

兼容性模式允许XDM JSON-LD模型通过更改标准XDM中的值并保持语义相同,与现有数据基础结构配合使用。 它使用嵌套JSON结构,以类树格式显示模式。

标准XDM和兼容性模式之间的主要区别是删除字段名称的“xdm:”前缀。

以下是标准XDM和兼容性模式中与生日相关的字段(删除了“描述”属性)的并排比较。 请注意,兼容性模式字段包括对“meta:xdmField”和“meta:xdmType”属性中XDM字段及其数据类型的引用。

标准XDM 兼容性模式
        { "xdm:birthDate":{ "title":“出生日期”、“类型”:"string", "format":"date", }, "xdm:birdhDayAndMonth":{ "title":“出生日期”、“类型”:"string", "pattern":"[0-1][0-9]-[0-9][0-9]", }, "xdm:pirthYear":{ "title":“出生年”、“类型”:"integer", "minimum":1, "maximum":32767 }
  
        { "birthDate":{ "title":“出生日期”、“类型”:"string", "format":"date", "meta:xdmField":"xdm:birthDate", "meta:xdmType":"date" }, "birthDayAndMonth":{ "title":“出生日期”、“类型”:"string", "pattern":"[0-1][0-9]-[0-9][0-9]", "meta:xdmField":"xdm:birdyDayAndMonth", "meta:xdmType":"string" }, "birthYear":{ "title":“出生年”、“类型”:"integer", "minimum":1, "maximum":32767, "meta:xdmField":"xdm:birthYear", "meta:xdmType":"short" }
      

为什么需要兼容模式?

Adobe Experience Platform设计为使用多种解决方案和服务,每种解决方案和服务都有各自的技术挑战和限制(例如,某些技术如何处理特殊特性)。 为了克服这些限制,开发了兼容模式。

大多 Experience Platform 数服 Catalog务,包括 Data Lake、和 Real-time Customer Profile 用于 Compatibility Mode 替代标准XDM。 该 Schema Registry API还使 Compatibility Mode用,此文档中的示例都使用 Compatibility Mode。

应该知道标准XDM与其操作方式之间存在映射,但 Experience Platform它不应影响您对服务的使 Platform 用。

开放源项目可供您使用,但在涉及通过与资源交互时,此文档中的 Schema RegistryAPI示例提供您应了解和遵循的最佳实践。

在此页面上