使用商業物件

若要測試商業程序介面的開發是否正確,您必須驗證商業物件能否順利交換及處理。 本節說明如何執行下列動作:

使用要求商業物件

要求商業物件是指「測試連接器」於模擬作為觸發介面之事件來源的連接器時, 您從「測試連接器」傳送的那些商業物件。要求商業物件的使用內容包含建立 商業物件實例、移入資料到實例中以及傳送要求。

建立要求商業物件

若要在「測試連接器」中建立新的商業物件,請執行下列動作:

  1. 於「支援的商業物件」窗格中,從 BOType 下拉功能表中 選取要建立的商業物件名稱。
  2. 按一下 BOInstance 欄位旁的建立
  3. 當出現「新建實例」對話框時,請於輸入名稱欄位中鍵入實例名稱。
  4. 動詞下拉功能表中選取所要的動詞。
  5. BOLocale 下拉功能表中選取所要的語言環境。
  6. 依照設定商業物件屬性的值中的說明,提供最上層物件內 子項商業物件和簡單屬性的值。

    圖 33 顯示名為 Caesar_Customer 的 商業物件,它具有 Create 動詞、en_US 語言環境、對其每一個簡單 屬性指定的值,以及 Caesar_Address 子項商業物件的單一實例。

    圖 33. 將資料移入商業物件


  7. 按一下確定

傳送要求商業物件

一旦建立或載入商業物件並指定其屬性值後,您有幾個方式可將商業物件 當作要求傳送給整合分配管理系統。

非同步傳送要求商業物件

如果來源連接器於非同步模式中傳送要求商業物件,則不預期取回回應商業物件。 一旦要求商業物件分派出去,來源連接器在交易中扮演的角色就算完成了。 回應商業物件通常是由整合分配管理系統來處理。「測試連接器」的預設模式為非同步。

若要非同步傳送商業物件,請執行下列動作:

  1. 從功能表列選取要求 > 模式 > 非同步
    註:
    依預設,「測試連接器」是在「非同步」模式中運作, 所以只有在您先前有從連接器傳送同步要求,才需要執行這個步驟。此外, 在傳送每一個要求之前,您不需要設定此模式。
  2. 從功能表列選取要求 > 傳送

若連接器定義中指定的分配管理系統為 InterChange Server,則會傳送商業物件要求給伺服器處理。

若連接器定義中指定的分配管理系統是受支援的訊息分配管理系統中的其中之一或是 WebSphere Application Server, 則商業物件會被置於 RequestQueue 標準內容中指定的佇列上。

同步傳送要求商業物件

若來源連接器同步傳送要求商業物件,則在任何目的地應用程式處理完要求之後, 預期會從整合分配管理系統取回回應商業物件。於同步模式中,「測試連接器」會將回應商業物件置於來源連接器的 「同步要求佇列」內容所指定的佇列上。「測試連接器」的預設模式為非同步。

  1. 從功能表列選取要求 > 模式 > 同步,將「測試連接器」設定為同步模式。
  2. 從功能表列選取要求 > 傳送
  3. 若連接器定義中指定的分配管理系統是 InterChange Server,則會顯示 「選取協同作業」對話框。從協同作業下拉功能表中, 選取商業物件應傳送到的協同作業,然後按一下確定

若連接器定義中指定的分配管理系統為 InterChange Server,則商業物件 要求傳送到選擇處理之協同作業物件的已配置埠。

若連接器定義中指定的分配管理系統是受支援的訊息分配管理系統中的其中之一或是 WebSphere Application Server, 則商業物件會被置於 SynchronousRequestQueue 標準內容中指定的佇列上。

以批次模式傳送要求商業物件

於批次模式中,「測試連接器」讓您指定要傳送的特定商業物件實例數目, 以及您要對每一個實例設成唯一值之最上層物件中的一個屬性 (例如主要索引鍵屬性)。「測試連接器」會依您指定的次數複製商業物件、增加所指定單一屬性的值, 並傳送每一個商業物件。此選項可讓您既快速又輕鬆地建立大量商業物件。

若選取的屬性是加入動態交互參照作為身分識別關係一部份的索引鍵欄位, 您必須保證起始值及遵循起始值的所有值都是唯一的。否則,交互參照邏輯將失敗, 這也會導致要求商業物件失敗。

