屬性元素

內容模型

屬性:==幫助

屬性

_operation(字串)、advanced(boolean)、appliableIf(string)、autoIncrement(boolean)、tellesTo(string)、dataPolicy(string)、dbEnum(string)、defOnDuplicate(boolean)、default(string)、desc(string)、edit(string)、enum(string)、expr(string)、featureDate(boolean)、img(string)、lel(string)、lacable(bol)、Nnen(bolen)、NOLN(boolname)string)、ref(字串)、必要(布林值)、sql(布林值)、sqlDefault(字串)、sqlname(字串)、sqltable(字串)、target(MNTOKEN)、範本(字串)、translatedDefault(字串)、translatedExpr(字串)、類型(MNTOKEN)、用戶(布林值)、userEnum(字串)、visibleIf(字串)、xml(布林值)

父母

<element>

兒童

<help>

說明

<attribute> 元素可讓您定義資料庫中的欄位。

使用與使用內容

<attribute> 元素中必須宣告 <element> 元素。

<srcschema>中定義<attribute>元素的序列不會影響資料庫中的欄位建立序列。 建立順序將按字母順序排列。

屬性說明

  • _operation(string):定義資料庫中的寫入類型。

    此屬性主要用於擴充現成可用的結構時。

    可存取的值包括:

    • "none":單獨調解。 這表示Adobe Campaign將復原元素,而不會更新元素,或在不存在的情況下產生錯誤。
    • "insertOrUpdate":更新為插入。 這表示Adobe Campaign將更新元素,或在元素不存在時加以建立。
    • "insert":插入。 這表示Adobe Campaign將插入元素,而不會檢查元素是否存在。
    • "update":更新。 這表示Adobe Campaign將更新元素,或在元素不存在時產生錯誤。
    • "delete":刪除。 這表示Adobe Campaign將復原和刪除元素。
  • 進階(布林值):啟用此選項時(@advanced="true"),它可讓您隱藏可用欄位清單上的屬性,這些欄位可用於配置表單中的清單。

  • applicableIf(字串):此屬性可讓您將欄位設為選填欄位。當符合約束時更新資料庫時,將考慮<attribute>元素。 "appliableIf"接收XTK運算式。

  • autoIncrement(布林值):如果啟用此選項,欄位就會變成計數器。這可讓您增加值(大部分是ID)。 (外部使用)

  • tellesTo(字串):取用共用欄位之表格的名稱和命名空間,並填入宣告屬性的架構。(僅用於<schema>)。

  • dataPolicy(string):允許對SQL或XML欄位中允許的值指定批准約束。此屬性的值為:

    • "none":無值
    • "smartCase":首字母大寫
    • "lowerCase":全部小寫
    • "upperCase":全部大寫
    • "email":電子郵件地址
    • "phone":電話號碼
    • "identifier":識別碼名稱
    • "resIdentifier":檔案名
  • dbEnum(string):接收「已關閉」枚舉的內部名稱。必須在<srcschema>中定義枚舉值。

  • defOnDuplicate(布林值):如果激活了此屬性,則當記錄重複時,預設值(在@default中定義)將自動重新應用於記錄。

  • 預設值(字串):可讓您定義預設欄位的值(呼叫函式、預設值)。此屬性會接收XTK運算式。

  • dsc(字串):可讓您插入屬性的說明。此說明會顯示在介面的狀態列中。

  • 編輯(字串):此屬性指定將以連結到架構的形式使用的輸入類型。

  • 列舉(字串):接收連結到欄位的枚舉的名稱。枚舉可以插入到相同的架構或遠程架構中。

  • expr(字串):定義欄位預計算表達式。此屬性會接收Xpath或XTK運算式。

  • 功能(字串):定義特徵欄位:這些欄位用於擴充現有表格中的資料,但會將資料儲存在附件表格中。接受的值為:

    • "shared":內容儲存在每個資料類型的共用表中
    • "dedicated":內容儲存在專用表中

    SQL特性表是根據特性類型自動建立的:

    • 專用:Ft_[name_of_the_schema_containing_the_characteristic]_[name_of_the_characteristic]
    • 共用:Ft_[type_of_key_of_the_schema_containing_the_characteristic]_[type_of_the_characteristic]

    特徵欄位有兩種類型:簡單的oà¹欄位,其中單個值被授權於特徵上;或者,oà¹多個選擇欄位,其中特徵被連結至可包含多個值的集合元素。

    在架構中定義特性時,此架構必須具有基於單一欄位的主鍵(未授權複合鍵)。

  • featureDate(布林值):連結到「@feature」特性欄位的屬性。如果其值為「true」,則可讓您找出值的上次更新時間。

  • img(string):可讓您定義連結至欄位之影像的路徑(命名空間+影像名稱)(範例:img="cus:mypicture.jpg")。實際上,必須將映像導入應用程式伺服器。

  • 標籤(字串):連結至欄位的標籤,通常會傳送給介面中的使用者。它可讓您避免命名限制。

  • length(string):max。「字串」類型SQL欄位的值的字元數。 如果未指定「@length」屬性,Adobe Campaign會自動建立255個字元的欄位。

  • 可本地化(布林值):如果已啟動,此屬性會告訴收集工具,以復原「@label」屬性的值,以供翻譯(內部使用)。

  • name(MNTOKEN):與表中欄位名稱匹配的屬性名稱。「@name」屬性的值必須是短的,最好是英文,並符合XML命名限制。

    當架構寫入資料庫時,前置詞會由Adobe Campaign自動新增至欄位名稱:

    • "i":前置詞用於「整數」類型。
    • "d":首碼表示'double'類型。
    • "s":字元字串類型的前置詞。
    • "ts":「date」類型的前置詞。

    要完全定義表中欄位的名稱,在定義屬性時使用「@sqlname」選項。

  • notNull(布林值):可讓您重新定義Adobe Campaign在資料庫中管理NULL記錄的行為。預設情況下,數值欄位不為null,字串和日期類型欄位可為null。

  • pkgStatus(string):在套件匯出期間,會根據「@pkgStatus」的值考量值:

    • "always":總是存在
    • "never":永不存在
    • "default(或無)":除非值是預設值,或它不是與其他實例不相容的內部欄位,否則會導出該值。
  • 參考(字串):此屬性會定義對由多個結 <attribute> 構共用的元素的參考(定義計分)。定義不會複製到目前的架構中。

  • 必要(布林值):如果已啟用此屬性(@required="true"),介面中會反白顯示該欄位。欄位的標籤在表單中為紅色。

  • sql(布林值):如果激活了此屬性(@sql="true"),則會強制儲存SQL屬性,即使包含該屬性的元素具有xml="true"屬性時也是如此。

  • sqlDefault(字串):如果激活了屬性,此屬性允許您定義更新資料庫時考慮的預設@notNull值。如果此屬性是在建立屬性後添加的,則即使是新記錄,架構行為也不會更改。 若要變更結構並更新新記錄的值,您需要刪除並再次建立屬性。

  • sqlname(string):表建立期間的欄位。如果@sqlname未指定,預設會使用「@name」屬性的值。 當將架構寫入資料庫時,會根據欄位類型自動添加前置詞。

  • 範本(字串):此屬性定義對由多個結 <attribute> 構共用的元素的引用。定義會自動複製到目前的架構中。

  • translatedDefault(string):如果找到「@default」屬性,則「@translatedDefault」可讓您重新定義運算式,以符合@default中定義的運算式,並由翻譯工具收集(內部使用)。

  • translatedExpr(string):如果存在「@expr」屬性,則「@translatedExpr」屬性可讓您重新定義表達式,以匹配@expr中定義的表達式,由翻譯工具收集(內部使用)。

  • 類型(MNTOKEN):欄位類型。

    欄位類型為通用。 根據安裝的資料庫類型,Adobe Campaign會將定義的類型更改為結構更新期間所安裝資料庫的特定值。

    可用類型清單:

    • 任何
    • bin
    • blob
    • 布林值
    • 位元組
    • CDATA
    • 日期時間
    • datemetz
    • datetimenotz
    • 日期
    • 兩次
    • 列舉
    • 浮點
    • html
    • int64
    • 連結
    • long
    • 備忘錄
    • MNTOKEN
    • 百分比
    • primarykey
    • short
    • 字串
    • 時間
    • 時間盤
    • uuid

    如果「@type」屬性留空,Adobe Campaign依預設會將長度為100的字元字串(STRING)連結至欄位。

    如果欄位為STRING類型,且欄位名稱未由"@sqlname"屬性的存在指定,則資料庫中欄位的名稱會自動前面加上"s"。 此操作模式與INTEGER(i)、DOUBLE(d)和DATES(ts)類型欄位類似。

  • userEnum(string):接收「開啟」枚舉的內部名稱。枚舉的值可由用戶在介面中定義。

  • visibleIf(字串):會以XTK運算式的形式定義條件,以顯示或隱藏屬性。

    重要

    屬性隱藏,但仍可存取其資料。

  • xml(布林值):如果激活了此選項,則欄位的值沒有連結的SQL欄位。Adobe Campaign會為記錄儲存建立「mData」文字類型欄位。 這表示這些欄位沒有篩選或排序。

範例

其值儲存在資料庫中的枚舉值的示例:

    <enumeration name="myEnum">
       <value name="One" value="1"/>
       <value name="Two" value="2"/>
    </enumeration>

    <element label="Sample" name="Sample">
       <attribute dbEnum="myEnum" length="100" name="Number" required="true" type="string"/>
    </element>     

使用"@datapolicy"聲明XML欄位:

<attribute dataPolicy="phone" desc="Mobile number" label="Mobile"
     length="32" name="mobilePhone" sqlname="sMobilePhone" type="string"/>

以「@applicableIf」為例:「包含」屬性僅會在國家/地區數量大於20時建立。

<attribute length="100" name="Continent" type="string" applicableIf="@country > 20"/>

「@feature」為「共用」類型的範例:

<attribute name="field1" label="Field 1" type="long" feature="shared"/>
<attribute name="field1" label="Field 1" type="long" feature="shared" sqlname="126" sqltable="Ft_Content_Long"/>

「@feature」為「dedicated」類型的範例:

<attribute name="field1" label="Field 1" type="long" feature="dedicated"/>
<attribute name="field1" label="Field 1" type="long" feature="dedicated" sqlname="sField1" sqltable="Ft_recipient_field1"/>

本頁內容