JSON 빌더 단계

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분
  • 다른 단계에서 사용할 JSON 페이로드를 생성합니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 이 단계에서는 중첩 구조에 대한 개체 및 배열을 포함하여 여러 데이터 형식을 지원합니다.

    역할 및 가용성

    이 단계에는 구독이 통합 허브 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오. 필요한 플러그인이 활성화되면 통합 아래에 단계가 표시됩니다.

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

    입력

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

    이름
    데이터 유형: String

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

    데이터 유형: String

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

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

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

    빈 값인 경우
    데이터 유형: Choice
    이름-값 쌍에 값이 비어 있거나 null인 경우 수행할 작업을 지정하는 옵션입니다.
    • 대로 두기: 빈 값이나 null 값을 빈 문자열로 유지합니다.
    • 속성 생략: 값이 비어 있거나 null인 경우 이름-값 쌍을 제외합니다.
    • null로 설정: 비어 있거나 null 값을 null 데이터 형식으로 반환합니다.
    • Throw 오류: 이름-값 쌍에 값이 비어 있거나 null인 경우 오류를 반환합니다.
    외부 구조 포함
    데이터 유형: True/False

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

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

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

    구조
    데이터 유형: Structure

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

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

    다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 단계 상태 코드 또는 메시지를 사용하려면 다음 문서를 참조하십시오 .

    출력

    이러한 출력은 데이터 패널에 나타납니다. 이러한 항목을 작업의 다른 곳에서 입력으로 사용할 수 있습니다.

    출력
    데이터 유형: String

    문자열로 표시된 JSON 페이로드입니다. 페이로드를 객체로 사용하려는 경우 JSON 파서 단계를 사용하여 문자열을 구문 분석할 수 있습니다.

    단계 상태
    데이터 유형: Object

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

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

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

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

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

    JSON 페이로드 작성

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

    JSON 페이로드 생성기를 사용할 때 알아야 할 몇 가지 세부 사항이 있습니다.
    • JSON에 빈 키가 있는 경우 페이로드는 여전히 생성됩니다.
    • 스크립트 편집기에 중복된 키가 있는 경우 객체의 마지막 키 항목이 동일한 이름의 이전 키 값을 재정의합니다.
    • 루트 객체가 배열인 경우 루트 배열은 루트 객체로 래핑됩니다.
    • 배열에 여러 객체가 포함되어 있으면 객체의 모든 키가 하나의 상위 객체로 병합됩니다.
    JSON 페이로드 생성기는 다음을 지원하지 않습니다.
    • 빈 페이로드
    • 복잡하지 않은 객체 유형
    • 잘못된 JSON
    • 빈 배열과 같은 빈 루트 객체
    • 65,000바이트를 초과하는 페이로드
    주:
    JSON 페이로드를 생성하면 JSON 빌더 단계의 기존 구조가 재정의됩니다.