Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

289.6. 설정

SAP 구성 요소는 대상 데이터, 서버 데이터 및 리포지토리 데이터를 저장하는 3개의 맵을 유지 관리합니다. 대상 데이터 저장소 및 서버 데이터 저장소는 특수 구성 오브젝트인 SapConnectionConfiguration 을 사용합니다. 이 오브젝트는 SAP 구성 요소( resultiction XML 구성 또는 Spring XML 구성 파일의 컨텍스트에서)에 자동으로 삽입됩니다. 리포지토리 데이터 저장소는 관련 SAP 구성 요소에서 직접 구성해야 합니다.

289.6.1. 구성 개요
링크 복사

289.6.1.1. 개요
링크 복사

SAP 구성 요소는 대상 데이터, 서버 데이터 및 리포지토리 데이터를 저장하는 3개의 맵을 유지 관리합니다. 구성 요소의 속성인 destinationDataStore 는 대상 이름을 기반으로 하는 대상 데이터를 저장합니다. 속성인 serverDataStore 는 서버 이름으로 키화된 서버 데이터를 저장합니다. 속성인 repositoryDataStore.은 리포지토리 이름으로 키화된 리포지토리 데이터를 저장합니다. 초기화하는 동안 이러한 구성을 구성 요소에 전달해야 합니다.

289.6.1.2. 예제
링크 복사

다음 예제에서는 샘플 대상 데이터 저장소와 샘플 서버 데이터 저장소를 FlexVolume XML 파일에 구성하는 방법을 보여줍니다. sap-configuration Bean( SapConnectionConfiguration유형)은 이 XML 파일에 사용되는 모든 SAP 구성 요소에 자동으로 삽입됩니다. 

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
        <property name="serverDataStore">
            <map>
                <entry key="quickstartServer" value-ref="quickstartServerData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="passowrd" />
        <property name="lang" value="en" />
    </bean>

    <!-- Configures an Inbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment ** -->
    <bean id="quickstartServerData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl">
        <property name="gwhost" value="example.com" />
        <property name="gwserv" value="3300" />
        <!-- Do not change the following property values -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>
Copy to Clipboard Toggle word wrap

289.6.2. 대상 설정
링크 복사

289.6.2.1. 개요
링크 복사

대상 구성은 SAP 구성 요소의 destinationDataStore 속성에 유지됩니다. 이 맵의 각 항목은 SAP 인스턴스에 대한 고유한 아웃바운드 연결을 구성합니다. 각 항목의 키는 아웃바운드 연결의 이름이며 URI 형식 섹션에 설명된 대로 대상 엔드포인트 URI의 destinationName 구성 요소에 사용됩니다.

각 항목의 값은 아웃바운드 SAP 연결 구성을 지정하는 대상 데이터 구성 오브젝트(또는g .fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl -)입니다.

289.6.2.2. 대상 구성 샘플
링크 복사

다음ECDHE XML 코드는 이름 quickstartDest 로 샘플 대상을 구성하는 방법을 보여줍니다. 

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Create interceptor to support tRFC processing -->
    <bean id="currentProcessorDefinitionInterceptor"
          class="org.fusesource.camel.component.sap.CurrentProcessorDefinitionInterceptStrategy" />

    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="password" />
        <property name="lang" value="en" />
    </bean>

</blueprint>
Copy to Clipboard Toggle word wrap

예를 들어 이전 IRQ XML 파일에 표시된 대로 대상을 구성한 후 다음 URI를 사용하여 빠른 시작 대상에서 BAPI_FLECDHEST_GETLIST 원격 함수 호출을 호출할 수 있습니다. 

sap-srfc-destination:quickstartDest:BAPI_FLCUST_GETLIST
Copy to Clipboard Toggle word wrap

289.6.2.3. tRFC 및 qRFC 대상의 인터셉터
링크 복사

위의 샘플 대상 구성은 CurrentProcessorDefinitionInterceptStrategy 오브젝트의 인스턴스화를 보여줍니다. 이 오브젝트는 Camel 런타임에 인터셉터를 설치하여 Camel SAP 구성 요소가 RFC 트랜잭션을 처리하는 동안 Camel 경로 내에서 위치를 추적할 수 있도록 합니다. 자세한 내용은 “트랜잭션 RFC 대상 끝점” 에서 참조하십시오.

중요

아웃바운드 트랜잭션 RFC 통신을 올바르게 관리하려면 이 인터셉터를 Camel 런타임에 설치해야 합니다.

