將 CBE 事件對映成規則庫中的 Enterprise Console 事件類別時, 會將每個延伸資料元素對映成所產生之 Enterprise Console 事件中的屬性。
如果延伸資料元素的完整名稱與 Enterprise Console 事件類別定義中的屬性名稱不符,則會捨棄延伸資料元素。
表 1 說明 CBE 延伸資料元素與 Enterprise Console 事件中之屬性的對映。
延伸資料元素子欄位 |
Enterprise Console 屬性 |
---|---|
屬性名稱 |
|
指出 Enterprise Console 屬性值是簡單值或陣列。 |
|
屬性值 |
|
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 事件中的屬性。
表 2 說明延伸資料元素類型與 Enterprise Console 屬性類型之間的類型相容性。
延伸資料元素類型 |
Enterprise Console 屬性類型 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
表 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']
將「共用基本事件」格式的事件轉換成 Enterprise Console 事件格式