延伸資料元素與 Enterprise Console 事件類別屬性的對映

CBE 事件延伸定義中的每個 extendedDataElement 元素都會對映成相對應的 Enterprise Console 事件類別定義中的屬性。

表 1 說明 CBE 事件延伸定義中之 extendedDataElement 與 Enterprise Console 事件類別定義中之屬性的對映。

CBE 事件延伸定義

Enterprise Console 事件類別定義

extendedDataElement.name

屬性名稱

extendedDataElement.type

屬性類型

extendedDataElement.defaultValue
extendedDataElement.defaultHexValue

屬性 "default" 構面類型

extendedDataElement.minOccurs

如果是 "0" (零),因為 Enterprise Console 伺服器需要所有屬性, 所以不會將延伸資料元素對映至 Enterprise Console 事件類別定義。

extendedDataElement.maxOccurs

忽略:從 CBE 格式的事件轉換成 Enterprise Console 格式的事件期間, 只會對映第一個重複延伸資料元素。

children extendedDataElement

每個延伸資料元素子元素都會轉換成 Enterprise Console 事件類別定義中的另一個屬性。除非延伸資料元素內不再有其他子元素, 否則此程序會遞迴地重複執行。如需 Enterprise Console 事件類別定義中所產生之屬性名稱的詳細資料,請參閱名稱一節。

表 1. CBE 事件定義中之元素與 Enterprise Console 事件類別定義中之屬性的對映。


下列各節會詳細解釋如何將 CBE 事件定義的每個屬性對映至 Enterprise Console 事件類別定義中的屬性:

名稱

extendedDataElement 可用巢狀形式出現在另一個 extendedDataElement 內。Enterprise Console 事件類別定義中之所產生的屬性名稱格式是所有從最上層上代開始之 extendedDataElements 名稱的總和 (直到對映元素名稱)。"." (句點) 字元是當成分隔字元。

例如,CBE 事件延伸定義

<eventDefinition name="Transaction"> parent="event";
    <extendedDataElement name="tx_number" type="string">
        <extendedDataElement name="tx_items" type="string">
            ...
        </extendedDataElement>
    </extendedDataElement>
</eventDefinition>

產生下列 Enterprise Console 事件定義類別:

TEC_CLASS :
    Transaction ISA EVENT
    DEFINES {
        tx_number: STRING;
        tx_number.tx_items: STRING;
        ...
    }
END
注意事項
  1. 所產生之屬性的名稱可能需要進行轉換, 才能放入 Enterprise Console 事件中之屬性名稱所使用的字元空間。
  2. 沒有 parent 屬性的 CBE 事件定義一律會對映成將 EVENT 作為其超類別的 Enterprise Console 事件類別定義。

類型

表 2 說明如何將延伸資料元素的 "type" 子欄位對映至 Enterprise Console 事件類別定義中的屬性資料類型。

CBE 事件延伸定義

Enterprise Console 事件類別定義

  • noValue

會忽略整個 extendedDataElement

  • byte
  • short
  • int
  • long

INT32

  • float
  • double

REAL

  • string
  • dateTime
  • boolean
  • hexBinary

STRING

  • byteArray
  • shortArray
  • intArray
  • longArray

LIST_OF INT32

  • floatArray
  • doubleArray

LIST_OF REAL

  • stringArray
  • dateTimeArray
  • booleanArray

LIST_OF STRING

表 2. 延伸資料元素類型與 Enterprise Console 屬性類型的對映。

預設值及預設十六進位值

延伸資料元素定義的預設值會對映至 Enterprise Console 事件類別定義中之對應屬性的預設值。

例如,CBE 事件延伸定義

<eventDefinition name="Transaction" parent="event">
    ...
    <extendedDataElement name="tx_type" type="string">
        <defaultValue>purchase</defaultValue>
    </extendedDataElement>
 
    <extendedDataElement name="tx_internal_code" type="long">
        <defaultValue>42</defaultValue>
    </extendedDataElement>

    <extendedDataElement name="tx_approvers" type="string">
        <defaultValue>employee_1</defaultValue>
        <defaultValue>employee_2</defaultValue>
    </extendedDataElement>

    <extendedDataElement name="tx_key" type="hexBinary">
        <defaultValue>CE908712AF</defaultValue>
    </extendedDataElement>

</eventDefinition>

產生下列 Enterprise Console 事件定義類別:

TEC_CLASS :
    Transaction ISA EVENT
    DEFINES {
        tx_type: STRING, default="purchase";
        tx_internal_code: INT32, default=42;
        tx_approvers: STRING, default=[employee_1, employee_2];
        tx_key: STRING , default=CE908712AF;
        ...
    };
END


相關主題
「共用基本事件」屬性與 Enterprise Console 事件屬性的對映