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


---

# WFActivityHandler - 전역

# WFActivityHandler - 전역 {#ariaid-title1}

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

WFActivityHandler 스크립트 포함은 모든 워크플로우 활동의 기본 클래스입니다.

모든 워크플로우 활동의 기본 클래스인 이 코드는 항상 활동의 일부로 실행됩니다.

고유한 워크플로우 활동을 개발할 때 이 클래스에서 파생되고 원하는 기능을 얻기 위해 필요에 따라 메서드를 재정의하여 스크립트 객체를 만듭니다. 의미 있는 활동 처리를 수행하려면 클라이언트 코드에서 onExecute() 메서드를 재정의해야 합니다.

## WFActivityHandler - 디버그(문자열 메시지, 문자열 인수) {#ariaid-title2}

디버그 메시지를 로그에 기록합니다.
{#r_WFAH-debug_S_S__table_xdr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 문자열 | 로그로 보낼 문자열 |
[표 1. 매개변수]

{#r_WFAH-debug_S_S__table_xdr_nf5_4t} {#r_WFAH-debug_S_S__table_ydr_nf5_4t__entry__2}

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

{#r_WFAH-debug_S_S__table_ydr_nf5_4t}

## WFActivityHandler - 디버그(문자열 메시지, 배열 인수) {#ariaid-title3}

디버그 메시지를 로그에 기록합니다.
{#r_WFAH-debug_S_A__table_bv2_sh5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 배열 | 로그로 보낼 값의 배열 |
[표 3. 매개변수]

{#r_WFAH-debug_S_A__table_bv2_sh5_4t} {#r_WFAH-debug_S_A__table_cv2_sh5_4t__entry__2}

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

{#r_WFAH-debug_S_A__table_cv2_sh5_4t}

## WFActivityHandler - generate(문자열 activityId, 문자열 순서, GlideDateTime startAtDspValue, 부울 noCreateFlag) {#ariaid-title4}

예정된 작업의 미리 보기를 위해 활동을 실행하기 전에 승인 및 작업을 생성합니다.
워크플로우를 시작할 때 보 류 중 상태의 객체를 생성할 수 있습니다. 관련 정보는 [워크플로우 활동 생성을](https://www.servicenow.com/docs/access?context=r_Generate&version=australia&pubname=australia-build-workflows&ft:locale=en-US) 참조하십시오.
{#r_WFAH-generate_S_S_GDT_B__table_dv2_sh5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| activityId | 문자열 | 이 실행 중인 활동의 Sys_id입니다. 테이블: 워크플로우 활동 \[wf_activity\] |
| 순서 | 문자열 | 작업 또는 승인과 연결된 주문 번호입니다. |
| startAtDspValue | 문자열 | 작업 또는 승인에 대한 시작 시간( [GlideDateTime](https://servicenow-prod.fluidtopics.net/yyrrUwOqTDBeMM3IDUcPLQ#c_GlideDateTimeAPI "GlideDateTime 클래스는 GlideDateTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.") 형식)입니다. |
| noCreateFlag | 부울 | 승인 기록 생성을 건너뛸지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 승인 기록을 생성하지 않습니다. * false: 승인 기록을 생성합니다. {#r_WFAH-generate_S_S_GDT_B__ul_cbr_ds4_f4b} 기본값: true |
[표 5. 매개변수]

{#r_WFAH-generate_S_S_GDT_B__table_dv2_sh5_4t} {#r_WFAH-generate_S_S_GDT_B__table_ev2_sh5_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 워크플로우 스크래치패드에 저장된 사전 생성 객체입니다. 예를 들어, 객체는 승인 ID의 배열일 수 있습니다. 활동이 onExecute 함수를 실행할 때 사전 생성 객체에 다음 조건 중 하나를 결정하도록 요청할 수 있습니다. * 승인이 이미 보류 중 상태로 생성되었습니다. * 활동은 onExecute 함수를 사용하여 승인을 생성해야 합니다. {#r_WFAH-generate_S_S_GDT_B__ul_u13_mdp_f4b} |
[표 6. 반환]

{#r_WFAH-generate_S_S_GDT_B__table_ev2_sh5_4t}

## WFActivityHandler - 정보(문자열 메시지, 문자열 인수) {#ariaid-title5}

정보 메시지를 로그에 기록합니다.
{#r_WFAH-info_S_S__table_pdr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 문자열 | 로그로 보낼 문자열입니다. |
[표 7. 매개변수]

{#r_WFAH-info_S_S__table_pdr_nf5_4t} {#r_WFAH-info_S_S__table_qdr_nf5_4t__entry__2}

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

{#r_WFAH-info_S_S__table_qdr_nf5_4t}

## WFActivityHandler - 정보(문자열 메시지, 배열 인수) {#ariaid-title6}

정보 메시지를 로그에 기록합니다.
{#r_WFAH-info_S_A__table_rdr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 배열 | 로그로 보낼 값의 배열 |
[표 9. 매개변수]

{#r_WFAH-info_S_A__table_rdr_nf5_4t} {#r_WFAH-info_S_A__table_qdr_nf5_4t__entry__2}

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

{#r_WFAH-info_S_A__table_qdr_nf5_4t}

## WFActivityHandler - js(문자열 문자열) {#ariaid-title7}

스크립트의 활동 변수를 평가합니다.
el이 포함된 문자열( `예: ${some script}` ) 또는 `javascript:`로 시작하는 문자열을 평가하는 데 사용됩니다. 사용량과 같은 거의 모든 기존 활동을 봅니다.
{#r_WFAH-js_S__table_ndr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 문자열 | 문자열 | 포함된 el을 포함할 수 있는 문자열입니다. |
[표 11. 매개변수]

{#r_WFAH-js_S__table_ndr_nf5_4t} {#r_WFAH-js_S__table_odr_nf5_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 평가된 문자열입니다. |
[표 12. 반환]

{#r_WFAH-js_S__table_odr_nf5_4t}

## WFActivityHandler - onCancel( ) {#ariaid-title8}

이벤트에 대한 이벤트 핸들러입니다.cancel
활동 스크립트의 기본 클래스는 이 활동을 취소로 설정합니다. 이 활동을 취소하기 위해 추가 처리가 필요한 경우 파생 클래스(활동)가 이 메서드를 재정의할 수 있습니다. 활동 Manual Approvals 은 이 활동을 취소하기 위한 추가 처리를 수행하도록 이 메서드를 재정의하는 예입니다.
{#r_WFAH-onCancel__table_pqd_1b5_4t__entry__3}

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

{#r_WFAH-onCancel__table_pqd_1b5_4t} {#r_WFAH-onCancel__table_qqd_1b5_4t__entry__2}

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

{#r_WFAH-onCancel__table_qqd_1b5_4t}

## WFActivityHandler - onExecute( ) {#ariaid-title9}

가상 메서드. 활동 하위 클래스는 활동에 적합한 작업을 수행하기 위해 이 메서드를 재정의해야 합니다.
{#r_WFAH-onExecute__table_nqd_1b5_4t__entry__3}

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

{#r_WFAH-onExecute__table_nqd_1b5_4t} {#r_WFAH-onExecute__table_oqd_1b5_4t__entry__2}

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

{#r_WFAH-onExecute__table_oqd_1b5_4t}

## WFActivityHandler - runScript(문자열 스크립트) {#ariaid-title10}

활동에서 스크립트 유형의 활동 변수에 포함된 스크립트를 실행할 수 있습니다.
이 메서드를 사용하는 활동의 예로는 If, Wait for condition, Approval - User및 등이 있습니다.
{#r_WFAH-runScript_S__table_rqd_1b5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 스크립트 | 문자열 | 유효한 Javascript를 포함하는 문자열입니다. |
[표 17. 매개변수]

{#r_WFAH-runScript_S__table_rqd_1b5_4t} {#r_WFAH-runScript_S__table_sqd_1b5_4t__entry__2}

| 유형 | 설명 |
|-|-|
| 변수 | 스크립트가 워크플로우 변수 <var class="keyword varname">answer</var> 를 설정하면 이 값이 반환됩니다. 그렇지 않은 경우 스크립트 실행 결과가 반환됩니다. |
[표 18. 반환]

{#r_WFAH-runScript_S__table_sqd_1b5_4t}

## WFActivityHandler - setActivityOutput( ) {#ariaid-title11}

활동 출력 속성을 설정합니다.
활동 SOAP Message참조 .
{#r_WFAH-setActivityOutput__table_lqd_1b5_4t__entry__3}

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

{#r_WFAH-setActivityOutput__table_lqd_1b5_4t} {#r_WFAH-setActivityOutput__table_mqd_1b5_4t__entry__2}

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

{#r_WFAH-setActivityOutput__table_mqd_1b5_4t}

## WFActivityHandler - setResultFailed(문자열 이유) {#ariaid-title12}

선택적 이유 문자열을 사용하여 활동 결과를 실패로 설정합니다.
활동을 SOAP Message참조하십시오.
{#r_WFAH-setResultFailed_S__table_hqd_1b5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이유 | 문자열 | (선택 사항) 이 활동이 실패한 이유에 대한 설명입니다. |
[표 21. 매개변수]

{#r_WFAH-setResultFailed_S__table_hqd_1b5_4t} {#r_WFAH-setResultFailed_S__table_iqd_1b5_4t__entry__2}

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

{#r_WFAH-setResultFailed_S__table_iqd_1b5_4t}

## WFActivityHandler - setResultSucceeded( ) {#ariaid-title13}

이 활동의 결과를 성공으로 설정합니다.
{#r_WFAH-setResultSucceeded__table_jqd_1b5_4t__entry__3}

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

{#r_WFAH-setResultSucceeded__table_jqd_1b5_4t} {#r_WFAH-setResultSucceeded__table_kqd_1b5_4t__entry__2}

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

{#r_WFAH-setResultSucceeded__table_kqd_1b5_4t}

## WFActivityHandler - warn(문자열 메시지, 문자열 인수) {#ariaid-title14}

경고 메시지를 로그에 기록합니다.
{#r_WFAH-warn_S_S__table_tdr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 문자열 | 로그로 보낼 문자열 |
[표 25. 매개변수]

{#r_WFAH-warn_S_S__table_tdr_nf5_4t} {#r_WFAH-warn_S_S__table_udr_nf5_4t__entry__2}

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

{#r_WFAH-warn_S_S__table_udr_nf5_4t}

## WFActivityHandler - warn(문자열 메시지, 배열 인수) {#ariaid-title15}

경고 메시지를 로그에 기록합니다.
{#r_WFAH-warn_S_A__table_vdr_nf5_4t__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| msg | 문자열 | 로그에 보낼 메시지입니다. |
| args | 배열 | 로그로 보낼 값의 배열 |
[표 27. 매개변수]

{#r_WFAH-warn_S_A__table_vdr_nf5_4t} {#r_WFAH-warn_S_A__table_udr_nf5_4t__entry__2}

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

{#r_WFAH-warn_S_A__table_udr_nf5_4t}