方案結構 schema-structure

的基本結構 <srcschema> 如下所示:

<srcSchema>
    <enumeration>
        ...          //definition of enumerations
    </enumeration>

    <element>         //definition of the root <element>    (mandatory)

        <compute-string/>  //definition of a compute-string
        <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="AAAA/DD/MM" 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 caution
    CAUTION
    元素名稱應簡潔,最好是英文,並根據XML命名規則僅包含授權字元。
  • 僅限 <element> 元素可包含 <attribute> 元素和 <element> XML結構中的元素。

  • 一個 <attribute> 元素在「 」中必須有唯一的名稱 <element>.

  • 使用 <elements> 在多行資料字串中,建議使用。

資料類型 data-types

資料型別是透過 type 中的屬性 <attribute><element> 元素。

詳細清單位於 Campaign Classic v7檔案.

未填入此屬性時, 字串 是預設的資料型別,除非元素包含子元素。 如果是,則僅用於階層式架構元素(<location> 元素)。

架構支援下列資料型別:

  • 字串:字元字串。 範例:名字、城鎮等。

    大小可透過 長度 屬性(選用,預設值「255」)。

  • 布林值:布林值欄位。 可能值的範例:true/false、0/1、yes/no等。

  • 位元組:整數(1位元組、2位元組、4位元組)。 範例:年齡、帳號、點數等。

  • 兩次:雙精確度浮點數。 範例:價格、費率等。

  • 日期日期時間:日期和日期+時間。 範例:出生日期、購買日期等。

  • datetimenotz:日期+時間不含時區資料。

  • 時間跨度:持續時間。 範例:資歷。

  • 備忘錄:長文字欄位(多行)。 範例:說明、註解等。

  • uuid:"uniqueidentifier"欄位

    note note
    NOTE
    若要包含 uuid 欄位中,必須以預設值新增及完成「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>

屬性 properties

<elements><attributes> 資料結構描述的元素可以包含各種屬性。 您可以填入標籤來說明目前的元素。

標籤和說明 labels-and-descriptions

  • 標籤 屬性可讓您輸入簡短說明。

    note note
    NOTE
    標籤與執行個體的目前語言相關聯。

    範例

    code language-none
    <attribute name="email" type="string" length="80" label="Email"/>
    

    您可以從Adobe Campaign使用者端主控台輸入表單中看到標籤:

  • desc 屬性可讓您輸入詳細說明。

    您可以從Adobe Campaign使用者端主控台主視窗之狀態列的輸入表單看到說明。

    note note
    NOTE
    說明與執行個體的目前語言相關聯。

    範例

    code language-none
    <attribute name="email" type="string" length="80" label="Email" desc="Email of recipient"/>
    

預設值 default-values

預設 屬性可讓您定義在內容建立時傳回預設值的運算式。

值必須是符合XPath語言的運算式。 如需詳細資訊,請參閱本章節

範例

  • 目前日期: default="GetDate()"

  • 計數器: default="'FRM'+CounterValue('myCounter')"

    在此範例中,預設值是使用串連並呼叫 計數器值 函式加上可用的計數器名稱。 傳回的數目會在每次插入時遞增1。

    note note
    NOTE
    在Adobe Campaign使用者端主控台中, Administration>Counters 節點用於管理計數器。

若要將預設值連結至欄位,您可以使用 <default> or <sqldefault> field. </sqldefault> </default>

<default> :可讓您在建立實體時,使用預設值預先填寫欄位。 此值不會是預設SQL值。

<sqldefault> :可讓您在建立欄位時增加值。 此值會顯示為SQL結果。 在結構描述更新期間,只有新記錄會受此值影響。

分項清單 enumerations

可用分項清單 free-enumeration

userEnum 屬性可讓您定義任意分項清單,以記憶並顯示透過此欄位輸入的值。 語法如下:

userEnum="列舉名稱"

為分項清單指定的名稱可以自由選擇,並與其他欄位共用。

這些值會顯示在輸入表單的下拉式清單中:

NOTE
在Adobe Campaign使用者端主控台中, Administration > Enumerations 節點用於管理分項清單。

設定分項清單 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不會將值儲存在內部,而是儲存程式碼,可讓您擴充相關表格,而不需修改其綱要。

    值的定義方式為 Administration>Enumerations 節點。

    例如,此分項清單用於指定行銷活動的性質。

範例 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的參考 reference-with-xpath

XPath語言在Adobe Campaign中用於參照屬於資料結構的元素或屬性。

XPath是一種語法,可讓您在XML檔案的樹狀結構中尋找節點。

元素是以其名稱來指定,而屬性是以字元「@」開頭的名稱來指定。

範例

  • @email:選取電子郵件,
  • location/@city:選取「城市」屬性於 <location> 元素
  • …/@email:從目前元素的父元素選取電子郵件地址
  • 群組[1]/@label:選取第一個的「label」子屬性 <group> collection element — 收集要素
  • 群組[@label='test1']:選取的「label」屬性是 <group> 元素並包含「test1」值
NOTE
當路徑穿過子元素時,會新增額外的限制。 在此情況下,下列運算式必須放在方括弧之間:
  • 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)

NOTE
如果結構描述不包含計算字串,則計算字串預設會填入結構描述主索引鍵的值。
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b