레코드 스크립트

이 주제에서는 ClearQuest 레코드 스크립트의 개념을 설명합니다.

레코드 스크립트는 양식 또는 기타 후크의 이벤트에 대한 응답으로 호출되는 후크의 일반 양식입니다. 레코드 컨텍스트에 사용자 정의 동작을 수행하는 스크립트를 작성할 수 있습니다. 스크립트는 현재 선택한 레코드의 컨텍스트에서 실행됩니다. 레코드-스크립트 서브루틴은 하나의 레코드 유형에 고유합니다.

일반적으로, 레코드 스크립트는 누름 단추 또는 양식의 특정 필드와 연관된 컨텐스트 메뉴 항목에 대한 클릭 이벤트의 응답으로 수행할 수 있는 조치를 구현하는 데 사용됩니다. 예를 들어, 레코드 스크립트는 현재 레코드에 대한 데이터를 다른 시스템으로 보낼 수 있습니다.

세 가지 방법에서 레코드 스크립트를 실행할 수 있습니다.

다음 예제는 Visual Basic 레코드 스크립트 구문을 보여 줍니다.

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

다른 후크에서 레코드 스크립트를 호출하는 경우, 후크로 전달되는 매개변수는 해당 데이터를 포함하는 변형입니다. 후크가 호출 후크에 정보를 리턴하는 경우, 해당 정보를 변형으로 리턴하십시오.

양식 제어 도구와 연관될 경우, 메소드로 전달된 매개변수에는 EventObject 클래스 인스턴스가 포함되어 있습니다. 이 인스턴스에는 후크를 호출한 이벤트에 대한 정보가 포함됩니다(양식 제어 도구 이벤트 참조). Rational ClearQuest 소프트웨어는 해당 레코드 스크립트의 리턴값을 예상하지 않습니다. 레코드 후크에서 널(null)이 아닌 리턴값은 오류로 해석되며 Rational ClearQuest 클라이언트의 메시지 상자에 표시됩니다.

레코드 스크립트는 누름 단추, 텍스트 필드 및 목록과 연관될 수 있습니다. 단추와 연관되는 경우 해당 단추를 클릭하면 후크가 실행됩니다. 텍스트 필드 및 목록 관련 제어 도구와 연관되는 경우 후크는 제어 도구에 대한 컨텍스트 메뉴에 추가됩니다.

레코드 스크립트는 또한 RECORD_SCRIPT_ALIAS 유형의 조치와 연관될 수 있습니다. 이러한 조치와 연관되는 경우 Rational ClearQuest 양식의 조치 메뉴에 사용자 정의 단추를 배치할 수 있습니다.

자세한 정보는 다음을 참조하십시오.

Rational ClearQuest Web에서 레코드 스크립트 사용

Rational ClearQuest Web은 누름 단추로 호출되는 레코드 스크립트의 리턴값을 확인합니다. 리턴값이 문자열인 경우 오류 메시지로 간주되어 후크가 실행되지 않습니다.

레코드 스크립트 함수의 리턴값을 명시적으로 설정하지 않으면, 후크가 실행되었음을 표시하는 널(null) 또는 비어 있는 값이 리턴됩니다.

해당 웹에 레코드 후크를 사용하려면 제어 도구 특성 시트의 확장 탭에서 웹에 사용을 선택하십시오.

Rational ClearQuest Web에서 레코드 후크는 Rational ClearQuest Web 서버에서 실행됩니다. 따라서 창을 열리게 하는 Windows 루틴을 호출하면 안됩니다. 창은 웹 클라이언트가 아닌 서버에서 열립니다. Rational ClearQuest Web 서버는 서버 세션을 시작할 때 CQ_WEB_SESSION이라는 Session.NameValue 오브젝트를 설정함으로써 웹에서 사용자 스크립트를 사용할 수 있도록 합니다.

양식 제어 도구 이벤트

레코드 스크립트가 양식 제어 도구에 의해 트리거되면 Rational ClearQuest 소프트웨어가 EventObject 오브젝트를 해당 매개변수로서 레코드 스크립트에 전달합니다. 이 오브젝트에는 발생한 이벤트 유형에 대한 정보가 포함됩니다. 제어 도구에 따라 단추 클릭, 항목 선택 등과 같은 여러 가지 이벤트 유형을 생성할 수 있습니다. EventObject 오브젝트의 정보를 사용하여 이벤트 처리 방법을 결정해야 합니다.

양식 제어 도구에 대해 다음 유형의 이벤트를 생성합니다.

다음 표에는 각 제어 도구에 대해 지원되는 이벤트 유형과 EventObject가 제공하는 기타 정보가 표시됩니다. 지원되는 이벤트 유형 열에 나열된 상수는 EventType 열거 유형의 일부입니다.

제어 도구 유형 지원되는 이벤트 유형 자세한 정보
누름 단추 AD_BUTTON_CLICK 단추 이름
콤보 상자 AD_CONTEXMENU_ITEM_SELECTION 널(null) 문자열
드롭 다운 목록 상자 AD_CONTEXMENU_ITEM_SELECTION 널(null) 문자열
목록 상자 AD_CONTEXMENU_ITEM_SELECTION 현재 필드 값 선택
목록 보기 AD_CONTEXMENU_ITEM_SELECTION 현재 필드 값 선택
텍스트 상자 AD_CONTEXMENU_ITEM_SELECTION 현재 필드 값 선택
드롭 다운 콤보 상자 AD_CONTEXMENU_ITEM_SELECTION 널(null) 문자열

피드백