處理失敗事件

您可以使用 IBM WebSphere InterChange Server Express 中的兩種工具來尋找、檢視及處理失敗的事件:「失敗事件管理程式」 是一種具有角色型安全性的瀏覽器型工具,可讓您從 Web 使用失敗的事件,而 「流程管理程式」是一種與 InterChange Server Express 產品一起安裝的工具。 若要解析交易式流程,您必須使用「流程管理程式」,但是「失敗事件管理程式」與「流程管理程式」都容許您使用失敗的事件。本節包含下列資訊:

使用失敗事件管理程式

使用流程管理程式

使用失敗事件管理程式

「失敗事件管理程式」可讓您從 Web 檢視及管理失敗的事件。 您可以對失敗的事件執行的動作,是根據角色型安全而定。 管理者可以指派下列四個預設角色的一個或多個給使用者:

管理者也可以使用「應用程式組合工具」為特定團隊建立自訂角色。

「失敗事件管理程式」可與 IBM WebSphere Application Server 或 Tomcat 搭配使用 (只限 Windows 與 Linux)。如需設定「失敗事件管理程式」搭配 WebSphere Application Server、WebSphere Application Server Express 或 Tomcat 的其他資訊,請參閱 Windows 版、Linux 版或 OS/400 版的 WebSphere Business Integration Server Express 安裝手冊。 OS/400 不支援 Tomcat。

「失敗事件管理程式」可搭配下列版本的 WebSphere Application Server、WebSphere Application Server Express 及 Tomcat:

本節包括下列程序:

設定失敗事件管理程式的安全性

管理者必須使用「失敗事件管理程式」與 WebSphere Application Server 搭配來設定安全。 此外,如果您的團隊想要使用超過預設的四個使用者角色, 管理者也可以建立其他的安全角色。有不同的方法來建立那些角色, 取決於您正在使用 WebSphere Application Server 或 Tomcat 與「失敗事件管理程式」搭配而定。

設定失敗事件管理程式與 WebSphere Application Server 的安全的步驟

如果您的群組使用 Tomcat 與「失敗事件管理程式」搭配, 將沒有其他的步驟來啟用預設角色型安全。 如果您使用 WebSphere Application Server,管理者必須啟用安全。

執行下列步驟,利用 WebSphere Application Server 啟用「失敗事件管理程式」的角色型安全:

  1. 執行下列動作來啟動 WebSphere Application Server:
  2. 在左邊導覽頁框上,按一下安全 > 使用者登錄 > 本端 OS
  3. 在「本端」使用者登錄頁面上,輸入有效的本端 OS 使用者名稱及密碼, 再按一下確定

    畫面上會出現「廣域安全」頁面。

  4. 一般內容下面選取已啟用勾選框。
  5. 確定已清除實施 Java2 安全勾選框、 保持其他預設值不變,然後按一下確定
  6. 在關於本端配置變更的訊息上按一下儲存按鈕。 畫面上會出現「儲存」頁面。
  7. 儲存至主要配置下面按一下儲存
  8. 重新啟動 WebSphere Application Server (請參閱步驟 1)。
  9. 開啟「管理主控台」。如果已正確地配置安全, 主控台頁面將要求使用者名稱與密碼 (這些是您在步驟 3 中,於「本端」使用者登錄頁面上輸入的值), 然後按一下確定

    畫面上會出現主要「管理主控台」頁面。

  10. 執行下列動作,在 WebSphere Application Server 上安裝「失敗事件管理程式」應用程式 (如果尚未安裝的話)
  11. 重新啟動 WebSphere Application Server。

利用 WebSphere Application Server Express 為「失敗事件管理程式」建立自訂角色的步驟

WebSphere Application Server Express 包括一個稱為 Studio Site Developer 的工具,管理者將使用它來編輯 WAR 檔並建立自訂的角色。 Studio Site Developer 併入在第二片 WebSphere Application Server CD;您必須從那裡安裝它。 如需安裝 WebSphere Studio Site Developer 工具的詳細資料, 請參閱 Windows 版、Linux 版或 OS/400 版的 WebSphere Business Integration Server Express 安裝手冊。

