使用模式

应用中所承载数据的物理和逻辑结构以 XML 格式进行描述。它遵循Adobe Campaign特有的语法，称为 架构.

架构是与数据库表关联的XML文档。 它定义数据结构并描述表的SQL定义：

• 表的名称
• 字段
• 与其他表的链接

它还描述了用于存储数据的XML结构：

• 元素和属性
• 元素层次结构
• 元素和属性类型
• 默认值
• 标签、描述和其他属性。

使用架构可在数据库中定义实体。 每个实体都有一个架构。

Adobe Campaign使用数据架构来：

• 定义应用程序中的数据对象如何与底层数据库表绑定。
• 定义 Campaign 应用程序中不同数据对象之间的链接。
• 定义并描述每个对象中包含的个别字段。

要更好地了解Campaign内置表及其交互，请参阅 本节.

架构的语法

架构的根元素为 <srcschema>. 它包含 <element> 和 <attribute> 子元素。

第一个 <element> 子元素与实体的根一致。

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <attribute name="lastName"/>
    <attribute name="email"/>
    <element name="location">
      <attribute name="city"/>
   </element>
  </element>
</srcSchema>

此 <element> 标记定义实体元素的名称。 <attribute> 架构的标记定义 <element> 已链接到的标记。

架构的标识

数据架构由其名称和命名空间来标识。

命名空间允许您按感兴趣的区域对一组架构进行分组。 例如， cus 命名空间用于特定于客户的配置(客户)。

保留的命名空间

某些命名空间是保留空间，用于描述Adobe Campaign应用程序操作所需的系统实体。 以下命名空间 不得使用 要识别新架构，请在任意大写/小写组合中执行以下操作：

• xxl：保留给云数据库架构
• xtk：保留给平台系统数据
• nl：保留给应用程序的总体使用
• nms：为投放预留（收件人、投放、跟踪等）
• ncm：保留给内容管理
• 临时：保留给临时架构
• crm：保留给CRM连接器集成

架构的标识键是使用命名空间和名称构建的字符串，名称之间用冒号分隔；例如： nms：recipient.

创建或扩展Campaign模式

要将字段或其他元素添加到Campaign中的某个核心数据架构，例如收件人表(nms：recipient)，您必须扩展该架构。

有关详细信息，请参见 扩展模式.

要添加Adobe Campaign中不存在的全新类型数据（例如合同表），您可以直接创建自定义架构。

有关详细信息，请参见 创建新架构.

创建或扩展要在其中工作的架构后，最佳做法是按照下面显示的XML内容元素顺序来定义其XML内容元素。

明细列表

枚举先于架构的主元素之前定义。 它们允许您在列表中显示值，以限制用户对给定字段的选择。

示例:

<enumeration basetype="byte" name="exTransactionTypeEnum" default="store">
<value label="Website" name="web" value="0"/>
<value label="Call Center" name="phone" value="1"/>
<value label="In Store" name="store" value="2"/>
</enumeration>

在定义字段时，您可以使用此枚举，如下所示：

<attribute desc="Type of Transaction" label="Transaction Type" name="transactionType"
type="string" enum="exTransactionTypeEnum"/>

键

每个表必须至少有一个键，通常使用在架构的主元素中自动建立它 autopk 属性设置为 true.

此外，在 企业(FFDA)部署，使用 @autouuid 并将其设置为 true.

也可使用定义主键 内部 属性。

示例:

<key name="householdId" internal="true">
  <keyfield xpath="@householdId"/>
</key>

在此示例中，不要让 @autopk 或 @autouuid 属性创建一个名为“id”的默认主键，我们将指定自己的“householdId”主键。

了解中有关键的更多信息 本节.

属性（字段）

属性允许您定义组成数据对象的字段。 您可以使用 Insert 模式版工具栏中的按钮，将空属性模板拖放到光标所在的XML中。 可在此部分中了解详情。

完整的属性列表可在 <attribute> 中的元素部分 Campaign Classicv7文档. 以下是一些更常用的属性： @advanced， @dataPolicy， @default， @desc， @enum， @expr， @label， @length， @name， @notNull， @required， @ref， @xml， @type.

有关每个属性的详细信息，请参阅中的属性说明 Campaign Classicv7文档.

示例

定义默认值的示例：

<attribute name="transactionDate" label="Transaction Date" type="datetime" default="GetDate()"/>

将公共属性用作标记为必填字段的模板的示例：

<attribute name="mobile" label="Mobile" template="nms:common:phone" required="true" />

使用隐藏的计算字段示例 @advanced 属性：

<attribute name="domain" label="Email domain" desc="Domain of recipient email address" expr="GetEmailDomain([@email])" advanced="true" />

XML字段的示例也存储在SQL字段中，该字段具有 @dataPolicy 属性。

<attribute name="secondaryEmail" label="Secondary email address" length="100" xml="true" sql="true" dataPolicy="email" />

链接

链接是架构主元素的最后几个元素之一。 它们定义实例中所有不同的架构如何相互关联。

在包含 外键 所链接到的表的URL值。

基数有三种类型：1-1、1-N和N-N。默认使用1-N类型。

示例

收件人表（现成模式）和自定义事务表之间的1-N链接示例：

<element label="Recipient" name="lnkRecipient" revLink="lnkTransactions" target="nms:recipient" type="link"/>

自定义模式“Car”（位于“cus”命名空间中）和收件人表之间的1-1链接示例：

<element label="Car" name="lnkCar" revCardinality="single" revLink="recipient" target="cus:car" type="link"/>

收件人表和地址表之间的外部联接示例，该表基于电子邮件地址而不是主键：

<element name="emailInfo" label="Email Info" revLink="recipient" target="nms:address" type="link" externalJoin="true">
  <join xpath-dst="@address" xpath-src="@email"/>
</element>

此处，“xpath-dst”对应于目标架构中的主键，“xpath-src”对应于源架构中的外键。

审核跟踪

架构底部可能想要包含一个有用元素，即跟踪元素（审核跟踪）。

使用下面的示例包含与创建日期、创建数据的用户、日期和表格中所有数据的上次修改的作者相关的字段：

<element aggregate="xtk:common:auditTrail" name="auditTrail"/>

更新数据库结构

完成并保存更改后，任何可能影响SQL结构的更改都需要应用到数据库。 为此，请使用数据库更新助手。

如需详细信息，请参阅此部分。