290.6. 설정

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

다음 예제에서는 블루프린트 XML 파일에서 샘플 대상 데이터 저장소 및 샘플 서버 데이터 저장소를 구성하는 방법을 보여줍니다. SapConnectionConfiguration유형의 sap-configuration MeshMemberRoll은 이 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>

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

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

다음 블루프린트 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>

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

sap-srfc-destination:quickstartDest:BAPI_FLCUST_GETLIST

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

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

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

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

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

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

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

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

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

다음 블루프린트 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>

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

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

sap-srfc-server:quickstartServer:BAPI_FLCUST_GETLIST

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

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

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

리포지토리 구성은 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>

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

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

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

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

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

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

다음 메타데이터 구성은 TICKET_PRICE 라는 두 개의 10진수가 있는 선택적 24-digit packed 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>

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

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

레코드 메타데이터 오브젝트인 org.fusesource.camel.component.sap.model.rfc.impl.RecordMetaDataImpl 에서는 중첩된 STRUCTURE 또는 Cryostat 매개변수 행의 이름과 내용을 지정합니다. 레코드 메타데이터 오브젝트는 중첩된 구조 또는 테이블 행에 상주하는 매개변수를 지정하는 레코드 필드 메타데이터 오브젝트 목록 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>

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

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

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

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

다음 메타데이터 구성은 ARR DATE 라는 이름의 필드 매개변수를 유니코드 레이아웃이 아닌 레이아웃의 경우 enclosing 구조에 배치하고 Unicode 레이아웃의 경우 enclosing 구조에 위치하는 필드 매개변수를 지정합니다.

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

다음 메타데이터 구성은 FLTINFO 라는 STRUCTURE 필드 매개변수를,plane Info 레코드 메타데이터 오브젝트에 지정된 구조와 함께 지정합니다. 매개 변수는 유니코드와 유니코드 레이아웃의 경우 모두 포함 구조의 시작 부분에 있습니다.

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