GSU_CQXE_SubmitRecord API를 사용하여 미리 채워진 양식 열기

설명

후크의 미리 채워진 양식을 열려면 GSU_CQXE_SubmitRecord 글로벌 스크립트 유틸리티를 사용하십시오. 이 API는 GSU_CQXE_OpenSubmitForm 후크와 같은 기능을 제공하지만 데이터베이스 ID를 요청하는 API에 대한 임시 오브젝트를 작성하지 않기 때문에 성능이 더 좋습니다.

GSU_CQXE_SubmitRecord 글로벌 후크 함수를 사용하려면 이 글로벌 후크 코드를 사용하여 스키마를 업데이트하는 GlobalScriptUtility(GSU_CQXE) 패키지를 적용해야 합니다. 글로벌 후크 코드를 다운로드하는 방법에 대한 지시사항은 패키지 적용을 참조하십시오.

이 기능은 Eclipse 및 웹용 ClearQuest 클라이언트 버전 7.1.2 이상에서 사용할 수 있습니다. 사용자가 기존 버전의 클라이언트나 Windows용 ClearQuest 클라이언트에서 양식을 열려고 시도하면 정보 메시지가 리턴됩니다. 이 메시지를 사용자에게 표시하려면 die 함수를 호출하십시오.

클라이언트에서 이 기능을 지원하는 경우에는 예외가 발생하면서 API 호출 이후의 코드가 실행되지 않습니다. 스크립트의 콜백 후크를 사용하여 API 호출 이후의 추가 코드를 실행하십시오.

주: 미리 채워진 양식을 여는 방법을 보여 주는 코드 샘플은 미리 채워진 양식 열기를 참조하십시오.

구문

Perl

GSU_CQXE_SubmitRecord($session, $rcdType, $saveCallback, $cancelCallback, $fieldNameRef, $fieldValueRef)
ID
설명
$session
현재 ClearQuest 세션입니다.
$rcdType
열려는 레코드 유형입니다.
$saveCallback
원본 레코드에 첨부된 레코드 스크립트입니다. 이 스크립트는 제출 양식이 저장될 때 실행됩니다. 원하는 콜백이 없으면 비어 있는 값("")을 지정하십시오.
$cancelCallback
원본 레코드에 첨부된 레코드 스크립트입니다. 이 스크립트는 제출 양식이 취소될 때 실행됩니다. 원하는 콜백이 없으면 비어 있는 값("")을 지정하십시오.
$fieldNameRef
ClearQuest 양식에 미리 채워질 필드의 이름이 포함된 배열에 대한 참조입니다. 필드는 이 목록에 지정된 순서대로 설정됩니다. 종속자 선택사항 목록 필드가 있는 경우에는 유효성 검증을 위해 순서가 중요합니다.
$fieldValueRef:
ClearQuest 양식을 채우는 데 사용된 값이 들어 있는 배열에 대한 참조입니다. 값의 길이는 $fieldNameArrayRef와 같아야 하며, 그렇지 않으면 오류 문자열이 리턴됩니다.

Perl 예제

sub Defect_SubmitChild {
    my($result);
    my($param) = @_;
    # record type name is Defect
    
    $session= $entity->GetSession();	
    my $id = $entity->GetFieldStringValue("id");   
    my $headline = $entity->GetFieldStringValue("Headline");

    my $fieldName = ["parent", "Headline"];
    my $fieldValue = [$id, $headline];
    $returnValue = GSU_CQXE_SubmitRecord($session, "Defect", "", "", $fieldName, $fieldValue);

    return $result;
}

피드백