在本課程中,您將配置您在前一節課程中為外掛程式專案定義的 parameterValidator 延伸。
parameterValidator 延伸點容許提供延伸,以在使用者輸入特定參數的值時,對該值進行驗證。針對本範例,value 參數會接受小於 4 的單位數數值字元。您將利用使用者可以輸入到 value 參數中的不同可能值,來向使用者顯示不同的參考訊息,以確保使用者只輸入數值字元。
- 請先從配置 parameterValidators 延伸開始。
在外掛程式開發視景中,用滑鼠右鍵按一下 com.ibm.carma.plugin.howto 外掛程式專案,然後選取 PDE 工具 > 開啟資訊清單。這時將開啟外掛程式編輯器對話框。
- 從標籤底端的清單中,選取延伸。在此頁面中,您應該會看到與外掛程式專案相關聯的延伸。選取 com.ibm.carma.ui.parameterValidators 延伸點下面的 (parameterValidator) 選項。延伸元素詳細資料將在右側列出。
- 請使用本範例的「PDS RAM 範例」,因為在「第 1 課」建立的配置檔中,這是您要新增自訂動作及適當參數的目標 RAM。在 uniqueId 文字欄位中,輸入 com.ibm.carma.sample.PDSRAM。
- 開啟 CARMA 儲存庫視圖並連接至遠端系統。
- 展開包含您要使用之 RAM 的主機系統,用滑鼠右鍵按一下特定的 RAM,然後選取內容。
- 在開啟的 RAM 內容對話框中,您應該會看到唯一識別已列出。這是您在配置延伸點時將要使用的 uniqueId。
- 在類別文字欄位中,輸入包含程式碼之類別的名稱,該程式碼用於指定參數驗證的詳細資料。輸入類別名稱 com.ibm.carma.plugin.howto.action.ValueParamValidationAction。
您將稍後在本練習中建立此類別。
- 在 parameterId 文字欄位中,輸入套用參數驗證的 PDS RAM 中所定義的參數。針對本範例,請使用 value 參數,這是您在「第 1 課」中,於 PDS RAM 上定義且 parameterId 為 000 的參數。
- 最後,在 actionId 文字欄位中,輸入應套用參數驗證的 PDS RAM 上所定義的動作。針對本範例,請使用 HowTo 自訂動作,此動作是您在「第 1 課」中對 actionId 為 100 的 PDS RAM 定義的。
現在,您已配置了 parameterValidator 來驗證 PDS RAM HowTo 自訂動作上的 value 參數。