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


---

# 페이로드 빌더 단계

# 페이로드 빌더 단계 {#ariaid-title1}

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

작업 디자이너가 동적 데이터를 사용하여 JSON 및 XML 페이로드로 이름-값 쌍을 쉽게 생성할 수 있도록 합니다.

## 역할 및 가용성 {#payload-build-step-action-designer__section_g2v_5jq_2fb}

워크플로우 스튜디오 동작 단계로 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 만들 수 있습니다.  
주:  
JSON의 경우 이 단계는 더 이상 사용되지 않으며 [JSON 빌더 단계](https://servicenow-prod.fluidtopics.net/FJh3wL5Y4evy5xEOZvNv3A "다른 단계에서 사용할 JSON 페이로드를 생성합니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 이 단계에서는 중첩 구조에 대한 개체 및 배열을 포함하여 여러 데이터 형식을 지원합니다.").

## 필드 {#payload-build-step-action-designer__section_fhk_zjq_2fb}

{#payload-build-step-action-designer__table_hqc_ckq_2fb__entry__2}

| 필드 | 설명 |
|-|-|
| 이름 값 쌍 | 페이로드에 포함할 이름-값 쌍입니다. 더하기 아이콘을 클릭하여 이름-값 쌍을 추가합니다. 데이터 알약을 두 필드 중 하나로 끌어 동적 페이로드를 생성합니다. 이름은 JSON의 키가 되고 XML의 요소가 됩니다. 예를 들어, 이 이름-값 쌍을 생성한다고 가정하겠습니다. * 이름: <kbd class="ph userinput">short_description</kbd> * 값: <kbd class="ph userinput">[action]-&gt;[short_description]</kbd> {#payload-build-step-action-designer__ul_vcy_kmq_2fb} 시스템에서 이름-값 페어의 형식을 JSON으로 지정하는 경우: "short_description": "[action]->[short_description]" 시스템에서 이름-값 쌍을 XML로 형식화하는 경우: <short_description>[action]->[short_description]</short_description> |
| 비어 있는 경우 생략 | 값이 비어 있거나 null인 경우 이름-값 쌍을 제외하는 옵션입니다. 주: 이 필드는 아래쪽 화살표를 클릭하여 고급 옵션을 표시한 후에만 표시됩니다. |
| 출력 형식 | 페이로드 파일 형식입니다. * JSON: 페이로드를 JSON 문서로 포맷하려면 선택합니다. * XML: 페이로드를 XML 문서로 포맷하려면 선택합니다. {#payload-build-step-action-designer__ul_gbf_3kq_2fb} |
| 네임스페이스 | 각 요소에 적용할 XML 네임스페이스입니다. 네임스페이스가 <kbd class="ph userinput">incident</kbd>로 설정된 경우의 예를 들어 다음과 같습니다. <incident:short_description>[action]->[short_description]</incident:short_description> 주: 이 필드는 출력 형식 이 XML로 설정된 경우에만 표시됩니다. |
| 외부 구조 포함 | 출력 형식에 적합한 최상위 컨테이너를 포함하거나 제외하는 옵션입니다. 출력 형식이 JSON인 경우 중괄호에는 이름-값 쌍이 포함됩니다. 출력 형식이 XML인 경우 지정된 XML 요소에는 이름-값 쌍이 포함됩니다. 예를 들어, 시스템에서 이름-값 페어의 형식을 JSON으로 지정하는 경우: { "short_description": "[action]->[short_description]" } 시스템에서 이름-값 쌍을 XML로 형식화하는 경우: <xml> <short_description>[action]->[short_description]</short_description> </xml> |
| 빈 구조 보냄 | 페이로드가 비어 있을 때 유효한 JSON 또는 XML 구조를 보내는 옵션입니다. 페이로드에 JSON 또는 XML 구조 텍스트를 포함하려면 이 옵션을 활성화합니다. 예를 들어 시스템이 빈 구조를 JSON으로 형식화하는 경우: {} 시스템에서 빈 구조를 XML로 포맷하는 경우: <xml></xml> 빈 페이로드를 생성하려면 이 옵션을 비활성화합니다. 모든 이름-값 쌍에 대해 Omit if empty 옵션을 선택하면 빈 페이로드가 발생할 수 있으며, 페이로드의 모든 이름-값 쌍은 빈 값을 생성합니다. |
| 상위 노드 | 이름-값 쌍을 포함하는 XML 요소의 이름입니다. 기본 부모 노드 요소는 `xml`입니다. 주: 이 필드는 출력 형식 이 XML 로 설정되고 외부 구조 포함 옵션이 활성화된 경우에만 표시됩니다. |
| 미리 보기 | 단계에서 생성하는 읽기 전용 페이로드입니다. |
[ ]

{#payload-build-step-action-designer__table_hqc_ckq_2fb}

## 작업 오류 평가 {#payload-build-step-action-designer__id_lg2_4s3_15b}

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

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