如果您正在使用 WebSphere Application Server Express,請執行下列步驟,以建立自訂的角色:

  1. 按一下開始 > 程式集 > IBM WebSphere Application Server Express 5.1.1 > Studio Site Developer 來啟動 Studio Site Developer。
  2. 開啟 Web 視景。在工作台出現之後,請按一下視窗 > 開啟視景 > Web
  3. 按一下檔案 > 匯入以匯入要編輯的 FailedEvents.war 檔案,再選取該檔案並按下一步
    OS/400

    若為 OS/400,war 檔案位於 OS/400 上,不是位於 Windows 上。 因此,您必須將它複製至 Windows,或從 Windows 將磁碟機對映至 OS/400。 OS/400 上的檔案是 /qibm/proddata/wbiserver43/product/WBFEM/WAS/FailedEvents.war
    請不要編輯 proddata 中的檔案。將它複製至 OS/400 上的另一個路徑、 在那裡編輯它,然後從新的位置部署已變更的 war 檔案。

  4. 按一下瀏覽按鈕以選取要編輯的 FailedEvents.war 檔案。
  5. 執行下列動作來建立 Web 專案:
  6. 展開 FailedEventWebProject 並按兩下 Web 部署描述子。 已加上標籤的視窗將在編輯器中開啟,依預設其中會顯示概觀標籤。
  7. 執行下列動作來建立自訂角色:
  8. 按一下「安全」畫面上的安全限制標籤, 然後執行下列動作,將新角色新增至安全限制:
  9. 按一下編輯器畫面底端的 Servlet 標籤, 然後編輯「登入」Servlet 的起始設定參數來說明每一個您已建立的角色:
  10. 按一下檔案 > 儲存來儲存 Studio Site Developer 中的專案。
  11. 以滑鼠右鍵按一下「專案導覽器」檢視畫面中的 Web 專案,再按一下匯出,將專案匯出至 WAR 檔:

利用 WebSphere Application Server 為「失敗事件管理程式」建立自訂角色的步驟

WebSphere Application Server 包括一個稱為「應用程式組合工具」的工具, 管理者將使用它來編輯 WAR 檔並建立自訂的角色。 (若為 OS/400,管理者可以在 Windows 上使用工具,來編輯 OS/400 上儲存及部署的 Jar 檔。)

如果您正在使用 WebSphere Application Server,請執行下列步驟,以建立自訂的角色:

  1. 選取開始 > 程式集 > IBM WebSphere Application Server > 應用程式組合工具,來啟動「應用程式組合工具」。
  2. 在「歡迎」對話框中,按一下現有的標籤,然後瀏覽以選取 FailedEvents.war 檔案。 按一下確定

    這時 war 檔案的完整結構會出現在左窗格。

  3. 用滑鼠右鍵按一下安全角色,再按一下新建
  4. 在「新建安全角色」對話框中,輸入新角色的名稱及說明, 再按一下確定
  5. 展開安全限制,然後從左窗格選取 SC1
  6. 在右窗格的授權限制下面按一下新增
  7. 選取您已建立的角色,再按一下確定
  8. 按一下套用
  9. 從左窗格上的根目錄,展開「Web 元件」-> 展開「登入」-> 用滑鼠右鍵按一下「起始設定」參數。
  10. 選取「角色元件」參數並編輯參數值。

    參數值是一種具有下列格式的字串:

    <RoleName1>:event_owners=<ownername>*connectors=<connectorName>*bos=
     

    <boname.verb>#
     

    <CompositeKeyValue>+<CompositekeyValue2>/<AnotherPossibleKeyValue>  |
     

     <RoleName2>:
     

    ......
     

    < | > - 區隔兩個角色

    < : > - 區隔角色名稱與角色的元件

    < * > - 區隔角色內的元件 (連接器與商業物件)

    < = > - 區隔元件名稱與它的值

    < , > - 區隔元件內的值

    < # > - 區隔商業物件名稱與它的鍵值

    < / > - 區隔商業物件的可能索引鍵 (相同商業物件 - 不同索引鍵)

    < + > - 區隔商業物件的組合索引鍵 (確定這些索引鍵值是按它們出現在商業物件的特殊順序來提供)

    例如:

    Role1:event_owners=collab1, collab2*connectors=conn1,
     conn2*bos=bo1.create#55/67,
     

    bo2.delete#99/80
     

     |Role2:event_owners=collab3,collab4*connectors=conn3*bos=bo4.create
     #59+9876/82, bo2.delete#56
     

    在此範例中,『event_owners』 是指協同作業或連接器上的事件失敗點。

  11. 在輸入參數值之後,請按一下套用
  12. 按一下檔案 > 儲存。這時 war 檔案已備妥,可以開始部署。
  13. 在建立了這些角色之後,您必須重新設定安全。 請跳至設定失敗事件管理程式與 WebSphere Application Server 的安全的步驟