트랜잭션 RFC 대상 끝점(예: sap-trfc-destination 및 sap-qrfc-destination)에 매우 중요합니다.

Destination RFC Transaction Handlers는 런타임 시 전략이 없는 경우 Camel 로그에 경고를 발행하며 이러한 경우 아웃바운드 트랜잭션 RFC 통신을 올바르게 관리하기 위해 Camel 런타임을 다시 프로비저닝하고 다시 시작해야 합니다.

289.6.2.4. 로그인 및 인증 옵션
링크 복사

다음 표에는 SAP 대상 데이터 저장소 에서 대상을 구성하기 위한 로그인 및 인증 옵션이 나와 있습니다.

Expand

이름

기본값

설명

클라이언트

 

SAP 클라이언트, 필수 로그인 매개변수

user

 

로그인 사용자, 암호 기반 인증의 로그인 매개 변수

aliasUser

 

로그인 사용자 별칭은 로그인 사용자 대신 사용할 수 있습니다.

userId

 

ABAP AS 로그인에 사용할 사용자 ID입니다. JCo 런타임에서 대상 구성에서 SSO/assertion 티켓, 인증서, 현재 사용자 또는 SNC 환경을 사용하여 인증을 사용하는 경우 사용됩니다. 사용자 또는 사용자 별칭이 없는 경우 사용자 ID가 필수입니다. 이 ID는 SAP 백엔드에서 사용되지 않으며, JCo 런타임에서는 이를 로컬에서 사용합니다.

passwd

 

로그인 암호, 로그인 매개 변수(암호 기반 인증)

lang

 

사용자 언어 대신 사용할 로그인 언어

mysapsso2

 

지정된 SAPECDHE 버전 2를 SSO 기반 인증의 로그인 티켓으로 사용

x509cert

 

인증서 기반 인증에 지정된 X509 인증서 사용

lcheck

 

첫 번째 호출 - 1(활성화)까지 인증을 연기합니다. 특수 경우에만 lcheck 를 사용합니다.

useSapGui

 

가시화되거나 숨겨져 있거나 SAP GUI를 사용하지 않는 경우

codePage

 

로그인 매개 변수를 변환하는 데 사용되는 codepage를 정의하는 추가 로그인 매개 변수입니다. 특별한 경우에만 codePage 를 사용하십시오.

getsso2

 

로그인 후 SSO 티켓을 주문하면 받은 티켓이 대상 속성에서 사용할 수 있습니다.

denyInitialPassword

 

1 로 설정하면 초기 암호를 사용하면 예외가 발생합니다(기본값은 0입니다).

289.6.2.5. 연결 옵션
링크 복사

다음 표에는 SAP 대상 데이터 저장소에서 대상을 구성하기 위한 연결 옵션이 나열되어 있습니다.

Expand

이름

기본값

설명

saprouter

 

SAP 라우터 뒤의 시스템과의 연결을 위한 SAP 라우터 문자열입니다. SAP Router 문자열에는 SAP 라우터 체인과 해당 포트 번호의 체인이 포함되어 있으며, 형식은 (/H/<host>[/S/<port>])+

sysnr

 

SAP ABAP 애플리케이션 서버의 시스템 번호, 직접 연결의 경우 필수 항목

ashost

 

SAP ABAP 애플리케이션 서버, 직접 연결의 경우 필수 항목

mshost

 

SAP 메시지 서버, 로드 밸런싱 연결에 대한 필수 속성

msserv

 

SAP 메시지 서버 포트, 로드 밸런싱 연결에 대한 선택적 속성. 서비스 이름 sapmsXXX를 해결하기 위해 운영 체제의 네트워크 계층은 etc/services 에서 조회를 수행합니다. 심볼릭 서비스 이름 대신 포트 번호를 사용하는 경우 조회 및 추가 항목이 필요하지 않습니다.

gwhost

 

공식 게이트웨이를 지정할 수 있습니다. 이를 사용하여 애플리케이션 서버에 대한 연결을 설정합니다. 지정하지 않으면 애플리케이션 서버의 게이트웨이가 사용됩니다.

gwserv

 

gwhost 를 사용할 때 이를 설정합니다. 해당 게이트웨이에서 사용되는 포트를 지정할 수 있습니다. 지정하지 않으면 애플리케이션 서버의 게이트웨이 포트가 사용됩니다. 서비스 이름 sapgwXXX를 해결하기 위해 운영 체제의 네트워크 계층은 etc/services 에서 조회를 수행합니다. 심볼릭 서비스 이름 대신 포트 번호를 사용하는 경우 조회 및 추가 항목이 필요하지 않습니다.

