Red Hat Summit55.2. URI 형식
SAP 구성 요소에서 제공하는 엔드포인트에는 Remote Function called (RFC) 엔드포인트와 Intermediate Document (IDoc) 끝점이 있습니다.
RFC 끝점의 URI 형식은 다음과 같습니다.
sap-srfc-destination:destinationName:rfcName
sap-trfc-destination:destinationName:rfcName
sap-qrfc-destination:destinationName:queueName:rfcName
sap-srfc-server:serverName:rfcName[?options]
sap-trfc-server:serverName:rfcName[?options]IDoc 끝점의 URI 형식은 다음과 같습니다.
sap-idoc-destination:destinationName:idocType[:idocTypeExtension[:systemRelease[:applicationRelease]]]
sap-idoclist-destination:destinationName:idocType[:idocTypeExtension[:systemRelease[:applicationRelease]]]
sap-qidoc-destination:destinationName:queueName:idocType[:idocTypeExtension[:systemRelease[:applicationRelease]]]
sap-qidoclist-destination:destinationName:queueName:idocType[:idocTypeExtension[:systemRelease[:applicationRelease]]]
sap-idoclist-server:serverName:idocType[:idocTypeExtension[:systemRelease[:applicationRelease]]][?options]sap-endpointKind-destination이 접두사로 지정된 URI 형식은 대상 끝점(즉, Camel 프로듀서 끝점)을 정의하는 데 사용되며 destinationName 은 SAP 인스턴스에 대한 특정 아웃바운드 연결의 이름입니다. 아웃바운드 연결은 구성 요소 수준에서 이름이 지정되고 구성됩니다.
sap-endpointKind-server 접두사가 접두사로 지정된 URI 형식은 서버 끝점(즉, Camel 소비자 끝점)을 정의하는 데 사용되며 serverName 은 SAP 인스턴스에서 가져온 특정 인바운드 연결의 이름입니다. 인바운드 연결은 구성 요소 수준에서 이름이 지정되고 구성됩니다.
RFC 끝점 URI의 다른 구성 요소는 다음과 같습니다.
- rfcName
- (필수) 대상 끝점 URI에서 는 연결된 SAP 인스턴스의 끝점에서 호출한 RFC의 이름입니다. 서버 끝점 URI에서 는 연결된 SAP 인스턴스에서 호출할 때 끝점에서 처리하는 RFC의 이름입니다.
- queueName
- 이 끝점에서 SAP 요청을 보내는 큐를 지정합니다.
IDoc 끝점 URI의 다른 구성 요소는 다음과 같습니다.
- idocType
- (필수) 이 끝점에서 생성한 IDoc의 기본 IDoc 유형을 지정합니다.
- idocTypeExtension
- 이 끝점에서 생성한 IDoc의 IDoc Type Extension이 지정합니다.
- systemRelease
- 이 끝점에서 생성한 IDoc의 관련 SAP Basis 릴리스(있는 경우)를 지정합니다.
- applicationRelease
- 이 끝점에서 생성한 IDoc의 관련 애플리케이션 릴리스(있는 경우)를 지정합니다.
- queueName
- 이 끝점에서 SAP 요청을 보내는 큐를 지정합니다.
55.2.1. RFC 대상 끝점 옵션
RFC 대상 끝점(sap-srfc-destination,sap-trfc-destination, sap-qrfc-destination)은 다음과 같은 URI 옵션을 지원합니다.
| 이름 | Default | 설명 |
|---|---|---|
|
|
|
|
|
|
|
|
55.2.2. RFC 서버 엔드 포인트 옵션
SAP RFC 서버 끝점(sap-srfc-server 및 sap-trfc-server)은 다음과 같은 URI 옵션을 지원합니다.
| 이름 | Default | 설명 |
|---|---|---|
|
|
|
|
|
|
|
(SAP-trfc-server 끝점만 해당) |
55.2.3. IDoc List 서버 끝점의 옵션
SAP IDoc List Server 끝점(sap-idoclist-server)은 다음과 같은 URI 옵션을 지원합니다.
| 이름 | Default | 설명 |
|---|---|---|
|
|
|
|
|
|
|
|
55.2.4. RFC 및 IDoc 끝점 요약
SAP 구성 요소 패키지는 다음과 같은 RFC 및 IDoc 끝점을 제공합니다.
sap-srfc-destinationCamel SAP 비동기 원격 기능 call Destination Camel 구성 요소. 이 엔드포인트는 Camel 경로가 SAP 시스템에 대한 요청 및 응답을 동기식으로 전달해야 하는 경우 사용해야 합니다.
참고이 구성 요소에서 사용하는 sRFC 프로토콜은 최상의 노력으로 SAP 시스템에 대한 요청 및 응답을 제공합니다. 요청을 보내는 동안 통신 오류가 발생하는 경우 SAP 시스템을 수신하는 원격 기능 호출의 완료 상태는 의심의 여지없이 유지됩니다.
sap-trfc-destinationCamel SAP Transactional Remote Function call Destination Camel 구성 요소. 이 끝점은 최대 한 번 수신 SAP 시스템에 요청을 전달해야하는 경우 사용해야합니다. 이를 위해 구성 요소는 경로 교환에서 구성 요소를 통해 전송된 모든 요청과 함께 제공되는 트랜잭션 ID인
tid를 생성합니다. SAP 시스템을 수신하는 것은 요청을 전달하기 전에 요청과 함께 제공된tid를 기록합니다. SAP 시스템이 동일한tid로 요청을 다시 수신하는 경우 요청을 전달하지 않습니다. 따라서 이 구성 요소의 끝점을 통해 요청을 보낼 때 경로에서 통신 오류가 발생하면 해당 경로가 한 번만 전달 및 실행된다는 것을 알고 있는 동일한 교환 내의 요청 전송을 다시 시도할 수 있습니다.참고이 구성 요소에서 사용하는 tRFC 프로토콜은 비동기식이며 응답을 반환하지 않습니다. 따라서 이 구성 요소의 끝점에서 응답 메시지를 반환하지 않습니다.
참고이 구성 요소는 끝점을 통한 일련의 요청 순서를 보장하지 않으며, 이러한 요청의 제공 및 실행 순서는 통신 오류 및 요청의 재전송으로 인해 SAP 시스템을 수신하는 것과 다를 수 있습니다. 보장된 제공 주문은 Camel SAP Queued Remote Function call Destination Camel 구성 요소를 참조하십시오.
sap-qrfc-destinationCamel SAP Queued Remote Function call Destination Camel 구성 요소. 이 구성 요소는 끝점을 통한 요청 전달에 대해 전달을 보장하는 순서에 추가하여 Transactional Remote Function call camel 구성 요소의 기능을 확장합니다. 이 끝점은 일련의 요청이 서로 의존하며 수신 SAP 시스템에 한 번만 전달되어야 하는 경우에 사용해야 합니다. 이 구성 요소는 대부분 Camel SAP Transactional Remote Function call Destination Camel 구성 요소와 동일한 메커니즘을 사용하여 제공을 보장합니다. 순서 보장은 SAP 시스템에서 인 바운드 큐로 수신되는 순서대로 요청을 직렬화하여 수행됩니다. 인바운드 대기열은 SAP 내의 QIN 스케줄러 에서 처리합니다. 인바운드 큐가 활성화되면 QIN Scheduler는 큐 요청을 순서대로 실행합니다.
참고이 구성 요소에서 사용하는 qRFC 프로토콜은 비동기식이며 응답을 반환하지 않습니다. 따라서 이 구성 요소의 끝점에서 응답 메시지를 반환하지 않습니다.
sap-srfc-server- Camel SAP 비동기 원격 기능 call Server Camel 구성 요소. 이 구성 요소와 엔드포인트는 SAP 시스템에서 요청을 동시에 처리하고 응답을 처리하기 위해 Camel 경로가 필요한 경우 사용해야 합니다.
sap-trfc-server-
Camel SAP Transactional Remote Function call Server Camel 구성 요소. 이 엔드포인트는 전송 시 SAP 시스템에 요청을 Camel 경로로 전달해야 하는 경우 사용해야 합니다. 이를 위해 SAP 시스템 전송은 구성 요소의 끝점으로 전송하는 모든 요청과 함께 트랜잭션 ID인
tid를 생성합니다. 송신 SAP 시스템은 먼저tidtid목록을 확인하고, 전송된tid가 해당 목록에 없는 경우 전송된 tid를 기록합니다. 그런 다음 전송 SAP 시스템에 응답하고,tid가 이미 기록되었는지 여부를 나타냅니다. 그런 다음 전송 SAP 시스템은 태그를 이전에 기록하지 않은 경우 일련의 요청을 보냅니다.이를 통해 SAP 시스템을 전송하면 일련의 요청을 camel 경로에 안정적으로 보낼 수 있습니다. sap-idoc-destination- Camel SAP IDoc Destination Camel 구성 요소. Camel 경로가 중간 문서(IDoc) 목록을 SAP 시스템으로 보내는 경우 이 엔드포인트를 사용해야 합니다.
sap-idoclist-destination- Camel SAP IDoc List Camel 구성 요소. Camel 경로가 중간 문서(IDoc) 목록을 SAP 시스템으로 보내는 경우 이 엔드포인트를 사용해야 합니다.
sap-qidoc-destination- Camel SAP Queued IDoc Destination Camel 구성 요소. 이 구성 요소와 끝점은 Camel 경로가 SAP 시스템에 중간 문서(IDoc) 목록을 순서대로 보내야 하는 경우 사용해야 합니다.
sap-qidoclist-destination- Camel SAP Queued IDoc List Destination Camel 구성 요소. 이 구성 요소와 해당 끝점은 camel 경로가 중간 문서(IDoc) 목록을 SAP 시스템으로 전송하는 경우에 사용됩니다.
sap-idoclist-server-
Camel SAP IDoc List Server Camel 구성 요소. 이 엔드포인트는 SAP 시스템에서 중간 문서 목록을 Camel 경로로 전달해야 하는 경우 사용해야 합니다. 이 구성 요소는 tRFC 프로토콜을 사용하여
sap-trfc-server-standalone퀵 스타트에 설명된 대로 SAP와 통신합니다.
55.2.5. SAP RFC 대상 끝점
RFC 대상 끝점은 SAP에 대한 아웃바운드 통신을 지원하므로 이러한 끝점이 SAP에서 ABAP 함수 모듈을 RFC로 호출할 수 있습니다. RFC 대상 엔드포인트는 특정 SAP 인스턴스에 대한 연결을 통해 특정 ABAP 함수에 대한 RFC 호출을 수행하도록 구성됩니다. RFC 대상은 아웃바운드 연결에 대한 논리적 지정이며 고유한 이름을 갖습니다. RFC 대상은 대상 데이터 라는 일련의 연결 매개변수로 지정됩니다.
RFC 대상 끝점은 IN-OUT 교환의 입력 메시지에서 RFC 요청을 추출하고 SAP에 대한 함수 호출에서 해당 요청을 수신하고 전달합니다. 함수 호출의 응답은 교환의 출력 메시지에 반환됩니다. SAP RFC 대상 끝점은 아웃바운드 통신만 지원하므로 RFC 대상 끝점은 생산자 생성만 지원합니다.
55.2.6. SAP RFC 서버 끝점
RFC 서버 엔드포인트는 SAP의 인바운드 통신을 지원하므로 SAP의 ABAP 애플리케이션이 서버 끝점에 대한 RFC 호출을 수행할 수 있습니다. ABAP 애플리케이션은 RFC 서버 끝점과 마치 원격 기능 모듈인 것처럼 상호 작용합니다. RFC 서버 엔드포인트는 SAP 인스턴스에서 특정 연결을 통해 특정 RFC 함수에 대한 RFC 호출을 수신하도록 구성됩니다. RFC 서버는 인바운드 연결에 대한 논리적 지정이며 고유한 이름이 있습니다. RFC 서버는 server data 라는 일련의 연결 매개변수로 지정됩니다.
RFC 서버 끝점은 들어오는 RFC 요청을 처리하고 IN-OUT 교환의 입력 메시지로 전달합니다. 교환의 출력 메시지는 RFC 호출의 응답으로 반환됩니다. SAP RFC 서버 엔드포인트는 인바운드 통신만 지원하므로 RFC 서버 엔드포인트는 소비자 생성만 지원합니다.
55.2.7. SAP IDoc 및 IDoc 목록 대상 끝점
IDoc 대상 끝점은 SAP에 대한 아웃바운드 통신을 지원하므로 IDoc 메시지에서 추가 처리를 수행할 수 있습니다. IDoc 문서는 비SAP 시스템과 쉽게 교환할 수 있는 비즈니스 트랜잭션을 나타냅니다. IDoc 대상은 대상 데이터 라는 일련의 연결 매개 변수로 지정됩니다.
IDoc 목록 대상 끝점은 처리하는 메시지가 IDoc 문서 목록으로 구성된다는 점을 제외하고 IDoc 대상 끝점과 유사합니다.
55.2.8. SAP IDoc 목록 서버 끝점
IDoc 목록 서버 엔드포인트는 SAP의 인바운드 통신을 지원하므로 Camel 경로를 통해 SAP 시스템에서 IDoc 문서 목록을 수신할 수 있습니다. IDoc 목록 서버는 서버 데이터 라는 일련의 연결 매개 변수로 지정됩니다.
55.2.9. 메타데이터 리포지토리
메타데이터 리포지토리는 다음과 같은 종류의 메타데이터를 저장하는 데 사용됩니다.
- 함수 모듈에 대한 인터페이스 설명
- 이 메타데이터는 JCo 및 ABAP 런타임에서 이러한 호출을 디스패치하기 전에 통신 파트너 간 데이터 유형을 안전하게 전송하기 위해 RFC 호출을 확인하는 데 사용됩니다. 리포지토리는 리포지토리 데이터로 채워집니다. 리포지토리 데이터는 이름이 지정된 함수 템플릿의 맵입니다. 함수 템플릿에는 모든 매개변수와 함수 모듈에서 전달되거나 전달되는 입력 정보를 설명하는 메타데이터가 포함되어 있으며, 설명하는 함수 모듈의 고유한 이름이 있습니다.
- IDoc 유형 설명
- 이 메타데이터는 IDoc 런타임에서 IDoc 문서가 통신 파트너에게 전송되기 전에 올바르게 포맷되도록 하는 데 사용됩니다. 기본 IDoc 유형은 이름, 허용된 세그먼트 목록 및 세그먼트 간 계층 관계에 대한 설명으로 구성됩니다. 세그먼트에 일부 추가 제약 조건을 적용할 수 있습니다. 세그먼트는 필수 또는 선택 사항일 수 있으며 각 세그먼트에 대해 최소/최대 범위를 지정할 수 있습니다(해당 세그먼트의 허용된 반복 수 정의).
따라서 SAP 대상 및 서버 끝점은 RFC 호출을 전송 및 수신하기 위해 리포지토리에 IDoc 문서를 전송 및 수신해야 합니다. RFC 호출의 경우 끝점에서 호출하고 처리하는 모든 함수 모듈의 메타데이터는 리포지토리 내에 있어야 하며 IDoc 끝점의 경우 끝점에서 처리하는 모든 IDoc 유형 확장의 메타데이터가 리포지토리 내에 있어야 합니다. 대상 및 서버 끝점에서 사용하는 리포지토리의 위치는 대상 데이터 및 해당 연결의 서버 데이터에 지정됩니다.
SAP 대상 끝점의 경우 일반적으로 사용하는 리포지토리는 SAP 시스템에 있으며 연결된 SAP 시스템의 기본값입니다. 이 기본값은 대상 데이터에 대한 명시적 구성이 필요하지 않습니다. 또한 대상 끝점이 생성하는 remote 함수 호출의 메타데이터는 호출하는 기존 함수 모듈에 대한 리포지토리에 이미 존재합니다. 따라서 대상 끝점에서 호출하기 위한 메타데이터는 SAP 구성 요소에 구성이 필요하지 않습니다.
반면 서버 끝점에서 처리하는 함수 호출의 메타데이터는 일반적으로 SAP 시스템의 리포지토리에 상주하지 않으며 SAP 구성 요소에 상주하는 리포지토리에서 대신 제공해야 합니다. SAP 구성 요소는 이름이 지정된 메타데이터 리포지토리의 맵을 유지 관리합니다. 리포지토리의 이름은 메타데이터를 제공하는 서버의 이름에 해당합니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}