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


---

# GlideURI - 전역

# GlideURI - 전역 {#ariaid-title1}

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

GlideURI API는 전역 애플리케이션에서 URI 매개변수를 처리하는 메서드를 제공합니다.  
주:  
익스포트 중 또는 백그라운드 작업에서 실행되는 스크립트에서 GlideURI API를 사용하지 마십시오.  
URI 사용에 대한 자세한 내용은 다음을 참조하십시오.

* [URL로 탐색](https://www.servicenow.com/docs/access?context=navigate-using-url&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)
* [탐색 스택](https://www.servicenow.com/docs/access?context=c_NavigationStack&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)
{#GlideURIGlobalAPI__ul_swn_bjb_rmb}

[작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")도 참조하십시오.

## GlideURI - deleteMatchingParameter(문자열 일치) {#ariaid-title2}

제공된 문자열의 시작과 일치하는 URI에서 하나 이상의 매개변수를 삭제합니다.
{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 일치 | 문자열 | URI의 쿼리 부분에서 제거할 하나 이상의 매개변수의 부분 이름입니다. |
[표 1. 매개변수]

{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 2. 반환]

{#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb}  
다음 예시에서는 제공된 이름과 부분적으로 일치하는 URI 매개변수를 삭제하는 방법을 보여줍니다.

    // create the GlideURI object
    var uri = action.getGlideURI();

    uri.deleteMatchingParameter('sysparm_list_');
    uri.deleteMatchingParameter('sysparm_record_');

### 범위가 지정된 해당 항목 {#GlideURI_deleteMatchingParameter_S__section_bct_nbs_mcb}

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

## GlideURI - deleteParameter(문자열 이름) {#ariaid-title3}

URI의 쿼리 부분에서 지정된 매개변수를 제거합니다.
{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | URI의 쿼리 부분에서 제거할 매개변수의 이름입니다. |
[표 3. 매개변수]

{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteParameter_S__table_wh4_ftg_rmb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 4. 반환]

{#GlideURI_deleteParameter_S__table_wh4_ftg_rmb}  
다음 예제는 URI 매개변수를 삭제하는 방법을 보여줍니다.

    // create the GlideURI object
    var uri = action.getGlideURI(); 

    uri.deleteParameter('sysparm_referring_url');

### 범위가 지정된 해당 항목 {#GlideURI_deleteParameter_S__section_bct_nbs_mcb}

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

## GlideURI - get(문자열 이름) {#ariaid-title4}

지정된 매개변수의 값을 반환합니다.
{#GlideURI_get_S__table_bff_yp3_ks__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 매개변수 이름입니다. |
[표 5. 매개변수]

{#GlideURI_get_S__table_bff_yp3_ks} {#GlideURI_get_S__table_cff_yp3_ks__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 매개변수의 값입니다. |
[표 6. 반환]

{#GlideURI_get_S__table_cff_yp3_ks}  

    // create the GlideURI object
    var uri = action.getGlideURI();
    uri.set('sysparm_query', 'priority=2^active=true' );
    var fileString = uri.get('sysparm_query');
    gs.info(fileString);

출력:

    priority=2^active=true

### 범위가 지정된 해당 항목 {#GlideURI_get_S__section_q2n_wgs_mcb}

범위가 지정된 애플리케이션에서 get() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [GlideURI - get(String name)](https://servicenow-prod.fluidtopics.net/w_fwK29n5qQh~LclVRADew#r_ScopedGlideURIGet_String "지정된 매개변수의 값을 반환합니다.") 을 사용합니다.

## GlideURI - getFileFromPath() {#ariaid-title5}

URI의 파일 이름 부분을 반환합니다.
{#GlideURI_getFileFromPath__table_nzz_gs3_ks__entry__3}

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

{#GlideURI_getFileFromPath__table_nzz_gs3_ks} {#GlideURI_getFileFromPath__table_ozz_gs3_ks__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | URI의 파일 이름 부분입니다. |
[표 8. 반환]

{#GlideURI_getFileFromPath__table_ozz_gs3_ks}  

    var gURI = action.getGlideURI();
            
    var fileString = gURI.getFileFromPath();
    gs.info(fileString);

### 범위가 지정된 해당 항목 {#GlideURI_getFileFromPath__section_q2n_wgs_mcb}

범위가 지정된 애플리케이션에서 getFileFromPath() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [GlideURI - getFileFromPath()](https://servicenow-prod.fluidtopics.net/w_fwK29n5qQh~LclVRADew#r_ScopedGlideURIGetFileFromPath "URI의 파일 이름 부분을 반환합니다.") 를 사용합니다.

## GlideURI - getMap() {#ariaid-title6}

쿼리의 각 매개변수와 관련 값을 포함하는 맵(키 값 쌍)을 반환합니다.
{#GlideURI_getMap__table_g2b_b5g_rmb__entry__3}

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

{#GlideURI_getMap__table_g2b_b5g_rmb} {#GlideURI_getMap__table_h2b_b5g_rmb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 |   |
[표 10. 반환]

{#GlideURI_getMap__table_h2b_b5g_rmb}  
다음 예시에서는 `sysparm_query` 매개변수를 가져오는 방법을 보여줍니다. [작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")도 참조하십시오.

    gs.action.getGlideURI().getMap().get('sysparm_query');

### 범위가 지정된 해당 항목 {#GlideURI_getMap__section_bct_nbs_mcb}

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

## GlideURI - set(문자열 이름, 문자열 값) {#ariaid-title7}

지정된 매개변수를 지정된 값으로 설정합니다.
{#GlideURI_set_S_S__table_z2w_tq3_ks__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 매개변수 이름입니다. |
| 값 | 문자열 | 값입니다. |
[표 11. 매개변수]

{#GlideURI_set_S_S__table_z2w_tq3_ks} {#GlideURI_set_S_S__table_afw_tq3_ks__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 12. 반환]

{#GlideURI_set_S_S__table_afw_tq3_ks}  
다음 예는 sysparm_query 필드의 값을 설정하는 방법을 보여줍니다. [작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")도 참조하십시오.

    var gURI = action.getGlideURI();
    gURI.set('sysparm_query', 'priority=2^active=true' );
    var fileString = gURI.get('sysparm_query');
    gs.info(fileString);

출력:

    priority=2^active=true

### 범위가 지정된 해당 항목 {#GlideURI_set_S_S__section_q2n_wgs_mcb}

범위가 지정된 애플리케이션에서 set() 메서드를 사용하려면 해당하는 범위가 지정된 메서드인 [GlideURI - set(String name, String value)](https://servicenow-prod.fluidtopics.net/w_fwK29n5qQh~LclVRADew#r_ScopedGlideURISet_String_String "지정된 매개변수를 지정된 값으로 설정합니다.") 을 사용합니다.

## GlideURI - setView(문자열 뷰) {#ariaid-title8}

명명된 뷰가 있는 쿼리에 매개변수를 추가합니다 sysparm_view .
뷰는 사용자가 양식이나 목록을 열 때 나타나는 요소를 정의합니다. 매개변수는 sysparm_view 목록 또는 양식에 사용할 뷰를 지정합니다. 뷰에 대한 자세한 내용은 [뷰 관리를](https://www.servicenow.com/docs/access?context=view-management-overview&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 참조하십시오.  
참조 :

* [작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")
* [GlideModalV3 - switchView()](https://servicenow-prod.fluidtopics.net/qjZHeDiv75a0KJfrp1gXxw#r_GMODV3-switchView_S "뷰를 변경하고 모달을 다시 로드합니다.")
{#GlideURI_setView_S__ul_bll_frk_smb}
{#GlideURI_setView_S__table_tgr_g5g_rmb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 뷰 | 문자열 | URI 쿼리에서 설정할 매개변수의 sysparm_view 이름입니다. |
[표 13. 매개변수]

{#GlideURI_setView_S__table_tgr_g5g_rmb} {#GlideURI_setView_S__table_ugr_g5g_rmb__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 14. 반환]

{#GlideURI_setView_S__table_ugr_g5g_rmb}  
다음 예시에서는 인시던트 \[incident\] 테이블의 URI 쿼리에 중요 인시던트 뷰를 추가하는 방법을 보여줍니다. 예를 들어 `sysparm_view=중요%20인시던트입니다.` [작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")도 참조하십시오.

    // create the GlideURI object
    var uri = action.getGlideURI(); 

    // Adds the Major incidents to the query
    uri.setView('Major Incidents');

    // https://instance.service-now.com/incident.do?sys_id=0&sysparm_view=Major%20Incidents ...

### 범위가 지정된 해당 항목 {#GlideURI_setView_S__section_bct_nbs_mcb}

범위가 지정된 애플리케이션에서는 이 방법을 사용할 수 없습니다.

## GlideURI - toString(문자열 경로) {#ariaid-title9}

URI 문자열을 재구성하고 유효하지 않은 문자를 URL 코드로 변환하여 적절한 URL 인코딩을 수행합니다. 예를 들어 \&를 '%26'으로 변환합니다.
set() 메서드로 설정된 매개변수도 URI로 인코딩됩니다.
{#GlideURI_toString_S__table_zjw_4r3_ks__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 경로 | 문자열 | URI가 추가되는 시스템 URL의 기본 부분입니다. |
[표 15. 매개변수]

{#GlideURI_toString_S__table_zjw_4r3_ks} {#GlideURI_toString_S__table_akw_4r3_ks__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | URL입니다. |
[표 16. 반환]

{#GlideURI_toString_S__table_akw_4r3_ks}  
다음 예시는 잘못된 문자를 인스턴스 URL의 URL 코드로 변환하는 방법을 보여줍니다. [작업 - getGlideURI()](https://servicenow-prod.fluidtopics.net/FwDxWHv4zc_Ej6inlIJkSw#Action_getGlideURI "사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.")도 참조하십시오.

    var gURI = action.getGlideURI();
    fileString = gURI.toString('https://<your instance>.service-now.com/navpage.do');

### 범위가 지정된 해당 항목 {#GlideURI_toString_S__section_q2n_wgs_mcb}

범위가 지정된 애플리케이션에서 toString() 메서드를 사용하려면 해당하는 범위가 지정된 메서드( [GlideURI - toString(String path)](https://servicenow-prod.fluidtopics.net/w_fwK29n5qQh~LclVRADew#r_ScopedGlideURIToString_String "URI 문자열을 재구성하고 유효하지 않은 문자를 URL 코드로 변환하여 적절한 URL 인코딩을 수행합니다. 예를 들어 &를 '%26'으로 변환합니다.") )를 사용합니다.