UniversalRequestUtilsSNC - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • UniversalRequestUtilsSNC API를 사용하면 범용 요청 수명 주기를 처리할 수 있습니다. 스크립트 포함 기록으로 제공됩니다.

    이 API에는 (com.snc.universal_request) 플러그인이 필요하며 범용 요청sn_uni_req 네임스페이스 내에서 제공됩니다.

    자세한 내용은 범용 요청을 참조하십시오.

    UniversalRequestUtilsSNC - createUniversalRequest(객체 copyFields)

    범용 요청을 생성하고 새로 생성된 범용 요청 기록의 sys_id 반환합니다.

    이 메서드는 sn_uni_req 네임스페이스의 UniversalRequestUtils 프로토타입을 사용하여 호출됩니다. 예를 들어 sn_uni_req. UniversalRequestUtils().createUniversalRequest(<copyFields>)입니다.

    표 1. 매개변수
    이름 유형 설명
    copyFields 객체 범용 요청 [universal_request] 테이블의 새 기록에 설정할 필드 이름과 값을 포함하는 JSON 객체입니다.

    { '<field_name>': '<field_value>' } 형식으로 필드 이름 및 필드 값으로 상세 정보를 제공합니다. 다음 필드는 기본 티켓에 할당하는 데 가장 유용한 세부 정보로 간주됩니다.

    
{
  'assignment_group': 'String',
  'assigned_to': 'String',
  'contact_type': 'String',
  'description': 'String',
  'opened_by': 'String',
  'opened_for': 'String',
  'priority': 'String',
  'restricted': Boolean,
  'short_description': 'String'
};

    나열되지 않은 다른 필드는 사용 케이스에 적합할 수 있습니다. 시스템의 테이블 필드 및 관련 필드 목록은 를 Data dictionary tables참조하십시오.

    주:
    copyFields JSON 객체에 primary_ticket 또는 sys_id 필드를 포함하지 마십시오.
    copyFields.assignment_group 문자열 옵션입니다. 자원에 할당된 그룹의 Sys_id입니다.

    기본값: 기본 할당 그룹은 할당 규칙별로 설정됩니다.

    테이블: 그룹 [sys_user_group] 테이블
    copyFields.contact_type 문자열 옵션입니다. 자원이 처음 보고된 방법입니다.
    가능한 값:
    • 채팅
    • 이메일
    • 전화
    • 사회적인
    • 웹

    최대 길이: 40
    copyFields.description 문자열 옵션입니다. 자원과 관련된 문제에 대한 자세한 설명입니다.

    최대 길이: 4,000
    copyFields.opened_by 문자열 옵션입니다. 자원을 처음 시작한 사람의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다.
    copyFields.opened_for 문자열 옵션입니다. 케이스에 HR 서비스 제공 필요합니다. 자원이 열린 사용자의 sys_id입니다.
    copyFields.priority 문자열 옵션입니다. 자원의 우선순위입니다. 숫자로 지정됩니다.
    가능한 값:
    • 1: 중요
    • 2: 높음
    • 3: 보통
    • 4: 낮음

    기본값: 3
    copyFields.restricted 부울

    옵션입니다. 범용 요청에 접근이 제한되었는지 여부를 나타내는 플래그입니다. 범용 요청 역할 및 그룹을 참조하십시오.

    유효한 값은 다음과 같습니다.
    • true: 범용 요청은 sn_uni_req.sensitiveinfo_agent 역할을 가진 사용자만 액세스할 수 있습니다. 이 역할을 가진 사용자는 급여 세부 정보와 같은 중요한 정보를 볼 수 있는 권한이 있습니다.
    • false: 범용 요청 액세스에 제한이 없습니다.

    기본값: false
    copyFields.short_description 문자열 자원에 대한 간결한 설명입니다.

    최대 길이: 160
    표 2. 반환
    유형 설명
    문자열 새로 생성된 범용 요청 기록의 Sys_id입니다.

    다음 예제에서는 새 범용 요청에 필드를 설정하는 방법을 보여줍니다. 이 사용 사례에서 이 코드는 인바운드 이메일 작업 [sysevent_in_email_action] 범위가 지정된 HR 케이스 생성 스크립트의 시작 부분에 추가됩니다. 케이스가 HR에 적용되지 않는 경우 에이전트는 케이스를 적절한 부서로 이전할 수 있습니다.

    var copiedFields = {
  'opened_for': "<user_sys_id>",    
  'short_description': email.subject,
  'restricted': false,
  'priority': '1'
};

// createUniversalRequest() must be called to create the universal request prior to creating the child case

var ur = new sn_uni_req.UniversalRequestUtils().createUniversalRequest(copiedFields);
current.universal_request = ur;