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


---

# 작업 - 범위, 전역

# 작업 - 범위, 전역 {#ariaid-title1}

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

작업 API는 UI 작업 스크립트에서 URL에 대한 데이터를 처리하는 메서드를 제공합니다.
이 API를 사용하여 사용자가 상호작용할 수 있는 UI 작업을 구성합니다. UI 작업 \[sys_ui_action\] 테이블에서 다음 스크립트를 사용합니다. 자세한 내용은 [UI 작업을](https://www.servicenow.com/docs/access?context=t_EditingAUIAction&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 참조하십시오.

이 API에 대한 메서드는 모든 서버 측 JavaScript에서 변수 이름 'action'으로 참조됩니다. 자세한 내용은 [UI 작업으로 상호작용 생성을](https://developer.servicenow.com/blog.do?p=/post/training-ui-action-101/) 참조하십시오.

## 작업 - getGlideURI() {#ariaid-title2}

사용자 뷰를 결정하기 위해 GlideURI 객체를 가져옵니다.
{#Action_getGlideURI__table_dxr_lfj_nkb__entry__3}

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

{#Action_getGlideURI__table_dxr_lfj_nkb} {#Action_getGlideURI__table_exr_lfj_nkb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 사용자 뷰의 URI 매개변수를 나타내는 GlideURI 객체입니다. * [GlideURI - 범위 지정됨](https://servicenow-prod.fluidtopics.net/w_fwK29n5qQh~LclVRADew#c_GlideURIScopedAPI "GlideURI API는 범위가 지정된 애플리케이션에서 URI 매개변수를 처리하는 메서드를 제공합니다.") * [GlideURI - 전역](https://servicenow-prod.fluidtopics.net/Zl~~iFMU~8Kr_qh~iTDNww#GlideURIGlobalAPI "GlideURI API는 전역 애플리케이션에서 URI 매개변수를 처리하는 메서드를 제공합니다.") {#Action_getGlideURI__ul_f4h_5lj_5mb} 주: null을 포함한 다른 반환 값은 오류로 간주됩니다. |
[표 2. 반환]

{#Action_getGlideURI__table_exr_lfj_nkb}  
다음 예는 사용자 뷰를 가져오고 서비스 카탈로그 홈페이지로 리디렉션 URL을 설정하는 방법을 보여줍니다.

    var uri = action.getGlideURI();
    var path = 'catalog_home.do';

    uri.set('sysparm_view', 'catalog_default');
    action.setRedirectURL(uri.toString(path));

## 작업 - getReturnURL() {#ariaid-title3}

UI 작업이 완료된 후 뷰에서 반환 페이지의 URL을 가져옵니다.
{#Action_getReturnURL__table_db4_ffj_nkb__entry__3}

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

{#Action_getReturnURL__table_db4_ffj_nkb} {#Action_getReturnURL__table_eb4_ffj_nkb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | UI 작업이 완료된 후 뷰에 표시되는 반환 페이지의 URL입니다. |
[표 4. 반환]

{#Action_getReturnURL__table_eb4_ffj_nkb}  

    action.getReturnURL();

## 작업 - getURLParameter(String parameterName) {#ariaid-title4}

URL 매개변수의 값을 가져옵니다.
{#Action_getURLParameter_S__table_alv_y2j_nkb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 매개변수 이름 | 문자열 | URL 매개변수 값에 대해 쿼리할 URL 매개변수 이름의 이름입니다. |
[표 5. 매개변수]

{#Action_getURLParameter_S__table_alv_y2j_nkb} {#Action_getURLParameter_S__table_blv_y2j_nkb__entry__2}

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

{#Action_getURLParameter_S__table_blv_y2j_nkb}  

    action.getURLParameter('sysparm_query');

## 작업 - openGlideRecord(Object gr) {#ariaid-title5}

사용자 뷰에서 GlideRecord가 있는 페이지를 엽니다.
{#Action_openGlideRecord_O__table_sy5_bfj_nkb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| gr | [GlideRecord](https://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.") | 사용자 뷰에서 열 페이지의 GlideRecord입니다. |
[표 7. 매개변수]

{#Action_openGlideRecord_O__table_sy5_bfj_nkb} {#Action_openGlideRecord_O__table_ty5_bfj_nkb__entry__2}

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

{#Action_openGlideRecord_O__table_ty5_bfj_nkb}  
다음 예는 상호작용 기록에서 만든 호출자 이름과 인시던트 설명을 포함하는 방법을 보여줍니다. 자세한 내용은 [Customizing Configurable Workspace with declarative actions](https://www.servicenow.com/docs/access?context=declarative-actions-landing&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 문서를 참조하십시오.

    if(current.update()){
      var inc = new GlideRecord("incident");
      inc.newRecord();
      inc.caller_id = current.opened_for;
      inc.short_description = current.short_description;
      action.openGlideRecord(inc);
    }

## 작업 - setNoPop(부울 noPop) {#ariaid-title6}

현재 뷰의 페이지에서 팝업 창을 활성화할지 여부를 나타냅니다.
{#Action_setNoPop_B__table_mms_gfj_nkb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 노팝 | 부울 | 페이지의 팝업 창을 활성화할지 비활성화할지 여부를 나타내는 플래그: * true: 팝업 창을 비활성화합니다. * false: 기본값 팝업 창을 활성화합니다. {#Action_setNoPop_B__ul_qmz_fwj_nkb} |
[표 9. 매개변수]

{#Action_setNoPop_B__table_mms_gfj_nkb} {#Action_setNoPop_B__table_nms_gfj_nkb__entry__2}

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

{#Action_setNoPop_B__table_nms_gfj_nkb}  
다음 예시에서는 UI 작업에 대한 팝업 창을 비활성화하는 방법을 보여줍니다.


    action.setNoPop(true);

## 작업 - setRedirectURL(객체 URL) {#ariaid-title7}

이 트랜잭션에 대한 리디렉션 URI를 설정하여 사용자가 보는 다음 페이지를 결정합니다.
사용 사례의 경우:

* [UI 라우팅 작업 생성](https://servicenow-prod.fluidtopics.net/ny3UJ4m0AR9WNgbzXZsMCA#t_CreateAUIRoutingAction "이 솔루션을 사용하면 인시던트인지 요청 항목인지 모른 채 서비스 데스크에 기록을 만들 수 있습니다. 그러면 서비스 데스크에서 기록을 적절한 테이블로 라우팅할 수 있습니다.")
* [HR 케이스에서 지식 문서 생성](https://www.servicenow.com/docs/access?context=ui-action-hrcase-article&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)
* [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=australia&pubname=australia-platform-administration&ft:locale=en-US)
{#Action_setRedirectURL_O__ul_i1s_2qk_lmb}
{#Action_setRedirectURL_O__table_bdm_2fj_nkb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| URL | 객체 | 리디렉션으로 설정할 URL입니다. URL을 문자열 또는 [GlideRecord](https://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.")로 제공할 수 있습니다. URL을 GlideRecord로 전달하면 이 값은 해당 기록의 양식에 포커스를 가져갑니다. |
[표 11. 매개변수]

{#Action_setRedirectURL_O__table_bdm_2fj_nkb} {#Action_setRedirectURL_O__table_cdm_2fj_nkb__entry__2}

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

{#Action_setRedirectURL_O__table_cdm_2fj_nkb}  
다음 예시에서는 [현재](https://servicenow-prod.fluidtopics.net/9T2QJvB8wRo2J3f8LGlzZA "스크립팅을 사용하여 범위가 지정된 환경과 범위가 지정되지 않은 환경의 테이블에서 요청 항목 변수를 참조할 수 있습니다.") 변수를 사용하여 UI 작업에서 URL로 사용자를 리디렉션하는 방법을 보여줍니다.

    var fixchg = new GlideRecord("change_request");
    fixchg.short_description= current.short_description;
    fixchg.comments= current.comments.getHTMLValue();
    // fixchg.parent = current.sys_id;
    fixchg.insert();
    FixChange();
     
    gs.addInfoMessage("Change "+ fixchg.number+" created");
    action.setRedirectURL(current);
    action.setReturnURL(fixchg);
     
    function FixChange(){
    var m2m = new GlideRecord('task_rel_task');
    m2m.initialize();
    m2m.child= current.sys_id;
    m2m.parent= fixchg.sys_id;
    m2m.type.setDisplayValue("Fixes::Fixed by");
    m2m.insert();}

다음 예는 UI 작업이 완료된 후 새 인시던트 기록을 만들고 새 인시던트로 리디렉션하는 방법을 보여줍니다.

    var reqItem = current.u_item;
    var requestedFor = current.u_requested_for;
    var location = current.location;

    if(current.u_incident_request == 'Incident'){
      //Create a new incident record and redirect to the new incident
      var rec = new GlideRecord('incident');
      rec.initialize();
      rec.caller_id = requestedFor;
      rec.location = location;
      rec.insert();
      action.setRedirectURL(rec);
    }

    if(current.u_incident_request == 'Request'){
      //Build the url and route the user to the request item
      var url = '';
      if(current.u_item.sys_class_name == 'sc_cat_item_guide'){
        url = 'com.glideapp.servicecatalog_cat_item_guide_view.do?sysparm_initial=true&sysparm_guide=' + 
          reqItem + '&sysparm_user=' + requestedFor + '&sysparm_location=' + location;
      }
      else{
        url = 'com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=' + reqItem + '&sysparm_user=' +  
          requestedFor + '&sysparm_location=' + location;
      }
      action.setRedirectURL(url);
    }

## 작업 - setReturnURL(객체 URL) {#ariaid-title8}

UI 작업이 완료된 후 이 트랜잭션에 대한 반환 URI를 설정합니다. 이 방법을 사용하여 사용자가 제출에서 돌아올 때 볼 수 있는 페이지를 확인할 수 있습니다.
{#Action_setReturnURL_O__table_bdm_2fj_nkb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| URL | 객체 | UI 작업이 완료된 후 반환 위치로 설정할 URI입니다. URL을 문자열 또는 [GlideRecord](https://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.")로 제공할 수 있습니다. |
[표 13. 매개변수]

{#Action_setReturnURL_O__table_bdm_2fj_nkb} {#Action_setReturnURL_O__table_cdm_2fj_nkb__entry__2}

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

{#Action_setReturnURL_O__table_cdm_2fj_nkb}  
다음 예에서는 사용자가 UI 작업을 선택하여 문제 기록과 변경 템플릿의 정보를 사용하여 변경 기록을 만들 수 있도록 합니다. 변경 후 사용자는 [현재](https://servicenow-prod.fluidtopics.net/9T2QJvB8wRo2J3f8LGlzZA "스크립팅을 사용하여 범위가 지정된 환경과 범위가 지정되지 않은 환경의 테이블에서 요청 항목 변수를 참조할 수 있습니다.") 뷰로 돌아갑니다. 자세한 내용은 [스크립팅된 템플릿을 참조하십시오.](https://www.servicenow.com/docs/access?context=r_ScriptedTemplates&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 더 많은 사용 사례는 다음 문서를 참조하십시오 [Task relationships with UI actions](https://www.servicenow.com/docs/access?context=r_UIActions&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

    var change = new GlideRecord("change_request");
    change.initialize();
    change.short_description = current.short_description;
    change.description = current.u_details;
    change.cmdb_ci = current.u_service;
    change.priority = current.priority;
    change.requested_by = current.caller_id;
    change.assignment_group.setDisplayValue('Change & Release');
    change.u_status = 'New';
    change.parent = current.number;
    change.applyTemplate("standard_rfc");
    current.rfc = change.insert();
    current.comments = 'Change ' + change.number + ' created.';

    var mySysID = current.update();

    gs.addInfoMessage("Change " + change.number + " created");
    action.setRedirectURL(change);
    action.setReturnURL(current);

## 작업 - setURLParameter(String parameterName, String parameterValue) {#ariaid-title9}

URL 매개변수 이름과 값을 설정합니다.
{#Action_setURLParameter_S_S__table_elv_z2j_nkb__entry__3}

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

{#Action_setURLParameter_S_S__table_elv_z2j_nkb} {#Action_setURLParameter_S_S__table_flv_z2j_nkb__entry__2}

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

{#Action_setURLParameter_S_S__table_flv_z2j_nkb}  

    action.setURLParameter('sysparm_query', 'priority=2^active=true');