269.2.2. 宛先設定
概要
宛先の設定は、SAP コンポーネントの destinationDataStore プロパティーで維持されます。このマップの各エントリーは、SAP インスタンスへの個別のアウトバウンド接続を設定します。各エントリーのキーはアウトバウンド接続の名前であり、「URI format」セクションで説明されているように、宛先エンドポイント 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>
たとえば、前述の Blueprint XML ファイルにあるように宛先を設定したら、以下の URI を使用して quickstartDest 宛先で BAPI_FLCUST_GETLIST リモート関数呼び出しを呼び出すことができます。
sap-srfc-destination:quickstartDest:BAPI_FLCUST_GETLIST
tRFC および qRFC 宛先のインターセプター
前述の宛先設定のサンプルは、CurrentProcessorDefinitionInterceptStrategy オブジェクトのインスタンス化を示しています。このオブジェクトは Camel ランタイムにインターセプターをインストールします。これにより、RFC トランザクションの処理中に Camel SAP コンポーネントが Camel ルート内での位置を追跡できます。詳細は、「トランザクション RFC 宛先エンドポイント」 を参照してください。
このインターセプターは、トランザクション RFC 宛先エンドポイント（ sap-trfc-destination、sap-qrfc-destinationなど）で重要であり、アウトバウンドトランザクション RFC 通信を適切に管理するために Camel ランタイムにインストールする必要があります。Destination RFC Transaction Handlers は、ストラテジーが実行時に見つからない場合に警告を発行し、この場合に Camel ランタイムを再プロビジョニングして再起動し、アウトバウンドトランザクション RFC 通信を適切に管理する必要があります。
ログインオプションおよび認証オプション
以下の表は、SAP 宛先データストアで宛先を設定するための ログオンオプションおよび認証 オプションを示しています。
| Name | デフォルト値 | 説明 |
|
| SAP クライアント、必須のログオンパラメーター | |
|
| Logon user, logon parameter for password based authentication（パスワードベースの認証の logon パラメーター） | |
|
| Logon ユーザーエイリアス（ログオンユーザーの代わりに使用可能） | |
|
| ABAP AS へのログオンに使用されるユーザー ID。JCo ランタイムによって使用されます。宛先設定が認証に SSO/assertion チケット、証明書、現在のユーザー、または SNC 環境を使用する場合に使用されます。ユーザーやユーザーエイリアスが設定されていない場合は、ユーザー ID が必須です。この ID は SAP バックエンドに送信されず、JCo ランタイムによってローカルに使用されます。 | |
|
| ログインパスワード、パスワードベースの認証の logon パラメーター | |
|
| Logon 言語 - 定義されていない場合は、デフォルトのユーザー言語が使用されます。 | |
|
| SSO ベースの認証のログオンチケットとして、指定された SAP Cookie Version 2 を使用します。 | |
|
| 証明書ベースの認証に、指定した X509 証明書を使用します。 | |
|
| 最初の呼び出しまで認証を延期します - 1(enable)。特殊なケースでのみ使用されます。 | |
|
| Use a visible, hidden, or do not use SAP GUI（表示、非表示、または SAP GUI を使用しない）の使用 | |
|
| logon パラメーターの変換に使用されるコードページを定義するための追加の logon パラメーター。特殊なケースでのみ使用 | |
|
| ログイン後 SSO チケットの順序により、取得したチケットは宛先属性で利用可能になります。 | |
|
|
|
接続オプション
以下の表は、SAP 宛先データストアで宛先を設定するための 接続 オプションを示しています。
| Name | デフォルト値 | 説明 |
|
|
SAP ルーターの背後にあるシステムに接続するための SAP ルーター文字列。SAP Router 文字列には、SAP ルーターとそのポート番号のチェーンが含まれ、形式： | |
|
| SAP ABAP アプリケーションサーバーのシステム番号（直接接続に必要） | |
|
| 直接接続に必須、SAP ABAP アプリケーションサーバー | |
|
| SAP メッセージサーバー（負荷分散接続に必須のプロパティー） | |
|
|
SAP メッセージサーバーポート、ロードバランシング接続の任意のプロパティー。サービス名 sapmsXXX を解決するために、 | |
|
| アプリケーションサーバーへの接続を確立するために使用する 具体的なゲートウェイ の指定を許可します。指定のない場合は、アプリケーションサーバーのゲートウェイが使用されます。 | |
|
| gwhost を使用する場合は設定する必要があります。そのゲートウェイで使用するポートの指定を許可します。指定のない場合は、アプリケーションサーバーのゲートウェイポートが使用されます。サービス名 sapgwXXX を解決するには、オペレーティングシステムのネットワーク層により etc/services でルックアップが実行されます。シンボリックサービス名の代わりにポート番号を使用する場合には、検索が行われず、追加のエントリーは必要ありません。 | |
|
| SAP システムのシステム ID。ロードバランシング接続の必須プロパティーです。 | |
|
| SAP アプリケーションサーバーのグループ（ロードバランシング接続に必須プロパティー） |
接続プールのオプション
以下の表は、SAP 宛先データストアで宛先を設定するための 接続プール オプションを示しています。
| Name | デフォルト値 | 説明 |
|
|
|
宛先に同時に作成できるアクティブなアウトバウンド接続の最大数。値が |
|
|
|
宛先によって開放されているアイドルアウトバウンド接続の最大数。 |
|
| 宛先によって内部に保持される空き接続が閉じられるまでの時間（ミリ秒単位）。 | |
|
| 宛先がリリースした接続の有効期限をチェックする期間（ミリ秒単位）。 | |
|
| アプリケーションによって許可される最大接続数がすでに割り当てられている場合、接続を待つ最大時間（ミリ秒単位）。 |
セキュアなネットワーク接続オプション
以下の表は、SAP 宛先データストアで宛先を設定するための セキュアなネットワーク オプションを示しています。
| Name | デフォルト値 | 説明 |
|
|
Secure network connection(SNC)モード、 | |
|
|
SNC パートナー（例： | |
|
|
SNC レベルのセキュリティー： | |
|
| 独自の SNC 名。環境設定の上書き | |
|
| SNC サービスを提供するライブラリーへのパス |
リポジトリーオプション
以下の表は、SAP 宛先データストアで宛先を設定するための リポジトリー オプションを示しています。
| Name | デフォルト値 | 説明 |
|
| リポジトリーとして使用する宛先を指定します。 | |
|
| リポジトリーの宛先が設定されていない場合、このプロパティーはリポジトリー呼び出しのユーザーとして使用されます。これにより、リポジトリー検索に別のユーザーを使用できます。 | |
|
| リポジトリーユーザーのパスワード。リポジトリーユーザーを使用する場合は必須です。 | |
|
|
（オプション） SNC をこの宛先に使用する場合は、このプロパティーが | |
|
|
プロパティーが設定されていない場合、宛先は最初に 注記： リポジトリーがすでに初期化されている場合は（たとえば、他の宛先で使用されているため）、このプロパティーには影響がありません。通常、このプロパティーは ABAP System に関連し、同じ ABAP システムを指すすべての宛先に同じ値である必要があります。バックエンドの前提条件については、注記 1456826 を参照してください。 |
トレース設定オプション
以下の表は、SAP 宛先データストアで宛先を 設定するためのトレース設定 オプションを示しています。
| Name | デフォルト値 | 説明 |
|
|
RFC トレースの有効化/無効化（ | |
|
|
CPIC トレースの有効化/無効化 |