r3name

 

SAP 시스템의 시스템 ID, 로드 밸런싱 연결에 대한 필수 속성입니다.

group

 

SAP 애플리케이션 서버 그룹, 로드 밸런싱 연결에 대한 필수 속성

network

LAN

JCo와 대상 시스템 간의 네트워크 품질에 따라 이 값을 설정하여 성능을 최적화합니다. 유효한 값은 LAN 또는 ECDHE 입니다(빠른 직렬화만 해당). DestinationRule 은 더 느리지만 더 효율적인 압축 알고리즘을 사용하며 추가 압축 옵션을 위한 데이터 분석을 사용합니다. LAN 은 기본 데이터 분석만으로 매우 빠른 압축 알고리즘을 사용합니다. LAN 옵션을 사용하면 압축 비율은 효율적이지 않지만 네트워크 전송 시간이 덜 중요한 것으로 간주됩니다. 기본 설정은 LAN 입니다.

serializationFormat

rowBased

직렬화의 형식입니다. 행 기반(기본값) 또는 열Based (빠른 직렬화)일 수 있습니다.

289.6.2.6. 연결 풀 옵션
링크 복사

다음 표에는 SAP 대상 데이터 저장소에서 대상을 구성하기 위한 연결 풀 옵션이 나열되어 있습니다.

Expand

이름

기본값

설명

peakLimit

0

대상에 대해 동시에 활성 상태인 아웃바운드 연결의 최대 수입니다. 값 0 은 무제한 활성 연결을 허용합니다. 그렇지 않으면 poolCapacity 로 자동으로 증가합니다. 기본 설정은 구성된 경우 poolCapacity 의 값입니다. poolCapacity 를 지정하지 않으면 기본값은 0 (제한 없음)입니다.

poolCapacity

1

대상에 의해 열려 있는 유휴 아웃바운드 연결의 최대 수입니다. 값 0 은 연결 풀링이 없음을 의미합니다(기본값은 1입니다).

expirationTime

 

대상에 의해 내부적으로 보유되는 여유 연결이 최소 시간(밀리초)을 유지해야 합니다.

expirationPeriod

 

대상이 릴리스된 연결에 대한 만료를 확인하는 시간(밀리초)입니다.

maxGetTime

 

애플리케이션에서 허용되는 최대 연결 수를 이미 할당한 경우 연결을 대기하는 최대 시간(밀리초)입니다.

289.6.2.7. 보안 네트워크 연결 옵션
링크 복사

다음 표에는 SAP 대상 데이터 저장소에서 대상을 구성하기 위한 보안 네트워크 옵션이 나열되어 있습니다.

Expand

이름

기본값

설명

sncMode

 

Secure Network connection (SNC) 모드, 0 (off) 또는 1 (on)

sncPartnername

 

SNC 파트너, 예: p:CN=R3, O=XYZ-INC, C=EN

sncQop

 

SNC 보안 수준: 1~9

sncMyname

 

자체 SNC 이름입니다. 환경 설정 덮어쓰기

sncLibrary

 

SNC 서비스를 제공하는 라이브러리 경로

289.6.2.8. 리포지터리 옵션
링크 복사

다음 표에는 SAP 대상 데이터 저장소에서 대상을 구성하기 위한 리포지토리 옵션이 나열되어 있습니다.

Expand

이름

기본값

설명

repositoryDest

 

리포지토리로 사용할 대상을 지정합니다.

repositoryUser

 

리포지토리 대상을 정의하지 않은 경우 리포지토리 호출에 사용할 사용자를 정의합니다. 이를 통해 리포지토리 조회에 다른 사용자를 사용할 수 있습니다.

repositoryPasswd

 

리포지토리 사용자의 암호입니다. 리포지토리 사용자를 사용할 때는 필수입니다.

repositorySnc

 

(선택 사항) 이 대상에 SNC를 사용하는 경우 이 속성이 0 으로 설정된 경우 리포지토리 연결에 대해 SNC를 해제할 수 있습니다. 기본 설정은 jco.client.snc_mode 의 값입니다. 특별한 경우에만 해당됩니다.

repositoryRoundtripOptimization

 

