3.14.2 データ変換用システムプロパティファイル
- 〈この項の構成〉
(1) 形式
[csc.dt.codetablepath=コード変換テーブルの格納パス] [csc.dt.ownCodeConverter.className=文字コード変換UOCのクラス名] [csc.dt.customFuncDir=カスタムファンクションで使用するjarファイルの格納パス] [csc.dt.valueTable.変換テーブルID=値置換えファンクションで使用する変換テーブルのファイルパス] [csc.dt.valueTableSize=値置換えファンクションで使用する変換テーブルの合計ファイルサイズ] [csc.dt.encodeType.変換テーブルID={MS932|UTF8|UTF16_BIG|UTF16_LITTLE}] [csc.dt.undefined.replace.データ変換種別=置換文字コード] [csc.dt.sizeNode.includeSelfSize={true|false}]
(2) 機能
Service Platformのデータ変換のシステムプロパティを設定します。設定したファイルは,cscbinaryparseコマンド,csctransformコマンド,およびcscgenbinaryコマンドの実行時に指定します。
(3) ファイルの格納先
テンプレートファイルの格納場所を次に示します。任意のディレクトリにコピーし,ファイルを編集して任意のファイル名で保存してください。
- テンプレートファイルの場所:
<サービスプラットフォームのインストールディレクトリ>\CSCTE\template\csctransform_sys.properties
(4) 設定できるプロパティ
csc.dt.codetablepath=コード変換テーブルの格納パス
文字コード変換UOCでコード変換のAPIを使用する場合に,Code Converterのコード変換テーブルの格納パスを次の形式で指定します。
<コード変換テーブル格納パスディレクトリ>/table
設定方法については,マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「2.7.2 文字コード変換UOCによる拡張」を参照してください。
csc.dt.ownCodeConverter.className=文字コード変換UOCのクラス名
開発環境で作成した文字コード変換UOCを実行環境で使用する場合に,文字コード変換UOCのクラス名を完全修飾名で登録します。設定方法については,マニュアル「サービスプラットフォーム 開発ガイド 基本開発編」の「付録H.2 文字コード変換UOCを使用するための設定」を参照してください。
なお,このプロパティはcscbinaryparseコマンド,csctransformコマンド,cscgenbinaryコマンド,およびそれらのコマンドプロパティファイルでも指定できます。重複して指定されている場合は,データ変換用システムプロパティファイルの指定が優先されます。該当するプロパティ名および引数名を次の表に示します。
プロパティファイル名/コマンド名 |
該当するプロパティ名/引数名 |
---|---|
データ変換用システムプロパティファイル |
csc.dt.ownCodeConverter.className |
|
csctransform.uoc.class |
|
-uocclass |
csc.dt.customFuncDir=カスタムファンクションで使用するjarファイルの格納パス
カスタムファンクションで使用するjarファイルの格納先を変更する場合,パスを指定します。
- 注意事項
-
jarファイルの格納先としてサービスプラットフォームのインストールディレクトリ配下を指定すると,アンインストール時にjarファイルが削除されるおそれがあります。そのため,インストールディレクトリ配下以外の場所を設定してください。
csc.dt.valueTable.変換テーブルID=値置換えファンクションで使用する変換テーブルのファイルパス
開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合,値置換えファンクションで利用する変換テーブルのファイルパスを指定します。
- 変換テーブルID
-
変換テーブルの変換テーブルIDを指定します。
- 変換テーブルのファイルパス
-
変換テーブルのファイルパスを絶対パスで指定します。
csc.dt.valueTableSize=値置換えファンクションで使用する変換テーブルの合計ファイルサイズ 〜<数字>((1−2097151))<<10>>
開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合,値置換えファンクションで利用する変換テーブルの合計ファイルサイズ(単位:キロバイト)の上限値を正の整数で指定します。
指定を省略した場合は10が仮定されます。上限値を超えるサイズの変換テーブルを読み込むと,KDEC40730-EをJ2EEサーバのログファイルに出力し,HCSCサーバの起動を中断します。
csc.dt.encodeType.変換テーブルID={MS932|UTF8|UTF16_BIG|UTF16_LITTLE}
開発環境で作成したデータ変換定義に値置換えファンクションが含まれる場合,値置換えファンクションで利用する文字コードを指定します。
csc.dt.undefined.replace.データ変換種別=置換文字コード
バイナリデータとUnicode文字列とを変換する場合,未定義の文字コードはデフォルトでは空白文字へ置換されますが,このプロパティに設定した任意の文字へ置換することもできます。
なお,任意の文字へ置換するには,次のどちらかにREPLACEを指定する必要があります。
-
csctransformコマンドの引数-undefinedcode
-
データ変換コマンドプロパティファイルのcsctransform.undefined.codeプロパティ
プロパティは変換する文字コードと置換種別によって,次のように異なります。置換する文字は16進数で指定してください。
-
バイナリデータをUnicode文字列に変換する場合
該当するシステムプロパティに置換文字コードをUnicode big endianの16進数で指定します。
指定できるシステムプロパティを次の表に示します。システムプロパティは,入力バイナリデータの置換種別ごとに指定できます。
表3‒2 システムプロパティ一覧(バイナリデータをUnicode文字列に変換する場合) 項番
キー名称
置換種別
変換先のUnicode文字列の文字コード
1
csc.dt.undefined.replace.bin2xml
半角
Unicode big endian
2
csc.dt.undefined.replace.bin2xml.full
全角
-
Unicode文字列をバイナリデータに変換する場合
該当するシステムプロパティに置換文字コードを16進数で指定します。
指定できるシステムプロパティを次の表に示します。システムプロパティは,変換先のバイナリデータの文字コードと置換種別ごとに指定できます。
表3‒3 システムプロパティ一覧(Unicode文字列をバイナリデータに変換する場合) 項番
キー名称
置換種別
変換先のバイナリデータの文字コード
1
csc.dt.undefined.replace.xml2utf16be
半角
UTF16 big endian
2
csc.dt.undefined.replace.xml2utf16be.full
全角
3
csc.dt.undefined.replace.xml2utf16le
半角
UTF16 little endian
4
csc.dt.undefined.replace.xml2utf16le.full
全角
5
csc.dt.undefined.replace.xml2utf8
半角
UTF8
6
csc.dt.undefined.replace.xml2utf8.full
全角
7
csc.dt.undefined.replace.xml2ms932
半角
MS932
8
csc.dt.undefined.replace.xml2ms932.full
全角
9
csc.dt.undefined.replace.xml2keisC
半角
KEIS+EBCDIC
10
csc.dt.undefined.replace.xml2keisC.full
全角
11
csc.dt.undefined.replace.xml2keisK
半角
KEIS+EBCDIK
12
csc.dt.undefined.replace.xml2keisK.full
全角
13
csc.dt.undefined.replace.xml2keis.full
全角
KEIS
14
csc.dt.undefined.replace.xml2ibmC.latin
半角
IBM+EBCDIC(LATIN)
15
csc.dt.undefined.replace.xml2ibmC.latin.full
全角
16
csc.dt.undefined.replace.xml2ibmC.kana
半角
IBM+EBCDIC(KANA)
17
csc.dt.undefined.replace.xml2ibmC.kana.full
全角
18
csc.dt.undefined.replace.xml2ibm.full
全角
IBM
19
csc.dt.undefined.replace.xml2jefC
半角
JEF+EBCDIC
20
csc.dt.undefined.replace.xml2jefC.full
全角
21
csc.dt.undefined.replace.xml2jefK
半角
JEF+EBCDIK
22
csc.dt.undefined.replace.xml2jefK.full
全角
23
csc.dt.undefined.replace.xml2jef.full
全角
JEF
24
csc.dt.undefined.replace.xml2jis
半角
JIS
25
csc.dt.undefined.replace.xml2jis.full
全角
26
csc.dt.undefined.replace.xml2euc
半角
EUC
27
csc.dt.undefined.replace.xml2euc.full
全角
28
csc.dt.undefined.replace.xml2euchj
半角
EUC_HJ
29
csc.dt.undefined.replace.xml2euchj.full
全角
csc.dt.sizeNode.includeSelfSize={true|false} 〜<<false>>
サイズノードの拡張機能を使用するかどうかを指定します。
-
true
サイズノードの拡張機能を使用します。
-
false
サイズノードの拡張機能を使用しません。