이
섹션에는 후크를 작성할 수 있는 기본 빌딩 블록이 나열됩니다. 각 API 호출은 먼저
VBScript로 표시되고 그 다음에 Perl로 표시됩니다. 구문은 <object.><method> 형식을 사용합니다.
Perl에서는 현재 Entity 오브젝트와
Session 오브젝트가 entity 및 session(소문자)으로 사전 정의됩니다.
VBScript의 경우 현재 Entity 오브젝트를 가정하므로
해당 메소드를 호출할 때 명시적으로 식별하지 않아도 됩니다.
자세한 정보는 IBM Rational ClearQuest API 참조서를 참조하십시오.
- API 호출(VBScript/Perl)
- 함수
- [entity.]GetSession $entity->GetSession
- 다른 많은 API를 호출하는 데 필요한 세션을 가져옵니다.
- session.OutputDebugString $session->OutputDebugString
- 후크 코드 또는 외부 애플리케이션을 디버그하는
데 사용할 수 있는 디버그 스트림 정보에 출력합니다.
- session.GetEntity $session->GetEntity
- 데이터베이스에서 레코드를 검색합니다.
- session.EditEntity $session->EditEntity
- 데이터베이스에서 검색한 레코드를 편집합니다.
- [entity.]SetFieldValue $entity->SetFieldValue
- 값을 필드에 지정합니다.
- [entity.]Validate $entity->Validate
- 데이터베이스에 레코드를 저장하기 전에 레코드의 데이터가 올바른지
확인하십시오.
- [entity.]Commit $entity->Commit
- 편집을 포함하여 레코드를 데이터베이스에 확약합니다.
- [entity.]Revert $entity->Revert
- 변경을 취소합니다. 유효성 검증이 실패하여 확약되지 않은 레코드의 경우
사용할 수 있는 유용한 방법입니다.
- [entity.]GetFieldValue $entity->GetFieldValue
- 지정된 필드에 대한 필드 정보 오브젝트를 검색합니다.
- FieldInfo.GetValue $FieldInfo->GetValue
- 필드의 값을 검색합니다.
- session.BuildQuery $session->BuildQuery
- 조회를 빌드합니다.
- QueryDef.BuildField $QueryDef->BuildField
- 조회 결과 설정에 필드를 포함합니다.
- QueryDef.BuildFilterOperator QueryFilterNode.BuildFilterOperator $QueryDef->BuildFilterOperator
$QueryFilterNode->BuildFilter Operator
- "equal to" 또는 "greater than"과 같은 조회 필터 연산자를 빌드합니다.
- QueryFilterNode.BuildFilter $QueryFilterNode->BuildFilter
- 복잡한 조회에 대한 지원을 작성합니다.
- session.BuildResultSet $session->BuildResultSet
- 조회를 실행하는 데 필요한 ResultSet 오브젝트를 작성합니다.
- ResultSet.Execute $ResultSet->Execute
- 현재 ResultSet 오브젝트를 사용하여 조회를 실행합니다.
- ResultSet.MoveNext $ResultSet->MoveNext
- 데이터 세트의 다음 레코드로 커서를 이동합니다.
- ResultSet.GetColumnValue $ResultSet->GetColumnValue
- 현재 행에서 지정하는 열의 값을 검색합니다.
- session.GetUserLoginName $session->GetUserLoginName
- 사용자 로그인 ID를 가져옵니다.
- entity.Revert $entity->Revert
- Entity 오브젝트의 모든 변경사항을 버립니다. 후크에서 현재 조치를 중단하기 위해
되돌리기 API를 사용하지 마십시오. 이 API는
후크 또는 스크립트에서 명시적으로 시작된 조치만 되돌립니다. 현재 조치를 중단해야 하는 경우,
스크립팅 언어의 예외 메커니즘을 사용하여 예외를 발행하거나 조치-유효성 검증 후크가 "false"를 리턴하도록 설정하십시오.