페이로드 빌더 단계

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분

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

    역할 및 가용성

    작업 단계로 워크플로우 스튜디오 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 생성할 수 있습니다.
    주:
    JSON의 경우 이 단계는 더 이상 사용되지 않으며 JSON 빌더 단계.

    필드

    필드 설명
    이름 값 쌍

    페이로드에 포함할 이름-값 쌍입니다. 더하기 아이콘을 클릭하여 이름-값 쌍을 추가합니다. 데이터 정제를 두 필드 중 하나로 끌어다 놓아 동적 페이로드를 생성합니다.

    Name은 JSON의 키와 XML의 요소가 됩니다. 예를 들어, 다음과 같은 이름-값 쌍을 생성한다고 가정하겠습니다.
    • 이름: short_description
    • 값: [action]->[short_description]
    시스템에서 이름-값 쌍의 형식을 JSON으로 지정하는 경우:
    "short_description": "[action]->[short_description]"

    시스템에서 이름-값 쌍의 형식을 XML로 지정하는 경우:

    <short_description>[action]->[short_description]</short_description>
    비어 있는 경우 생략 값이 비어 있거나 null인 경우 이름-값 쌍을 제외하는 옵션입니다.
    주:
    이 필드는 아래쪽 화살표를 클릭하여 고급 옵션을 표시한 후에만 표시됩니다.
    출력 형식 페이로드 파일 형식입니다.
    • JSON: 페이로드를 JSON 문서로 포맷하려면 선택합니다.
    • XML: 페이로드를 XML 문서로 포맷하려면 선택합니다.
    네임스페이스 각 요소에 적용할 XML 네임스페이스입니다. 예를 들어 네임스페이스가 인시던트로 설정된 경우:
    <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>

    빈 페이로드를 생성하려면 이 옵션을 비활성화합니다.

    빈 페이로드는 모든 이름-값 쌍에 대해 비어 있는 경우 생략 옵션을 선택하고 페이로드의 모든 이름-값 쌍이 빈 값을 생성할 때 발생할 수 있습니다.
    상위 노드 이름-값 쌍을 포함하는 XML 요소의 이름입니다. 기본 부모 노드 요소는 xml입니다.
    주:
    이 필드는 출력 형식이XML 로 설정되고 외부 구조 포함 옵션이 활성화된 경우에만 표시됩니다.
    미리 보기 단계에서 생성하는 읽기 전용 페이로드입니다.

    작업 오류 평가

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

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