利用 Tomcat 為失敗事件管理程式建立自訂使用者及角色的步驟

本節只適用於 Windows 與 Linux 系統。 OS/400 不支援 Tomcat。

請執行下列步驟,以建立自訂使用者及角色 (使用 Tomcat):

  1. 編輯 Tomcat_Home\conf 下的 tomat-users.xml 檔案,並視需要進行下列變更:
  2. 儲存檔案。
  3. 編輯 Tomcat_Home\webapps\FailedEvents\WEB-INF 下的 web.xml 檔案,將您在步驟 1 中新增的角色新增到 tomat-users.xml 檔案。請執行下列動作:
  4. 儲存檔案。
  5. 從指令行啟動 Tomcat 以呼叫 setclasspath.bat 檔案:Tomcat_home/bin/startup.bat

登入失敗事件管理程式的步驟

只在 Windows 平台上,才能透過支援的瀏覽器來存取「失敗事件管理程式」。 支援的瀏覽器如下:

請執行下列步驟,以登入「失敗事件管理程式」:

  1. 根據針對您團隊設定「失敗事件管理程式」的方式,在 Windows 上開啟瀏覽器並輸入下列其中一個 URL:
  2. 如果已啟用安全,則您必須輸入「應用程式伺服器」使用者名稱及密碼。
  3. 在「連接」畫面中輸入伺服器名稱使用者名稱密碼,然後按一下登入

    圖 61. 失敗事件管理程式「連接」畫面


    登入之後,畫面上會出現「查詢」對話框,如圖 62 所示。

    圖 62. 失敗事件管理程式「查詢」對話框


檢視失敗事件的步驟

請執行下列步驟,以檢視「失敗事件管理程式」中的失敗事件相關資訊:

  1. 在「查詢」頁面上,選取您要檢視之失敗事件的相關資訊:
  2. 按一下送出

    畫面上會出現「失敗事件表格」,如圖 63 所示。

    圖 63. 失敗事件管理程式「失敗事件表格」


    如果您尚未被指派具有檢視商業物件之存取權的角色之一, 則可能無法在此表格中使用商業物件按鈕,如圖 64 所示。

    註:
    根據您的瀏覽器,按鈕或其他控制項不出現,或出現但無法使用。

    圖 64. 失敗事件管理程式「失敗事件表格」(無權檢視商業物件)


  3. 如果您要檢視特定失敗事件的詳細資料,請選取左側直欄中的勾選框,然後按一下詳細資料直欄中的檢視

    畫面上會出現「事件詳細資料」對話框,如圖 65 所示。

    圖 65. 失敗事件管理程式「事件詳細資料」對話框


  4. 如果您已被指派了可存取商業物件的角色,請按一下 商業物件直欄中的商業物件按鈕,以檢視商業物件的相關詳細資料。 畫面上會出現「商業物件資料」對話框,如圖 66 所示。

    圖 66. 失敗事件管理程式「商業物件資料」對話框


在失敗事件管理程式中處理失敗事件的步驟

在「失敗事件表格中」執行下列步驟,以處理失敗的事件:

  1. 選取您要使用之失敗事件左側直欄中的勾選框。
  2. 請執行下列動作之一:

在失敗事件管理程式中檢查存取權的步驟

請執行下列步驟,以檢查針對「失敗的管理程式」角色型安全所指派給您的角色:

  1. 登入「失敗事件管理程式」(請參閱登入失敗事件管理程式的步驟)。
  2. 在開啟的查詢頁面上,按一下左側底端的檢查存取權鏈結。

    畫面上會顯示頁面,列出可用的預設角色。您可以輸入角色名稱以得知您是否指派為該角色。

使用流程管理程式

若要尋找、檢視及處理失敗的事件,請使用「流程管理程式」,它是隨 InterChange Server Express 產品安裝的一項工具。 「流程管理程式」可讓您易於建構查詢來尋找及顯示未解析的流程。 顯示未解析的流程之後,您可以選取顯示畫面中的任何流程,然後送出、捨棄它或執行其他動作。 如需失敗流程的背景資訊,請參閱流程失敗

下列主題說明如何使用「流程管理程式」來建構查詢、檢視明細及處理事件:

啟動流程管理程式的步驟

尋找未解析流程的步驟

"檢視未解析流程詳細資料的步驟"

處理未解析流程的步驟

啟動流程管理程式的步驟

