---
sourceDocument: 호주 워크플로우 빌드
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/build-workflows

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 워크플로우 빌드

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# JSON 빌더 단계

# JSON 빌더 단계 {#ariaid-title1}

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

다른 단계에서 사용할 JSON 페이로드를 생성합니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 이 단계에서는 중첩 구조에 대한 개체 및 배열을 포함하여 여러 데이터 형식을 지원합니다.

## 역할 및 가용성 {#json-build-step-action-designer__section_g22_gnn_gxb}

이 단계를 수행하려면 통합 허브 구독이 필요합니다. 자세한 내용은 [법무 일정 - 통합 허브 개요를](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf) 참조하십시오.
필요한 플러그인이 활성화되면 통합 아래에 단계가 표시됩니다.

작업 단계로 워크플로우 스튜디오 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 생성할 수 있습니다.

## 입력 {#json-build-step-action-designer__section_fgp_z4n_gxb}

작업에 필요한 각 입력에 대한 값을 제공합니다. 동적 값을 추가하려면 데이터 패널에서 정제를 끌어서 놓거나 정제 선택기에서 선택할 수도 있습니다.{#json-build-step-action-designer__inputs-description}

이름
:   데이터 유형: String

    이름-값 쌍의 이름 부분입니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다.

값
:   데이터 유형: String

    이름-값 쌍의 값 부분입니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 복합 객체 정제를 사용하여 객체 데이터 유형으로 행을 채울 수 있지만 이렇게 하면 복합 객체 정제에 이미 있는 하위 항목이 삭제됩니다.

유형
:   데이터 유형: Choice  
    이름-값 쌍의 데이터 유형입니다. 이름 또는 값에 데이터 정제를 사용하는 경우 정제의 데이터 유형이 여기에서 선택한 데이터 유형과 일치하는지 확인합니다. 옵션은 다음과 같습니다.

    * 문자열
    * 객체
    * 번호
    * 부울
    * 배열
    {#json-build-step-action-designer__ul_kqt_v4p_xbc}

    배열 및 객체의 경우 더하기 아이콘( ![더하기 아이콘]())을 사용하여 배열 또는 객체에 이름-값 쌍을 추가합니다.

빈 값인 경우
:   데이터 유형: Choice  
    이름-값 쌍에 값이 비어 있거나 null인 경우 수행할 작업을 지정하는 옵션입니다.

    * 그대로 두기: 빈 값이나 null 값을 빈 문자열로 유지합니다.
    * 속성 생략: 값이 비어 있거나 null인 경우 이름-값 쌍을 제외합니다.
    * null로 설정: 비어 있거나 null 값을 null 데이터 형식으로 반환합니다.
    * Throw 오류: 이름-값 쌍에 값이 비어 있거나 null인 경우 오류를 반환합니다.
    {#json-build-step-action-designer__ul_wtl_1pp_xbc}

외부 구조 포함
:   데이터 유형: True/False

    최상위 JSON 컨테이너에 중괄호를 포함하는 옵션입니다.

빈 구조 생략
:   데이터 유형: True/False

    빈 페이로드를 생략하는 옵션입니다. 빈 페이로드는 모든 이름-값 쌍 및 페이로드의 모든 이름-값 쌍에 대해 빈 값의 경우 입력에 대한 생략 속성을 선택할 때 발생할 수 있습니다.

구조
:   데이터 유형: Structure

    단계가 생성하는 읽기 전용 페이로드입니다.

이 단계가 실패할 경우
:   데이터 유형: Choice

    다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 단계 상태 코드 또는 메시지를 사용하려면 다음 문서를 참조하십시오 [작업 오류 평가](https://servicenow-prod.fluidtopics.net/h3JedAXkUCYgRja3yw7kEw "단계를 포착하고 계속 실행하는 작업을 활성화합니다. 특정 오류 조건이 발생하는 시기를 식별하고 고유한 작업 상태 코드, 상태 메시지 및 오류 상태를 반환합니다.").

## 출력 {#json-build-step-action-designer__section_zch_jln_lyb}

이러한 출력은 데이터 패널에 나타납니다. 이러한 항목을 작업의 다른 곳에서 입력으로 사용할 수 있습니다.{#json-build-step-action-designer__outputs-description}

출력
:   데이터 유형: String

    문자열로 표시된 JSON 페이로드입니다. 페이로드를 객체로 사용하려는 경우 [JSON 파서 단계를](https://www.servicenow.com/docs/access?context=json-parser-step-action-designer&version=australia&pubname=australia-integrate-applications&ft:locale=en-US) 사용하여 문자열을 구문 분석할 수 있습니다.

단계 상태
:   데이터 유형: Object

    단계에 대한 런타임 상세 정보를 포함하는 객체 데이터 정제입니다. 동작의 각 단계는 단계 상태를 반환합니다.

단계 상태 \> 코드
:   데이터 유형: Integer

    단계에서 오류가 발생했는지 여부를 나타내는 정수 데이터 정제입니다. 기본적으로 값 1은 단계에서 오류가 발생했음을 나타냅니다. 값이 0이면 단계가 성공적으로 실행되었음을 나타냅니다. 이 코드는 사용자 지정할 수 없습니다.

단계 상태 \> 메시지
:   데이터 유형: String

    단계 또는 시스템 운영에 의해 작성된 오류 메시지를 포함하는 문자열 데이터 정제입니다. 이 메시지는 사용자 지정할 수 없습니다.

## JSON 페이로드 작성 {#json-build-step-action-designer__section_okh_v3w_sbc}

페이로드에 JSON 추가 단추를 사용하여 JSON 페이로드를 자동으로 작성합니다. 이 버튼을 클릭하면 구조화된 입력으로 자동으로 역직렬화될 JSON 페이로드를 입력할 수 있는 페이로드 추가 스크립트 편집기가 열립니다.  
JSON 페이로드 생성기를 사용할 때 알아야 할 몇 가지 세부 사항이 있습니다.

* JSON에 빈 키가 있는 경우 페이로드는 여전히 생성됩니다.
* 스크립트 편집기에 중복된 키가 있는 경우 객체의 마지막 키 항목이 동일한 이름의 이전 키 값을 재정의합니다.
* 루트 객체가 배열인 경우 루트 배열은 루트 객체로 래핑됩니다.
* 배열에 여러 객체가 포함되어 있으면 객체의 모든 키가 하나의 상위 객체로 병합됩니다.
{#json-build-step-action-designer__ul_t4t_dlw_sbc}  
JSON 페이로드 생성기는 다음을 지원하지 않습니다.

* 빈 페이로드
* 복잡하지 않은 객체 유형
* 잘못된 JSON
* 빈 배열과 같은 빈 루트 객체
* 65,000바이트를 초과하는 페이로드
{#json-build-step-action-designer__ul_igz_jkw_sbc}  
주:  
JSON 페이로드를 생성하면 JSON 빌더 단계의 기존 구조가 재정의됩니다.