결과 - 범위 지정, 전역

Findings API는 검사에서 인스턴스 스캔 결과를 생성하는 방법을 처리하기 위한 메서드를 제공합니다.

이 API는 (com.glide.instance_scan) 플러그인에 인스턴스 스캔 포함되어 있으며 sn_instance_scan 네임스페이스에서 실행됩니다. 자세한 내용은 Instance Scan 단원을 참조하십시오.

Instance Scan에서는 인스턴스의 스캔 범위 내에 있는 각 레코드에 대해 검사가 실행되어 결과를 생성합니다. 각 결과에는 문제 기록과 위반한 검사에 대한 정보가 들어 있습니다. 결과 메서드는 사용자에게 전달된 엔진 객체의 일부로 검사에 사용됩니다 인스턴스 스캔 . 검사 양식의 스크립트 필드에 코드를 추가합니다.

참고 항목:

• 검사 시작하기
• 정보

결과 - increment()

현재 찾기의 수를 늘립니다.

검색 결과 수는 검사가 스캔에서 분석하는 각 레코드에 대해 0부터 시작합니다. 호출되면 이 메서드는 찾기 횟수를 증가시킵니다. 개수는 현재 기록에 대한 발견 사항이 생성될 것임을 나타냅니다.

이 메서드는 여러 번 호출되어 이 발견 사항이 현재 기록에 검사 위반이 여러 번 발생한다는 것을 나타낼 수 있습니다.

표 1. 매개변수

이름	유형	설명
없음

표 2. 반환

유형	설명
없음

다음 예는 테이블 유형 검사에서 실패 상태의 레코드 수를 계산하는 방법을 보여줍니다. 자세한 내용은 테이블 유형 검사 생성을 참조하세요.

(function(engine) {
  if (current.getValue("state") == "failed") {
    engine.finding.increment();
  }
})(engine);

결과 - incrementWithNode(객체 노드)

현재 찾기가 linter 검사에서 나온 경우 이 메서드는 현재 찾기 수를 증가시키고 동시에 linter 노드 개체를 찾기에 전달합니다.

린터 검사 양식의 스크립트 필드에서 이 방법을 사용합니다. 이 방법은 현재 결과의 상세 정보 열에 있는 줄 번호와 같이 지정된 노드에 대한 정보를 저장합니다.

참고 항목:

• 고급 린터 검사 스크립트
• LinterCheckAst노드 API

표 3. 매개변수

이름	유형	설명
노드	객체	Linter 검사의 노드 객체입니다.

표 4. 반환

유형	설명
없음

다음 예는 linter 검사에서 linter 유형 노드를 증가시키는 방법을 보여줍니다. linter 검사 메서드 사용에 대한 자세한 내용은 LinterCheckAstNode API를 참조하세요.

(function(engine) {
  engine.rootNode.visit(function(node) {
    if (node.getTypeName() === "NAME" &&
        node.getNameIdentifier() === "soughtFunction" &&
        node.getParent().getTypeName() === "CALL") {
      engine.finding.incrementWithNode(node);
    } 
  });
})(engine);

결과 - setCurrentSource(GlideRecord 소스)

제공된 GlideRecord를 기반으로 현재 발견의 소스를 설정합니다.

스크립트만 검사의 스크립트 필드에 이 메서드를 사용합니다. 이 방법은 스캔 중에 소스를 현재 기록으로 자동 설정하기 때문에 다른 검사에는 사용되지 않습니다. 자세한 내용은 스크립트 전용 검사 만들기를 참조하세요.

표 5. 매개변수

이름	유형	설명
소스	GlideRecord	현재 찾은 결과에 대한 소스 기록으로 설정할 기록입니다. 이 값은 스캔 결과 [scan_finding] 테이블의 소스 필드에 참조로 추가됩니다.

표 6. 반환

유형	설명
없음

다음 예는 스크립트 전용 검사에서 현재 소스를 인시던트 기록으로 설정하는 방법을 보여줍니다. 자세한 내용은 스크립트 전용 검사 만들기를 참조하세요.

(function(engine) {
  var gr = new GlideRecord('incident');
  gr.get('2f99f330730210100a5310c92bf6a798');
  engine.finding.setCurrentSource(gr);
  engine.finding.increment();
})(engine);