이 작업 주제에서는 Workbench의 새 메시지 정의
파일 마법사를 사용하는 XML 스키마에서 새 메시지 정의를 작성하는 방법에 대해 설명합니다.
시작하기 전에
이 작업을 완료하려면 먼저 다음 작업을 완료해야 합니다.
이 작업을 시작하기 전에 아래에 나열된 사항에 유의해야 합니다.
- ML 스키마에서 새 메시지 정의 파일을 작성하려면 스키마 파일이
Workbench(예: 메시지 세트 프로젝트)에 있어야 합니다. 이것은
새 메시지 정의 파일 마법사에서 스키마 파일을 선택할 수 있도록 합니다.
- 새 메시지 정의 파일을 추가하는 메시지 세트에 XML Wire 형식 계층이
있으나 네임스페이스는 지원하지 않을 경우,
들여온 스키마는 네임스페이스를 제거하도록 수정됩니다. 이러한 이유로, 스키마를 들여오기 전에
네임스페이스 지원을 사용하도록 해야 합니다.
- 새 메시지 정의 파일을 추가하는 메시지 세트에 XML Wire 형식 계층이
없으나 네임스페이스가 지원되면, 모델에는
논리 정보만이 나타납니다. 이러한 이유로 인해
스키마를 들여오기 전에 물리적 계층을 메시지 세트에 추가해야 합니다. 이로써,
스키마의 설정 및 값이 채워졌음이 확인됩니다.
XML 스키마는 네임스페이스를 제거하도록 수정되지 않습니다.
- 새 메시지 정의 파일을 추가하는 메시지 세트에 XML Wire 형식 계층이
없고 네임스페이스가 지원되지 않으면,
논리 정보만이 모델에 나타나며 들여온 스키마는 네임스페이스를
제거하도록 수정됩니다.
- 네임스페이스 지원이 없는 메시지 세트에 대한 작업을 하는 경우,
스키마를 메시지 세트로 들여올 때 적용할 환경설정을 지정해야
합니다.
이러한 환경설정에서 임포터가 특정 개별 스키마 구조체를
처리하는 방법을 지정할 수있습니다. 구성이 발생했음을 발견할 경우
스키마를 거부하거나 구성의 발생을 수정할 수 있습니다. 수정하도록 선택한 경우, 임포터는
구조체의 모든 발생을 수정합니다.
- XML 스키마 파일의 확장자는 소문자 .xsd여야 합니다.
다음 단계에서는 완전히 새로운 메시지 정의 파일을 작성하고
기존 파일의 컨텐츠를 덮어쓰는 것에 대해서도 다룹니다.
XML 스키마 파일에서 메시지 정의를 작성하려면, 다음을 수행하십시오.
- 브로커 응용프로그램 개발 perspective로 전환하십시오.
- Workbench 메뉴에서 파일 > 새로 작성 > 메시지 정의 파일을
눌러 새 메시지 정의 파일 마법사를 여십시오. 또는
이전에 Workbench로 들여온 *.xsd 파일을
마우스 오른쪽 단추로 누른 후 메뉴에서 새로 작성 > 메시지 정의 파일을 눌러
마법사를 열 수 있습니다.
- 표시된 옵션 목록에서 XML 스키마 파일을 눌러
선택한 후 다음을 누르십시오.
- 필요한 사항을 입력하여 남은 마법사 단계를 진행하십시오. XML 스키마 들여오기 처리 시간은 해당 스키마의 크기 및 복잡도에 따라
달라집니다.
대형 복합 스키마에서 파일 들여오기, 로그 파일 생성 및
임의의 타스크 목록 경고 또는 오류를 표시하는데 시간이 다소 소요됩니다.
마법사를 사용하여 XML 스키마 들여오기를 완료한 경우 다음을 수행하십시오.
- 파일을 들여올 때 작성한 보고서에 오류나 경고가 없는지 로그 파일을
주의하여 점검하십시오. 이로써, 스키마를 들여오는데 실패했는지 또는
들여오기가 완료될 수 있도록 수정해야 하는지 여부와 관련된 정보가
제공됩니다. 이 보고서는 작성하려 했던 메시지 정의를 포함하는 프로젝트 내의
log 디렉토리에 구조에 있습니다. 보고서는 새 메시지 정의 파일에 지정한
이름을 접두부로 사용하며, 파일 확장자가 .xsd.report.txt 입니다.
- Workbench 작업 목록에 표시된 메시지를 검토하여 새 경고
또는 오류가 표시되었는지 점검하십시오. 완전히 올바른 스키마를
들여올 수 있었지만 작업 목록이 메시지 정의 파일에 있는 모든 경고
또는 오류를 표시합니다. 메시지가 표시되는 상황에 대한 일부 예가
아래에 제시되어 있습니다.
- 들여올 XML 스키마에 xsd:key, xsd:keyref 및 xsd:unique 구성이 있는 경우,
작업 목록에 경고 메시지가 표시되어 이러한 구성이 지원되지 않으므로 브로커에서 무시됨을 알려줍니다.
이러한 구성을 삭제하려면 메시지 정의 편집기에서 메시지 정의 파일을 열고 오브젝트 삭제에 설명된 대로 구성을 삭제하십시오.
구성을 삭제하면 작업 목록에서 경고 메시지도 제거됩니다. 구성을 삭제하지 않기로 한 경우,
구성이 메시지 모델에 남아 있지만 브로커로 전개되거나 다른 목적으로
사용되지 않습니다. 작업 목록에 경고 메시지가 남지만 메시지 모델을 정상적으로
사용할 수 있습니다.
- 들여오는 중인 XML 스키마에 xsd:redefine 구조체가
포함된 경우 작업 목록에 오류 메시지가 표시되어 이 구조체가 지원되지 않음을 나타냅니다. 오류 메시지를
마우스 오른쪽 단추로 누르고 빠른 수정사항을 선택하면 xsd:redefine 구조체를
xsd:include 구조체로 변환하도록 선택할 수 있습니다. 이 방법으로도 오류 메시지가 제거됩니다.
- 관련된 XML 스키마 파일 콜렉션을 들여오고 메시지 정의 편집기가
들여온 두 파일 간의 링크를 해석할 수 없는 경우, 작업 목록에 참조된 유형 또는
기타 오브젝트를 찾을 수 없음을 알려주는 메시지가 표시됩니다. 이 경우, 메시지 모델 개발 시 문제점 해결에서
추가 정보를 참조하십시오.