한 라운드트립에서 리포지토리 데이터를 제공하는 RFC_METADATA_GET API를 활성화합니다.

1
ABAP 시스템에서 RFC_METADATA_GET 사용을 활성화
0
ABAP 시스템에서 RFC_METADATA_GET 를 비활성화합니다.

속성이 설정되지 않은 경우 대상은 처음에 원격 호출을 수행하여 RFC_METADATA_GET 를 사용할 수 있는지 확인합니다. 사용 가능한 경우 대상이 이를 사용합니다.

참고

리포지토리가 이미 초기화된 경우(예: 다른 대상에서 사용하기 때문에) 이 속성에는 적용되지 않습니다. 일반적으로 이 속성은 ABAP 시스템과 관련이 있으며 동일한 ABAP 시스템을 가리키는 모든 대상에 대해 동일한 값을 가져야 합니다. 백엔드 사전 요구 사항은 1456826 을 참조하십시오.

289.6.2.9. 구성 옵션 추적
링크 복사

다음 표에는 SAP 대상 데이터 저장소에서 대상을 구성하기 위한 추적 구성 옵션이 나와 있습니다.

Expand

이름

기본값

설명

trace

 

RFC 추적 활성화/비활성화 (0 또는 1)

cpicTrace

 

CPIC 추적 활성화/비활성화 [0..3]

289.6.3. 서버 설정
링크 복사

289.6.3.1. 개요
링크 복사

서버의 구성은 SAP 구성 요소의 serverDataStore 속성에 유지됩니다. 이 맵의 각 항목은 SAP 인스턴스와 별도의 인바운드 연결을 구성합니다. 각 항목의 키는 아웃바운드 연결의 이름이며 URI 형식 섹션에 설명된 대로 서버 끝점 URI의 serverName 구성 요소에서 사용됩니다.

각 항목의 값은 인바운드 SAP 연결 구성을 정의하는 서버 데이터 구성 개체 또는g.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl 입니다.

289.6.3.2. 서버 구성 샘플
링크 복사

다음 IRQ XML 코드는 이름, quickstartServer 로 샘플 서버 구성을 생성하는 방법을 보여줍니다. 

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the Inbound and Outbound SAP Connections -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="destinationDataStore">
            <map>
                <entry key="quickstartDest" value-ref="quickstartDestinationData" />
            </map>
        </property>
        <property name="serverDataStore">
            <map>
                <entry key="quickstartServer" value-ref="quickstartServerData" />
            </map>
        </property>
    </bean>

    <!-- Configures an Outbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment *** -->
    <bean id="quickstartDestinationData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.DestinationDataImpl">
        <property name="ashost" value="example.com" />
        <property name="sysnr" value="00" />
        <property name="client" value="000" />
        <property name="user" value="username" />
        <property name="passwd" value="passowrd" />
        <property name="lang" value="en" />
    </bean>

    <!-- Configures an Inbound SAP Connection -->
    <!-- *** Please enter the connection property values for your environment ** -->
    <bean id="quickstartServerData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl">
        <property name="gwhost" value="example.com" />
        <property name="gwserv" value="3300" />
        <!-- Do not change the following property values -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>
Copy to Clipboard Toggle word wrap

이 예에서는 서버가 원격 SAP 인스턴스에서 메타데이터를 검색하는 데 사용하는 대상 연결 빠른 시작Dest 도 구성하는 방법을 확인합니다. 이 대상은 repositoryDestination 옵션을 통해 서버 데이터에 구성됩니다. 이 옵션을 설정하지 않으면 대신 로컬 메타데이터 리포지토리를 생성해야 합니다( 289.6.4절. “리포지토리 구성”참조).

예를 들어 이전 IRQ XML 파일에 표시된 대로 대상을 구성한 후 다음 URI를 사용하여 호출 클라이언트의 BAPI_FLECDHEST_GETLIST 원격 함수 호출을 처리할 수 있습니다. 

sap-srfc-server:quickstartServer:BAPI_FLCUST_GETLIST
Copy to Clipboard Toggle word wrap

289.6.3.3. 필수 옵션
링크 복사

서버 데이터 구성 오브젝트에 필요한 옵션은 다음과 같습니다.

Expand

이름

기본값

설명

gwhost

 

서버 연결을 등록할 게이트웨이 호스트입니다.

gwserv

 

