사용자 인터페이스에서 맵 정책 구성

• YAML
• JSON
• 샘플 JSON으로부터 생성
• 샘플 XML로부터 생성

오브젝트 또는 배열을 선택하면 완료를 클릭하고 특성 시트의 기본 보기로 돌아간 후 사용자 인터페이스를 통해 스키마를 작성할 수 있습니다.

• YAML
• JSON
• 샘플 JSON으로부터 생성
• 샘플 XML로부터 생성

오브젝트 또는 배열을 선택하면 완료를 클릭하고 특성 시트의 기본 보기로 돌아간 후 사용자 인터페이스를 통해 스키마를 작성할 수 있습니다.

비어 있음 포함

이 선택란을 선택하면(기본 옵션) 비어 있는 XML 요소가 맵 정책의 출력에 포함됩니다. 비어 있는 XML 요소를 맵 정책의 출력에 포함시키지 않으려면 이 선택란을 선택 취소하십시오.

네임스페이스 상속

이 선택란을 선택하면(기본 옵션) 상위 요소에서 XML 네임스페이스가 상속됩니다. 맵 정책에서 명시적인 네임스페이스를 사용하도록 하려면 이 선택란을 선택 취소하십시오.

네임스페이스 삽입

이 선택란을 선택하면(기본 옵션) XML 네임스페이스를 처음 사용된 문서에 삽입합니다. 루트 요소에서 모든 네임스페이스를 정의하려면 선택란을 선택 취소하십시오.

XML 입력 데이터 유형 해석

이 선택란을 선택하면 스키마가 부울 또는 숫자 유형으로 구성된 XML 요소가 해당 데이터 유형으로 변환됩니다. 모든 XML 요소 값이 문자열로 리턴되도록 하려면 이 선택란을 선택 취소하십시오(기본 옵션).

XML 출력 구문 분석

선택란을 선택한 경우 맵 정책은 구문 분석된 XML 문서로서 XML 출력을 message.body에 작성합니다. 기본적으로, XML은 XML 문자열로 출력됩니다. 다른 변수에 대한 XML 출력은 항상 XML 문자열로 작성됩니다.

• 문자열(기본 옵션): 비어 있는 XML 요소가 비어 있는 문자열로 처리됩니다.
• 널: 비어 있는 XML 요소가 널값으로 처리됩니다.
• 없음: 데이터가 무시됩니다.
• String Badgerfish : 빈 XML 요소의 값은 빈 문자열로 간주됩니다. 비어 있는 문자열 값은 JSON badgerfish 값 특성에 배치됩니다.
• Null Badgerfish : 빈 XML 요소의 값은 null로 간주됩니다. 널 값은 JSON badgerfish 값 특성에 배치됩니다. 널 값 허용 옵션이 선택되지 않으면 JSON 출력 특성에 대한 이 요소의 맵핑은 발생하지 않습니다.

첫 번째 배열 요소만 사용

이 선택란이 선택된 경우 입력 순회에서 배열을 만나면 첫 번째 요소만 사용됩니다. 맵 정책에서 모든 배열 요소를 사용하도록 하려면 이 선택란을 선택 취소하십시오(기본 옵션).

변수 참조 API Connect 해결

이 확인란의 선택이 해제된 경우(기본 설정), 맵 정책은 맵 정책 내의 변수 참조를 API Connect 무시합니다. 맵 특성에서 찾은 API Connect 변수 참조를 해석하려는 경우 선택란을 선택하십시오.

널값 허용

이 선택란을 선택하면(기본 옵션) 널값이 있는 입력 특성 값이 출력 문서에 맵핑됩니다. 맵 정책에서 널 입력 값을 무시하도록 하려면 이 선택란을 선택 취소하십시오(기본 옵션).

스키마 정의 최적화

이 선택란을 선택하면 최적화된 방식으로 복합 스키마 유형 평가가 순환 유형 참조를 처리합니다. 표준 방식으로 이러한 스키마 유형을 평가하려면 이 선택란을 선택 취소하십시오(기본 옵션).

JSON 사후 처리 사용