請執行下列步驟,以啟動「流程管理程式」:

  1. 按一下開始 > 程式集 > IBM WebSphere Business Integration Express > Toolset Express > 管理 > 流程管理程式。 會出現「連接到 InterChange Server」對話框 (請參閱圖 67)。

    圖 67. 「連接到 InterChange Server」對話框


  2. 使用下列任一方法來輸入伺服器名稱:
  3. 針對您想要連接的伺服器輸入使用者名稱和密碼。 如果您勾選記住使用者名稱及密碼勾選框,則使用者名稱及密碼將連同伺服器名稱一起儲存在登錄中, 且密碼會加密。 按一下連接
    註:
    若要從登錄中移除不要的使用者或伺服器,請按一下「選項」。 如此將會開啟「選項」對話框,您可以從這裡移除伺服器或使用者。
    下圖顯示「選項」對話框。

    圖 69. 「選項」對話框


當您按一下「連接到 InterChange Server」對話框中的連接之後, 即會開啟「流程管理程式」(請參閱圖 70)。

圖 70. 流程管理程式


尋找未解析流程的步驟

在「流程管理程式」中執行下列步驟,以尋找所有未解析的流程:

  1. 啟動「流程管理程式」。請參閱啟動流程管理程式的步驟
  2. 請執行下列動作之一:
  3. 指定搜尋準則之後,請按一下尋找按鈕,或是按一下 事件 > 尋找。結果會出現在「流程管理程式」視窗的下半部 (請參閱圖 71)。

    圖 71. 顯示過濾結果的流程管理程式


  4. 若要將現行過濾條件資訊儲存成查詢,請按一下查詢 > 儲存。 您輸入的查詢名稱會出現在查詢清單中。

事件屬性標籤

按一下事件屬性標籤,依據未解析事件的性質來進行搜尋 (請參閱圖 72)。

圖 72. 流程管理程式「事件屬性」標籤


事件屬性標籤提供下列選項:

日期及時間標籤

使用日期及時間標籤,只查詢在特定時段失敗的流程 (請參閱圖 73)。

圖 73. 「日期及時間」標籤


日期及時間標籤提供下列選項:

「錯誤文字及商業物件屬性」標籤

使用錯誤文字及商業物件屬性標籤來建構一個只包括特定商業物件、商業物件屬性和屬性值的查詢 (請參閱圖 74)。

圖 74. 「錯誤文字及商業物件屬性」標籤


在下列直欄中選取值:

您也可以只查詢未解析的流程,這些流程產生的訊息中含有您在含有錯誤文字欄位中所輸入的指定文字。

註:
您在含有錯誤文字欄位中輸入的關鍵字不區分大小寫。

檢視未解析流程詳細資料的步驟

請執行下列步驟,以檢視「流程管理程式」中的未解析流程的詳細資料:

  1. 查詢清單中選取查詢。
  2. 請執行下列動作之一:

    結果會出現在「流程管理程式」視窗的下半部 (請參閱圖 71)。

    畫面上會出現未解析的流程表格,以及事件清單與下列資訊:

    關於等待中事件,事件狀態資料格會包含下列資訊:


    等待中
    [逾時期限:...]
    [範例情況名稱:...]
    [範例情況節點 ID...]

  3. 若要存取關於任一事件的詳細資訊,請按兩下包含該事件的列 (或是按一下事件 > 全選)。 如此將會開啟「顯示事件詳細資料」對話框 (請參閱圖 75)。

    圖 75. 流程管理程式「顯示事件詳細資料」對話框


  4. 若要存取與所選取事件相關聯之商業物件的詳細資訊,請按一下事件 > 顯示詳細資料。 畫面上會出現「顯示商業物件資料」對話框 (請參閱圖 76)。

    圖 76. 「顯示商業物件資料」對話框


如果您想要對任何未解析的流程採取動作,請參閱處理未解析流程的步驟

管理查詢的步驟

請執行下列步驟之一,以管理您為未解析流程所建立的查詢:

管理查詢結果的步驟

請執行下列步驟,以管理您為未解析流程所建立的查詢:

  1. 在「流程管理程式」的結果清單中,選取結果清單中的一或多個事件。
  2. 請執行下列動作之一:

處理未解析流程的步驟

請執行下列步驟,以處理「流程管理程式」結果清單中的任何失敗事件:

  1. 在「流程管理程式」的結果清單中,選取結果清單中的一或多個事件。
  2. 請執行下列動作之一:

Copyright IBM Corp. 2004