주 컨텐츠로 이동
Administrator Guide
최종 업데이트: 2023-06-23
참조: Studio 헬퍼 오브젝트

참조: Studio 헬퍼 오브젝트

Studio는 MVEL을 사용하여 통합의 런타임 속성에 액세스할 수 있게 해주는 다양한 헬퍼 오브젝트를 제공합니다. 헬퍼 오브젝트를 사용하여 런타임 값을 간단히 변경하거나, 런타임 값을 추출하여 어셈블리의 구성요소에 전달할 수 있습니다.
헬퍼 오브젝트
용도
context
에 대한 액세스를 제공합니다.
MediationContext
오브젝트 - 즉, 런타임시 통합의 동적 상태로 변경됩니다. 다음
MediationContext
현재 메시지, 미디에이션 속성, 미디에이션 변수 및 현재 오류 정보에 대한 오브젝트 링크
예: 이 표현식은 속성의 값을 검색합니다.
myProperty
에서
MediationContext
:
context.getProperty('myProperty')
예: 이 표현식은 속성을 검색합니다.
someProperty
에서
MediationContext
속성 값이 다음으로 설정된 경우
someValue
:
context.getProperty('someProperty').equals('someValue')
da
문서 접근자 헬퍼 오브젝트입니다. 이 통합이 실행되기 전에 통합 이벤트에 첨부된 문서 목록에 대한 접근 권한을 제공합니다. 웹서비스 응답에서 참조되는 문서 검색과 Get Event Documents 웹서비스 호출을 효과적으로 결합합니다.
다음
da
헬퍼 오브젝트에는 다음과 같은 몇 가지 제한사항이 있습니다.
  • 예상치 못한 수의 첨부파일을 사용할 수 있는 경우를 처리하는 로직을 명시적으로 포함해야 합니다.
  • 첨부파일의 파일 형식에 액세스할 수 없습니다.
  • 첨부파일의 문자 인코딩에 액세스할 수 없습니다.
