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

55.3. 설정

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

55.3.1. 구성 개요
링크 복사

SAP 구성 요소는 대상 데이터, 서버 데이터 및 리포지토리 데이터를 저장하기 위해 세 개의 맵을 유지 관리합니다. 구성 요소의 속성인 destinationDataStore 는 대상 이름, 속성, serverDataStore 에서 키가 지정된 대상 데이터를 저장하고, 서버 이름과 속성, repositoryDataStore, 리포지토리 이름별로 키가 지정된 리포지토리 데이터를 저장합니다. 이러한 구성은 초기화 중에 구성 요소에 전달되어야 합니다.

예제

다음 예제는 청사진 XML 파일에서 샘플 대상 데이터 저장소와 샘플 서버 데이터 저장소를 구성하는 방법을 보여줍니다. sap-configuration console(예: 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" />
        <!-- The following property values should not be changed -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>
Copy to Clipboard Toggle word wrap

55.3.2. 대상 구성
링크 복사

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

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

샘플 대상 구성

다음 Blueprint 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

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

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

55.3.2.1. tRFC 및 qRFC 대상에 대한 인터셉터
링크 복사

이전 샘플 대상 구성은 CurrentProcessorDefinitionInterceptStrategy 오브젝트의 인스턴스화를 보여줍니다. 이 오브젝트는 Camel 런타임에 인터셉터를 설치하여 Camel SAP 구성 요소가 RFC 트랜잭션을 처리하는 동안 Camel 경로 내에서의 위치를 추적할 수 있습니다.

중요

이 인터셉터는 트랜잭션 RFC 대상 끝점(예: sap-trfc-destination 및 sap-qrfc-destination)에서 매우 중요하며 아웃바운드 트랜잭션 RFC 통신을 올바르게 관리하려면 Camel 런타임에 설치해야 합니다. 런타임 시 전략이 없는 경우 Destination RFC Transaction Handlers에서 Camel 로그에 경고를 발행합니다. 이 경우 아웃바운드 트랜잭션 RFC 통신을 올바르게 관리하려면 Camel 런타임을 다시 프로비저닝하고 다시 시작해야 합니다.

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

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

Expand

이름

기본값

설명

클라이언트

 

SAP 클라이언트, 매개 변수에서 필수 로그입니다.

user

 

user에서 로그인합니다. 암호 기반 인증에 대한 매개 변수를 로그인합니다.

aliasUser

 

사용자 별칭에 대한 로그는 사용자에 대한 로그 대신 사용할 수 있습니다.

userId

 

ABAP AS에 로그인하는 데 사용되는 사용자 ID입니다. JCo 런타임에서 사용하는 경우 대상 구성에서 SSO/전송 티켓, 인증서, 현재 사용자 , 또는 인증을 위해 SNC 환경을 사용하는 경우. 사용자 ID와 사용자 별칭이 설정되지 않은 경우 사용자 ID가 필수입니다. 이 ID는 SAP 백엔드로 전송되지 않으며 JCo 런타임에서 로컬로 사용합니다.

passwd

 

암호로 로그인하여 암호 기반 인증에 대한 매개 변수에 로그인합니다.

lang

 

언어가 정의되지 않은 경우 기본 사용자 언어가 사용됩니다.

mysapsso2

 

지정된 SAP Version 2를 SSO 기반 인증 티켓에 대한 로그로 사용합니다.

x509cert

 

인증서 기반 인증에 지정된 X509 인증서를 사용합니다.

lcheck

 

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

useSapGui

 

표시되거나 숨겨져 있거나 SAP GUI를 사용하지 않음

codePage

 

매개 변수에서 로그를 변환하는 데 사용되는 codepage를 정의하는 추가 log on 매개 변수입니다. 특수한 경우에만 사용됩니다.

getsso2

 

로그인한 후 SSO 티켓을 주문하면 대상 속성에서 가져온 티켓을 사용할 수 있습니다.

denyInitialPassword

 

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

55.3.2.3. 연결 옵션
링크 복사

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

Expand

이름

기본값

설명

saprouter

 

SAP 라우터 뒤의 시스템에 연결하기 위한 SAP 라우터 문자열입니다. SAP Router string에는 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 또는 iPXE ( 빠른 직렬화에만 관련이 있음)입니다. 네트워크 구성 옵션을 iPXE로 설정하면 더 느리지만 더 효율적인 압축 알고리즘이 사용되고 추가 압축 옵션에 대해 데이터를 분석합니다. 네트워크 구성을 LAN 으로 설정하면 매우 빠른 압축 알고리즘이 사용되며 데이터 분석은 매우 기본적인 수준에서만 수행됩니다. LAN 옵션을 설정하면 압축 비율이 효율적이지 않지만 네트워크 전송 시간은 덜 중요한 것으로 간주됩니다. 기본 설정은 LAN 입니다.

serializationFormat

rowBased

유효한 값은 rowBased 또는 columnBased 입니다. 빠른 직렬화 열의 경우Based를 설정해야 합니다.For fast serialization columnBased must be set. 기본 serialization 설정은 행 기반입니다.

55.3.2.4. 연결 풀 옵션
링크 복사

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

Expand

이름

기본값

설명

peakLimit

0

대상에 대해 동시에 생성할 수 있는 최대 활성 아웃바운드 연결 수입니다. 값 0 은 무제한 활성 연결을 허용합니다. 그렇지 않으면 값이 jpoolCapacity 값보다 작으면 이 값으로 자동으로 증가합니다. 기본 설정은 poolCapacity 의 값이거나 poolCapacity 를 지정하지 않는 경우 기본값은 0 (unlimited)입니다.

poolCapacity

1

대상에 의해 열려 있는 최대 유휴 상태의 연결 수입니다. 값 0 은 연결 풀링이 없음을 나타냅니다(기본값은 1).

expirationTime

 

시간(밀리초) 후 대상에서 내부적으로 보유한 사용 가능한 연결을 닫을 수 있습니다.

expirationPeriod

 

기간(밀리초) 후 대상에서 해제된 연결의 만료 여부를 확인합니다.

maxGetTime

 

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

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

다음 표에는 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 서비스를 제공하는 라이브러리의 경로입니다.

55.3.2.6. 리포지토리 옵션
링크 복사

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

Expand

이름

기본값

설명

repositoryDest

 

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

repositoryUser

 

리포지토리 대상을 설정하지 않고 이 속성이 설정되면 repository 호출에 대해 user로 사용됩니다. 이를 통해 리포지토리 조회에 다른 사용자를 사용할 수 있습니다.

repositoryPasswd

 

리포지토리 사용자의 암호입니다. 리포지토리 사용자를 사용하는 경우 필수 항목입니다.

repositorySnc

 

(선택 사항) 이 대상에 SNC를 사용하는 경우 이 속성이 0 으로 설정된 경우 리포지토리 연결에 대해 이를 해제할 수 있습니다. 기본 설정은 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 을 참조하십시오.

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

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

Expand

이름

기본값

설명

Trace

 

RFC 추적을 활성화/비활성화합니다(0 또는 1).

cpicTrace

 

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

55.3.3. 서버 설정
링크 복사

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

각 항목의 값은 서버 데이터 구성 오브젝트,org.fusesource.camel.component.sap.model.rfc.impl.ServerDataImpl 이며 인바운드 SAP 연결의 구성을 정의합니다.

샘플 서버 구성

다음 Blueprint XML 코드는 name, 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" />
        <!-- The following property values should not be changed -->
        <property name="progid" value="QUICKSTART" />
        <property name="repositoryDestination" value="quickstartDest" />
        <property name="connectionCount" value="2" />
    </bean>
</blueprint>
Copy to Clipboard Toggle word wrap

이 예에서는 서버가 원격 SAP 인스턴스에서 메타데이터를 검색하는 데 사용하는 대상 연결인 quickstartDest 도 구성하는 방법을 확인합니다. 이 대상은 repositoryDestination 옵션을 통해 서버 데이터에서 구성됩니다. 이 옵션을 구성하지 않으면 대신 로컬 메타데이터 리포지토리를 생성해야 합니다.

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

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

55.3.3.1. 필수 옵션
링크 복사

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

Expand

이름

기본값

설명

gwhost

 

서버 연결을 등록해야 하는 게이트웨이 호스트입니다.

gwserv

 

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

progid

 

등록이 완료된 프로그램 ID입니다. 게이트웨이 및 ABAP 시스템의 대상에서 식별자로 사용됩니다.Serves as an identifier on the gateway and in the destination in the ABAP system.

repositoryDestination

 

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

connectionCount

 

게이트웨이에서 등록해야 하는 연결 수입니다.

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

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

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 속성의 값이 대신 사용됩니다.

55.3.3.3. 기타 옵션
링크 복사

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

Expand

이름

기본값

설명

saprouter

 

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

maxStartupDelay

 

실패 시 두 번의 시작 시도 사이의 최대 시간(초)입니다. 최대 값에 도달하거나 서버가 성공적으로 시작될 때까지 각 시작 실패 후 1초 동안 대기 시간이 두 배로 늘어납니다.

Trace

 

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

workerThreadCount

 

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

workerThreadMinCount

 

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

55.3.4. 리포지토리 설정
링크 복사

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

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

리포지토리 데이터 예

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

<?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

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

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

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

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

Expand

속성

설명

importParameterList

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

changingParameterList

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

exportParameterList

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

tableParameterList

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

exceptionList

ABAP 예외 메타데이터 오브젝트 목록, org.fusesource.camel.component.sap.model.rfc.impl.AbapExceptionImpl. 함수 모듈의 RFC 호출에서 잠재적으로 발생한 ABAP 예외를 지정합니다.

함수 템플릿 예

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

<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

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

목록 필드 메타데이터 오브젝트인 org.fusesource.camel.component.sap.model.rfc.impl.ListFieldMeataDataImpl, 매개변수 목록에 필드의 이름 및 유형을 지정합니다. 요소 매개변수 필드(elementary parameter 필드, bCD ,TIME,BYTE,NUM,FLOAT,INT 1,INT2,DECF16,DECF34, STRING,XSTRING), 다음 표에는 목록 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

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

type

-

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

byteLength

-

숫자가 아닌 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다.

unicodeByteLength

-

유니코드 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다.

10진수

0

필드 값의 10진수 수입니다. 매개 변수 유형 BCD 및 FLOAT에 필요합니다.

optional

false

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

모든 요소 매개 변수 필드는 필드 메타데이터 오브젝트에 이름,type,byteLength, unicodeByteLength 속성을 지정해야 합니다. 또한 BCD,FLOAT,DECF16, DECF34 필드에는 10진수 속성을 필드 메타데이터 오브젝트에 지정해야 합니다.

다음 표에는 list 필드 메타데이터 개체에 설정할 수 있는 구성 속성이 나열되어 있습니다.For a complex parameter field of type 10.0.0.1 or STRUCTURE, the following table lists the configuration properties that may be set on a list field metadata object:

Expand

이름

기본값

설명

name

-

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

type

-

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

recordMetaData

-

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

optional

false

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

참고

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

기본 목록 필드 메타데이터의 예

다음 메타데이터 구성은 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

복잡한 목록 필드 메타데이터의 예

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

<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

55.3.4.3. 메타데이터 속성 기록
링크 복사

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

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

Expand

이름

기본값

설명

name

-

레코드의 이름입니다.

recordFieldMetaData

-

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

참고

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

메타데이터 레코드 예

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

<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

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

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

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

참고

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

요소 매개변수 필드(elementary parameter 필드, bCD ,TIME,BYTE,NUM,FLOAT,INT 1,INT2,DECF16,DECF34, STRING,XSTRING), 다음 표에는 레코드 필드 메타데이터 오브젝트에 설정할 수 있는 구성 속성이 나열되어 있습니다.

Expand

이름

기본값

설명

name

-

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

type

-

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

byteLength

-

숫자가 아닌 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다.

unicodeByteLength

-

유니코드 레이아웃의 필드 길이(바이트)입니다. 이 값은 매개변수 유형에 따라 다릅니다.

byteOffset

-

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

unicodeByteOffset

-

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

10진수

0

필드 값의 10진수 수입니다. BCD 및 FLOAT 매개 변수 유형에만 필요합니다.

다음 표에는 레코드 필드 메타데이터 개체에 설정할 수 있는 구성 속성이 나열되어 있습니다.For a complex parameter field of type 10.0.0.1 or STRUCTURE, the following table lists the configuration properties that may be set on a record field metadata object:

Expand

이름

기본값

설명

name

-

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

type

-

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

byteOffset

-

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

unicodeByteOffset

-

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

recordMetaData

-

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

기본 레코드 필드 메타데이터의 예

다음 메타데이터 구성에서는 유니코드 레이아웃의 경우 85바이트라는 ARR DATE 필드 매개 변수를 지정합니다. 

<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

복잡한 레코드 필드 메타데이터 예

다음 메타데이터 구성은 flightInfo 레코드 메타데이터 오브젝트에 의해 지정된 구조를 사용하여 FLTINFO 라는 STRUCTURE 필드 매개변수를 지정합니다. 매개 변수는 비-ECDHE 및 유니코드 레이아웃의 경우 둘 다의 enclosing 구조의 시작 부분에 있습니다. 

<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