使用方案 gs-ac-schemas

並以 XML 描述了應用程式中資料的實體和邏輯結構。它會遵循Adobe Campaign特有的語法,稱為 綱要.

綱要是與資料庫表格相關聯的XML檔案。 它會定義資料結構,並描述表格的SQL定義:

  • 資料表的名稱
  • 欄位
  • 與其他表格的連結

它也會說明用來儲存資料的XML結構:

  • 元素和屬性
  • 元素的階層
  • 元素和屬性型別
  • 預設值
  • 標籤、說明和其他屬性。

結構描述可讓您定義資料庫中的實體。 每個實體都有一個結構描述。

Adobe Campaign採用資料結構描述來:

  • 定義應用程式內的資料物件如何繫結至基礎資料庫表格。
  • 定義 Campaign 應用程式中不同資料物件之間的連結。
  • 定義及描述每個物件中包含的個別欄位。

若要更瞭解Campaign內建表格及其互動,請參閱 本節.

CAUTION
某些內建的Campaign方案在雲端資料庫上有關聯的方案。 這些結構描述的識別方式為 Xxl 名稱空間且不得修改或擴充。

結構描述的語法 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>
NOTE
實體的根元素與結構描述同名。

<element> 標籤定義圖元元素的名稱。 <attribute> 架構的標籤會定義 <element> 連結至的標籤。

結構描述的識別 identification-of-a-schema

資料結構是以其名稱和名稱空間來識別。

名稱空間可讓您依感興趣的區域來分組一組結構描述。 例如, cus 名稱空間用於客戶特定的設定(客戶)。

CAUTION
作為標準,名稱空間的名稱必須簡潔,而且根據XML命名規則,只能包含授權字元。
識別碼不能以數字字元開頭。

保留的名稱空間 reserved-namespaces

系統會保留某些名稱空間,以說明Adobe Campaign應用程式運作所需的系統實體。 以下名稱空間 不得使用 若要識別任何大寫/小寫組合中的新結構描述:

  • xxl:保留給雲端資料庫結構
  • xtk:保留給平台系統資料
  • nl:保留給應用程式的整體使用
  • nms:保留給傳遞(收件者、傳遞、追蹤等)
  • ncm:保留給內容管理
  • 臨時:保留給臨時結構描述
  • 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"/>
NOTE
您也可以使用使用者管理的分項清單(通常位於 Administration > Platform ),指定指定欄位的值。 這些實際上是全域分項清單,如果您可在您使用的特定結構描述之外使用分項清單,這是較好的選擇。

金鑰 keys

每個資料表都必須至少有一個索引鍵,而且通常會在結構描述的主要元素中使用 autopk 屬性設定為 true.

此外,在 企業(FFDA)部署,使用 @autouuid 並將其設為 true.

主索引鍵也可使用定義 內部 屬性。

例如:

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

在此範例中,請不要讓 @autopk@autouuid 屬性會建立名為「id」的預設主索引鍵,我們指定自己的「householdId」主索引鍵。

CAUTION
建立新結構描述或在結構描述擴充期間,您需要為整個結構描述保留相同的主要索引鍵序列值(@pkSequence)。

進一步瞭解中的金鑰 本節.

屬性(欄位) attributes--fields-

屬性可讓您定義組成資料物件的欄位。 您可以使用 Insert 結構描述版本工具列中的按鈕,將空的屬性範本拖放至游標所在的XML中。 若要了解詳細資訊,請參閱本章節

完整的屬性清單可在 <attribute> 中的元素區段 Campaign Classic v7檔案. 以下是一些較常用的屬性: @advanced@dataPolicy@default@desc@enum@expr@label@length@name@notNull@required@ref@xml@type.

如需每個屬性的詳細資訊,請參閱中的屬性說明 Campaign Classic v7檔案.

範例 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" />

同樣儲存在SQL欄位中的XML欄位範例,此欄位具有 @dataPolicy 屬性。

<attribute name="secondaryEmail" label="Secondary email address" length="100" xml="true" sql="true" dataPolicy="email" />
CAUTION
雖然大多數屬性都是根據1-1基數連結到資料庫的實體欄位,但XML欄位或計算欄位則不是這種情況。
XML欄位儲存在表格的備忘錄欄位(「mData」)中。
但是,計算欄位在每次查詢啟動時都會動態建立,因此只存在於應用程式層中。

連結是結構描述中主要元素的最後幾個元素。 它們定義您執行個體中所有不同的結構描述如何相互關聯。

在包含下列專案的架構中宣告連結: 外部索引鍵 連結至的資料表。

基數有三種型別: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結構的變更都必須套用至資料庫。 要執行此操作,請使用資料庫更新輔助程式。

如需詳細資訊,請參閱本章節

NOTE
當修改不會影響資料庫結構時,您只需要重新產生結構描述。 若要這麼做,請選取要更新的結構描述,按一下滑鼠右鍵並選擇 Actions > Regenerate selected schemas….
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b