---
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) 소요 시간: 3분

범위가 지정된 워크플로우 API는 활동 정의 스크립트에 사용할 수 있는 메서드를 제공합니다.

범위가 지정된 워크플로우 개체의 인스턴스를 만들기 위한 생성자가 없습니다. 대신 활동 스크립트에서 사용할 수 있는 전역 워크플로우 객체를 사용하십시오. 이 워크플로우 객체는 워크플로우 내의 모든 스크립트 위치에서 사용할 수 있습니다.

## 범위가 지정된 워크플로우 - 디버그(문자열 메시지, 객체 인수) {#ariaid-title2}

로그에 디버그 메시지를 추가합니다.
{#r_SWF-debug_S_O__table_q3h_rqz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 로그에 추가할 메시지입니다. |
| args | 객체 | 메시지에 추가할 인수입니다. |
[표 1. 매개변수]

{#r_SWF-debug_S_O__table_q3h_rqz_lt} {#r_SWF-debug_S_O__table_r3h_rqz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 로그에 추가된 메시지입니다. |
[표 2. 반환]

{#r_SWF-debug_S_O__table_r3h_rqz_lt}  

    var loggedMessage = workflow.debug("All is well");

## 범위가 지정된 워크플로우 - 오류(문자열 메시지, 객체 인수) {#ariaid-title3}

로그에 오류 메시지를 추가합니다.
{#r_SWF-error_S_O__table_ttc_2rz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 로그에 추가할 메시지입니다. |
| args | 객체 | 메시지에 추가할 인수입니다. |
[표 3. 매개변수]

{#r_SWF-error_S_O__table_ttc_2rz_lt} {#r_SWF-error_S_O__table_utc_2rz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 로깅된 메시지 |
[표 4. 반환]

{#r_SWF-error_S_O__table_utc_2rz_lt}  

    var loggedMessage = workflow.error("An error has occurred. ");

## 범위가 지정된 워크플로우 - getVariable(문자열 이름) {#ariaid-title4}

지정된 변수의 값을 반환합니다.
{#r_SWF-getVariable_S__table_rsb_psz_lt__entry__3}

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

{#r_SWF-getVariable_S__table_rsb_psz_lt} {#r_SWF-getVariable_S__table_ssb_psz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 변수의 값 |
[표 6. 반환]

{#r_SWF-getVariable_S__table_ssb_psz_lt}  

    var value = workflow.getVariable("task");

## 범위가 지정된 워크플로우 - 정보(문자열 메시지, 객체 인수) {#ariaid-title5}

로그에 정보 메시지를 추가합니다.
{#r_SWF-info_S_O__table_rz5_1qz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 로그에 추가할 메시지입니다. |
| args | 객체 | 메시지에 추가할 인수입니다. |
[표 7. 매개변수]

{#r_SWF-info_S_O__table_rz5_1qz_lt} {#r_SWF-info_S_O__table_sz5_1qz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 기록되는 메시지입니다. |
[표 8. 반환]

{#r_SWF-info_S_O__table_sz5_1qz_lt}  

    var loggedMessage = workflow.info("All is well");

## 범위가 지정된 워크플로우 - 입력 {#ariaid-title6}

워크플로우 변수를 포함하는 객체입니다.
이는 메서드가 아니라 사용자와 같은 워크플로우 객체의 변수를 참조하는 방법입니다. 워크플로우 변수는 워크플로우의 속성 또는 스크립팅된 활동에 의해 정의됩니다.
{#SWF-inputs__table_ry3_4h1_qfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 입력 | 객체 | 이름 값 쌍으로서의 워크플로우 변수. 워크플로우 객체의 변수는 통합자의 구현에 맞게 사용자 지정됩니다. |
[표 9. 필드]

{#SWF-inputs__table_ry3_4h1_qfb}  

    var user = workflow.inputs.u_user;

## 범위가 지정된 워크플로우 - name() {#ariaid-title7}

워크플로우 이름을 반환합니다.
{#r_SWF-name__table_wm2_spz_lt__entry__3}

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

{#r_SWF-name__table_wm2_spz_lt} {#r_SWF-name__table_xm2_spz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 워크플로우 이름 |
[표 11. 반환]

{#r_SWF-name__table_xm2_spz_lt}  

    var name = workflow.name();

## 범위가 지정된 워크플로우 - removeVariable(문자열 이름) {#ariaid-title8}

워크플로우에서 지정된 변수를 제거합니다.
{#r_SWF-removeVariable_S__table_d2r_ysz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 변수 이름 |
[표 12. 매개변수]

{#r_SWF-removeVariable_S__table_d2r_ysz_lt} {#r_SWF-removeVariable_S__table_e2r_ysz_lt__entry__2}

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

{#r_SWF-removeVariable_S__table_e2r_ysz_lt}  

    var value = workflow.removeVariable("task");

## 범위가 지정된 워크플로우 - 결과 {#ariaid-title9}

워크플로우 결과를 포함하는 워크플로우 객체의 요소입니다.
이는 메서드가 아니라 워크플로우의 결과를 포함하는 워크플로우 개체의 요소입니다.
{#SWF-result__table_grb_p31_qfb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 결과 | 문자열 | 워크플로우 결과입니다. |
[표 14. 필드]

{#SWF-result__table_grb_p31_qfb}  

    var wfResult = workflow.result;

## 범위가 지정된 워크플로우 - scratchpad() {#ariaid-title10}

워크플로우의 스크래치패드 객체를 반환합니다.
{#r_SWF-scratchpad__table_tfn_hpz_lt__entry__3}

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

{#r_SWF-scratchpad__table_tfn_hpz_lt} {#r_SWF-scratchpad__table_ufn_hpz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 스크래치패드 객체입니다. |
[표 16. 반환]

{#r_SWF-scratchpad__table_ufn_hpz_lt}  

    var scratchpad = workflow.scratchpad();

## 범위가 지정된 워크플로우 - setResult(문자열 결과) {#ariaid-title11}

워크플로우의 결과를 설정합니다.
{#r_SWF-setResult_S__table_zvp_stz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 결과 | 문자열 | 워크플로우의 결과 |
[표 17. 매개변수]

{#r_SWF-setResult_S__table_zvp_stz_lt} {#r_SWF-setResult_S__table_awp_stz_lt__entry__2}

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

{#r_SWF-setResult_S__table_awp_stz_lt}  

    workflow.setResult("Success");

## 범위가 지정된 워크플로우 - setVariable(문자열 이름, 객체 값) {#ariaid-title12}

지정된 변수를 지정된 값으로 설정합니다.
{#r_SWF-setVariable_S_O__table_spj_2sz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 변수 이름 |
| 값 | 객체 | 변수에 할당할 값입니다. |
[표 19. 매개변수]

{#r_SWF-setVariable_S_O__table_spj_2sz_lt} {#r_SWF-setVariable_S_O__table_tpj_2sz_lt__entry__2}

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

{#r_SWF-setVariable_S_O__table_tpj_2sz_lt}  

    workflow.setVariable("task", "terrible");

## 범위가 지정된 워크플로우 - warn(문자열 메시지, 객체 인수) {#ariaid-title13}

로그에 경고 메시지를 추가합니다.
{#r_SWF-warn_S_O__table_gxm_qrz_lt__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메시지 | 문자열 | 로그에 추가할 메시지입니다. |
| args | 객체 | 메시지에 추가할 인수입니다. |
[표 21. 매개변수]

{#r_SWF-warn_S_O__table_gxm_qrz_lt} {#r_SWF-warn_S_O__table_hxm_qrz_lt__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 로깅된 메시지 |
[표 22. 반환]

{#r_SWF-warn_S_O__table_hxm_qrz_lt}  

    var loggedMessage = workflow.warn("Check your permissions.");