WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 作業系統: AIX, HP-UX, Linux, Solaris, Windows

「資料庫查閱」調解基本元素

您可以使用「資料庫查閱」調解基本元素,使用資料庫的資訊來修改訊息。

簡介

「資料庫查閱」調解基本元素可以新增或變更訊息。它會利用使用者提供之資料庫中的資訊,來執行這項作業。

這個調解基本元素會從資料庫查閱值,並將這些值當成元素儲存在訊息中。從資料庫取得的資訊可能需要轉換成正確的類型,才能儲存在訊息中。 這會使用訊息值類型內容來指定。 如果從資料庫取得的資訊無法轉換成訊息所預期的類型, 則會發生異常狀況。

如果訊息元素已存在於訊息中, 則舊的值會改寫成新的值。如果新的值與訊息值類型內容所定義的元素類型不相容,則會發生異常狀況。

「資料庫查閱」調解基本元素需要各種不同的資料庫資訊,包括索引鍵。您可以使用稱為索引鍵路徑的內容,來找出索引鍵。 如果索引鍵路徑的索引鍵不存在於輸入訊息中, 則會發生異常狀況。

「資料庫查閱」調解基本元素有一個輸入端和三個輸出端。連接輸入端可用來接受訊息, 而連接輸出端則可用來傳送訊息。如果索引鍵路徑的索引鍵同時位於訊息和資料庫中, 則會使用一個輸出端。在此情況下,從資料庫取得的資訊會儲存在訊息中, 並傳送更新後的訊息。 如果索引鍵路徑的索引鍵位於訊息中,但不位於資料庫中, 則會使用另一個輸出端。在此情況下,則會傳送未變更的原始訊息。最後一個輸出端則是用於失敗輸出。 如果處理輸入訊息期間發生異常狀況,則失敗端會傳送原始訊息,以及任何異常狀況資訊。

用法

您可以使用「資料庫查閱」調解基本元素來確保訊息中的資訊是最新的。

您可以使用「資料庫查閱」調解基本元素,利用訊息內含的索引鍵,將資訊加入訊息中。比方說,索引鍵可以是帳號。

將「資料庫查閱」調解基本元素與其他調解基本元素結合通常會很有用。比方說,您可以在呼叫「資料庫查閱」之前或之後, 使用 XSLT 調解基本元素來操作資料。

內容

資料來源名稱
資料來源的 JNDI 名稱。
表格名稱
資料庫表格的名稱,包括綱目名稱。例如:myschema.mytable。
索引鍵直欄名稱
資料庫之主要索引鍵直欄的名稱。指定的索引鍵直欄必須包含唯一的值; 系統不支援多直欄的資料庫索引鍵。 此外,唯一的值必須與位於訊息中使用索引鍵路徑的值,具有相同的元素類型。
索引鍵路徑
XPath 1.0 表示式。從 XPath 表示式傳回的值可用來作為資料庫中的索引鍵。
資料元素
包含三種內容的表格。這三個內容會說明尋找資料庫資訊的位置、 資訊的類型,以及訊息中用來儲存資訊的位置。
值直欄名稱
從中取得元素值之資料庫直欄的名稱。
訊息值類型
元素值的類型。唯一受支援的類型是 Java 初始類型或字串。在執行時期,從資料庫取得的值會轉換成訊息值類型所定義的類型。訊息值類型會使用字串來定義。
訊息元素
這是一個 XPath 1.0 表示式,它說明訊息元素的路徑位置。 訊息元素是儲存資料庫值的位置。XPath 表示式必須評估成訊息中的單一元素。
驗證輸入
如果是 true,會在執行調解之前先驗證輸入訊息。
表 1. 「資料庫查閱」調解基本元素內容
內容 有效值 預設值
資料來源名稱 字串  
表格名稱 字串:  
索引鍵直欄名稱 字串  
索引鍵路徑 字串  
資料元素 值直欄名稱 字串  
訊息值類型 字串:定義 Java 初始類型或 Java 字串  
訊息元素 字串:這是一個 XPath 1.0 表示式,它說明訊息元素的路徑位置  
驗證輸入 Boolean:truefalse false

注意事項

當您使用「資料庫查閱」調解基本元素時,請考量下列事項:


Reference topic

使用條款 | 此頁的評等

時間戳記前次更新: 6 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.wbit.help.medprim.doc.nl1_6.0.1\ref\rwesb_DatabaseLookupmediationprimitive.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)