사용자 정의 ESQL 프로시저를 포함하는 레거시 메시지 맵 변환

ESQL 프로시저를 포함하는 레거시 메시지 맵 을 변환할 때 변환 프로세스는 각 ESQL 프로시저를 ESQL을 호출하는 동등한 사용자 정의 ESQL 변환으로 변환합니다. 태스크 변환은 ESQL 프로시저가 맵핑 노드의 맵에서 호출되는 요구사항을 이행하지 않을 때 변환된 맵에 추가됩니다.

프로시저

레거시 메시지 맵 을 ESQL 프로시저를 포함하는 메시지 맵 으로 변환할 때 변환 프로세스 동작을 확인하십시오.

  1. 변환이 그래픽 데이터 맵에서 호출되는 ESQL 모듈의 요구사항을 충족하는지 확인하십시오. 그래픽 데이터 맵에서 호출되는 ESQL 모듈의 요구사항을 참조하십시오.
  2. 변환된 각 ESQL 프로시저는 소스로 배치됩니다. IBM® App Connect Enterprise 애플리케이션 및 라이브러리 프로젝트를 사용하여 ESQL 프로시저를 저장하지 않는 경우, ESQL 프로시저가 동일한 통합 서버에 독립적으로 배포되므로 각 프로시저의 이름이 고유한지 확인하십시오.
  3. 레거시 메시지 맵 에 ESQL REFERENCE 데이터 유형을 사용하는 ESQL 프로시저가 포함되어 있는지 확인하십시오.
    기본적으로, 변환 프로세스는 ESQL 프로시저를 다음과 같이 변환합니다.
    • ESQL REFERENCE 데이터 유형을 사용하지 않는 ESQL 프로시저는 사용자 정의 ESQL 변환으로 변환됩니다. 자세한 정보는 사용자 정의 ESQL을 참조하십시오.
    • ESQL REFERENCE 데이터 유형을 사용하는 ESQL 프로시저는 태스크 변환으로 변환됩니다. 태스크 변환을 대체하여 맵 변환을 완료해야 합니다. 태스크 변환은 동등한 함수를 제공하는 사용자 정의 XPath 변환으로 대체할 수 있습니다. 사용자 정의 Java 변환이나 사용자 정의 ESQL 변환을 사용할 수도 있습니다.
    ESQL REFERENCE 데이터 유형과 연관된 요구사항이 충족되고 ( 그래픽 데이터 맵에서 호출되는 ESQL 모듈에 대한 요구사항참조) ESQL REFERENCE 데이터 유형을 사용하는 ESQL 프로시저를 태스크 변환 대신 사용자 정의 ESQL 변환으로 변환하려는 경우, 다음 단계를 완료하여 환경 설정을 설정하십시오.
    1. IBM App Connect Enterprise 툴킷 메뉴에서 Windows > 환경 설정 > 통합 개발 >.msgmap 파일의 메시지 맵을.map 파일로 변환을 클릭합니다
    2. REFERENCE 매개변수를 포함하는 사용자 정의 ESQL 프로시저 변환 허용 선택란을 선택하십시오.
  4. ESQL 프로시저에 INOUT 인수가 있는지 확인하십시오.
    변환 프로세스는 INOUT 인수가 포함된 ESQL 프로시저를 INOUT 인수가 IN 인수로 변환되는 사용자 정의 ESQL 변환으로 변환합니다. 기본값인 완료된 변환이 유효하지 않은 경우, 사용자 정의 ESQL 변환은 사용자 정의 XPath 변환 또는 사용자 정의 Java 변환으로 바꿀 수 있습니다.
  5. ESQL 프로시저가 NULL 값을 리턴할 수 있는지 여부를 고려하십시오.
    생성된 ESQL에서 실행되는 레거시 메시지 맵 에서 ESQL 프로시저가 널 (NULL) 값을 리턴하는 경우 출력 대상이 작성되지 않습니다. 변환된 .map 파일에서, 대상 출력 요소는 ESQL 프로시저가 NULL 값을 리턴하는 경우 비어 있는 값으로 작성됩니다. ESQL NULL값을 리턴하는 상황에서 ESQL이 호출되지 않도록 하기 위해 변환된 .map 파일의 사용자 정의 ESQL 변환에 XPath 조건 표현식을 추가해야 할 수 있습니다. 자세한 정보는 널 동작을 참조하십시오.

다음 수행할 사항

레거시 메시지 맵변환을 계속하십시오. 자세한 정보는 .msgmap 파일에서 .map 파일로 메시지 맵 변환을 참조하십시오.