若要確定值是唯一的,您可使用「關係管理程式」或對關係參與者表格執行 SQL 陳述式, 如下所示:

若要以批次模式傳送商業物件,請執行下列動作:

  1. BOType 下拉功能表中,選取要傳送的商業物件名稱。
  2. 從功能表列選取要求 > 批次傳送
  3. 在「批次模式」視窗中,從動詞下拉功能表中選取所要的動詞。
  4. BOLocale 下拉功能表中選取所要的語言環境。
  5. 屬性清單中,選取要隨批次中每一個商業物件要求增量之最上層商業物件中的屬性。

    選取的屬性通常應是唯一識別商業物件的屬性,例如主要索引鍵。

  6. 起始值欄位中,輸入要增量的屬性起始值。
  7. 商業物件數目欄位中,輸入要產生及傳送的商業物件實例數目。
  8. 請按一下確定

    「測試連接器」會產生您所指定的連接器數目,除了其值針對每一個實例增量的 指定屬性不同之外,其餘皆相同。

    若連接器定義中指定的分配管理系統為 InterChange Server,則會傳送商業物件要求給伺服器處理。

    若連接器定義中指定的分配管理系統是受支援的訊息分配管理系統中的其中之一或是 WebSphere Application Server, 則商業物件會被置於 RequestQueue 標準內容中指定的佇列上。

圖 34 顯示內容如下的批次模式配置:

圖 34. 批次模式視窗


設定商業物件屬性的值

下列各節說明設定商業物件實例中簡式和複合屬性值的各種方式:

設定簡式屬性的值

若要提供簡式屬性的值,請於直欄中按一下它的資料格並輸入一值。

新增子項商業物件

若要新增子項商業物件的實例,請用滑鼠右鍵按一下代表子項物件的實例,然後從快速功能表中 選取新增實例

在代表子項商業物件的屬性旁邊出現一個加號 (+),表示至少有一個子項商業物件實例存在。 若您展開該子項物件屬性,則會顯示每個實例的編號項目。個別實例的旁邊也有加號 (+), 您可以展開它們來設定其屬性值。

若要新增其他子項商業物件實例,請以滑鼠右鍵按一下代表子項物件的實例,然後從快速功能表中 選取新增實例

註:
若參照子項商業物件之屬性的內容設為值 1 (指示其為單一主要屬性),則您只能新增一個子項物件實例。

移除子項商業物件

若要移除子項商業物件的實例,請以滑鼠右鍵按一下該實例,然後從快速功能表中選取 移除實例

若要移除所有子項商業物件的實例,請以滑鼠右鍵按一下代表子項商業物件的屬性, 然後從快速功能表中選取刪除全部實例

設定子項商業物件的動詞

您可設定子項商業物件的動詞來測試該值在商業程序上的效果。 這對於您在疑難排解涉及到子項物件交互參照的邏輯時可能有幫助。

若要設定子項商業物件實例的動詞,請以滑鼠右鍵按一下它,然後從快速功能表中 選擇 設定動詞。 當出現「選取動詞」提示畫面時,選取所要的動詞並按一下確定

使用「回應 BO」工具列

您可編輯目的地連接器所接收的商業物件屬性,之後再將此商業物件當做回應傳送。 您於執行上述動作時所用的「回應 BO」對話框,其工具列具有數個可用來設定商業物件值的按鈕。 如需詳細資訊,請參閱編輯回應商業物件

儲存商業物件

您可於「測試連接器」中儲存商業物件,以便用於稍後的測試、共用技術支援 (協助進行問題疑難排解) 或作為回應資料。您可儲存任何商業物件,包括您在目的地連接器的 「測試連接器」中所建立的商業物件,及顯示為要求的商業物件。依預設,商業物件會以商業物件副檔名 (.bo) 存檔。

建議您建立專門用於測試資料檔的目錄或目錄結構,其中有每個介面或連接器 (適合的話) 專用的子目錄。此種組織可讓您輕鬆地找到需要的檔案並使測試更有效率。 此外,建議您為商業物件的測試資料檔指定與商業物件定義本身相同的名稱。

儲存要求商業物件

請執行下列動作,儲存您建立為要求的商業物件實例:

  1. 選取要儲存的商業物件。
  2. 從功能表列,選取編輯 > 儲存 BO
  3. 瀏覽至所要的目錄,並於檔案名稱欄位中指定檔名。
  4. 按一下儲存

