---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# JSON 빌더 단계

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

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

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

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

이 단계를 수행하려면 Integration Hub 구독이 필요합니다. 자세한 내용은 [법무 일정 - 통합 허브 개요를](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 값이 있는 경우 수행할 작업을 지정하는 옵션입니다.

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

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

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

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

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

구조
:   데이터 유형: Structure

    단계에서 작성하는 읽기 전용 페이로드입니다.

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

    다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 대한 단계 상태 코드 또는 메시지를 사용하려면 을 참조하십시오 [Action error evaluation](https://www.servicenow.com/docs/access?context=action-error-evaluation&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US).

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

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

출력
:   데이터 유형: String

    문자열로 JSON 페이로드합니다. 페이로드를 객체로 사용하려면 [JSON 구문 분석기 단계를](https://servicenow-prod.fluidtopics.net/HcdwwSQpS7dahP~EQ7QRPw "스크립트를 쓰지 않고도 JSON 페이로드에서 구조적 데이터를 식별합니다. 다른 단계 또는 동작에서 사용할 수 있는 복합 객체 출력에 수신 JSON 컨텐츠를 매핑합니다. 런타임에 JSON 페이로드의 값이 복합 객체 출력을 채웁니다.") 사용하여 문자열을 구문 분석할 수 있습니다.

단계 상태
:   데이터 유형: 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 빌더 단계의 기존 구조가 재정의됩니다.