등록을 수행할 수 있는 포트인 gateway 서비스. 서비스 이름 sapgwXXX 를 해결하기 위해 운영 체제의 네트워크 계층은 etc/services 에서 조회를 수행합니다. 심볼릭 서비스 이름 대신 포트 번호를 사용하는 경우 조회 및 추가 항목이 필요하지 않습니다.

progid

 

등록이 수행되는 프로그램 ID입니다. 게이트웨이 및 ABAP 시스템의 대상에서 식별자 역할을 합니다.

repositoryDestination

 

서버가 원격 SAP 서버에서 호스팅되는 메타데이터 리포지토리에서 메타데이터를 검색하는 데 사용할 수 있는 대상 이름을 지정합니다.

connectionCount

 

게이트웨이에 등록할 연결 수입니다.

289.6.3.4. 보안 네트워크 연결 옵션
링크 복사

서버 데이터 구성 오브젝트의 보안 네트워크 연결 옵션은 다음과 같습니다.

Expand

이름

기본값

설명

sncMode

 

Secure Network connection (SNC) 모드, 0 (off) 또는 1 (on)

sncQop

 

SNC 보안 수준, 1 에서 9까지

sncMyname

 

서버의 SNC 이름입니다. 기본 SNC 이름을 덮어씁니다. 일반적으로 p:CN=JCoServer, O=ACompany, C=EN 과 같습니다.

sncLib

 

SNC 서비스를 제공하는 라이브러리 경로입니다. 이 속성을 제공하지 않으면 jco.ECDHE.snc_lib 속성 값이 대신 사용됩니다.

289.6.3.5. 기타 옵션
링크 복사

서버 데이터 구성 오브젝트의 다른 옵션은 다음과 같습니다.

Expand

이름

기본값

설명

saprouter

 

방화벽에 의해 보호되는 시스템에 사용할 SAP 라우터 문자열은 따라서 해당 ABAP 시스템의 게이트웨이에 서버를 등록할 때만 SAProuter를 통해 도달할 수 있습니다. 일반적인 라우터 문자열은 /H/firewall.hostname/H/입니다.

maxStartupDelay

 

실패 시 두 시작 시도 사이의 최대 시간(초)입니다. 처음에는 최대 값에 도달하거나 서버를 성공적으로 시작할 수 있을 때까지 시작 실패 후 1초에서 대기 시간이 두 배로 증가합니다.

trace

 

RFC 추적 활성화/비활성화 (0 또는 1)

workerThreadCount

 

서버 연결에 사용되는 최대 스레드 수입니다. 설정하지 않으면 connectionCount 의 값이 workerThreadCount 로 사용됩니다. 최대 스레드 수는 99를 초과할 수 없습니다.

workerThreadMinCount

 

서버 연결에 사용되는 최소 스레드 수입니다. 설정하지 않으면 connectionCount 의 값이 workerThreadMinCount 로 사용됩니다.

289.6.4. 리포지토리 구성
링크 복사

289.6.4.1. 개요
링크 복사

리포지토리의 구성은 SAP Component의 repositoryDataStore 속성에서 유지됩니다. 이 맵의 각 항목은 고유한 리포지토리를 구성합니다. 각 항목의 키는 리포지토리 이름이고 이 키는 이 리포지토리가 연결된 서버의 이름에도 해당합니다.

각 항목의 값은 메타데이터 리포지토리의 콘텐츠를 정의하는 리포지토리 데이터 구성 오브젝트 또는g .fusesource.camel.component.sap.model.rfc.impl.RepositoryDataImpl 입니다. 리포지토리 데이터 오브젝트는 함수 템플릿 구성 오브젝트 org.fuesource.camel.component.sap.model.rfc.impl.FunctionTemplateImpl 의 맵입니다. 이 맵의 각 항목은 함수 모듈의 인터페이스를 지정하고 각 항목의 키는 지정된 함수 모듈의 이름입니다.

289.6.4.2. 리포지터리 데이터 예
링크 복사

다음 코드는 메타데이터 리포지토리를 구성하는 간단한 예를 보여줍니다. 

<?xml version="1.0" encoding="UTF-8"?>
<blueprint ... >
    ...
    <!-- Configures the sap-srfc-server component -->
    <bean id="sap-configuration"
        class="org.fusesource.camel.component.sap.SapConnectionConfiguration">
        <property name="repositoryDataStore">
            <map>
                <entry key="nplServer" value-ref="nplRepositoryData" />
            </map>
        </property>
    </bean>

    <!-- Configures a metadata Repository -->
    <bean id="nplRepositoryData"
        class="org.fusesource.camel.component.sap.model.rfc.impl.RepositoryDataImpl">
        <property name="functionTemplates">
            <map>
                <entry key="BOOK_FLIGHT" value-ref="bookFlightFunctionTemplate" />
            </map>
        </property>
    </bean>
    ...
