OnCallContactPrefTemplate - 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기4분
  • OnCallContactPrefTemplate 스크립트 포함은 에스컬레이션 집합에 연락처 기본 설정 템플릿을 적용하는 메서드를 제공합니다.

    에스컬레이션 프로세스에 대한 자세한 내용은 다음 문서를 참조하십시오 Defining On-Call Scheduling escalation process.

    이 스크립트 포함에는 com.snc.on_call_rotation(On-Call Scheduling 플러그인)이 필요합니다.

    OnCallContactPrefTemplate - OnCallContactPrefTemplate()

    OnCallContactPrefTemplate 개체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함

    이 예제에서는 OnCallContactPrefTemplate 개체를 인스턴스화합니다.

    var contactPrefTemp = new global.OnCallContactPrefTemplate();

    OnCallContactPrefTemplate - copyContactPreferences(String templateSysId, String escalationSetSysId)

    연락처 기본 설정 템플릿을 에스컬레이션 집합에 적용합니다.

    템플릿이 에스컬레이션 집합에 적용되면 교대조 연락처 기본 설정 [cmn_rota_contact_preference] 테이블에 연락 시도 기록이 생성됩니다.

    이 메서드를 호출하기 전에 deleteContactPreferenceAttempts() 메서드를 호출하여 기존 연락 시도 기록을 삭제합니다. 기존 기록이 먼저 삭제되지 않으면 이 메서드는 오류를 반환합니다.

    표 2. 매개변수
    이름 유형 설명
    templateSysId 문자열 당직 연락처 기본 설정 템플릿 [on_call_template_contact_preference] 테이블에 있는 연락처 기본 설정 템플릿의 Sys_id.
    에스컬레이션SetSysId 문자열 교대조 에스컬레이션 세트 [cmn_rota_escalation_set] 테이블에 있는 에스컬레이션 세트의 Sys_id입니다.
    표 3. 반환
    유형 설명
    객체
    오류 및 경고 메시지를 포함하는 객체입니다. 작업이 성공하면 이 객체는 비어 있습니다.
    주:
    오류가 발생하면 작업이 중지되고 템플릿이 적용되지 않습니다. 경고가 발생해도 작업이 계속되고 일부 기록은 계속 생성됩니다.
    {
      "error": "String", 
      "warning": "String" 
    }
    <Object>.오류 오류 메시지.
    가능한 값:
    • 연락처 기본 설정 템플릿 sys_id 올바르지 않습니다.
    • 에스컬레이션 세트 sys_id이 올바르지 않습니다.
    • 연락처 시도가 이미 있습니다.

    데이터 유형: 문자열

    <Object>.경고 경고 메시지.

    데이터 유형: 문자열

    이 예에서는 Service Desk – 기본 에스컬레이션 세트에 연락처 기본 설정 템플릿을 적용합니다. 오류나 경고가 없기 때문에 반환 개체가 비어 있습니다.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var templateSysId = "f8dac9ebeb5a6110249e8d835d522873";
    
    var contactPrefTemp = new global.OnCallContactPrefTemplate();
    
    // delete existing contact attempt records before applying the template
    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId); 
    
    var result = contactPrefTemp.copyContactPreferences(templateSysId, escSetSysId);
    gs.info(JSON.stringify(result));

    출력:

    {}

    OnCallContactPrefTemplate - deleteContactPreferenceAttempts(문자열 escalationSetSysId)

    에스컬레이션 세트와 관련된 모든 연락처 기본 설정을 삭제합니다.

    에스컬레이션 세트에 대한 모든 연락 시도 기록이 교대조 연락처 기본 설정[cmn_rota_contact_preference] 테이블에서 삭제됩니다.

    표 4. 매개변수
    이름 유형 설명
    에스컬레이션SetSysId 문자열 교대조 에스컬레이션 세트 [cmn_rota_escalation_set] 테이블에 있는 에스컬레이션 세트의 Sys_id입니다.
    표 5. 반환
    유형 설명
    안 함

    이 예에서는 Service Desk - 기본 에스컬레이션 세트와 관련된 모든 연락처 기본 설정을 삭제합니다.

    var escSetSysId = "a47ac1abeb5a6110249e8d835d5228aa";
    var contactPrefTemp = new global.OnCallContactPrefTemplate();
    
    contactPrefTemp.deleteContactPreferenceAttempts(escSetSysId);