스크립팅된 감사 생성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 9분

    • 스크립팅된 감사는 조건이 스크립트로 정의되는 감사입니다.

    프로시저

    1. 다음으로 이동 모두 > 준수 > 스크립트된 감사 > 감사.

      감사 유형이 스크립팅됨 으로 목록을 필터링합니다.

    2. 새로 만들기를 클릭합니다.
    3. 양식을 작성합니다(표 참조).
    4. 감사 스크립트를 생성합니다.

      이 스크립트 실행 필드에는 감사를 수행하고 후속 작업을 생성하기 위한 지침이 포함된 샘플 스크립트가 포함되어 있습니다. 이 필드는 스크립팅된 감사 모듈에서 감사에 액세스할 때만 나타납니다.

    5. 제출을 클릭합니다.

      샘플 스크립트:

      /*
/////////////////////////////////////////////////////
/// This script works with Data Center Zones filter //
/////////////////////////////////////////////////////
 
var desiredFloorSpaceUsage = 30;		// Value to audit against
var assignToUser = '46d44a23a9fe19810012d100cca80666';	 // Beth Anglin
var assignToGroup = '8a5055c9c61122780043563ef53438e3';	// Hardware group
var taskMsg = 'See the audit results below for the discrepancies that must be addressed';
 
// API call to retrieve records based on the filter
var gr = new SNC.CertificationProcessing().getFilterRecords(current.filter);
 
// Loop over all records defined by the filter
while(gr.next()) {
	var sysId = gr.getValue('sys_id');	// Sys ID of audited record
	var floorSpaceInUse = gr.getValue('floor_space_in_use');	// Value to audit
 
	// Determine if certification condition passes or fails
	if (floorSpaceInUse < desiredFloorSpaceUsage) {
		var columnNameSpace = gr.floor_space_in_use.getLabel();	// String value of column audited against
 
		// Call create Follow on Task API and save the returned sys_id for use in logging audit result fail
		// Params: 
		// auditId - Sys id of the audit record executed
		// ciId Sys - id of the configuration item.  Empty string if not a cmdb ci
		// assignedTo - Sys id of user to assign task to.  Can be empty
		// assignmentGroup - Sys id of group to assign task to.  Can be empty
		// shortDescr - Short description for the Follow On Task.  Can be empty
		// Return value: Sys id of the created follow on task
		var followOnTask = new SNC.CertificationProcessing().createFollowOnTask(current.sys_id, sysId, assignToUser, '', taskMsg);
 
		// Call log failed result API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// followOnTask - Sys id of the follow on task associated with the audited record(@see auditedRecordId). Can be empty
		// columnDisplayName - Label of the column audited(ex. Disk space (GB)).  Can be empty
		// operatorLabel - Label of the operator used to audit the column(ex. is not empty, greater than). Can be empty
		// desiredValue - Desired value of the column.  Can be empty
		// discrepancyValue - Discrepancy value.  Can be empty
		// isCI - True, if audited record is a CI. False, otherwise.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty
		new SNC.CertificationProcessing().logAuditResultFail(current.sys_id, sysId, followOnTask, columnNameSpace, 'greater than', desiredFloorSpaceUsage, floorSpaceInUse, true);
	} else { // If certification condition pass, write a Audit Result Pass via API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// isCI - True, if audited record is a CI. False, otherwise.  Can be empty.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty.
		new SNC.CertificationProcessing().logAuditResultPass(current.sys_id, sysId, true);
	}
}
*/
      표 1. 새 스크립팅된 감사 테이블
      필드 설명
      이름 이 감사의 이름입니다.
      필터 감사 유형이 스크립팅됨일 때 사용할 필터입니다. 이 필드는 스크립트된 감사에는 필수이지만 다른 모든 감사 유형에는 숨겨집니다.
      템플릿 [필수] 이 감사가 실행될 때 사용할 템플릿입니다. 감사 유형은 사용 가능한 템플릿 목록을 필터링하며 템플릿의 활성 버전만 선택할 수 있습니다. 감사 유형이 스크립팅되면 이 필드가 숨겨집니다.
      테이블 [읽기 전용] 템플릿의 테이블을 표시합니다.
      작업 작성 선택되면 불일치를 수정하기 위한 후속 작업을 생성합니다. 스크립팅된 감사에서 예를 사용하여 작업을 생성하거나 작업이 생성되지 않은 경우 false를 사용하여 작업 상태에 대한 논리를 만들 수 있습니다. 기본적으로 새 감사 기록에서는 이 확인란이 선택이 취소됩니다(false).
      할당 유형
      감사에서 후속 작업을 할당하는 방법을 선택하는 선택 목록입니다. 이 필드는 작업 생성 확인란을 선택한 경우에만 표시됩니다. 선택 항목은 다음과 같습니다.
      • 사용자 필드: 감사 중인 테이블에서 사용자 참조 필드를 선택합니다. 예를 들어, 실패한 기록의 관리자 필드에 이름이 지정된 사용자를 선택하여 작업을 수행합니다. 이 항목을 선택하면 할당 대상 및 할당 대상의 빈 필드가 표시됩니다. 기록의 참조 필드가 비어 있으면 할당 대상 빈 필드의 값이 사용됩니다.
      • 특정 사용자: 작업을 수행할 특정 사용자를 선택합니다. 이 선택에 사용자 필드가 표시됩니다.
      • 그룹 필드: 감사 중인 테이블에서 그룹 참조 필드를 선택합니다. 예를 들어, 실패한 기록에서 지원 그룹을 선택하여 작업을 수행합니다. 이 선택 항목은 그룹에 할당 및 빈 필드에 할당을 표시합니다. 실패한 기록의 참조 필드에 있는 그룹의 모든 구성원이 작업에 할당됩니다. 기록의 참조 필드가 비어 있으면 할당 대상 빈 필드의 값이 사용됩니다.
      • 특정 그룹: 작업을 수행할 특정 그룹을 선택합니다. 이 선택항목에 그룹 필드가 표시됩니다. 선택한 그룹의 모든 구성원이 작업에 할당됩니다.
      사용자
      이 감사가 후속 작업에 할당하는 특정 사용자입니다. 이 필드는 다음 조건에서 사용할 수 있습니다.
      • 할당 유형이 특정 사용자로 설정됩니다.
      • 빈 값에 할당은 할당된 작업 생성으로 설정되고, 할당 유형은 사용자 필드로 설정됩니다.
      주:
      지정된 사용자에게 인증 역할이 있는지 확인합니다.
      그룹에 할당 이 감사가 후속 작업에 할당하는 그룹을 정의하는 그룹 필드입니다. 이 필드는 할당 유형이 그룹 필드인 경우에만 사용할 수 있습니다.
      그룹 이 감사가 후속 작업에 할당하는 특정 그룹입니다. 이 필드는 할당 유형이 특정 그룹이고 그룹 필드를 할당 유형으로 선택한 경우에만 사용할 수 있습니다.
      담당자 이 감사에서 후속 작업에 할당하는 사용자를 정의하는 사용자 필드입니다. 이 필드는 할당 유형이 사용자 필드인 경우에만 사용할 수 있습니다.
      빈 값에 할당
      할당 대상 또는 그룹에 할당에서 선택한 필드가 감사 중인 기록에서 비어 있을 경우 사용할 동작입니다. 예를 들어, 관리자에게 후속 작업을 할당해야 하지만 관리자가 식별되지 않은 경우 이 필드의 값에 따라 수행되는 작업이 결정됩니다. 이 필드는 할당 유형이 사용자 필드 또는 그룹 필드인 경우에만 나타납니다. 가능한 선택 항목은 다음과 같습니다.
      • 작업을 만들지 않음: 할당 대상 또는 그룹에 할당 필드가 비어 있으면 후속 작업이 생성되지 않습니다.
      • 할당되지 않은 작업 생성: 후속 작업을 생성하지만 사용자나 그룹에 할당하지 마십시오. 작업은 나중에 수동으로 할당할 수 있습니다.
      • 할당된 작업 작성: 후속 작업을 작성하여 지정된 사용자 또는 그룹에 할당합니다. 사용자 필드의 할당 유형을 선택한 경우, 사용자 필드를 사용할 수 있게 됩니다. 그룹 필드 유형을 선택한 경우 그룹 필드를 사용할 수 있게 됩니다.

      감사는 '빈 값에 할당'으로 어떤 선택을 하든 상관없이 '할당 대상'이 채워진 모든 기록에 대한 후속 작업을 자동으로 생성합니다.
      간단한 설명 감사의 목적에 대한 간략한 설명입니다.
      작업 설명 이 감사에서 만든 후속 작업에 필요한 작업에 대한 일반 설명입니다. 이 감사에서 생성된 모든 후속 작업은 이 설명을 상속합니다.
      활성 이 감사 일정을 활성화하고 예약된 날짜 및 시간에 후속 작업을 생성합니다. 양식에서 일정 필드를 숨기고(마지막 실행 날짜 제외) 후속 작업을 생성하지 않으려면 이 확인란의 선택을 취소합니다.
      실행 감사를 생성하는 일정을 실행하는 빈도입니다.
      • 매일
      • 주별
      • 매월
      • 주기적으로
      • 한 번
      • 요청 시
      일
      • 실행이 매주인 경우 감사가 실행되는 요일입니다.
      • 실행이 매월이면 감사가 실행되는 일입니다. 날짜가 29, 30 또는 31일 경우 짧은 달의 경우 감사는 그 달의 마지막 날에 실행됩니다.
      반복 간격 실행이 주기적으로인 경우 감사가 실행되는 빈도를 시간, 일 또는 둘 다로 입력합니다. 예를 들어 10일마다 오후 2:00에 감사를 실행하려면 일을 10으로, 시간을 14:00:00로 설정합니다.
      시작 중 실행이 주기적으로 또는 한 번인 경우 감사가 실행되는 날짜 및 시간입니다.
      시간 실행이 매일, 매주, 매월 또는 한 번인 경우 감사가 실행되는 24시간제 시간입니다.
      마지막 실행 날짜 [읽기 전용] 감사가 정규 일정에 따라 또는 수동으로 실행된 마지막 날짜 및 시간입니다. 감사 미리 보기에서는 이 필드가 업데이트되지 않습니다.
      다음으로 예약된 실행 [읽기 전용] 감사가 실행되는 다음 날짜 및 시간입니다. 일정을 변경하면 시스템에서 이 필드를 다시 계산합니다.
      감사 유형 [읽기 전용] 이 감사에 할당된 유형입니다. 시스템은 감사가 생성된 애플리케이션에 따라 감사 유형을 선택하며 다음과 같습니다.
      • 원하는 상태
      • 아키텍처 컴플라이언스
      • 준수
      • 스크립트됨
      이 스크립트 실행 실행할 감사 스크립트입니다. 이 필드는 감사 유형이 스크립팅된 경우에만 사용할 수 있습니다. 감사 양식에는 감사를 수행하고 후속 작업을 생성하기 위한 지침이 포함된 샘플 스크립트가 포함되어 있습니다. 제공된 메서드와 허용되는 매개변수 목록은 스크립트 메서드 를 참조하십시오.