</blueprint>
Copy to Clipboard Toggle word wrap

289.6.4.3. 함수 템플릿 속성
링크 복사

함수 모듈의 인터페이스는 데이터가 RFC 호출에서 함수 모듈로 다시 전송되는 4개의 매개 변수 목록으로 구성됩니다. 각 매개변수 목록은 하나 이상의 필드로 구성되며, 각 필드는 RFC 호출에서 전송된 이름 지정된 매개변수입니다. 다음 매개변수 목록 및 예외 목록이 지원됩니다.

  • import 매개변수 목록에는 RFC 호출에서 함수 모듈로 전송되는 매개변수 값이 포함되어 있습니다.
  • export 매개변수 목록에는 function 모듈에서 RFC 호출에서 반환하는 매개변수 값이 포함되어 있습니다.
  • changing 매개변수 목록에는 RFC 호출에서 함수 모듈로 전송 및 반환되는 매개변수 값이 포함되어 있습니다.
  • table 매개변수 목록에는 RFC 호출에서 함수 모듈로 전송 및 반환되는 내부 테이블 값이 포함되어 있습니다.
  • 함수 모듈의 인터페이스도 RFC 호출에서 모듈이 호출될 때 발생할 수 있는 ABAP 예외의 예외 목록으로 구성됩니다.

함수 템플릿은 함수 인터페이스의 각 매개변수 목록에 있는 매개변수 이름 및 유형과 함수에서 발생하는 ABAP 예외를 설명합니다. 함수 템플릿 오브젝트는 다음 표에 설명된 대로 메타데이터 오브젝트의 5개의 속성 목록을 유지 관리합니다.

Expand

속성

설명

importParameterList

목록 필드 메타데이터 오브젝트 또는g .fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl. 함수 모듈에 RFC 호출로 전송되는 매개변수를 지정합니다.

changingParameterList

목록 필드 메타데이터 오브젝트 또는g .fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl. 함수 모듈에서 RFC 호출에서 전송 및 반환된 매개변수를 지정합니다.

exportParameterList

목록 필드 메타데이터 오브젝트 또는g .fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl. 함수 모듈에서 RFC 호출에서 반환되는 매개변수를 지정합니다.

tableParameterList

목록 필드 메타데이터 오브젝트 또는g .fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl. 함수 모듈에서 RFC 호출에서 전송 및 반환되는 테이블 매개변수를 지정합니다.

exceptionList

a list of ABAP exception metadata objects, org.fusesource.camel.component.sap.model.rfc.impl.AbapExceptionImpl. 함수 모듈의 RFC 호출에서 잠재적으로 발생하는 ABAP 예외를 지정합니다.

289.6.4.4. 함수 템플릿 예
링크 복사

다음 예제에서는 함수 템플릿을 구성하는 방법에 대한 개요를 보여줍니다. 

<bean id="bookFlightFunctionTemplate"
    class="org.fusesource.camel.component.sap.model.rfc.impl.FunctionTemplateImpl">
    <property name="importParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="changingParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="exportParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="tableParameterList">
        <list>
            ...
        </list>
    </property>
    <property name="exceptionList">
        <list>
            ...
        </list>
    </property>
</bean>
Copy to Clipboard Toggle word wrap

289.6.4.5. 필드 메타데이터 속성 나열
링크 복사

목록 필드 메타데이터 오브젝트, org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl.ListFieldMeataDataImpl 은 매개변수 목록에 필드의 이름과 유형을 지정합니다. 기본 매개 변수 필드 (,DATE,BCD,TIME,BYTE, NUM ,NUM, 4.6.1OAT,INT1,INT 1 ,INT2,DECF16,DECF34, )의 경우 STRING,XSTRING), 다음 표에는 목록 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

매개변수 필드의 이름입니다.

type

-

필드의 매개변수 유형입니다.

byteLength

-

비ECDHE 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

unicodeByteLength

-

유니코드 레이아웃의 바이트 단위 필드 길이입니다. 이 값은 매개변수 유형에 따라 다릅니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

10진수

0

