Interstage Studio ユーザーズガイド

1.5 コンポーネントデザイナからの移行について

Interstage Apworks V7.0L10、および、それ以前のバージョンのInterstage Apworksで作成したコンポーネントデザイナのプロジェクトを、ワークベンチのインポート機能を使用して移行することができます。
以下のコンポーネントデザイナのプロジェクトを移行できます。

移行可能なプロジェクト

Pure Javaアプリケーション　注1)

JavaBeans　注1)

アプレット　注1)

Enterprise JavaBeans　注1)　注2)

Webアプリケーション　注1)　注3)

Webアプリケーション(Apcoordinator)　注1)　注4)

注1）ホスト画面連携フレームワーク、ホスト画面連携フレームワーク(Apcoordinator)、SOAPサーバアプリケーション(Apcoordinator)を使用したアプリケーションは移行できません。
注2）EJB規約バージョンが1.0のEnterprise JavaBeansは移行できません。
注3）XML表示入力アプリケーション、拡張タグライブラリアプリケーションは移行できません。
注4）携帯端末対応Apcoordinatorは移行できません。

+コンポーネントデザイナのプロジェクトをインポートする

コンポーネントデザイナのプロジェクトをワークベンチに移行する手順について説明します。

1. メニューバーから[ファイル] > [インポート]を選択すると、[インポート]ダイアログボックスが表示されます。
2. [インポートソースの選択]から[既存のコンポーネントデザイナのプロジェクトをワークスペースへ]を選択します。
3. [次へ]をクリックすると、[プロジェクトのインポート]ページが表示されます。
4. [インポートするプロジェクト]にインポートするプロジェクトファイルのパスを入力するか、[参照]をクリックしてインポートするプロジェクトを選択します。
5. [プロジェクト名]にプロジェクト名が表示されます。[プロジェクト名]は変更できません。
6. 選択したプロジェクトに含まれるサブプロジェクトもインポートする場合は、[サブプロジェクトのインポート]をチェックします。
7. [終了]をクリックすると、コンポーネントデザイナのプロジェクトがワークベンチにインポートされます。

• ワークベンチでサポートしていない以下のプロジェクト種別、および、アプリケーション種別はインポートできません。
  • iアプリ
  • MIDPアプリケーション
  • EJB規約バージョンが1.0 のEnterprise JavaBeansプロジェクト
  • ホスト画面連携フレームワークを使用したアプリケーション
  • SOAPサーバアプリケーション(Apcoordinator)
  • XML表示入力アプリケーション
  • 拡張タグライブラリアプリケーション
  • 携帯端末対応Apcoordinator
  • AIM連携アプリケーション
  • 標準アプリケーション
  • フロントGUI(エミュレータ)
  • フロントGUI(MeFt)
  • フロントGUI(ACM)
  • ActiveXコントロール
  • ワークフローアプリケーション(FlowACT)
  • ActiveXコントロール(FlowACT)
  • CAAプロジェクト(Pure Java)
  • CAAプロジェクト(Enterprise JavaBeans)
• COBOL言語で記述されたCORBAサーバプロジェクトは、手操作によりワークベンチに移行することができます。詳細は、"COBOL言語で記述されたCORBAサーバプロジェクトをワークベンチに移行するには"を参照してください。それ以外の言語で記述されたCORBAサーバプロジェクトは、ワークベンチに移行することができません。
• Javaの場合、コンポーネントデザイナで設定しているクラスパスは、すべてインポートされたプロジェクトのビルドパスに追加されます。いずれかのクラスパスが存在しない場合はビルド時にエラーになります。ビルドパスはインポート後に適切に変更してください。
• 以下の設定はインポートされません。
  • 構築オプション
  • 翻訳オプション
  • リンクオプション
  • デバッガオプション
  • プロジェクトのプロパティの[実行]タブに設定した内容
• コンポーネントデザイナで作成した資産格納庫は移行できません。

+インポート後の作業

インポート時にはプロジェクトの種類に応じたビルドパスが設定されます。また、プロジェクトの種類、ファイルの種類、ファイルの設定によってファイルの配置場所が決まります。

インポートで設定される標準的なビルドパスや標準的なファイルの配置では、Interstage Studioで開発するうえでは適切でない場合があります。インポート後は、ビルドパスの設定、および、ファイルの配置を確認してください。

++ビルドパスの確認

インポート後のプロジェクトには、そのプロジェクトの種類で標準的に使用される事前定義ライブラリが、ビルドパスに追加されます。標準で追加されない事前定義ライブラリを使用する場合は、ビルドパスにその事前定義ライブラリを追加してください。

コンポーネントデザイナで設定していたクラスパスは、すべてインポートされたプロジェクトのビルドパスに追加されます。事前定義ライブラリで解決されるJARファイルがビルドパスに直接指定されている場合、そのJARファイルはビルドパスに指定する必要はありません。そのようなJARファイルはビルドパスより削除してください。また、インストールフォルダの違いでJARファイルが見つからないものがあります。Javaコンパイルで参照されないJARファイルや事前定義ライブラリで解決されるJARファイルは、ビルドパスより削除してください。ユーザが固有で追加したライブラリは、適切な場所にライブラリがあるか確認してください。

