瞭解綱要結構 schema-structure
結構描述的基本結構如下所述。
資料方案 data-schema
針對 <srcschema>
,其結構如下:
<srcSchema>
<enumeration>
... //definition of enumerations
</enumeration>
<element> //definition of the root <element> (mandatory)
<compute-string/> //definition of a compute-string
<dbindex>
... //definition of indexes
</dbindex>
<key>
... //definition of keys
</key>
<sysFilter>
... //definition of filters
</sysFilter>
<attribute>
... //definition of fields
</attribute>
<element> //definition of sub-<element>
<attribute> //(collection, links or XML)
... //and additional fields
</attribute>
...
</element>
</element>
<methods> //definition of SOAP methods
<method>
...
</method>
...
</methods>
</srcSchema>
資料結構描述的XML檔案必須包含 <srcschema>
根元素具有 名稱 和 名稱空間 屬性來填入結構描述名稱及其名稱空間。
<srcSchema name="schema_name" namespace="namespace">
...
</srcSchema>
讓我們使用以下XML內容來說明資料結構的結構:
<recipient email="John.doe@aol.com" created="2009/03/12" gender="1">
<location city="London"/>
</recipient>
及其對應的資料結構:
<srcSchema name="recipient" namespace="cus">
<element name="recipient">
<attribute name="email"/>
<attribute name="created"/>
<attribute name="gender"/>
<element name="location">
<attribute name="city"/>
</element>
</element>
</srcSchema>
說明 description
結構描述的進入點是其主要元素。 它很容易識別,因為其名稱與結構描述相同,且應是根元素的子項。 內容的說明以此元素開頭。
在我們的範例中,主要元素由以下行表示:
<element name="recipient">
此 <attribute>
和 <element>
主元素之後的元素用於定義XML結構中資料專案的位置和名稱。
在我們的範例結構描述中,這些類別包括:
<attribute name="email"/>
<attribute name="created"/>
<attribute name="gender"/>
<element name="location">
<attribute name="city"/>
</element>
下列規則適用:
-
每個
<element>
和<attribute>
必須透過名稱來識別 名稱 屬性。note important IMPORTANT 元素的名稱應簡潔,最好是英文,並且僅包含允許在XML命名規則中的字元。 -
僅限
<element>
元素可包含<attribute>
元素和<element>
XML結構中的元素。 -
一個
<attribute>
元素在「 」中必須有唯一的名稱<element>
. -
使用
<elements>
在多行資料字串中,建議使用。
資料類型 data-types
資料型別是透過 type 中的屬性 <attribute>
和 <element>
元素。
詳細清單可在的說明中取得 <attribute>
元素 和 <element>
元素.
未填入此屬性時, 字串 是預設的資料型別,除非元素包含子元素。 如果是,則僅用於階層式架構元素(<location>
元素)。
架構支援下列資料型別:
-
字串:字元字串。 範例:名字、城鎮等。
大小可透過 長度 屬性(選用,預設值「255」)。
-
布林值:布林值欄位。 可能值的範例:true/false、0/1、yes/no等。
-
位元組, 短, 長:整數(1位元組、2位元組、4位元組)。 範例:年齡、帳號、點數等。
-
兩次:雙精確度浮點數。 範例:價格、費率等。
-
日期, 日期時間:日期和日期+時間。 範例:出生日期、購買日期等。
-
datetimenotz:日期+時間不含時區資料。
-
時間跨度:持續時間。 範例:資歷。
-
備忘錄:長文字欄位(多行)。 範例:說明、註解等。
-
uuid:「uniqueidentifier」欄位支援GUID (僅在Microsoft SQL Server中支援)。
note note NOTE 若要包含 uuid Microsoft SQL Server以外的RDBMS欄位, the newuuid()
函式必須新增並以其預設值完成。
以下是輸入型別的結構描述範例:
<srcSchema name="recipient" namespace="cus">
<element name="recipient">
<attribute name="email" type="string" length="80"/>
<attribute name="created" type="datetime"/>
<attribute name="gender" type="byte"/>
<element name="location">
<attribute name="city" type="string" length="50"/>
</element>
</element>
</srcSchema>
對應Adobe Campaign/DBMS資料型別 mapping-the-types-of-adobe-campaign-dbms-data
下表列出Adobe Campaign針對不同資料庫管理系統所產生之資料型別的對應。
屬性 properties
此 <elements>
和 <attributes>
資料結構描述的元素可以包含各種屬性。 您可以填入標籤來說明目前的元素。
標籤和說明 labels-and-descriptions
-
此 標籤 屬性可讓您輸入簡短說明。
note note NOTE 標籤與執行個體的目前語言相關聯。 範例:
code language-sql <attribute name="email" type="string" length="80" label="Email"/>
標籤會顯示在Adobe Campaign使用者端主控台輸入表單中:
-
此 desc 屬性可讓您輸入詳細說明。
說明會顯示在Adobe Campaign使用者端主控台主視窗之狀態列的輸入表單中。
note note NOTE 說明與執行個體的目前語言相關聯。 範例:
code language-sql <attribute name="email" type="string" length="80" label="Email" desc="Email of recipient"/>
預設值 default-values
使用 預設 屬性來定義在內容建立時傳回預設值的運算式。
值必須是符合XPath語言的運算式。 有關詳細資訊,請參閱 使用XPath參照.
範例:
-
目前日期: default="GetDate()"
-
計數器: default="'FRM'+CounterValue('myCounter')"
在此範例中,預設值是使用串連並呼叫 計數器值 函式加上可用的計數器名稱。 傳回的數目會在每次插入時遞增1。
note note NOTE 在Adobe Campaign使用者端主控台中,瀏覽至 Administration > Counters 用來管理計數器的檔案總管資料夾。
若要將預設值連結至欄位,您可以使用 <default>
或 <sqldefault>
欄位。
<default>
:可讓您在建立實體時,使用預設值預先填寫欄位。 此值不會是預設SQL值。
<sqldefault>
:可讓您在建立欄位時增加值。 此值會顯示為SQL結果。 在結構描述更新期間,只有新記錄會受此值影響。
分項清單 enumerations
開啟分項清單 free-enumeration
此 userEnum 屬性可讓您定義開啟的列舉,以儲存及顯示透過此欄位輸入的值。
語法如下:
userEnum="name of enumeration"
這些值會顯示在輸入表單的下拉式清單中:
設定分項清單 set-enumeration
此 列舉 屬性可讓您定義預先知道可能值清單時使用的固定分項清單。
此 列舉 attribute是指在主要元素以外的結構描述中填入的列舉類別定義。
列舉可讓使用者從下拉式清單中選取值,而不是在常規輸入欄位中輸入值:
資料結構描述中的列舉宣告範例:
<enumeration name="gender" basetype="byte" default="0">
<value name="unknown" label="Not specified" value="0"/>
<value name="male" label="male" value="1"/>
<value name="female" label="female" value="2"/>
</enumeration>
列舉會透過在主要元素之外宣告 <enumeration>
元素。
列舉屬性如下:
- 基底型別:與值相關聯的資料型別
- 標籤:分項清單的說明
- 名稱:分項清單的名稱
- 預設:分項的預設值
列舉值是在下列位置中宣告: <value>
元素具有以下屬性:
- 名稱:內部儲存值的名稱
- 標籤:圖形介面中顯示的標籤
Dbenum分項清單 dbenum-enumeration
*此 德貝南 屬性可讓您定義其屬性類似於 列舉 屬性。
然而, 名稱 attribute不會將值儲存在內部,而是儲存程式碼,可讓您擴充相關表格,而不需修改其綱要。
例如,此分項清單用於指定行銷活動的性質。
範例 example
以下是填入屬性的結構描述範例:
<srcSchema name="recipient" namespace="cus">
<enumeration name="gender" basetype="byte">
<value name="unknown" label="Not specified" value="0"/>
<value name="male" label="male" value="1"/>
<value name="female" label="female" value="2"/>
</enumeration>
<element name="recipient">
<attribute name="email" type="string" length="80" label="Email" desc="Email of recipient"/>
<attribute name="created" type="datetime" label="Date of creation" default="GetDate()"/>
<attribute name="gender" type="byte" label="gender" enum="gender"/>
<element name="location" label="Location">
<attribute name="city" type="string" length="50" label="City" userEnum="city"/>
</element>
</element>
</srcSchema>
集合 collections
集合是具有相同名稱和相同階層層級的元素清單。
此 未繫結 值為「true」的屬性可讓您填入收集要素。
範例:的定義 <group>
結構描述中的集合元素。
<element name="group" unbound="true" label="List of groups">
<attribute name="label" type="string" label="Label"/>
</element>
透過XML內容的投影:
<group label="Group1"/>
<group label="Group2"/>
使用XPath參照 referencing-with-xpath
XPath語言在Adobe Campaign中用於參照屬於資料結構的元素或屬性。
XPath是一種語法,可讓您在XML檔案的樹狀結構中尋找節點。
元素是以其名稱來指定,而屬性是以字元「@」開頭的名稱來指定。
範例:
- @email:選取電子郵件,
- location/@city:選取「城市」屬性於
<location>
元素 - …/@email:從目前元素的父元素選取電子郵件地址
- 群組
[1]/@label
:選取第一個的「label」子屬性<group>
collection element — 收集要素 - 群組
[@label='test1']
:選取的「label」屬性是<group>
元素並包含「test1」值
- location/@city 無效;請使用
[location/@city]
[@email]
和 @email 相等
您也可以定義複雜的運算式,例如下列算術運算:
- @gender+1:將1新增至的內容 性別 屬性,
- @email + '('+@created+')':建構字串的方法為使用括弧之間新增至建立日期的電子郵件地址值(對於字串型別,請將常數放在引號中)。
已在運算式中新增高層級函式,以豐富此語言的潛力。
您可以透過Adobe Campaign使用者端主控台中的任何運算式編輯器,存取可用函式的清單:
範例:
- GetDate():傳回目前日期
- 年(@created):傳回「created」屬性中包含的日期年份
- GetEmailDomain(@email):傳回電子郵件地址的網域
透過計算字串建立字串 building-a-string-via-the-compute-string
A 計算字串 是XPath運算式,用來建構字串,代表與結構描述相關聯的資料表中的記錄。 計算字串 主要用於圖形介面,以顯示所選記錄的標籤。
此 計算字串 是透過 <compute-string>
資料結構描述主要元素下的元素。 一個 運算式 屬性包含計算顯示的XPath運算式。
範例:收件者表格的計算字串。
<srcSchema name="recipient" namespace="nms">
<element name="recipient">
<compute-string expr="@lastName + ' ' + @firstName +' (' + @email + ')' "/>
...
</element>
</srcSchema>
收件者的計算字串結果: Doe John (john.doe@aol.com)
了解更多
瀏覽以下連結以瞭解更多資訊: