ZIETrans アプリケーション外の接続および Web 構成ファイル (ear/war) の構成

ZIETrans の開発と運用では、ユーザーはさまざまな接続設定プロパティ(main.hco)または WEL 構成プロパティ ( zietranswelcfg.xml ) を使用します。

この機能により、ユーザーは ZIETrans アプリケーションの外部でmain.hcoおよびzietranswelcfg.xmlを構成できます。本番または開発の要件に応じて、接続ファイルまたは構成ファイルの内容を置き換えます。

コンテンツの置換は、ear をサーバーにデプロイするときに 1 回だけ行われます。

この構成を実行するには、ユーザーは必要なコンテンツを含むファイルを ZIETrans プロジェクトの外部に保持し、そのパスをZIETRANS_CONFIG_ENVという名前のシステム環境変数として提供する必要があります。

従うべき構成手順:

  1. main.hco/ zietranswelcfg.xmlファイルを ZIETrans プロジェクトの外のシステム環境変数パスに保持します。

    例: ENVPATH\projName\connections\ ENVPATH\projName\welconfig\

  2. 同じマシンで複数のプロジェクトを処理する場合、プロジェクト名でフォルダーを作成し、ファイルを追加する必要があります。
    図 1.
  3. システム環境変数をZIETRANS_CONFIG_ENVとして指定し、運用環境か開発環境かにかかわらず、ユーザーの要件に従ってパスを変更します。
    注:
    • オペレーティング システム (OS) 環境変数の変更には、システムの再起動が必要です。
    • サーバー レベルまたは Java レベルでの環境変数の変更には、サーバーの再起動が必要です。
  4. 接続ファイルを置き換えるには、パスを次のように指定します。

    ENVPATH\ZIETransProjName\connections.

  5. 同様の手順に従ってzietranswelcfg.xmlを構成します。次のようにパスを指定します。

    ENVPATH\ZIETransProjName\welconfig.

  6. ここで、ear をサーバーにデプロイしてみます。システム環境パスで指定されたファイルのコンテンツを選択する必要があり、コンテンツはサーバーへのデプロイ中に置き換えられます。
  7. また、バックグラウンド接続のコンテンツを、システムの環境パスに適切なファイル名を付けて保持することで置き換えることもできます。このファイルのコンテンツは、バックグラウンド接続の既存のコンテンツを置き換えます。
  8. コンテンツが置き換えられると、 projectName.propertiesという名前の新しいファイルが生成され、 main.hcoファイルまたはzietranswelcfg.xmlファイルの最終変更日が追跡されます。

    このプロパティ ファイルのパスは、 ENVPATH\PojectName\projectName.properties になります。

  9. ZIETrans アプリケーション内に存在するファイルを 2 回目に変更するには、環境変数パスのmain.hco/ zietranswelcfg.xmlが変更されていることを確認する必要があります。ファイルを変更した後、変更されたファイルを考慮するために、ランタイムで ZIETrans アプリケーションを再起動する必要があります。
注:

この機能を適切に動作させるには、ファイルが上記のファイル構造に存在する必要があります (図 1 を参照)。