WebSphere Enterprise Service Bus, 버전 6.2.0 운영 체제: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


XSL 변환 중개 기본

XSLT(XSL 변환) 중개 기본을 사용하여 메시지를 변환합니다.

소개

XSL 중개 기본을 사용하면 XSL 변환을 사용하여 메시지를 변환할 수 있습니다.

서비스를 통합할 때, 종종 데이터를 수신 서비스가 처리할 수 있는 형식으로 변환해야 합니다. XSL 변환 중개 기본을 사용하여 임의의 메시지 유형을 다른 메시지 유형으로 변환할 수 있습니다.

XSL 변환 기본에 하나의 입력 터미널(in), 하나의 출력 터미널(out) 및 실패 터미널(fail)이 있습니다. in 터미널은 메시지를 승인하도록 연결되고 다른 터미널은 메시지를 전달하도록 연결됩니다. 입력 메시지가 변환을 트리거하고 변환이 성공하는 경우 out 터미널이 수정된 메시지를 전달시킵니다. 변환 중에 예외가 발생하는 경우 fail 터미널은 failInfo 요소에 들어 있는 모든 예외 정보와 함께 원래 메시지를 전달시킵니다.

세부사항

XSL 변환 기본에서는 XSLT 1.0 변환을 사용하여 메시지 조작을 위한 간단한 메커니즘을 제공합니다. 입력 메시지와 출력 메시지를 맵핑하여 SMO의 헤더, 컨텍스트 또는 본문을 변경할 수 있습니다.

메시지를 변환하려면 XSL 변환 중개 기본은 맵핑 파일에 액세스해야 하며 해당 파일은 맵핑 파일 특성을 사용하여 지정할 수 있습니다. 맵핑 파일은 XML 맵핑 파일 또는 XSL 스타일시트 중 하나입니다.

XSL 변환 중개 기본을 작성할 때, WebSphere® Integration Developer를 사용하여 특성 보기의 세부사항 탭에서 새 XML 맵을 작성할 수 있습니다. 또는 기존 XML 맵을 찾아보고 적합한 맵을 선택할 수 있습니다.

XML 맵을 작성할 때, 메시지 루트(XPath 1.0 표현식)를 지정하며, 이는 중개 플로우의 경우 SMO에서 /, /headers, /context 또는 /body 위치를 참조할 수 있습니다. 메시지 루트는 변환 루트를 지정하며 입력 메시지와 출력 메시지 모두에 적용됩니다. 메시지 루트가 /인 경우 변환이 전체 SMO에 적용됩니다.

맵핑이 작성된 후 XML 맵핑 편집기를 사용하는 경우, XSL 스타일시트를 작성하여 런타임 시 변환을 수행합니다. XML 맵핑 편집기를 사용하기 전에 XSL 변환 기본의 입력 및 출력 터미널을 연결하는 경우, 입력 및 출력 메시지 유형이 입력되어 있습니다. 자세한 정보는 WebSphere Integration Developer 주제: 새 XML 맵 작성을 참조하십시오.

XML 맵핑 편집기를 사용하지 않아도 됩니다. 또는, 기존 XSL 스타일시트를 사용하여 변환을 수행할 수 있습니다. 스타일시트는 선택하기 전에 중개 모듈 프로젝트 디렉토리에 있어야 합니다. 자세한 정보는 WebSphere Integration Developer 주제: 기존 XSL 스타일시트 사용을 참조하십시오.

이주

WebSphere Integration Developer 버전 6.1에서, XSL 변환 기본에 새 XML 맵핑 편집기가 있습니다. 이전 버전에 빌드된 XML 맵을 편집하려면 새 형식으로 이주해야 합니다. 이주에 대한 자세한 정보는 WebSphere Integration Developer 주제: XSL 변환 기본 이주를 참조하십시오.

사용법

메시지 유형이 다른 중개 기본을 연결해야 하는 경우, XSL 변환 중개 기본을 사용하여 메시지 유형을 변환할 수 있습니다.

다음을 수행하려면 XSL 변환 기본을 사용할 수 있습니다.
  • 입력 메시지 유형을 다른 출력 메시지 유형으로 변환합니다. 예를 들어, 중개 플로우가 한 조작으로 시작하지만 다른 조작으로 끝나는 경우 두 번째 조작은 다른 인수 유형을 갖습니다.
  • 메시지 유형을 변경하지 않고 메시지의 컨텐츠를 변경합니다.
  • 기존 XML 맵 또는 스타일시트를 적용하여 메시지를 변환합니다.
XSL 변환 중개 기본은 다음을 원하는 경우에 유용할 수 있습니다.
  • 데이터베이스 찾아보기 중개 기본이 호출되기 전이나 후에 데이터를 조작합니다.
  • 서비스 호출 중개 기본의 응답을 공유 컨텍스트에 복사합니다.
  • 팬인 중개 기본 후에 공유 컨텍스트의 데이터를 사용하여 새 메시지 본문을 작성합니다.

XSL 변환 기본 또는 비즈니스 오브젝트 맵 중개 기본을 사용하여 메시지를 변환할 수 있습니다. 중요한 차이점은 XSL 변환 기본은 스타일시트를 사용하여 XML에서 변환을 수행하는 반면, 비즈니스 오브젝트 맵 기본은 서비스 데이터 오브젝트(SDO)를 사용하여 비즈니스 오브젝트에서 변환을 수행한다는 점입니다. 기존 XSL 맵 또는 XSL 스타일시트가 있는 경우 XSL 변환 기본에서 다시 사용할 수 있으며, 기존 비즈니스 오브젝트 맵이 있는 경우 비즈니스 오브젝트 맵 기본에서 다시 사용할 수 있습니다. 일부 종류의 변환은 XSL로 수행하기가 더 쉬우며, 다른 변환은 비즈니스 오브젝트 맵을 사용합니다.

특성

맵핑 파일
중개 기본이 사용하는 XML 맵핑 파일 또는 XSL 스타일시트의 이름을 지정합니다. XSL 스타일시트와 연관된 XML 맵핑 파일 또는 XSL 스타일시트를 선택할 수 있습니다.

기존 XML 맵핑 파일을 찾아보거나 새 맵핑 파일을 작성할 수 있습니다. XML 맵핑 파일에 런타임 시 변환을 수행하도록 생성된 XSL 스타일시트가 있습니다.

기존 XSL 스타일시트가 중개 모듈과 동일한 프로젝트에 있는 경우, 이를 찾을 수 있습니다.

런타임에서 맵핑 파일 값을 동적으로 대체하려면 맵핑 파일을 적절하게 승격해야 합니다. (단, 맵핑 파일 특성에 기본값을 제공해야 합니다.) 대체 값은 XSL 스타일시트로 해석해야 합니다. 스타일시트는 프로젝트의 자원 경로로 지정할 수 있습니다. (예: xslt/TransformCustomer.xsl) 또는 스타일시트는 URL로 지정할 수 있습니다. (예: http://myserver.com/customerstylsheet.xsl 또는 file://c:/customerstylesheet.xsl)
주: 변환이 제대로 수행되려면 스타일시트는 런타임 시스템에서 사용 가능해야 합니다.
루트
변환 루트를 지정하는 XPath 1.0 표현식입니다. 새 XML 맵을 작성할 때, 다음 메시지 루트 /, /headers, /context 또는 /body를 지정할 수 있습니다. /는 전체 SMO를 의미하고, /headers는 SMO의 헤더를 의미하고, /context는 SMO의 컨텍스트를 의미하고 /body는 SMO의 본문 섹션을 의미합니다. 이 특성이 입력 메시지와 변환된 메시지 모두에 사용됩니다.

/, /headers 또는 /context를 루트로 선택하는 경우, XML 맵핑 편집기를 사용하여 모든 SMO 섹션을 명시적으로 맵핑해야 합니다. 그렇지 않은 경우, 런타임 시 오류가 발생할 수 있습니다. SMO의 헤더 또는 컨텍스트 섹션에서 정보를 변경하지 않아도 되는 경우, 맵핑 시작점을 /body로 사용할 수 있습니다.

입력 유효성 검증
true인 경우 입력 메시지는 중개가 수행되기 전에 런타임에서 검증됩니다.
표 1. XSL 변환 중개 기본의 특성
특성 유효값 기본값
맵핑 파일 문자열  
루트 문자열: 변환 루트를 표시하는 XPath 표현식 /body
입력 유효성 검증 부울: true 또는 false false

고려사항

XSL 변환 중개 기본을 사용할 때 다음을 고려하십시오.


reference 참조 주제

이용약관 | 피드백


시간소인 아이콘 마지막 갱신 날짜: 09 7월 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/ref/rwesb_XSLTmediationprimitive.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org)