3.3. 運用管理ソフト(外部接続モジュール)¶
取込設定、出力設定の実施スケジュールを、運用管理ソフト等を使用して行う場合のモジュール構成、必要な設定内容などについて説明します。
AccelPlatformへの通信を行う為のモジュールはJavaで実装されていますので、外部モジュールを配置するサーバには、AccelPlatform設置サーバと同バージョンのJDKをインストールしてください。
この機能は、intra-mart Accel Platform / 外部ソフトウェア接続モジュール の機能を利用しています。
機能概要、仕様については『intra-mart Accel Platform / 外部ソフトウェア接続モジュール 仕様書』も参照してください。
※ 記載内容はサンプルとなります。各種設定・実行ファイルの記述内容などは、ご利用の環境に合わせて対応してください。
3.3.2. AccelPlatform APサーバの設定¶
外部接続モジュールを利用する場合、%RESIN_HOME%/webapps/%テナントID%/WEB-INF/web.xmlの設定値を変更する必要があります。servlet/servlet-name=HTTPActionEventListener のinit-param/param-name=use.account.securityのparam-valueをtrueに設定してください。
3.3.3. 構成例¶
3.3.3.1. windows環境の例¶
運用管理ソフトからバッチファイル起点で実行する場合のサンプルを示します。 上図の「外部モジュール」にあたる箇所の構成、設定例です。
[モジュールの構成例]
<任意のフォルダ> ├─ bin │ ├─ imic-batchconstant.properties │ └─ jp │ └─ co │ └─ itc │ └─ imic │ └─ batch │ └─ starter │ └─ ImMasterInfoConnectStarter.class │ ├─ lib │ └─ imaca_client-8.0.1-main.jar └─ bat └─ SampleImportStarter.bat
binAccel-KNIGHT標準のモジュール、設定ファイルを格納するフォルダです。binフォルダの配置場所は任意で構いませんが、プロパティファイルとクラスファイルの配置は上記を維持してください。変更するとモジュールが正常に動作しません。 libintra-mart標準のライブラリを格納するフォルダです。 bat管理モジュールから実行するバッチファイルです。[設定ファイル]
設定名 IMIC.BATCH.CLASS.NAME 内容 AccelPlatform APサーバ側モジュールの、バッチ起動クラス名を指定します。 デフォルト値 jp.co.itc.imic.batch.event.BatchExecuteEvent 備考 この値は変更しないでください。
設定名 IMIC.BATCH.ACTION.URL 内容 バッチ処理の依頼先URLを指定します。 デフォルト値 備考 [http または https]://<サーバアドレス>[:<ポート番号>]/[コンテキストパス]/HTTPActionEventListener
- [バッチファイルの例]
REM SampleImportStarter.bat REM 自フォルダへ移動 cd %~dp0 REM 環境変数を設定 SET JAVA_HOME=C:\java\jdk1.8.0_45 SET PATH=%PATH%;%JAVA_HOME%\bin; REM intra-martサーバへの処理実行依頼 java -classpath "..\bin";"..\lib\imaca_client-8.0.1-main.jar" jp.co.itc.imic.batch.starter.ImMasterInfoConnectStarter default itc001 00 import_sample REM このバッチの呼出元へ終了コードを返却 exit %ERRORLEVEL%作業フォルダ、環境変数の設定、呼出元へのコード返却などは運用環境に応じて対応してください。
- intra-martサーバへの処理実行依頼
-classpathオプション「bin」ディレクトリと「lib」ディレクトリにパスを通します。 実行クラスjp.co.itc.imic.batch.starter.ImMasterInfoConnectStarter(変更不可) 実行クラスパラメータ
第1パラメータ テナントID 第2パラメータ 実行ユーザIDテナントマスタ上でアカウントライセンスが付与されているユーザIDを指定してください。 第3パラメータ 処理区分(00:取込/10:出力) 第4パラメータ 取込設定の場合:対象となる取込ID出力設定の場合:対象となる出力ID
3.3.3.2. Linux系環境の例¶
運用管理ソフトからバッチファイル起点で実行する場合のサンプルを示します。 上図の「外部モジュール」にあたる箇所の構成、設定例です。
[モジュールの構成例]
<任意のフォルダ> ├─ bin │ ├─ imic-batchconstant.properties │ └─ jp │ └─ co │ └─ itc │ └─ imic │ └─ batch │ └─ starter │ └─ ImMasterInfoConnectStarter.class │ ├─ lib │ └─ imaca_client-8.0.1-main.jar └─ sh └─ SampleImportStarter.sh
binAccel-KNIGHT標準のモジュール、設定ファイルを格納するディレクトリです。binディレクトリの配置場所は任意で構いませんが、プロパティファイルとクラスファイルの配置は上記を維持してください。変更するとモジュールが正常に動作しません。 libintra-mart標準のライブラリを格納するディレクトリです。 sh管理モジュールから実行するシェルスクリプトです。[設定ファイル]
設定名 IMIC.BATCH.CLASS.NAME 内容 AccelPlatform APサーバ側モジュールの、バッチ起動クラス名を指定します。 デフォルト値 jp.co.itc.imic.batch.event.BatchExecuteEvent 備考 この値は変更しないでください。
設定名 IMIC.BATCH.ACTION.URL 内容 バッチ処理の依頼先URLを指定します。 デフォルト値 備考 [http または https]://<サーバアドレス>[:<ポート番号>]/[コンテキストパス]/HTTPActionEventListener
- [シェルスクリプトの例]
#!/bin/sh # SampleImportStarter.sh # 自ディレクトリへ移動 cd `dirname ${0}` # 環境変数を設定 JAVA_HOME=/usr/java/jdk1.8.0_45 PATH=${JAVA_HOME}/bin:${PATH} # intra-martサーバへの処理実行依頼 java -classpath "../bin":"../lib/imaca_client-8.0.1-main.jar" jp.co.itc.imic.batch.starter.ImMasterInfoConnectStarter default itc001 00 import_sample # このシェルの呼出元へ終了コードを返却 exit $?作業ディレクトリ、環境変数の設定、呼出元へのコード返却などは運用環境に応じて対応してください。
- intra-martサーバへの処理実行依頼
-classpathオプション「bin」ディレクトリと「lib」ディレクトリにパスを通します。 実行クラスjp.co.itc.imic.batch.starter.ImMasterInfoConnectStarter(変更不可) 実行クラスパラメータ
第1パラメータ テナントID 第2パラメータ 実行ユーザIDテナントマスタ上でアカウントライセンスが付与されているユーザIDを指定してください。 第3パラメータ 処理区分(00:取込/10:出力) 第4パラメータ 取込設定の場合:対象となる取込ID出力設定の場合:対象となる出力ID
