實務範例 1: 建立簡式自訂工具

此實務範例說明如何建立稱為 UIFrameworkTest的簡式自訂工具。 您可以使用相同的程序，在 IBM® Product Master 環境中部署自訂 JSP 檔。

開始之前

在部署自訂程式碼 (JSP 和 Java 指令物件) 之前，您必須先佈建登錄及取消登錄 Servlet 執行緒。
  • 在 flow-config.xml 檔中，針對自訂流程 (流程和非同步) 新增 customTool="true" :
    <flow path="testCommand"
    command="test.TestCommand"  
    method="getAction"   
    isCustomTool="true"
>
    此檔案位於 $TOP/etc/default 目錄中。
  • 新增標頭和標底包含將自訂 JSP 程式碼包裝在 try/catch/finally 區塊中:
    標頭
    將這個併入項目放在任何宣告之後，以及將在 JSP 類別層次定義物件的任何其他宣告之後，例如定義方法和成員變數的宣告。 下面提及的併入檔會開啟一個 try 區塊，關閉併入會完成這個 try 區塊。 這個 try 區塊必須包含 JSP 主要方法中的所有程式碼。 避免使用存取資料庫的靜態宣告。
    <%@ include file="/js/utils/customToolHeader.jsp.include" %>
    頁腳
    將此併入項目放在檔案結尾。 下面提及的併入檔會關閉在標頭 include 中開啟的 try 區塊。
    <%@ include file="/js/utils/customToolFooter.jsp.include" %>

程序

  1. 在使用者介面中建立自訂工具。
    1. 開啟 Script 主控台。
    2. 選取 自訂工具。
    3. 按一下「新建」按鈕。
    4. 指定任何輸入參數及其他設定。 在此情況下，請針對輸入參數指定 None 。 提供自訂工具名稱，例如: UIFrameworkTest ，並選取 ASP/JSP 類型。
    5. 在 Script 編輯器中，插入下列 Script ，以產生自訂工具所需的 HTML。 例如：
      Welcome to the new UI framework 
<HR>
<a href="/newhomepage.wpc"> New Custom Page </a>
    6. 按一下「儲存」。
  2. 編輯 flow-config.xml 檔案。
    在流程標籤下新增下列程式碼片段:
    <flow path="newhomepage" command="com.ibm.ccd.ui.util.DefaultNavigator" method="">
<flow-dispatch name="success" location="/user/welcome1.jsp" dispatchType="forward" />
</flow>

    雖然您可以直接呼叫 welcome1.jsp，但此程式碼會管理產品階段作業。 如果有逾時，則此程式碼會將使用者轉遞至登入頁面。

  3. 建立簡式 JSP 頁面並將它儲存為 welcome1.jsp。
    <BR>
<BR>
<HR>
<%
out.println("Welcome to the new UI extension framework ");
%>
<HR>
  4. 在 $TOP/public_html/user 目錄中新增自訂程式碼或 JSP 檔。
  5. 新增 Java 程式碼 (如果有的話)。
    1. 為您為新延伸撰寫的 Java™ 指令公用程式程式碼建立 JAR 檔。
    2. 將 Jar 檔新增至伺服器。
      附註: 在此實務範例中，不需要 Java 指令類別，因為您只是轉遞要求。 您將使用隨應用程式一起包裝的 DefaultNavigator.java。
  6. 重新啟動 Product Master 應用程式。
  7. 變更 Product Master中的設定。
    1. 在「使用者設定」頁面中，選取新的自訂工具作為新的預設起始頁，然後按一下 儲存。
    2. 請重新載入畫面，以查看含有「新建自訂頁面」鏈結的新自訂工具。 按一下此鏈結以開啟新頁面，即 welcome1.jsp。
      您看到訊息Welcome to the new UI extension framework.