儲存回應商業物件

請執行下列動作,儲存「測試連接器」目的地實例已接收且將作為回應傳送的商業物件實例:

  1. 於「BO 要求清單」窗格中選取商業物件實例。
  2. 從功能表列選取要求 > 編輯回應
  3. 按一下儲存 BO
  4. 瀏覽至所要的目錄,並於檔案名稱欄位中指定檔名。
  5. 按一下儲存

載入商業物件

若要載入已存檔的商業物件,請執行下列動作:

  1. 從「測試連接器」的功能表列中,選取編輯 > 載入 BO
  2. 瀏覽至商業物件測試資料檔並開啟它。
  3. 當出現「新建實例」對話框時,請於輸入名稱欄位中鍵入實例名稱。
  4. 按一下確定

刪除商業物件

若要從「測試連接器」刪除商業物件,請從功能表列選取編輯 > 刪除 BO

註:
此動作僅會從「測試連接器」移除商業物件。並不會移除連接器的商業物件定義支援。

接受要求商業物件

若交易未失敗,當您將商業物件當作要求傳送時,該商業物件會出現於模擬介面中目的地連接器的任何 「測試連接器」實例的「BO 要求清單」窗格中。

接受該要求商業物件之後,您可依照編輯回應商業物件中 的說明,視需要編輯它。

使用回應商業物件

回應商業物件是指「測試連接器」在模擬作為介面中商業物件要求的接收者時, 您從「測試連接器」傳送的那些商業物件。要求商業物件的使用內容包含編輯商業 物件實例中的值,並將回應傳回分配管理系統。

編輯回應商業物件

當您在「測試連接器」的目的地實例中接收商業物件要求時, 通常會想要編輯屬性的值。例如,您想要為加入關係的主要索引鍵屬性提供唯一值, 或想要修改其他屬性的值,根據商業物件中的正確值,來測試以不同方式回應的對映或協同作業邏輯。請執行下列動作,以設定商業物件屬性的值:

  1. 於「BO 要求清單」窗格中選取商業物件實例。
  2. 從功能表列選取要求 > 編輯回應
  3. 執行下列動作編輯商業物件的屬性:

傳送回應商業物件

接受要求商業物件之後,請視需要編輯該商業物件並作為回覆傳回。

表 24 列示「測試連接器」的回覆選項, 並針對 C++ 和 Java 連接器顯示其對應連接器回覆碼。如需 C++ 或 Java 連接器回覆碼的詳細資訊, 請參閱 Connector Development Guide for Java or C++

表 24. 「測試連接器」回覆類型與連接器回覆碼。
「測試連接器」回覆類型 C++ 連接器回覆碼 Java 連接器回覆碼
成功 BON_SUCCESS SUCCESS
失敗 BON_FAIL FAIL
多重命中 BON_MULTIPLE_HITS MULTIPLE_HITS
依內容擷取失敗 BON_FAIL_RETRIEVE_BY_CONTENT RETRIEVEBYCONTENT_FAILED
找不到 BON_BO_DOES_NOT_EXIST BO_DOES_NOT_EXIST
值重複 BON_VALDUPES VALDUPES

若要回覆要求商業物件,請執行下列動作:

  1. 在「BO 要求清單」窗格中選取商業物件。
  2. 從功能表列,選取要求 > 回覆
  3. 回覆子功能表選取一個項目。

比較商業物件實例

「測試連接器」可比較同類型的兩個商業物件並顯示不同值的屬性。 您可使用此功能來檢視交易執行中不同位置上的商業物件變更 (例如, 您可將傳送至整合分配管理系統的商業物件,與整合分配管理系統更新後的相同商業物件做比較)。 若要比較兩個商業物件,請執行下列動作:

  1. 遵循建立要求商業物件載入商業物件中的指示,建立一個要求商業物件實例。
  2. 在您要比較要求商業物件實例的「BO 要求清單」窗格中,選取回應商業物件實例。
  3. 從功能表列,選取編輯 > 比較 BO

    「測試連接器」會開啟「比較商業物件」視窗, 其中有一個表格顯示兩個商業物件中具有不同值的屬性。圖 35 顯示兩個商業物件實例之間的比較。

    圖 35. 「商業物件比較」視窗。


  4. 按一下確定,關閉視窗。

Copyright IBM Corp. 1997, 2003