OnCallContactPrefTemplate - 전역

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

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

이 API에는 com.snc.on_call_rotation(On-Call Scheduling) 플러그인이 필요합니다.

OnCallContactPrefTemplate - OnCallContactPrefTemplate()

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

표 1. 매개변수

이름	유형	설명
없음

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

var contactPrefTemp = new global.OnCallContactPrefTemplate();

OnCallContactPrefTemplate - copyContactPreferences(template SysId 문자열, 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);