---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UniversalRequestUtilsSNC - 범위 지정됨

# UniversalRequestUtilsSNC - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

UniversalRequestUtilsSNC API를 사용하면 범용 요청 수명주기를 처리할 수 있습니다. 스크립트 포함 기록으로 제공됩니다.
이 API에는 (com.snc.universal_request) 플러그인이 범용 요청 필요하며 `sn_uni_req` 네임스페이스 내에서 제공됩니다.

자세한 내용은 [범용 요청을](https://www.servicenow.com/docs/access?context=ur-landing-limitedaccess&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오.

## UniversalRequestUtilsSNC - createUniversalRequest(Object copyFields) {#ariaid-title2}

범용 요청을 생성하고 새로 생성된 범용 요청 기록의 sys_id 반환합니다.
이 메서드는 `sn_uni_req` 네임스페이스의 UniversalRequestUtils 프로토타입을 사용하여 호출됩니다. 예를 들면 `sn_uni_req입니다. UniversalRequestUtils().createUniversalRequest(<copyFields>)`를 호출합니다.
{#URUS-createUniversalRequest_O__table_agv_xrd_gnb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| copy필드 | 객체 | 범용 요청 \[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](https://www.servicenow.com/docs/access?context=c_DataDictionaryTables&version=australia&pubname=australia-platform-administration&ft:locale=en-US). 주: 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 | 부울 | 옵션입니다. 범용 요청에서 접근이 제한되었는지 여부를 나타내는 플래그입니다. [범용 요청 역할 및 그룹을](https://www.servicenow.com/docs/access?context=ur-roles&version=australia&pubname=australia-employee-service-management&ft:locale=en-US) 참조하십시오. 유효한 값은 다음과 같습니다. * true: 범용 요청은 `sn_uni_req.sensitiveinfo_agent` 역할을 가진 사용자만 액세스할 수 있습니다. 이 역할의 사용자는 급여 상세 정보와 같은 중요한 정보를 볼 수 있는 권한이 있습니다. * false: 범용 요청 액세스가 제한되지 않습니다. {#URUS-createUniversalRequest_O__ul_ghk_csg_knb} 기본값: false |
| copyFields.short_description | 문자열 | 자원에 대한 간결한 설명입니다. 최대 길이: 160 |
[표 1. 매개변수]

{#URUS-createUniversalRequest_O__table_agv_xrd_gnb} {#URUS-createUniversalRequest_O__table_bgv_xrd_gnb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 새로 만든 범용 요청 기록의 Sys_id입니다. |
[표 2. 반환]

{#URUS-createUniversalRequest_O__table_bgv_xrd_gnb}  
다음 예는 새 범용 요청의 필드를 설정하는 방법을 보여줍니다. 이 사용 사례에서는 이 코드가 인바운드 이메일 작업 \[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;