セットアップ・タスク
プロダクションで SAP コンポーネントを使用するには、このトピックで説明するセットアップ・アクティビティを実行する必要があります。
SAP にアクセスするには、ユーザ名とパスワードを入力する必要があります。つまり、SAP のユーザ名とパスワードを含むプロダクション認証情報を作成する必要もあります。認証情報の作成方法は、"プロダクションの構成" を参照してください。
Java ゲートウェイの設定
Java ゲートウェイ・サーバは JVM 環境で実行します。これは、InterSystems IRIS と同じマシンにインストールすることも、別のマシンにインストールすることもできます。Java ゲートウェイを実行するマシン上で、以下の設定手順を完了してください。
-
Java ランタイム環境をインストールします (例 : JRE 1.8.0_67)。
-
JRE のインストール・ディレクトリの場所をメモしておきます。これは、サブディレクトリ bin と lib が含まれているディレクトリです。
この値は、JAVA_HOME 環境変数に使用します。例 : c:\Program Files\Java\jre8
この情報は、あとでプロダクションを構成する際に使用します。
-
Java バージョンもメモしておきます。Java バージョンが不明の場合は、DOS ウィンドウを開き、Java インストール先の bin サブディレクトリに移動して、以下のコマンドを入力します。
java.exe -version
使用しているプラットフォームに応じて、以下のような出力が表示されます。
java version "1.8.0_67" Java(TM) SE Runtime Environment (build 1.8.0_67-b24) Java HotSpot(TM) 64-Bit Server VM (build 23.19-b22, mixed mode)
環境変数を設定する必要はありません。JVM にアクセスするために、InterSystems IRIS ではプロダクションに含まれる情報を使用します。
SAP JCo Jar ファイルのインストール
使用するオペレーティング・システムに応じて、SAP より SAP Java コネクタ 3.x を取得します。通常、これは、圧縮ファイルで提供されます。ファイルを解凍し、便利な場所にコンテンツを格納します。ディレクトリに、以下の項目が含まれている必要があります。
-
examples サブディレクトリ
-
javadoc サブディレクトリ
-
Readme.txt ファイル
-
sapjco3.dll ファイル
-
sapjco3.jar ファイル
-
sapjcomanifest.mf ファイル
SAP JCo のプロキシ・クラスの生成
SAP JCo と通信するには、SAP JCo を表すプロキシ・クラスが相互運用対応ネームスペースに含まれている必要があります。これらのクラスを生成するには、以下の操作を行います。
-
Java ゲートウェイの起動
そのための最も簡単な方法は以下のとおりです。
-
ビジネス・ホスト (EnsLib.JavaGateway.ServiceOpens in a new tab) を 1 つだけ含む簡易プロダクションを作成します。このビジネス・ホストの設定を構成する方法の詳細は、"EnsLib.JavaGateway.Service の設定" を参照してください。
-
プロダクションを起動し、プロダクションが Java ゲートウェイを起動します。
-
-
ターミナルで、相互運用対応ネームスペースに移動し、以下のように、EnsLib.SAP.BootStrapOpens in a new tab の ImportSAP() メソッドを使用します。
do ##class(EnsLib.SAP.BootStrap).ImportSAP(pFullPathToSAPJarFile,pPort,pAddress)
説明 :
-
pFullPathToSAPJarFile は、SAP Jar ファイルへの完全パスです。
-
pPort は、Java ゲートウェイ で使用されるポートです。
-
pAddress は、Java ゲートウェイ で使用される IP アドレスです。
-
SAP 接続のテスト
SAP 接続をテストするには、ターミナル (またはコード) で以下を実行します。
-
EnsLib.SAP.UtilsOpens in a new tab のインスタンスを作成します。
-
そのインスタンスの以下のプロパティを設定します。これらは、別途指定のない限り、文字列プロパティです。
-
SAPClient — SAP クライアント (例: 000)。
-
SAPUser — SAP サーバにアクセスしたユーザ名
-
SAPPassword — ユーザのパスワード
-
SAPLanguage
-
SAPHost — SAP サーバのホスト名または IP アドレス
-
SAPSystemNumber — SAP SystemNumber (例: 00)。
-
JavaGatewayAddress — Java ゲートウェイで使用される JVM が配置されている IP アドレスまたはマシン名
-
JavaGatewayPort — Java ゲートウェイで使用されるポート。
-
SAPTransactionAutoCommit — BAPI/RFC-call が正常終了した後に、BAPI "BAPI_TRANSACTION_COMMIT" を実行するかどうかを指定します。このプロパティは、%BooleanOpens in a new tab です。
-
-
インスタンスの PingSAP() メソッドを呼び出します。このメソッドは、SAP に接続し、STFC_CONNECTION 関数の動的呼び出しを実行します。%StatusOpens in a new tab を返します。