필드 값의 10진수 수입니다. 매개 변수 유형 BCD 및ECDHEOAT에만 필요합니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

optional

false

true 인 경우 해당 필드는 선택 사항이며 RFC 호출에서 설정할 필요가 없습니다.

참고

모든 elementary 매개변수 필드를 사용하려면 필드 메타데이터 오브젝트에 이름,유형,byteLength 및 unicodeByteLength 속성을 지정해야 합니다. 또한 BCD,ECDHEOAT,DECF16 및 DECF34 필드는 10진수 속성을 필드 메타데이터 오브젝트에 지정해야 합니다.

typeECDHE 또는 STRUCTURE 유형의 복잡한 매개변수 필드의 경우 다음 표에는 목록 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

매개변수 필드의 이름

type

-

필드의 매개변수 유형

recordMetaData

-

구조 또는 테이블에 대한 메타데이터입니다. 레코드 메타데이터 오브젝트, org.fusesource.camel.component.sap.rfc.impl.RecordMetaDataImpl 은 구조 또는 테이블 행의 필드를 지정하기 위해 전달됩니다.

optional

false

true 인 경우 해당 필드는 선택 사항이며 RFC 호출에서 설정할 필요가 없습니다.

참고

모든 복잡한 매개변수 필드를 사용하려면 필드 메타데이터 오브젝트에 name,type 및 recordMetaData 속성을 지정해야 합니다. recordMetaData 속성의 값은 레코드 필드 메타데이터 오브젝트인 org.fusesource.camel.component.sap.rfc.rfc.impl.RecordMetaDataImpl 이며 중첩 구조 또는 테이블 행의 구조를 지정합니다.

289.6.4.6. 기본 목록 필드 메타데이터 예
링크 복사

다음 메타데이터 구성은 TICKET_PRICE 라는 두 개의 10진수 위치가 포함된 선택적 24자리 BCD 번호 매개 변수를 지정합니다. 

<bean class="org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMetaDataImpl">
    <property name="name" value="TICKET_PRICE" />
    <property name="type" value="BCD" />
    <property name="byteLength" value="12" />
    <property name="unicodeByteLength" value="24" />
    <property name="decimals" value="2" />
    <property name="optional" value="true" />
</bean>
Copy to Clipboard Toggle word wrap

289.6.4.7. 복잡한 목록 필드 메타데이터 예
링크 복사

다음 메타데이터 구성은 connectionInfo 레코드 메타데이터 개체에서 지정한 행 구조를 사용하여 CONNINFO 라는 필수 4.6.1 매개변수를 지정합니다. 

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMetaDataImpl">
    <property name="name" value="CONNINFO" />
    <property name="type" value="TABLE" />
    <property name="recordMetaData" ref="connectionInfo" />
</bean>
Copy to Clipboard Toggle word wrap

289.6.4.8. 레코드 메타데이터 속성
링크 복사

레코드 메타데이터 오브젝트, org.fusesource.camel.component.sap.rfc.impl.RecordMetaDataImpl.impl.RecordMetaDataImpl . nested STRUCTURE 또는 FlexVolume 매개 변수의 행 행을 지정합니다. 레코드 메타데이터 오브젝트는 레코드 필드 메타데이터 오브젝트 또는g .fusesource.camel.component.sap.rfc.impl.FieldMetaDataImpl 목록을 유지 관리하며 중첩 구조 또는 테이블 행에 상주하는 매개변수를 지정합니다.

다음 표에는 레코드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나와 있습니다.

Expand

이름

기본값

설명

name

-

레코드의 이름입니다.

recordFieldMetaData

-

레코드 필드 메타데이터 오브젝트 목록 org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl. 구조 내에 포함된 필드를 지정합니다.

참고

레코드 메타데이터 오브젝트의 모든 속성이 필요합니다.

289.6.4.9. 레코드 메타데이터 예
링크 복사

다음 예제에서는 레코드 메타데이터 오브젝트를 구성하는 방법을 보여줍니다. 

<bean id="connectionInfo"
        class="org.fusesource.camel.component.sap.model.rfc.impl.RecordMetaDataImpl">
    <property name="name" value="CONNECTION_INFO" />
    <property name="recordFieldMetaData">
        <list>
            ...
        </list>
    </property>
</bean>
Copy to Clipboard Toggle word wrap

289.6.4.10. 레코드 필드 메타데이터 속성
링크 복사

