將「共用基本事件」格式的延伸資料元素對映成 Enterprise Console 事件格式

將 CBE 事件對映成規則庫中的 Enterprise Console 事件類別時, 會將每個延伸資料元素對映成所產生之 Enterprise Console 事件中的屬性。

如果延伸資料元素的完整名稱與 Enterprise Console 事件類別定義中的屬性名稱不符,則會捨棄延伸資料元素。

表 1 說明 CBE 延伸資料元素與 Enterprise Console 事件中之屬性的對映。

延伸資料元素子欄位

Enterprise Console 屬性

extendedDataElement.name

屬性名稱

extendedDataElement.type

指出 Enterprise Console 屬性值是簡單值或陣列。

extendedDataElement.values

屬性值

extendedDataElement.children

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

表 1. CBE 延伸資料元素與 Enterprise Console 屬性的對映。


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

名稱

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

例如,請考慮具有下列延伸資料元素的 CBE 事件

<CommonBaseEvent ...>
    <extendedDataElements name="abc" type="string">
      <values>my value</values> 
      <children name="def" type="int">  
        <values>123</values> 
      </children>  
    </extendedDataElements>
...
</CommonBaseEvent>

在 Enterprise Console 事件中產生的屬性及對應值會是:

abc='my value'
abc.def=123

如果延伸資料元素的對映名稱與 Enterprise Console 事件中的另一個屬性名稱衝突, 則會捨棄延伸資料元素。如需詳細資訊,請參閱延伸資料元素的名稱衝突主題。

基於相同的原因,因為轉換演算法會在延伸資料元素之前處理基本屬性, 所以不會將具有下列名稱的延伸資料元素對映成 Enterprise Console 事件中的屬性。

附註:

所產生的屬性名稱可能需要經過轉換,才能放入 Enterprise Console 事件中之屬性名稱所使用的字元空間。

類型及值

延伸資料元素中的類型子欄位會指出元素內之值的預期資料類型。如果延伸資料元素的類型與目標 Enterprise Console 事件中之屬性的類型相容, 則會將延伸資料元素對映成目標 Enterprise Console 事件中的屬性。

表 2 說明延伸資料元素類型與 Enterprise Console 屬性類型之間的類型相容性。

延伸資料元素類型

Enterprise Console 屬性類型

  • noValue
  • 無,會忽略整個延伸資料元素
  • byte
  • short
  • INTEGER
  • INT32
  • REAL
  • STRING
  • int
  • long
  • INT32
  • REAL
  • STRING
  • float
  • double
  • REAL
  • STRING
  • string
  • dateTime
  • boolean
  • hexBinary
  • STRING
  • byteArray
  • shortArray
  • LIST_OF INTEGER
  • LIST_OF INT32
  • LIST_OF REAL
  • LIST_OF STRING
  • intArray
  • longArray
  • LIST_OF INT32
  • LIST_OF REAL
  • LIST_OF STRING
  • floatArray
  • doubleArray
  • LIST_OF REAL
  • LIST_OF STRING
  • stringArray
  • dateTimeArray
  • booleanArray
  • LIST_OF STRING

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

例如,請考慮具有下列延伸資料元素的 CBE 事件

<CommonBaseEvent extensionName="CustomEvent" ...>
    <extendedDataElements name="slot1" type="string">
      <values>my value1</values> 
      <values>my value2</values> 
      <values>my value3</values> 
    </extendedDataElements>
...
</CommonBaseEvent>

假設規則庫中之事件類別 "CustomEvent" 的屬性 "slot1" 是定義成字串清單, 則產生的 Enterprise Console 事件會包含下列屬性:

slot1=['my value1', 'my value2', 'my value3']
附註:
  1. 如果 Enterprise Console 屬性的複式類型是 SINGLE STRING, 而延伸資料元素中的屬性是陣列,則會結合所有值,以形成最後的字串。
  2. 如果延伸資料元素中的屬性是陣列, 而 Enterprise Console 屬性的複式類型不是 LIST_OF, 則會捨棄延伸資料元素。
  3. 如果延伸資料元素中的屬性是陣列、屬性的類型不是 STRING,且 Enterprise Console 屬性的複式類型是 SINGLE, 則會捨棄延伸資料元素。


相關主題

延伸資料元素的名稱衝突


母主題

將「共用基本事件」格式的事件轉換成 Enterprise Console 事件格式


下載 | 書庫 | 支援 | 使用條款 | 意見

(C) Copyright IBM Corporation 1999,2005. All Rights Reserved.