記錄 Script

此主題解釋了 ClearQuest 記錄 Script 的概念。

記錄 Script 是一般形式的連結鉤,是為了回應表單上的事件而呼叫,或從其他連結鉤呼叫的。 您可以撰寫 Script,在記錄的環境定義中執行自訂行為。 Script 會在目前選取的記錄的環境定義中執行。 記錄 Script 子常式是一個記錄類型特有的。

一般而言,記錄 Script 是用來實作動作,執行此動作是為了回應與表單上特定欄位相關聯的按鈕或快速功能表項目的按一下事件。 例如,記錄 Script 可將關於現行記錄的資料傳送至另一個系統。

您可以用三種方式來執行記錄 Script:

下列範例顯示 Visual Basic 記錄 script 語法:

 Function RecordName_HookName(param) 
   ' param As Variant 
   ' RecordName_HookName As Variant 
   ' ...
 End Function 
 

從另一個連結鉤呼叫記錄 Script 時,您傳遞至連結鉤的參數是包含適當資料的變式。 如果連結鉤將資訊傳回至呼叫端連結鉤,請以變式傳回該資訊。

與表單控制項相關聯之後,傳遞至該方法的參數包含 EventObject 類別的實例。此實例包含造成呼叫連結鉤的事件的相關資訊。 (請參閱表單控制項事件。)當記錄 Script 與表單控制項相關聯時,Rational ClearQuest 軟體不預期來自記錄 Script 的回覆值。 來自記錄連結鉤的非空值回覆值會解譯為一項錯誤,Rational ClearQuest 用戶端可在訊息框中檢視此值。

記錄 Script 可與按鈕、文字欄位和清單相關聯。 與按鈕相關聯時,按一下該按鈕會導致連結鉤執行。 與文字欄位和清單相關控制項相關聯時,連結鉤會新增至控制項的快速功能表中。

您也可以使記錄 Script 與動作相關聯,該動作的類型為 RECORD_SCRIPT_ALIAS。此關聯容許您將自訂按鈕放在 Rational ClearQuest 表單的「動作」功能表上。

如需詳細資訊,請參閱:

Rational ClearQuest Web 上使用記錄 Script

Rational ClearQuest Web 查看按鈕所呼叫的記錄 Script 的回覆值。如果回覆值是字串,會視同錯誤訊息,且連結鉤失敗。

如果您未明確設定記錄 Script 函數的回覆值,它會傳回指出成功執行連結鉤的空值或空白值。

若要啟用 Web 的記錄連結鉤,請選取控制內容表的延伸事項標籤上的為 Web 啟用

Rational ClearQuest Web 中,記錄連結鉤是在 Rational ClearQuest Web 伺服器上執行。基於此原因,請勿呼叫會造成視窗開啟的 Windows 常式;視窗會在伺服器上而非用戶端上開啟。 當 Rational ClearQuest Web 伺服器啟動伺服器階段作業時,會設定 Session.NameValue 物件 CQ_WEB_SESSION,使 Script 可由 Web 啟用。

表單控制項事件

當記錄 Script 由表單控制項觸發時,Rational ClearQuest 軟體會將 EventObject 物件傳遞給記錄 Script 作為其參數。此物件包含所發生的事件類型的相關資訊。 不同控制項可產生不同類型的事件,包括按一下按鈕、項目選擇等等。 您必須使用 EventObject 物件的資訊來決定如何處理事件。

會對表單控制項產生下列類型的事件:

下表列出對每一個控制項支援的事件類型和 EventObject 提供的額外資訊。支援的事件類型直欄之下列出的常數是 EventType 列舉類型的一部分。

控制項類型 支援的事件類型 其他資訊
按鈕 AD_BUTTON_CLICK 按鈕名稱
組合框 AD_CONTEXMENU_ITEM_SELECTION 空值字串
下拉清單框 AD_CONTEXMENU_ITEM_SELECTION 空值字串
清單框 AD_CONTEXMENU_ITEM_SELECTION 現行欄位值選擇
清單視圖 AD_CONTEXMENU_ITEM_SELECTION 現行欄位值選擇
文字框 AD_CONTEXMENU_ITEM_SELECTION 現行欄位值選擇
下拉組合框 AD_CONTEXMENU_ITEM_SELECTION 空值字串

意見