++ファイルの配置の確認

インポート時には、プロジェクトの種類、ファイルの種類、ファイルの設定によってファイルの配置場所が決まります。インポート時の標準的な配置では、Interstage Studioで開発するうえでは適切ではない場所に配置されるファイルもあります。インポート後は、各ファイルが正しい配置となっているか確認し、適切な配置となっていないファイルは適切な配置に移動してください。

以下に、インポート機能がファイルを配置する規則を示します。

• Javaソースファイル(*.java)は、ソースフォルダ配下に配置されます。
• プロジェクトのプロパティの[構築]タブで、リソース結合対象としてチェックしているファイルは、ソースフォルダ配下に、元のフォルダ構成のまま配置されます。
• プロジェクトのプロパティの[構築]タブで、リソース結合対象としてチェックしていないファイルは、プロジェクトフォルダ配下に、元のフォルダ構成のまま配置されます。
• SPTファイル(*.spt)、帳票ファイル(*.pxd, *.psf, *.ovd)、オーバレイファイル(*.ovd, *.psf)、電子フォームファイル(*.fae, *.psf, *.ovd, *.pmd, *.js, *.bip)は、プロジェクトフォルダに配置されます。
• インポートするプロジェクトがWebアプリケーションおよびWebアプリケーション(Apcoordinator)の場合、HTMLファイルとJSPファイルは、ContextRootフォルダ配下に元のフォルダ構成のまま配置されます。ただし、一部のJSPファイルは、ContextRoot/pagesフォルダに配置されるものがあります。
  それ以外のプロジェクト種別の場合、HTMLファイルはプロジェクトフォルダ配下に元のフォルダ構成のまま配置されます。
• インポートするプロジェクトがWebアプリケーションおよびWebアプリケーション(Apcoordinator)の場合、WEB-INFフォルダにあるファイルは、ContextRoot/WEB-INFフォルダに配置されます。
• インポートするプロジェクトがEnterprise JavaBeansの場合、ejb-jar.xmlはソースフォルダ配下のMETA-INFフォルダに配置されます。
• application-client.xmlは、ソースフォルダ配下のMETA-INFフォルダに配置されます。
• コンポーネントデザイナの構築オプションで[Beanのシリアライズファイル(*.ser)をリソースとして扱う]がチェックされている場合は、プロジェクトフォルダ直下にあるすべての .serファイルがソースフォルダに配置されます。

Webアプリケーションや、Webアプリケーション(Apcoordinator)では、HTMLファイルとJSPファイル、および、WEB-INFフォルダ内にあるファイルだけがContextRootフォルダ配下に配置されます。その他のファイルは、リソース結合対象かどうかによってソースフォルダ配下やプロジェクトフォルダ配下に元のフォルダ構成のまま配置されます。
HTMLやJSPから参照するリソースファイルを確認し、適切な配置となるようにファイルを移動してください。

リソース結合対象となっているファイルは、基本的にソースフォルダ配下に配置されます。このため、テキストファイルなどのビルドの対象としないファイルもソースフォルダ配下に配置される場合があります。ビルドの対象としないファイルは、ソースフォルダ配下から適切な位置に移動してください。

　複数のプロジェクトを一括してインポートするには

コンポーネントデザイナのサブプロジェクトを利用することで、複数のプロジェクトを一括してインポートすることができます。以下に複数のプロジェクトを一括してインポートする手順を示します。

1. コンポーネントデザイナで、他のプロジェクトの親プロジェクトとなるインポート用の作業プロジェクトを作成します。
2. インポートするプロジェクトのプロジェクトフォルダをエクスプローラで開き、プロジェクトファイル「プロジェクト名.prj」をドラッグし、コンポーネントデザイナのプロジェクト表示域に表示されているインポート用の作業プロジェクトのプロジェクトファイル(インポート用の作業プロジェクト名がworkの場合、work.prj)にドロップします。
   [ファイル追加]ダイアログボックスが表示されますので、[OK]をクリックします。
   インポートするプロジェクトがインポート用の作業プロジェクトのサブプロジェクトとして追加されます。
3. インポートするコンポーネントデザイナのすべてのプロジェクトに対し、2.の操作を行います。
4. コンポーネントデザイナを終了します。
5. ワークベンチを起動し、メニューバーから[ファイル] > [インポート]を選択します。
6. [インポート]ダイアログボックスで[インポートソースの選択]から[既存のコンポーネントデザイナのプロジェクトをワークスペースへ]を選択し、[次へ]をクリックします。
7. [プロジェクトのインポート]ページで[インポートするプロジェクト]の[参照]をクリックし、1.で作成したインポート用の作業プロジェクトのプロジェクトファイルを選択します。
8. [サブプロジェクトのインポート]をチェックし、[終了]をクリックすると、インポート用の作業プロジェクトとそのサブプロジェクトすべてがインポートされます。
9. インポート完了後、インポートされたインポート用の作業プロジェクトをワークベンチから削除します。
10. インポート後の作業に沿って、ファイルを適切な位置に移動します。

　COBOL言語で記述されたCORBAサーバプロジェクトをワークベンチに移行するには

COBOL言語で記述されたCORBAサーバプロジェクトは、以下の手順でワークベンチに移行することができます。

1. 空のCORBAサーバプロジェクトを新規に作成します。
   メニューバーから[ファイル] > [新規] > [プロジェクト]を選択し、[新規プロジェクト]ダイアログボックスの[COBOL] > [CORBAサーバプロジェクト]を選択してプロジェクトを作成します。プロジェクト名およびターゲット名は移行元のプロジェクト名と同じ名前に設定します。生成するコードを選択する画面では、[コード生成は行わない]を選択して[終了]をクリックします。
2. 作成したプロジェクトに翻訳オプションおよびリンクオプションを設定します。
   移行元のプロジェクトで翻訳オプション、登録集名、リンクオプションおよびIDLコンパイラのオプションを独自に設定していた場合には、プロジェクトのプロパティ画面で同じ設定を行います。
3. 移行元のプロジェクトからソースファイルをコピーします。
   コンポーネントデザイナで移行元のプロジェクトを開き、プロジェクト表示域に表示されているソースファイル（COBOLソースファイルおよびIDLファイル）を確認します。そこに表示されているソースファイルを移行元のプロジェクトのフォルダから移行先のプロジェクトのフォルダにコピーします。ソースファイルの確認後はコンポーネントデザイナを終了してかまいません。
   • 移行元：<旧製品のインストールフォルダ>\APW\Projects\<プロジェクト名>
   • 移行先：<ユーザのドキュメントフォルダ>\Interstage Studio\<製品バージョン>\workspace\<プロジェクト名>
     
     注）移行元のフォルダ内にはプロジェクト表示域に表示されている以外のファイルも存在しますが、それらのファイルはコピーする必要はありません。
     注）ワークベンチのワークスペースフォルダをデフォルトの位置から変更している場合には、そのワークスペースフォルダ配下の（プロジェクト名）フォルダが移行先になります。
     
     
4. コピーしたファイルをプロジェクトに追加します。
   依存ビューでプロジェクトを選択し、コンテキストメニューから[最新表示]を実行します。コピーしたファイルが[その他のファイル]フォルダに追加されます。
5. コピーしたファイルを[ソースファイル]フォルダに移動します。
   コピーしたファイルを[その他のファイル]フォルダの中で選択し、コンテキストメニューから[ソースファイルへ追加]を実行します。ファイルが[その他のファイル]フォルダから[ソースファイル]フォルダに移動します。
6. メインプログラムを設定します。
   [ソースファイル]フォルダを開き、その中から（プロジェクト名）.cobというファイルを選択し、コンテキストメニューから[メインプログラム]を実行します。
7. IDLファイルを翻訳します。
   [ソースファイル]フォルダの中にあるIDLファイルを選択し、コンテキストメニューから[ファイルの翻訳]を実行します。なお、IDLファイルの翻訳にはあらかじめInterstage Application ServerおよびInterstageの管理に必要なサービス（基盤サービス）を起動しておく必要があります。起動していない場合にはあらかじめ起動しておいてください。
   基盤サービスの起動にはInterstage基盤サービス操作ツールを使用します。ツールを起動するには、スタートメニューから [Interstage] > [Studio] > [Interstage基盤サービス操作ツール]を選択してください。Interstage Application Serverの起動にはInterstage管理コンソールを使用してください。
8. スケルトンファイルを[ソースファイル]フォルダに移動します。
   IDLファイルが翻訳されると、[その他のファイル]フォルダにスタブ・スケルトンとなるCOBOLソースファイルおよびCOBOL登録集ファイルが生成されます。この中でスケルトンとなるファイルを[ソースファイル]フォルダに移動します。以下のファイルを先と同じ手順で[ソースファイル]フォルダに移動します。
   • インタフェースファイル：（モジュール名）-（インタフェース名）.cob
   • Helperクラスファイル：（モジュール名）-（インタフェース名）--HELPER.cob
   • Narrowスケルトンファイル：（モジュール名）-（インタフェース名）_NARROW.cob
   • tieクラスファイル：（モジュール名）-（インタフェース名）--TIE.cob
   • インプリメンテーション登録ファイル：（モジュール名）-（インタフェース名）--NEW.cob
   • データ型クラスファイル：（データ型名）.cob
   • データ型Helperファイル：（データ型名）--HELPER.cob
     
     注）登録集ファイル（*.cbl）およびスタブ用のファイル（*--stub.cob、*--NarrowStub.cob）は[ソースファイル]フォルダに移動しないでください。