屬性元素

內容模型

屬性：==幫助

屬性

_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)、label(string)、length(locallacallatin)、N(boolen)string)、ref（字串）、必要（布林值）、sql（布林值）、sqlDefault（字串）、sqlname（字串）、sqltable（字串）、target(MNTOKEN)、範本（字串）、translatedDefault（字串）、translatedExpr（字串）、類型(MNTOKEN)、用戶（布林值）、userEnum（字串）、visibleIf（字串）、xml（布林值）

父母

<element>

兒童

<help>

說明

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

使用與使用內容

<attribute> 元素必須在 <element> 元素。

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

屬性說明

• _operation（字串）:定義資料庫中的寫入類型。

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

  可存取的值包括：

  • "none":單獨調解。 這表示Adobe Campaign將復原元素，而不會更新元素，或在不存在的情況下產生錯誤。
  • "insertOrUpdate":更新為插入。 這表示Adobe Campaign將更新元素，或在元素不存在時加以建立。
  • "insert":插入。 這表示Adobe Campaign將插入元素，而不會檢查元素是否存在。
  • "update":更新。 這表示Adobe Campaign將更新元素，或在元素不存在時產生錯誤。
  • "delete":刪除。 這表示Adobe Campaign將復原和刪除元素。

• 進階（布林值）:啟用此選項時(@advanced="true")，它可讓您隱藏可用欄位清單上的屬性，這些欄位可用於配置表單中的清單。

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

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

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

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

  • "none":無值
  • "smartCase":首字母大寫
  • "lowerCase":全部小寫
  • "upperCase":全部大寫
  • "email":電子郵件地址
  • "phone":電話號碼
  • "identifier":識別碼名稱
  • "resIdentifier":檔案名

• dbEnum（字串）:接收「已關閉」枚舉的內部名稱。 必須在 <srcschema>.

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

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

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

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

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

• 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（字串）: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（字串）:表建立期間的欄位。 如果@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"/>