---
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


---

# UserCriteria - 범위 지정됨

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

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

UserCriteria API에는 스크립트를 사용하여 사용자 기준 기록을 생성, 수정 및 삭제하는 메서드가 있습니다.

범위가 지정된 애플리케이션에서 이 클래스를 사용하려면 `sn_uc` 네임스페이스 식별자를 사용하십시오. 이 API에 액세스하려면 사용자 기준 범위가 지정된 API 플러그인(ID: com.glideapp.user_criteria.scoped.api)을 활성화해야 합니다.

## 사용자 기준 - 사용자 기준() {#ariaid-title2}

UserCriteria 클래스의 인스턴스를 만듭니다.  

    var uc = new sn_uc.UserCriteria();

## UserCriteria - UserCriteria(문자열 sys_id) {#ariaid-title3}

지정된 sys_id을 사용하여 UserCriteria 클래스의 인스턴스를 만듭니다.
{#r_UCS-UserCriteria_S__table_dxz_fz2_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sys_id | 문자열 | 사용자 기준의 sys_id입니다. |
[표 1. 매개변수]

{#r_UCS-UserCriteria_S__table_dxz_fz2_vz}  

    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");

## UserCriteria - create(객체 columnValues, 부울 standardUpdate) {#ariaid-title4}

user_criteria 테이블에 지정된 값을 사용하여 사용자 기준을 만듭니다. columnValues에 지정된 값은 setter를 통해 제공된 값을 재정의합니다.
{#r_UCS-create_O_B__table_ncp_prf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| columnValues | 객체 | 열과 해당 값에 대한 키 및 값 쌍입니다. |
| 표준 업데이트 | 부울 | 엔진과 워크플로우를 실행할 수 있도록 하려면 예로 설정합니다. |
[표 2. 매개변수]

{#r_UCS-create_O_B__table_ncp_prf_vz} {#r_UCS-create_O_B__table_ocp_prf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 생성된 사용자 기준의 sys_id입니다. |
[표 3. 반환]

{#r_UCS-create_O_B__table_ocp_prf_vz}  

    var uc = new sn_uc.UserCriteria(); 
    uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
    uc.setActive(true); 
    uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89");
    var UserCriteriaId = uc.create();
    gs.info(UserCriteriaId);

출력:

    41bea3d53790200044e0bfc8bcbe5dec

## 사용자 기준 - deleteRecord() {#ariaid-title5}

현재 사용자 기준을 삭제합니다.
{#r_UCS-deleteRecord__table_erq_jlf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 4. 매개변수]

{#r_UCS-deleteRecord__table_erq_jlf_vz} {#r_UCS-deleteRecord__table_frq_jlf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | true이면 사용자 기준이 삭제됩니다. false인 경우 삭제할 사용자 기준을 찾을 수 없습니다. |
[표 5. 반환]

{#r_UCS-deleteRecord__table_frq_jlf_vz}  

    var uc = new sn_uc.UserCriteria("31bea3d53790200044e0bfc8bcbe5dec");
    uc.deleteRecord();

출력:

    true

## UserCriteria - 읽기(문자열 열) {#ariaid-title6}

카탈로그 항목의 속성 및 값 쌍에 대한 매핑을 표시합니다.
{#r_UCS-read_S__table_rnk_bpf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 열 | 문자열 | 카탈로그 항목 속성의 배열입니다. |
[표 6. 매개변수]

{#r_UCS-read_S__table_rnk_bpf_vz} {#r_UCS-read_S__table_snk_bpf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 카탈로그 항목의 속성 및 값 쌍에 대한 매핑입니다. |
[표 7. 반환]

{#r_UCS-read_S__table_snk_bpf_vz}  

    var uc = new sn_uc.UserCriteria("7b8a6927ef732100438236caa5c0fb89");
    var obj = uc.read(["company","name"]);
    gs.info(JSON.stringify(obj));

출력:

    Script: {"name":"All ACME Corporation employees","company":"e7c1f3d53790200044e0bfc8bcbe5deb,227cdfb03710200044e0bfc8bcbe5d6b,86c1f3193790200044e0bfc8bcbe5d95,98c37b193790200044e0bfc8bcbe5dbe,81f95197ac1d55eb35432fd1e068385e,df7d53303710200044e0bfc8bcbe5dac,81fdf9ebac1d55eb4cb89f136a082555,4b7d13f03710200044e0bfc8bcbe5db6,81f87336ac1d55eb06002def816d139f,81fbfe03ac1d55eb286d832de58ae1fd,81fca4cbac1d55eb355b4b6db0e3c80f,187d13f03710200044e0bfc8bcbe5df2,81fd65ecac1d55eb42a426568fc87a63,31bea3d53790200044e0bfc8bcbe5dec,81f75fcaac1d55eb2b0781d6f2c3c260"}

## UserCriteria - setActive(부울 활성) {#ariaid-title7}

사용자 기준이 활성 상태인지 여부를 지정합니다.
{#r_UCS-setActive_B__table_lc1_x3f_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 활성 | 부울 | true이면 사용자 기준이 활성 상태입니다. false인 경우 사용자 기준이 비활성 상태입니다. |
[표 8. 매개변수]

{#r_UCS-setActive_B__table_lc1_x3f_vz} {#r_UCS-setActive_B__table_mc1_x3f_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 9. 반환]

{#r_UCS-setActive_B__table_mc1_x3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setActive(true); 

## 사용자 기준 - setAdvanced(부울 고급) {#ariaid-title8}

사용자 기준에 고급 스크립트가 있는지 여부를 지정합니다.
{#r_UCS-setAdvanced_B__table_eps_xff_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 고급 | 부울 | 예일 경우 사용자 기준에 고급 스크립트가 포함됩니다. false인 경우 사용자 기준에 고급 스크립트가 없습니다. |
[표 10. 매개변수]

{#r_UCS-setAdvanced_B__table_eps_xff_vz} {#r_UCS-setAdvanced_B__table_fps_xff_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 11. 반환]

{#r_UCS-setAdvanced_B__table_fps_xff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setAdvanced(true); 

## UserCriteria - setCompanies(문자열 회사) {#ariaid-title9}

사용자 기준에 대한 회사 속성을 설정합니다.
{#r_UCS-setCompanies_S__table_qrr_gff_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 회사 | 문자열 | 사용자 기준에 대해 설정할 회사 sys_ids의 쉼표로 구분된 목록입니다. |
[표 12. 매개변수]

{#r_UCS-setCompanies_S__table_qrr_gff_vz} {#r_UCS-setCompanies_S__table_rrr_gff_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 13. 반환]

{#r_UCS-setCompanies_S__table_rrr_gff_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setCompanies("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setDepartments(문자열 부서) {#ariaid-title10}

사용자 기준에 대한 department 속성을 설정합니다.
{#r_UCS-setDepartments_S__table_k24_ddf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 부서 | 문자열 | 사용자 기준에 대해 설정할 부서sys_ids 쉼표로 구분된 목록입니다. |
[표 14. 매개변수]

{#r_UCS-setDepartments_S__table_k24_ddf_vz} {#r_UCS-setDepartments_S__table_l24_ddf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 15. 반환]

{#r_UCS-setDepartments_S__table_l24_ddf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setDepartments("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setGroups(String groups) {#ariaid-title11}

사용자 기준에 대한 그룹 속성을 설정합니다.
{#r_UCS-setGroups_S__table_zzq_j3f_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 그룹 | 문자열 | 사용자 기준에 대해 설정할 그룹 sys_ids의 쉼표로 구분된 목록입니다. |
[표 16. 매개변수]

{#r_UCS-setGroups_S__table_zzq_j3f_vz} {#r_UCS-setGroups_S__table_a1r_j3f_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 17. 반환]

{#r_UCS-setGroups_S__table_a1r_j3f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setGroups("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setLocations(문자열 위치) {#ariaid-title12}

사용자 기준에 대한 위치 속성을 설정합니다.
{#r_UCS-setLocations_S__table_hrs_42f_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 위치 | 문자열 | 사용자 기준에 대해 설정할 위치 sys_ids의 쉼표로 구분된 목록입니다. |
[표 18. 매개변수]

{#r_UCS-setLocations_S__table_hrs_42f_vz} {#r_UCS-setLocations_S__table_irs_42f_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 19. 반환]

{#r_UCS-setLocations_S__table_irs_42f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setLocations("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setMatchAll(부울 match_all) {#ariaid-title13}

사용자 기준에 대한 match_all 속성을 설정합니다.
{#r_UCS-setMatchAll_B__table_wvg_gkf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 | match_all | 예일 경우 사용자 기준에 대한 속성으로 설정된 모든 조건이 충족되어야 합니다. false인 경우 사용자 기준에 대한 속성으로 설정된 조건이 하나 이상 충족되어야 합니다. |
[표 20. 매개변수]

{#r_UCS-setMatchAll_B__table_wvg_gkf_vz} {#r_UCS-setMatchAll_B__table_xvg_gkf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 21. 반환]

{#r_UCS-setMatchAll_B__table_xvg_gkf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setMatchAll(true); 

## UserCriteria - setName(문자열 이름) {#ariaid-title14}

사용자 기준의 이름 속성을 설정합니다.
{#r_UCS-setName_S__table_qzy_vhf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 사용자 기준의 이름입니다. |
[표 22. 매개변수]

{#r_UCS-setName_S__table_qzy_vhf_vz} {#r_UCS-setName_S__table_rzy_vhf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 23. 반환]

{#r_UCS-setName_S__table_rzy_vhf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setName("Property1"); 

## UserCriteria - setRoles(String roles) {#ariaid-title15}

사용자 기준에 대한 역할 속성을 설정합니다.
{#r_UCS-setRoles_S__table_wxt_h1f_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 역할 | 문자열 | 사용자 기준에 대해 설정할 역할 sys_ids의 쉼표로 구분된 목록입니다. |
[표 24. 매개변수]

{#r_UCS-setRoles_S__table_wxt_h1f_vz} {#r_UCS-setRoles_S__table_xxt_h1f_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 25. 반환]

{#r_UCS-setRoles_S__table_xxt_h1f_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setRoles("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - setScript(문자열 스크립트) {#ariaid-title16}

사용자 기준에 대한 스크립트를 설정합니다.
{#r_UCS-setScript_S__table_elp_zgf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스크립트 | 문자열 | 고급 사용자 기준에 대해 설정할 스크립트입니다. |
[표 26. 매개변수]

{#r_UCS-setScript_S__table_elp_zgf_vz} {#r_UCS-setScript_S__table_flp_zgf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 27. 반환]

{#r_UCS-setScript_S__table_flp_zgf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setScript("function scriptTest() {
      var retVal;
      if (gs.getUser().getRecord().getDisplayValue('department') == 'Product Management') {
          retVal = true;
      } else {
          retVal = false;
      }
      return retVal;
    }"); 

## UserCriteria - setUsers(문자열 사용자) {#ariaid-title17}

사용자 기준에 대한 사용자 속성을 설정합니다.
{#r_UCS-setUsers_S__table_npm_qbf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 사용자 | 문자열 | 사용자 기준에 대해 설정할 사용자 sys_ids의 쉼표로 구분된 목록입니다. |
[표 28. 매개변수]

{#r_UCS-setUsers_S__table_npm_qbf_vz} {#r_UCS-setUsers_S__table_opm_qbf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 29. 반환]

{#r_UCS-setUsers_S__table_opm_qbf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.setUsers("31bea3d53790200044e0bfc8bcbe5dec,0c441abbc6112275000025157c651c89"); 

## UserCriteria - update(객체 columnValues, 문자열 이유) {#ariaid-title18}

현재 카탈로그 항목을 지정된 값으로 업데이트합니다.
{#r_UCS-update_O_S__table_nrg_fmf_vz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| columnValues | 객체 | 열 이름과 값 쌍에 대한 매핑입니다. |
| 이유 | 문자열 | 카탈로그 항목을 업데이트하는 이유입니다. |
[표 30. 매개변수]

{#r_UCS-update_O_S__table_nrg_fmf_vz} {#r_UCS-update_O_S__table_org_fmf_vz__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 생성된 사용자 기준의 sys_id 반환합니다. |
[표 31. 반환]

{#r_UCS-update_O_S__table_org_fmf_vz}  

    var uc = new sn_uc.UserCriteria();
    uc.update("name": "Updated name", "The existing name is not relevant. Setting a relevant name"); 

출력:

    31bea3d53790200044e0bfc8bcbe5dec