doc-iterator
라우터 전략은 예상치 못한 수의 첨부파일을 자동으로 처리하며, MIME 형식과 문자 인코딩 모두에 액세스할 수 있습니다. 통합에서 입력 문서를 검색할 때 이 헬퍼 오브젝트보다 해당 라우터 전략을 사용하는 것이 더 적합한 경우가 많습니다.
예: 이 표현식은 통합 이벤트에서 파일명이
eib_transform_output.txt
인 문서를 검색하고 이라는 변수를 추가합니다.
var1
:
da.toVar('eib_transform_output.txt', 'var1')
예: 다음 표현식은 지정된 레이블이 있는 문서를 검색합니다.
da.getDocsMatching('label')
ftp
ftp, ftps 또는 sftp 서버에 LIST 요청을 실행할 때 반환된 파일 목록에 대한 접근 권한을 제공합니다.
예: 다음 표현식은 URL에 대한 파일 목록을 검색합니다.
ftp.list('URL')
intsys
Get Integration Systems 웹서비스 호출에서 반환된 통합 시스템 구성에 편리하고 빠르게 액세스할 수 있는 접근 권한을 제공합니다.
예: 이 표현식은 이름이 인 통합 특성을 검색합니다.
username
:
intsys.getAttribute('username')
예: 다음 표현식은 지정된 이름의 통합 서비스가 있는 경우 True로 표시됩니다.
intsys.isServiceEnabled('name')
다음을 사용하는 경우
intsys
특성에 액세스하려면 먼저 에서 서비스를 정의해야 합니다.
workday-in
통합 시스템용 전송
lp
통합 개시 이벤트의 개시 매개변수 및 기타 정보에 대한 접근 권한을 제공합니다.
예: 다음 표현식은 지정된 이름을 사용하여 개시 매개변수의 값을 검색합니다.
lp.getSimpleData('name')
예: 다음 표현식은 지정된 레이블의 매개변수가 있는 경우 True로 표시됩니다.
lp.exists('label') == true
사용 전
lp
변수에 시작 매개변수 XML을 지정해야 합니다.
wd.launchparameters
.
message
현재 메시지 및 헤더 정보에 대한 접근 권한을 제공합니다. 이 오브젝트를 사용하여 메시지에 새 콘텐츠를 지정합니다.
예: 이 표현식은 메시지의 root 부분을 에서 텍스트로 검색합니다.
MediationMessage
인터페이스:
message.rootPartAsText
예: 이 표현식은 다음을 검색합니다.
MediationContext
변수:
message.variables
mtable
에 대한 액세스를 제공합니다.
MTableAdapter
의 작업을 정의하는 인터페이스
mtable
인스턴스
예: 이 표현식은
mtable
:
mtable['my_property'].set(0, 'Data_Column', 'my_test_data')
parts
현재 메시지의 개별 부분에 대한 접근 권한을 제공합니다. Workday 통합에서 대부분의 메시지는 단일 부분인 루트 부분으로 구성됩니다. 사용
parts[0]
root 부분에 액세스합니다.
예: 이 표현식은 헤더를 검색합니다.
someHeader
root 부분에서 다음을 수행합니다.
parts[0].getHeader('someHeader')
예: 이 표현식은 다음을 구현합니다.
xpathB
메서드를 사용하여 XPath 부울 표현식을 평가합니다.
parts[0].xpathB('/a/b')
props
에 대한 접근 권한을 제공합니다.
MediationContext
속성
예: 이 표현식은 속성의 값을 검색합니다.
myProperty
에서
MediationContext
:
props.myProperty
예: 이 표현식은 속성의 값을 검색합니다.
bean.property
에서
MediationContext
:
props['bean.property']
spring
어셈블리의 Spring 구성에 정의된 생성 및 검색 bean에 대한 접근 권한을 제공합니다.
예: 이 표현식은 다음을 검색합니다.
name
이라는 빈(bean)의 속성
Fred
다음과 같이 설정합니다.
spring.getBean('fred').name
예를 들어, 다음 표현식은 봄 어플리케이션 컨텍스트에 액세스합니다.
spring.parent ApplicationContext
util
XML에 삽입할 값을 이스케이프하거나 HTTPS URL을 생성하는 등의 일반적인 작업을 수행하기 위한 유틸리티 함수 세트입니다.
예: 이 표현식은 의 현재 메시지가
MediationContext
분할기 구성요소가 생성하는 마지막 메시지입니다.
props['is.last.record'] = util.isLastMessageInBatch()
일부
util
함수에는 중요한 제한사항이 있습니다. 예:
xpathToCommaDelimString
이 함수는 지정된 XML 문자열에서 작동하는 XPath 표현식에서 반환된 노드 시퀀스의 문자열 값에서 쉼표로 구분된 목록을 생성합니다. MVEL에서 Java 문자열 조작 함수를 사용하여 쉼표로 구분된 목록을 분할하고 조작할 수 있습니다. 그러나 이 함수에는 다음과 같은 제한사항이 있습니다.
  • XPath 1만 지원합니다.
  • 줄 바꿈 문자, 쉼표 및 따옴표 문자를 올바르게 이스케이프하지 않으므로 CSV 파일을 생성할 수 없습니다.
  • 쉼표가 포함된 데이터를 확실하게 구분할 수 없습니다.
  • XML이 문자열이어야 한다는 요구사항으로 인해 현재 컨텍스트 메시지 또는 변수를 문자열로 변환하는 등의 확장할 수 없는 방식이 권장됩니다.
안정성 및 이전 버전과의 호환성을 위해 버전이 지정된 명시적 웹서비스 요청을 사용하는 것이 좋습니다. 사용처
MVELUtilHelper.getLatestWWSVersion()
의 통합은 모범 사례가 아니며 통합으로 인해 예상치 못한 실패 또는 결과가 발생할 수 있습니다.
vars
에 대한 접근 권한을 제공합니다.
MediationContext
변수
예: 이 표현식은 변수의 길이를 검색합니다.
myVariable
:
vars['myVariable'].length
예: 이 표현식은 변수의 길이를 검색합니다.
myVariable
:
vars['myVariable'].length
xmldiff
xmldiff
구성요소를 사용하여 문서를 비교한 결과에 대한 프로그래밍 방식의 접근 권한을 제공합니다.
예: 이 표현식은 두 문서 간에 차이가 있는지 확인합니다.
xmldiff.isDifferent() == true
예: 다음 표현식은 두 문서 간의 차이점 목록을 검색합니다.
xmldiff.changes