레코드 필드 메타데이터 오브젝트, org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl.FieldMetaDataImpl은 구조를 사용하여 매개 변수 필드의 이름 및 유형을 지정합니다.

레코드 필드 메타데이터 오브젝트는 중첩 구조 또는 테이블 행 내의 개별 필드 위치의 오프셋을 추가로 지정해야 한다는 점을 제외하고 매개변수 필드 메타데이터 오브젝트와 유사합니다. 개별 필드의 비ECDHE 및 유니코드 오프셋은 구조 또는 행에서 이전 필드의 비-ECDHE 및 유니코드 바이트 길이의 합계에서 계산 및 지정해야 합니다.

참고

중첩 구조 및 테이블 행에 필드의 오프셋을 올바르게 지정하지 않으면 기본 JCo 및 ABAP 런타임의 매개변수 필드 스토리지가 겹치고 RFC 호출에서 값의 적절한 전송을 방지합니다.

기본 매개 변수 필드 (,DATE,BCD,TIME,BYTE, NUM ,NUM, 4.6.1OAT,INT1,INT 1 ,INT2,DECF16,DECF34, )의 경우 STRING,XSTRING), 다음 표에는 레코드 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

매개변수 필드의 이름

type

-

필드의 매개변수 유형

byteLength

-

비ECDHE 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

unicodeByteLength

-

유니코드 레이아웃의 바이트 단위 필드 길이입니다. 이 값은 매개변수 유형에 따라 다릅니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

byteOffset

-

비ECDHE 레이아웃의 바이트 단위의 필드 오프셋입니다. 이 오프셋은 enclosing 구조 내의 필드의 바이트 위치입니다.

unicodeByteOffset

-

유니코드 레이아웃의 바이트 단위의 필드 오프셋입니다. 이 오프셋은 enclosing 구조 내의 필드의 바이트 위치입니다.

10진수

0

필드 값의 10진수 수입니다. 매개 변수 유형 BCD 및ECDHE OAT에만 필요합니다. 289.9절. “RFC를 위한 메시지ECDHE”을 참조하십시오.

typeECDHE 또는 STRUCTURE 유형의 복잡한 매개변수 필드의 경우 다음 표에는 레코드 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

매개변수 필드의 이름

type

-

필드의 매개변수 유형

byteOffset

-

비ECDHE 레이아웃의 바이트 단위의 필드 오프셋입니다. 이 오프셋은 enclosing 구조 내의 필드의 바이트 위치입니다.

unicodeByteOffset

-

유니코드 레이아웃의 바이트 단위의 필드 오프셋입니다. 이 오프셋은 enclosing 구조 내의 필드의 바이트 위치입니다.

recordMetaData

-

구조 또는 테이블에 대한 메타데이터입니다. 레코드 메타데이터 오브젝트, org.fusesource.camel.component.sap.rfc.impl.RecordMetaDataImpl 은 구조 또는 테이블 행의 필드를 지정하기 위해 전달됩니다.

289.6.4.11. 기본 레코드 필드 메타데이터 예
링크 복사

다음 메타데이터 구성은 ARR DATE 라는 DATE 필드 매개 변수를 ARRDATE라는 이름의 DATE 필드 매개변수를 Unicode 레이아웃의 경우 enclosing structure에 지정합니다. 

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl">
    <property name="name" value="ARRDATE" />
    <property name="type" value="DATE" />
    <property name="byteLength" value="8" />
    <property name="unicodeByteLength" value="16" />
    <property name="byteOffset" value="85" />
    <property name="unicodeByteOffset" value="170" />
</bean>
Copy to Clipboard Toggle word wrap

289.6.4.12. 복잡한 레코드 필드 메타데이터 예
링크 복사

다음 메타데이터 구성은 FLTINFO 라는 STRUCTURE 필드 매개 변수를 flightInfo 레코드 메타데이터 오브젝트로 지정하는 구조를 지정합니다. 매개 변수는 캡슐화되지 않은 구조와 유니코드 레이아웃의 경우 모두 인클래싱 구조의 시작 부분에 있습니다. 

<bean    class="org.fusesource.camel.component.sap.model.rfc.impl.FieldMetaDataImpl">
    <property name="name" value="FLTINFO" />
    <property name="type" value="STRUCTURE" />
    <property name="byteOffset" value="0" />
    <property name="unicodeByteOffset" value="0" />
    <property name="recordMetaData" ref="flightInfo" />
</bean>
Copy to Clipboard Toggle word wrap
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat