3.16.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
サイズノードの拡張機能を使用しません。