uCosminexus 電子フォームワークフロー 解説

[目次][用語][索引][前へ][次へ]

5.6.3 ストリングリソースプロパティファイルのカスタマイズ

ストリングリソースプロパティファイルは,BLC実行環境の各ページで表示するテキストリソースをカスタマイズするファイルです。テキストリソースの用途を十分理解した上で,カスタマイズしてください。

ストリングリソースの一覧は,「付録E.2 ストリングリソースプロパティファイル」を参照してください。

ストリングリソースプロパティファイルの構成を次に示します。

カスタマイズする前に,ストリングリソースプロパティファイルをバックアップ用に,コピーしておいてください。

ストリングリソースの取得は,BLCSTRPortalクラスのメソッドを使用します。BLCSTRPortalクラスについては,マニュアル「uCosminexus 電子フォームワークフロー APIリファレンス」の「BLCSTRPortalクラス」の説明を参照してください。

<この項の構成>
(1) ファイル名と格納先
(2) 書式
(3) カスタマイズの手順
(4) 注意事項

(1) ファイル名と格納先

ストリングリソースプロパティファイルのファイル名は,「BLCstringResourcePortal.properties」です。BLCstringResourcePortal.propertiesファイルは,アプリケーションサーバの次のディレクトリに格納されています。

(2) 書式

ストリングリソースプロパティファイル内の記述形式を次に示します。

Id = Resource Text
Id
識別コードです。ユーザ任意のIDを新規に付けてリソーステキストを登録する場合は,次の範囲でIDを登録してください。
  • 1〜9999:システムで予約されています。
  • 10000〜49999:関連製品で予約されています。
  • 50000〜59999:ユーザが任意に使えます。
Resource Text
BLCで管理するテキストリソースです。埋め字は"%s"(半角2バイト)で表現します。入力する文字に半角記号を使用すると,HTMLエンコードが必要となる場合があります。HTMLエンコード用のメソッドは共通クラス(BLCCommonクラス)で提供しています。

IdとResource Textは,"="(半角)で区切ります。Resource Text部に"="が含まれていても,テキストの一部と解釈され,区切りの"="とはみなされません。また,区切りの"="の前後に半角スペースが入力されている場合は無視されますが,Resource Text部に半角スペースを入力した場合は有効となります。ただし,Resource Text部に半角スペースを連続して入力した場合は,ブラウザによって無視されることがあります。

共通クラス(BLCCommonクラス)で提供するメソッドを使用すると,半角スペースをHTMLエンコードできます。ただし,HTMLエンコードした場合,ブラウザから印刷した結果に問題が確認されています。半角スペースのHTMLエンコードは,BLCプロパティファイルでオプション化できます。BLCプロパティファイルについては,「付録E.1 BLCプロパティファイル」を参照してください。

(3) カスタマイズの手順

ストリングリソースプロパティファイルは,Unicodeコード文字エンコーディングされた値で構成されたファイルである必要があります。

ストリングリソースプロパティファイルをカスタマイズする場合,一度ネイティブコードのテキストファイルに変換し,テキストファイルを編集します。編集したテキストファイルをUnicodeコード文字エンコーディングされた値で構成されたファイルに変換すると,編集した内容が有効になります。

変換には,Cosminexusに付属のJDKコマンド(native2asciiコマンド)を使用します。native2asciiコマンドの実行例を次に示します。

操作手順

  1. BLCで提供するストリングリソースプロパティファイル(BLCstringResourcePortal.properties)を,ネイティブコードのテキストファイル(BLCstringResourcePortal.txt)に変換します。

    [図データ]

  2. ネイティブコードのテキストファイル(BLCstringResourcePortal.txt)の内容を編集します。
  3. 編集したネイティブコードのテキストファイル(BLCstringResourcePortal.txt)を,Unicodeコード文字エンコーディングされた値で構成されたファイルに変換します。

    [図データ]

(4) 注意事項