이 선택란이 선택된 경우 맵핑된 JSON 출력의 사후 처리가 사용으로 설정됩니다. JSON 출력의 사후 처리가 출력 스키마를 사용하여 특성 값이 스키마에 정의된 것과 동일한 데이터 유형인지 확인합니다. 또한 XML 입력의 오브젝트 맵핑으로 인해 Badgerfish JSON 구문이 있는 출력 특성 값을 정규화합니다. 선택란은 기본적으로 선택 취소된 상태이며, 이는 맵핑된 JSON 출력의 사후 처리가 없음을 의미합니다.

실패한 맵핑에 대한 빈 상위 오브젝트 작성

입력이 없고 기본 맵핑이 구성되지 않았으므로 맵핑이 실패하면 이 설정을 사용하여 동작을 제어합니다.

기본 동작은 출력을 변경하지 않는 것이지만 이 선택란을 선택하면 대상 맵핑의 상위에 대해 비어 있는 오브젝트가 작성되어 IBM API Management Version 4.0의 동작을 에뮬레이트합니다.

예

맵 정책이 output.a.b.c에 대한 맵핑을 정의합니다.

입력 데이터가 있으면 출력은 다음과 같습니다.

{
  "a": {
    "b": {
      "c": "inputvalue"
    }
  }
}

입력 데이터가 없고 실패한 맵핑에 대한 빈 상위 오브젝트 작성 옵션을 선택한 경우 출력은 다음과 같습니다.

{
  "a": {
    "b": {
    }
  }
}

특성 a 및 b가 작성되지만, b 값은 빈 오브젝트입니다.

선택란은 기본적으로 선택되지 않습니다.

배열 오브젝트 및 맵핑된 선택적 오브젝트의 필수 하위 특성 작성

이 선택란이 선택되면 다음과 같은 특정 경우에 입력 데이터가 없거나 맵핑되지 않은 필수 특성에 대한 기본값이 출력에 생성됩니다.

• 배열이 하나 이상의 필수 특성이 포함된 오브젝트로 구성되어 있습니다.
• 선택적인 오브젝트에는 필수인 하나 이상의 하위 특성이 있습니다.

기본적으로 이러한 필수 특성은 출력에 없습니다. 이 옵션을 선택하는 경우 이러한 필수 특성이 출력에 존재합니다. 출력 스키마가 출력 특성에 대한 default 특성을 정의하면 지정된 기본값이 사용됩니다. 그렇지 않으면 다음과 같이 데이터 유형에 따라 기본값이 지정됩니다.

• 문자열: 비어 있는 문자열("")
• 숫자: 0
• 부울: false
• 오브젝트: 비어 있는 오브젝트
• 배열: 비어 있는 배열

예제 1

입력 데이터에 다음과 같은 오브젝트 배열이 있습니다.

[{“a”: “value1”}, {“a”: “value2", "b": “value3”}]

출력 스키마가 출력 오브젝트에 두 개의 특성 a 및 b가 있는 것으로 정의하며, 이 중에서 b는 필수입니다. 맵 정책이 다음 맵핑을 정의합니다.

• input.array.a - output.array.a
• input.array.b - output.array.b

선택란이 선택되고 b가 맵핑되지 않았거나 여기에 입력 데이터가 없는 경우 b 기본값인 비어 있는 문자열이 지정되며 출력은 다음과 같습니다.

[{“a”: “value1", "b": ""}, {"a": "value2", "b": "value3"}]

예제 2

출력 스키마가 다음 구조를 정의합니다.

{"a" : {"b" : {"c" : "value1", "d" : "value2"} } }

b 특성은 선택사항이지만 b 내의 d는 필수입니다.

맵 정책이 output.a.b.c에 대한 맵핑을 정의합니다.

선택란이 선택되고 d가 맵핑되지 않은 경우 d에 기본값인 비어 있는 문자열이 지정되며 출력은 다음과 같습니다.

{"a" : {"b" : {"c" : "value1", "d" : ""} } }

선택란이 선택되지 않으면 이러한 필수 특성이 해당 기본값으로 출력에 작성되지 않습니다.

• 모두(기본 옵션): 비어 있는 하위 배열을 포함하여 비어 있는 배열을 모두 출력합니다.
• parent: 현재 특성의 빈 어레이 값만 출력합니다. 이 특성의 하위 맵 조치는 시도되지 않습니다.
• none: 빈 출력 어레이 값이 생성되지 않도록 합니다.

• 오류
• 경고
• 정보