24.3 新增自訂處理程式

自訂處理程式是在 DRA 中用於內容屬性以進行彼此的互動來完成工作流程任務，以及用於工作流程、內容或建立表單中的「載入和提交」自定。

內容自訂處理程式

內容自訂處理程式的一些範例，包括：

  • 查詢其他欄位的值

  • 更新欄位值

  • 切換欄位的唯讀狀態

  • 根據設定的變數顯示或隱藏欄位

表單載入處理程式

表單載入處理程式一般會執行初始化控制項。只會在表單初始載入時執行一次。如果是內容頁面，則會在向伺服器執行查詢以取得所選取物件的內容之前執行。

表單提交處理程式

表單提交處理程式可讓使用者執行一些驗證，並且在某些項目不正確時取消提交。

如需在 Web 主控台中使用自定處理程式和自訂的更詳細範例，請參考 DRA 文件頁面上產品自訂參考的「Web 主控台自訂」和「工作流程自訂」小節。

啟用自訂 JavaScript

基於安全性原因，依預設會停用自訂 JavaScript。啟用自定 JavaScript 會允許管理員寫入 JavaScript 程式碼的小程式，而 Web 主控台將會依原樣執行。您應該僅在瞭解並接受風險時才啟用此例外。

若要啟用自訂以包含自訂 JavaScript 程式碼：

  1. 導覽至 C:\ProgramData\NetIQ\DRARESTProxy 位置。

  2. 開啟 restProxy.config 檔案。

  3. 將 allowCustomJavaScript="true" 新增至 <consoleConfiguration> 元素。

24.3.1 建立自訂處理程式的基本步驟：

下列步驟是從預先選取的自訂處理程式頁面開始。若要進行到這點，您需要透過內容欄位上的內容圖示來存取物件內容自訂處理程式。您會透過所選取「工作流程」表單上的表單內容按鈕、「建立物件」頁面或「編輯內容」頁面來存取表單載入和表單提交處理程式。

  1. 根據您要自訂的內容或頁面，選取適當的處理程式索引標籤：

    • 自訂處理程式

    • 表單載入處理程式

    • 表單提交處理程式

  2. 啟用處理程式頁面，並執行下列其中一項：

    • 內容欄位自訂處理程式：

      1. 選取執行時間。一般而言，您會使用執行時間的第二或第三個選項。

      2. 按一下 「+ 新增」，並從新增自訂處理程式功能表選擇自訂處理程式。

    • 表單處理程式：按一下 「+ 新增」，並從新增自訂處理程式功能表選擇自定處理程式。

    附註：您一般只需要一個自訂處理程式，但您可以使用多於一個處理程式。多個處理程式會以所列順序循序執行。如果要變更處理程式的順序或略過某個不需要的處理程式，您可以在程序檔中新增流程控制項巨集。

  3. 您將需要設定 新增至頁面的每個自訂處理程式。。組態選項可能因處理程式類型而不同。

    您可以建立您自己的處理程式類型。

    • LDAP 或 REST 查詢處理程式：

      1. 如果您希望查詢是基於靜態值，請定義連線資訊和查詢參數。

        如果您希望您的查詢是動態的，請在必要欄位中輸入預留位置值。這是執行處理程式的必要項目。程序檔將會置換預留位置值。

        附註：您也可以設定 REST 查詢的標題及 Cookie。

      2. 在「查詢前動作」中，使用程序檔編輯器來編寫將在提交查詢之前執行的自訂 JavaScript 程式碼。此程序檔可存取所有連接資訊和查詢參數，並且可修改任一項來自訂查詢。例如，根據使用者在表單中輸入的值設定查詢參數。

      3. 在「查詢後動作」中，包含程序檔來處理查詢的結果。通用任務包括檢查錯誤、根據傳回的結果更新表單值，以及根據查詢傳回的物件數量驗證物件的獨特性。

    • 程序檔: 插入自訂 JavaScript 程式碼以建置程序檔。

    • DRA 查詢： 在「查詢參數」索引標籤中指定 JSON 承載。承載格式必須符合將傳送至 DRA 伺服器的 VarSet 機碼或值組。類似於 REST 和 LDAP 查詢，您可以指定可用來在提交至伺服器之前修改承載的「查詢前動作」，以及可處理結果的「查詢後動作」。

    • 訊息方塊處理程式： 定義訊息方塊本身的內容之後，您也可以針對顯示前動作和關閉後動作編寫 JavaScript 區段。

      這些動作為選擇性。「顯示前」可用來在向使用者顯示之前自訂任何訊息方塊內容，而「關閉後」動作則是用來處理使用者的按鈕選項，並根據其來執行任何額外的邏輯。

  4. 按一下「確定」來儲存處理程式。

如需在 Web 主控台中使用自訂處理程式和自定的更詳細範例，請參考 DRA 文件頁面上產品自訂參考的「Web 主控台自定」和「工作流程自定」小節。