使用模式 gs-ac-schemas
应用中所承载数据的物理和逻辑结构以 XML 格式进行描述。它遵循Adobe Campaign特有的语法,称为 架构。
架构是与数据库表关联的XML文档。 它定义数据结构并描述表的SQL定义:
- 表的名称
- 字段
- 与其他表的链接
它还描述了用于存储数据的XML结构:
- 元素和属性
- 元素层次结构
- 元素和属性类型
- 默认值
- 标签、描述和其他属性。
使用架构可在数据库中定义实体。 每个实体都有一个架构。
Adobe Campaign使用数据架构来:
- 定义应用程序中的数据对象如何与底层数据库表绑定。
- 定义 Campaign 应用程序中不同数据对象之间的链接。
- 定义并描述每个对象中包含的个别字段。
要更好地了解Campaign内置表及其交互,请参阅此部分。
架构的语法 syntax-of-schemas
架构的根元素为 <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>
标记中已链接到的属性的名称。
架构的标识 identification-of-a-schema
数据架构由其名称和命名空间来标识。
命名空间允许您按感兴趣的区域对一组架构进行分组。 例如,cus 命名空间用于特定于客户的配置(客户)。
保留的命名空间 reserved-namespaces
某些命名空间是保留空间,用于描述Adobe Campaign应用程序操作所需的系统实体。 不得使用下列命名空间 来标识任何大写/小写组合的新架构:
- xxl:保留给云数据库架构
- xtk:保留给平台系统数据
- nl:保留给应用程序的总体使用
- nms:保留给投放(收件人、投放、跟踪等)
- ncm:保留给内容管理
- temp:保留给临时架构
- crm:保留给CRM连接器集成
架构的标识键是使用命名空间和用冒号分隔的名称构建的字符串;例如: nms:recipient。
创建或扩展Campaign模式 create-or-extend-schemas
要将字段或其他元素添加到Campaign中的某个核心数据架构,例如收件人表(nms:recipient),您必须扩展该架构。
有关详细信息,请参阅扩展架构。
要添加Adobe Campaign中不存在的全新类型数据(例如合同表),您可以直接创建自定义架构。
有关详细信息,请参阅创建新架构。
创建或扩展要在其中工作的架构后,最佳做法是按照下面显示的XML内容元素顺序来定义其XML内容元素。
明细列表 enumerations
枚举先于架构的主元素之前定义。 它们允许您在列表中显示值,以限制用户对给定字段的选择。
例如:
<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"/>
键 keys
每个表必须至少有一个键,通常使用设置为 true 的 autopk 属性在架构的主元素中自动建立该键。
此外,在企业(FFDA)部署的上下文中,使用 @autouuid 并将其设置为 true。
也可使用 internal 属性定义主键。
例如:
<key name="householdId" internal="true">
<keyfield xpath="@householdId"/>
</key>
在此示例中,我们指定自己的“householdId”主键,而不是让 @autopk 或 @autouuid 属性创建一个名为“id”的默认主键。
在本节中了解有关密钥的更多信息。
属性(字段) attributes--fields-
属性允许您定义组成数据对象的字段。 您可以使用架构版工具栏中的 Insert 按钮,将空属性模板拖放到光标所在的XML中。 可在此部分中了解详情。
Campaign Classicv7文档的<attribute>
元素部分中提供了属性的完整列表。 以下是一些更常用的属性: @advanced、@dataPolicy、@default、@desc、@enum、@expr、@label、@length、@name、@notNull、@required、@ref、@xml、@type。
有关每个属性的详细信息,请参阅Campaign Classicv7文档中的属性说明。
示例 examples
定义默认值的示例:
<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" />
XML字段存储在表的备注字段(“mData”)中。
但是,计算字段是在每次启动查询时动态创建的,因此它仅存在于应用层中。
链接 links
链接是架构主元素的最后几个元素之一。 它们定义实例中所有不同的架构如何相互关联。
在包含链接到的表的 外键 的架构中声明链接。
基数有三种类型:1-1、1-N和N-N。默认使用1-N类型。
示例 examples-1
收件人表(现成模式)和自定义事务表之间的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”对应于源架构中的外键。
审核记录 audit-trail
架构底部可能想要包含一个有用元素,即跟踪元素(审核跟踪)。
使用下面的示例包含与创建日期、创建数据的用户、日期和表格中所有数据的上次修改的作者相关的字段:
<element aggregate="xtk:common:auditTrail" name="auditTrail"/>
更新数据库结构 updating-the-database-structure
完成并保存更改后,任何可能影响SQL结构的更改都需要应用到数据库。 为此,请使用数据库更新助手。
如需详细信息,请参阅此小节。